{ "openapi": "3.1.0", "info": { "title": "docsgen API", "version": "0.21.0", "description": "Send the document type and its data; receive the finished PDF. Amounts arrive prepared by the caller and are printed as received: the service does not calculate, number, or store documents.", "contact": { "name": "Piensa IT", "email": "info@piensait.com" } }, "servers": [ { "url": "https://docsgen.piensait.com/api" } ], "tags": [ { "name": "Documents", "description": "Compose documents and list the available types and designs." } ], "paths": { "/documents": { "get": { "tags": [ "Documents" ], "operationId": "listDocuments", "summary": "Catalog of document types and designs", "description": "The available types, their designs, the default one and the style each design is drawn with today. No key required.", "security": [], "responses": { "200": { "description": "Catalog", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Catalogo" } } } } } }, "post": { "tags": [ "Documents" ], "operationId": "createDocument", "summary": "Compose a document as PDF", "description": "One document per call. Call it from your server: the key must never reach the browser.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Peticion" }, "examples": { "colilla-de-nomina-cifrada": { "summary": "/examples/colilla-de-nomina-cifrada.json", "value": { "type": "colilla-de-nomina", "plantilla": "azul", "cifrar": true, "data": { "yourCompany": { "name": "Casa de Cambio Ejemplo S.A.S.", "nit": "900111222-4", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Calle 10 # 40-20, local 5, Medellín - Antioquia", "phone": "6044445566", "email": "nomina@ejemplo.com", "web": "www.ejemplo.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "empleado": { "nombre": "Valentina Ospina Cardona", "tipoDocumento": "CC", "numeroDocumento": "1037000001", "cargo": "Cajera", "sucursal": "El Poblado", "salarioBase": 2100000, "contrato": "Término indefinido", "fechaIngreso": "2023-03-01" }, "periodo": { "numero": "Nómina 2026-10", "desde": "2026-10-01", "hasta": "2026-10-31", "fechaPago": "2026-10-31", "diasTrabajados": 15, "diasVacaciones": 15, "diasAusencia": 0 }, "devengados": [ { "concepto": "Sueldo", "detalle": "15 días", "valor": 1050000 }, { "concepto": "Vacaciones disfrutadas", "detalle": "15 días", "valor": 1050000 }, { "concepto": "Recargo nocturno (HRN)", "detalle": "45 h · 35 %", "valor": 157250 }, { "concepto": "Auxilio de transporte", "detalle": "15 días", "valor": 200000 } ], "deducciones": [ { "concepto": "Salud", "detalle": "4 %", "valor": 90290 }, { "concepto": "Pensión", "detalle": "4 %", "valor": 90290 }, { "concepto": "Fondo de empleados", "detalle": "Aporte mensual", "valor": 50000 } ], "totales": { "devengado": 2457250, "deducido": 230580, "neto": 2226670 }, "pago": { "medio": "Transferencia bancaria", "banco": "Bancolombia", "cuenta": "Ahorros ****8901" }, "notes": "Liquidación con 15 días de vacaciones disfrutadas del 16 al 31 de octubre.", "paymentLegend": "Pago por transferencia a la cuenta registrada de la empleada el 31 de octubre de 2026.", "sideNotes": [ "Generado mediante software MiDivisa by Piensa IT S.A.S." ] } } }, "colilla-de-nomina-integral": { "summary": "/examples/colilla-de-nomina-integral.json", "value": { "type": "colilla-de-nomina", "plantilla": "azul", "data": { "yourCompany": { "name": "Casa de Cambio Ejemplo S.A.S.", "nit": "900111222-4", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Calle 10 # 40-20, local 5, Medellín - Antioquia", "phone": "6044445566", "email": "nomina@ejemplo.com", "web": "www.ejemplo.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "empleado": { "nombre": "Juan Sebastián Arango Villegas", "documento": "CC 1036000002", "cargo": "Gerente de Tesorería", "sucursal": "Sede administrativa", "salarioBase": 22000000, "contrato": "Término indefinido · Salario integral", "fechaIngreso": "2021-02-15" }, "periodo": { "numero": "Nómina 2026-10 · 1ª quincena", "desde": "2026-10-01", "hasta": "2026-10-15", "fechaPago": "2026-10-15", "diasTrabajados": 15, "diasVacaciones": 0, "diasAusencia": 0 }, "devengados": [ { "concepto": "Sueldo integral", "detalle": "15 días", "valor": 11000000 }, { "concepto": "Horas extra diurnas (HED)", "detalle": "6 h · 25 %", "valor": 785714 }, { "concepto": "Recargo nocturno (HRN)", "detalle": "8 h · 35 %", "valor": 293333 }, { "concepto": "Recargo dominical y festivo (HRDDF)", "detalle": "8 h · 90 %", "valor": 754286 }, { "concepto": "Comisiones", "detalle": "Metas de la 1ª quincena", "valor": 1200000 }, { "concepto": "Bonificación salarial", "detalle": "Cierre de septiembre", "valor": 750000 }, { "concepto": "Bonificación no salarial", "detalle": "Por desempeño", "valor": 500000 }, { "concepto": "Auxilio de alimentación", "detalle": "No salarial · 15 días", "valor": 300000 }, { "concepto": "Reembolso de gastos", "detalle": "Viaje a Bogotá · no salarial", "valor": 242650 } ], "deducciones": [ { "concepto": "Salud", "detalle": "4 % · IBC $ 10.348.333 (70 %)", "valor": 413933 }, { "concepto": "Pensión", "detalle": "4 % · IBC $ 10.348.333 (70 %)", "valor": 413933 }, { "concepto": "Fondo de solidaridad pensional", "detalle": "1 % · IBC entre 4 y 16 SMMLV", "valor": 103483 }, { "concepto": "Retención en la fuente", "detalle": "Procedimiento 1", "valor": 1685000 }, { "concepto": "Aporte voluntario a pensión", "detalle": "Protección", "valor": 800000 }, { "concepto": "Cuenta AFC", "detalle": "Davivienda", "valor": 500000 }, { "concepto": "Libranza", "detalle": "Banco de Bogotá · cuota 14 de 48", "valor": 615000 }, { "concepto": "Fondo de empleados", "detalle": "Ahorro y cuota de crédito", "valor": 125000 }, { "concepto": "Medicina prepagada", "detalle": "Plan familiar", "valor": 345000 }, { "concepto": "Embargo judicial", "detalle": "Oficio 0412 de 2026", "valor": 900000 } ], "totales": { "devengado": 15825983, "deducido": 5901349, "neto": 9924634 }, "pago": { "medio": "Transferencia bancaria", "banco": "Davivienda", "cuenta": "Corriente ****4417" }, "nominaElectronica": { "estado": "validada", "numero": "NE-002184", "cune": "4f9d2c7a1b3e5d8f0a6c9e2b4d7f1a3c5e8b0d2f4a6c8e1b3d5f7a9c2e4b6d8f0a1c3e5b7d9f2a4c6e8b1d3f5a7c9e0b", "qr": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=4f9d2c7a1b3e5d8f0a6c9e2b4d7f1a3c5e8b0d2f4a6c8e1b3d5f7a9c2e4b6d8f0a1c3e5b7d9f2a4c6e8b1d3f5a7c9e0b" }, "notes": "Salario integral de $ 22.000.000 mensuales liquidado por quincenas. Horas extra y recargos sobre el valor hora de 210 horas mensuales. Los aportes a seguridad social se liquidan sobre el 70 % de los pagos salariales del periodo, por tratarse de salario integral.", "paymentLegend": "Pago por transferencia a la cuenta corriente registrada del empleado el 15 de octubre de 2026.", "leyenda": "Salario integral pactado por escrito, que remunera además del trabajo ordinario el valor de las prestaciones, recargos y beneficios que se compensan en él, salvo las vacaciones. Este comprobante detalla los valores devengados y deducidos en el periodo indicado; consérvelo como soporte de su pago y de sus certificados de ingresos y retenciones.", "firmas": [ { "rol": "Empleador", "nombre": "Carolina Mejía Duque", "documento": "Directora de Gestión Humana · CC 43500001" }, { "rol": "Recibí conforme (empleado)", "nombre": "Juan Sebastián Arango Villegas", "documento": "CC 1036000002" } ], "sideNotes": [ "Generado mediante software MiDivisa by Piensa IT S.A.S." ] } } }, "colilla-de-nomina": { "summary": "/examples/colilla-de-nomina.json", "value": { "type": "colilla-de-nomina", "plantilla": "azul", "data": { "yourCompany": { "name": "Casa de Cambio Ejemplo S.A.S.", "nit": "900111222-4", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Calle 10 # 40-20, local 5, Medellín - Antioquia", "phone": "6044445566", "email": "nomina@ejemplo.com", "web": "www.ejemplo.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "empleado": { "nombre": "Valentina Ospina Cardona", "documento": "CC 1037000001", "cargo": "Cajera", "sucursal": "El Poblado", "salarioBase": 2100000, "contrato": "Término indefinido", "fechaIngreso": "2023-03-01" }, "periodo": { "numero": "Nómina 2026-10", "desde": "2026-10-01", "hasta": "2026-10-31", "fechaPago": "2026-10-31", "diasTrabajados": 15, "diasVacaciones": 15, "diasAusencia": 0 }, "devengados": [ { "concepto": "Sueldo", "detalle": "15 días", "valor": 1050000 }, { "concepto": "Vacaciones disfrutadas", "detalle": "15 días", "valor": 1050000 }, { "concepto": "Recargo nocturno (HRN)", "detalle": "45 h · 35 %", "valor": 157250 }, { "concepto": "Auxilio de transporte", "detalle": "15 días", "valor": 200000 } ], "deducciones": [ { "concepto": "Salud", "detalle": "4 %", "valor": 90290 }, { "concepto": "Pensión", "detalle": "4 %", "valor": 90290 }, { "concepto": "Fondo de empleados", "detalle": "Aporte mensual", "valor": 50000 } ], "totales": { "devengado": 2457250, "deducido": 230580, "neto": 2226670 }, "pago": { "medio": "Transferencia bancaria", "banco": "Bancolombia", "cuenta": "Ahorros ****8901" }, "notes": "Liquidación con 15 días de vacaciones disfrutadas del 16 al 31 de octubre.", "paymentLegend": "Pago por transferencia a la cuenta registrada de la empleada el 31 de octubre de 2026.", "sideNotes": [ "Generado mediante software MiDivisa by Piensa IT S.A.S." ] } } }, "contrato": { "summary": "/examples/contrato.json", "value": { "type": "contrato", "data": { "issuer": { "name": "PIENSA IT", "nit": "902001989-5", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png" }, "title": "Contrato de prestación de servicios", "number": "PS-0007", "date": "2026-09-10", "catalog": [ { "key": "contratante", "label": "Contratante", "grupo": "Partes" }, { "key": "contratista", "label": "Contratista", "grupo": "Partes" }, { "key": "objeto", "label": "Objeto", "grupo": "Condiciones" }, { "key": "valor", "label": "Valor", "grupo": "Condiciones" }, { "key": "plazo", "label": "Plazo", "grupo": "Condiciones" } ], "values": { "contratante": "Empresa Cliente S.A.S", "contratista": "PIENSA IT", "objeto": "la implementación del módulo de facturación electrónica", "valor": "$ 18.000.000", "plazo": "cuatro (4) meses" }, "body": "

Contrato de prestación de servicios

Entre {{contratante}}, en calidad de contratante, y {{contratista}}, en calidad de contratista, se celebra el presente contrato que tiene por objeto {{objeto}}.

CondiciónValor
Valor{{valor}}
Plazo{{plazo}}

Primera. Objeto

El contratista se obliga a ejecutar {{objeto}} conforme a la propuesta aceptada por el contratante.

Segunda. Valor y forma de pago

El valor del contrato es de {{valor}}, pagadero en cuotas mensuales iguales contra la entrega de cada hito.

Tercera. Plazo

El plazo de ejecución es de {{plazo}} contados desde la firma de este documento.

Cuarta. Confidencialidad

La información a la que acceda el contratista es confidencial y no podrá divulgarse sin autorización escrita.

", "signatures": [ { "nombre": "{{contratante}}", "documento": "NIT 901234567-8", "representante": "Laura Restrepo Ochoa", "rol": "El contratante" }, { "nombre": "{{contratista}}", "documento": "NIT 902001989-5", "representante": "Mariana Gómez Uribe", "rol": "El contratista" } ] } } }, "cuenta-de-cobro": { "summary": "/examples/cuenta-de-cobro.json", "value": { "type": "cuenta-de-cobro", "data": { "yourCompany": { "name": "PIENSA IT", "nit": "902001989-5", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png" }, "billTo": { "name": "Empresa Cliente S.A.S", "nit": "901234567-8", "address": "Calle 10 #20-30, Medellín", "phone": "3001234567" }, "invoice": { "number": "CC-0042", "date": "2026-09-09", "paymentDate": "2026-10-09" }, "items": [ { "name": "Desarrollo de la integración", "quantity": 1, "amount": 1800000, "total": 1800000 }, { "name": "Soporte mensual", "quantity": 2, "amount": 350000, "total": 700000 } ], "subTotal": 2500000, "grandTotal": 2500000, "notes": "Gracias por su pago oportuno.", "paymentLegend": "Consignar a la cuenta indicada por el emisor.", "payment": { "form": "Crédito", "method": "Transferencia bancaria", "amount": 2500000, "dueDate": "2026-10-09" }, "selectedCurrency": "COP" } } }, "entrada-de-inventario": { "summary": "/examples/entrada-de-inventario.json", "value": { "type": "entrada-de-inventario", "plantilla": "premium", "data": { "yourCompany": { "name": "Casa de Cambio Ejemplo S.A.S.", "nit": "900111222-4", "address": "Calle 10 # 40-20, local 5, Medellín - Antioquia", "phone": "6044445566", "email": "operaciones@ejemplo.com", "web": "www.ejemplo.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "documento": { "numero": "ENT-000123", "fecha": "2026-09-15", "motivo": "Compra de divisas", "referencia": "Transacción T-1045", "observaciones": "Billetes verificados con detector UV y contados dos veces en presencia del cliente." }, "bodega": { "nombre": "Sucursal Aeropuerto", "codigo": "AER", "direccion": "Aeropuerto José María Córdova, muelle nacional, local 14" }, "tercero": { "rol": "Proveedor", "nombre": "Ana Pérez", "documento": "CC 1037000001" }, "items": [ { "codigo": "USD", "descripcion": "Dólar estadounidense, billetes de 100", "cantidad": 1500, "unidad": "USD", "lote": "L-2026-0915-A", "serie": "PB 01234567 A – PB 01234581 A", "costoUnitario": 3950.5, "costoTotal": 5925750 }, { "codigo": "USD", "descripcion": "Dólar estadounidense, billetes de 20", "cantidad": 240, "unidad": "USD", "lote": "L-2026-0915-A", "serie": "", "costoUnitario": 3945, "costoTotal": 946800 }, { "codigo": "EUR", "descripcion": "Euro, billetes de 50", "cantidad": 350.5, "unidad": "EUR", "lote": "L-2026-0915-B", "serie": "", "costoUnitario": 4380, "costoTotal": 1535190 } ], "totales": { "costo": 8407740 }, "moneda": "COP", "firmas": [ { "rol": "Entrega", "nombre": "Ana Pérez", "documento": "CC 1037000001" }, { "rol": "Recibe", "nombre": "Laura Gómez", "documento": "CC 43210987" } ] } } }, "estado-de-cuenta": { "summary": "/examples/estado-de-cuenta.json", "value": { "type": "estado-de-cuenta", "plantilla": "premium", "data": { "yourCompany": { "name": "Piensa IT S.A.S.", "nit": "902001989-5", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "billTo": { "nit": "901456782-3", "name": "NOVA RETAIL S.A.S.", "country": "Colombia", "city": "La Estrella / Antioquia", "address": "CR 48 10 SUR 52", "email": "facturacion@novaretail.co", "contact": "Laura Restrepo Ochoa" }, "statement": { "cutoffDate": "13-09-2026" }, "movements": [ { "number": "FV-0231", "type": "Factura de venta", "date": "10-06-2026", "dueDate": "10-07-2026", "daysOverdue": 65, "amount": 4200000, "payments": 0, "balance": 4200000 }, { "number": "FV-0244", "type": "Factura de venta", "date": "13-07-2026", "dueDate": "12-08-2026", "daysOverdue": 32, "amount": 3100000, "payments": 1100000, "balance": 2000000 }, { "number": "FV-0259", "type": "Factura de venta", "date": "16-08-2026", "dueDate": "15-09-2026", "daysOverdue": 0, "amount": 5400000, "payments": 0, "balance": 5400000 }, { "number": "RC-0088", "type": "Recibo de caja", "date": "24-08-2026", "amount": -1100000 } ], "aging": [ { "label": "Por vencer", "amount": 5400000 }, { "label": "1 a 30", "amount": 0 }, { "label": "31 a 60", "amount": 2000000 }, { "label": "61 a 90", "amount": 4200000, "highlighted": true }, { "label": "Más de 90", "amount": 0, "highlighted": true } ], "totals": { "invoiced": 12700000, "payments": 1100000, "balance": 11600000 }, "payment": { "enlace": "https://www.psepagos.co/piensait/cartera/901456782", "textoDelEnlace": "Pagar en línea con PSE" }, "paymentLegend": "Consignar a nombre de Piensa IT S.A.S., NIT 902001989-5, en la cuenta de ahorros Bancolombia 123-456789-01, indicando el NIT del cliente como referencia.", "notes": "Si ya realizó el pago, haga caso omiso de este estado de cuenta.", "selectedCurrency": "COP", "sideNotes": [ "Documento generado por computador. No requiere firma autógrafa.", "CoreLink by Piensa IT S.A.S." ] } } }, "factura-premium": { "summary": "/examples/factura-premium.json", "value": { "type": "factura", "plantilla": "premium", "data": { "yourCompany": { "name": "Piensa IT S.A.S.", "nit": "902001989-5", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "billTo": { "nit": "901456782-3", "name": "NOVA RETAIL S.A.S.", "country": "Colombia", "city": "La Estrella / Antioquia", "address": "CR 48 10 SUR 52", "email": "facturacion@novaretail.co", "contact": "Laura Restrepo Ochoa" }, "invoice": { "number": "PIFE9", "generatedAt": "04-09-2026 07:14:01 PM", "validatedAt": "04-09-2026 07:14:02 PM", "operationType": "Estándar", "cufe": "498704ba66fc0b14390f0f5b876de61c76a93f13180836ef4809f325c132563ce11fce4c84ee4c94ba009788923d1858", "qr": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=498704ba66fc0b14" }, "items": [ { "code": "LIC-ERP-025", "name": "Licencia anual ERP — 25 usuarios", "quantity": 1, "amount": 18500000, "discount": 0, "taxRate": 19, "total": 18500000 }, { "code": "SRV-IMP-010", "name": "Implementación y migración de datos", "quantity": 1, "amount": 9800000, "discount": 0, "taxRate": 19, "total": 9800000 }, { "code": "SOP-PRE-012", "name": "Soporte premium — mensualidad", "quantity": 12, "amount": 650000, "discount": 0, "taxRate": 19, "total": 7800000 } ], "totals": { "gross": 36100000, "taxableBase": 36100000, "tax": 6859000, "withholding": 1444000, "discount": 0, "surcharge": 0, "total": 42959000 }, "payment": { "form": "Crédito", "term": "30 días calendario", "method": "Transferencia electrónica", "amount": 42959000, "dueDate": "10-10-2026", "enlace": "https://www.pse.com.co/persona-tu-primer-pago-por-pse", "textoDelEnlace": "Pagar en línea por PSE" }, "authorization": { "economicActivity": "6201", "resolution": "18764101686441", "prefix": "PIFE", "rangeFrom": 1, "rangeTo": 10000, "validFrom": "18-11-2025", "validUntil": "18-11-2027", "number": "18764101686441853", "authorizedAt": "18-11-2025" }, "selectedCurrency": "COP", "legalNotes": [ "Esta factura electrónica de venta se asimila en todos sus efectos legales a una letra de cambio, conforme al artículo 774 del Código de Comercio.", "De acuerdo con la Ley 1231 de 2008, esta factura se entenderá irrevocablemente aceptada si no es reclamada dentro de los tres (3) días hábiles siguientes a su recibo." ], "software": { "manufacturer": "CoreLink by Piensa IT S.A.S.", "name": "CoreLink Facturación Electrónica", "version": "1.0", "web": "www.corelink.com.co" }, "fields": [ { "label": "Canal", "value": "Venta directa" }, { "label": "Vendedor", "value": "Mariana Gómez Uribe" }, { "label": "Orden de compra", "value": "OC-2026-0448" }, { "label": "Contacto", "value": "Laura Restrepo Ochoa" }, { "label": "Teléfono contacto", "value": "3001234567" }, { "label": "Punto de entrega", "value": "Centro de datos, Carrera 70 #45-23, Medellín" }, { "label": "Concepto", "value": "Renovación de plataforma e infraestructura" }, { "label": "Nro pedido", "value": "PED-10237" }, { "label": "Centro de costos", "value": "TI-100 · Infraestructura" } ], "sideNotes": [ "Documento generado por computador. No requiere firma autógrafa.", "CoreLink by Piensa IT S.A.S." ], "paymentLegend": "Realice su pago en la cuenta corriente Bancolombia n.º 123-123123-12, a nombre de Empresa Emisora S.A.S., o desde su banco a la llave 123123123. También puede pagar en línea con el botón de pago." } } }, "factura-tirilla": { "summary": "/examples/factura-tirilla.json", "value": { "type": "factura", "plantilla": "tirilla", "data": { "yourCompany": { "name": "Piensa IT S.A.S.", "nit": "902001989-5", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "billTo": { "nit": "901456782-3", "name": "NOVA RETAIL S.A.S.", "country": "Colombia", "city": "La Estrella / Antioquia", "address": "CR 48 10 SUR 52", "email": "facturacion@novaretail.co", "contact": "Laura Restrepo Ochoa" }, "invoice": { "number": "PIFE9", "generatedAt": "04-09-2026 07:14:01 PM", "validatedAt": "04-09-2026 07:14:02 PM", "operationType": "Estándar", "cufe": "498704ba66fc0b14390f0f5b876de61c76a93f13180836ef4809f325c132563ce11fce4c84ee4c94ba009788923d1858", "qr": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=498704ba66fc0b14" }, "items": [ { "code": "SRV-DOM-001", "name": "Registro de dominio .com — anual", "quantity": 1, "amount": 240000, "discount": 0, "taxRate": 19, "total": 240000 } ], "totals": { "gross": 240000, "taxableBase": 240000, "tax": 45600, "withholding": 6000, "discount": 0, "surcharge": 0, "total": 285600 }, "payment": { "form": "Crédito", "term": "30 días calendario", "method": "Transferencia electrónica", "amount": 285600, "dueDate": "10-10-2026", "enlace": "https://www.pse.com.co/persona-tu-primer-pago-por-pse", "textoDelEnlace": "Pagar en línea por PSE" }, "authorization": { "economicActivity": "6201", "resolution": "18764101686441", "prefix": "PIFE", "rangeFrom": 1, "rangeTo": 10000, "validFrom": "18-11-2025", "validUntil": "18-11-2027", "number": "18764101686441853", "authorizedAt": "18-11-2025" }, "selectedCurrency": "COP", "legalNotes": [ "Esta factura electrónica de venta se asimila en todos sus efectos legales a una letra de cambio, conforme al artículo 774 del Código de Comercio.", "De acuerdo con la Ley 1231 de 2008, esta factura se entenderá irrevocablemente aceptada si no es reclamada dentro de los tres (3) días hábiles siguientes a su recibo." ], "software": { "manufacturer": "CoreLink by Piensa IT S.A.S.", "name": "CoreLink Facturación Electrónica", "version": "1.0", "web": "www.corelink.com.co" }, "fields": [ { "label": "Canal", "value": "Venta directa" }, { "label": "Vendedor", "value": "Mariana Gómez Uribe" }, { "label": "Orden de compra", "value": "OC-2026-0448" }, { "label": "Contacto", "value": "Laura Restrepo Ochoa" }, { "label": "Teléfono contacto", "value": "3001234567" }, { "label": "Punto de entrega", "value": "Centro de datos, Carrera 70 #45-23, Medellín" }, { "label": "Concepto", "value": "Renovación de plataforma e infraestructura" }, { "label": "Nro pedido", "value": "PED-10237" }, { "label": "Centro de costos", "value": "TI-100 · Infraestructura" } ], "sideNotes": [ "Documento generado por computador. No requiere firma autógrafa.", "CoreLink by Piensa IT S.A.S." ], "paymentLegend": "Realice su pago en la cuenta corriente Bancolombia n.º 123-123123-12, a nombre de Empresa Emisora S.A.S., o desde su banco a la llave 123123123. También puede pagar en línea con el botón de pago." } } }, "factura": { "summary": "/examples/factura.json", "value": { "type": "factura", "data": { "yourCompany": { "name": "Piensa IT S.A.S.", "nit": "902001989-5", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "billTo": { "nit": "901456782-3", "name": "NOVA RETAIL S.A.S.", "country": "Colombia", "city": "La Estrella / Antioquia", "address": "CR 48 10 SUR 52", "email": "facturacion@novaretail.co", "contact": "Laura Restrepo Ochoa" }, "invoice": { "number": "PIFE2", "generatedAt": "04-09-2026 07:14:01 PM", "validatedAt": "04-09-2026 07:14:02 PM", "operationType": "Estándar", "cufe": "498704ba66fc0b14390f0f5b876de61c76a93f13180836ef4809f325c132563ce11fce4c84ee4c94ba009788923d1858", "qr": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=498704ba66fc0b14" }, "items": [ { "code": "SRV-DOM-001", "name": "Registro de dominio .com — anual", "quantity": 1, "amount": 240000, "discount": 0, "taxRate": 19, "total": 240000 } ], "totals": { "gross": 240000, "taxableBase": 240000, "tax": 45600, "withholding": 6000, "discount": 0, "surcharge": 0, "total": 285600 }, "payment": { "form": "Crédito", "term": "30 días calendario", "method": "Transferencia electrónica", "amount": 285600, "dueDate": "10-10-2026", "enlace": "https://www.pse.com.co/persona-tu-primer-pago-por-pse", "textoDelEnlace": "Pagar en línea por PSE" }, "authorization": { "economicActivity": "6201", "resolution": "18764101686441", "prefix": "PIFE", "rangeFrom": 1, "rangeTo": 10000, "validFrom": "18-11-2025", "validUntil": "18-11-2027", "number": "18764101686441853", "authorizedAt": "18-11-2025" }, "selectedCurrency": "COP", "legalNotes": [ "Esta factura electrónica de venta se asimila en todos sus efectos legales a una letra de cambio, conforme al artículo 774 del Código de Comercio.", "De acuerdo con la Ley 1231 de 2008, esta factura se entenderá irrevocablemente aceptada si no es reclamada dentro de los tres (3) días hábiles siguientes a su recibo." ], "software": { "manufacturer": "CoreLink by Piensa IT S.A.S.", "name": "CoreLink Facturación Electrónica", "version": "1.0", "web": "www.corelink.com.co" }, "fields": [ { "label": "Canal", "value": "Venta directa" }, { "label": "Vendedor", "value": "Mariana Gómez Uribe" }, { "label": "Orden de compra", "value": "OC-2026-0448" }, { "label": "Punto de entrega", "value": "Centro de datos, Carrera 70 #45-23, Medellín" }, { "label": "Concepto", "value": "Renovación de plataforma e infraestructura" }, { "label": "Centro de costos", "value": "TI-100 · Infraestructura" } ], "sideNotes": [ "Documento generado por computador. No requiere firma autógrafa.", "CoreLink by Piensa IT S.A.S." ], "paymentLegend": "Realice su pago en la cuenta corriente Bancolombia n.º 123-123123-12, a nombre de Empresa Emisora S.A.S., o desde su banco a la llave 123123123. También puede pagar en línea con el botón de pago." } } }, "informe-horizontal": { "summary": "/examples/informe-horizontal.json", "value": { "type": "informe", "plantilla": "premium", "data": { "yourCompany": { "name": "Casa de Cambio Ejemplo S.A.S.", "nit": "900111222-4", "address": "Calle 10 # 40-20, local 5, Medellín - Antioquia", "phone": "6044445566", "email": "operaciones@ejemplo.com", "web": "www.ejemplo.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "informe": { "titulo": "Operaciones del periodo", "subtitulo": "Compras y ventas de divisas", "alcance": "Todas las sucursales", "periodo": { "desde": "2026-09-01", "hasta": "2026-09-15" }, "generadoEn": "2026-09-15T14:30:00-05:00", "generadoPor": "Andrés Montoya", "orientacion": "horizontal" }, "columnas": [ { "clave": "fecha", "titulo": "Fecha", "formato": "fecha", "ancho": 1.4 }, { "clave": "numero", "titulo": "Número", "ancho": 0.9 }, { "clave": "sucursal", "titulo": "Sucursal", "ancho": 1.1 }, { "clave": "cajera", "titulo": "Cajera", "ancho": 1.4 }, { "clave": "cliente", "titulo": "Cliente", "ancho": 1.8 }, { "clave": "documento", "titulo": "Documento", "ancho": 1.3 }, { "clave": "tipo", "titulo": "Tipo", "alineacion": "centro", "ancho": 0.8 }, { "clave": "moneda", "titulo": "Moneda", "alineacion": "centro", "ancho": 0.8 }, { "clave": "cantidad", "titulo": "Cantidad", "alineacion": "derecha", "formato": "numero", "ancho": 1 }, { "clave": "tasa", "titulo": "Tasa", "alineacion": "derecha", "formato": "moneda", "ancho": 1 }, { "clave": "totalCop", "titulo": "Total COP", "alineacion": "derecha", "formato": "moneda", "ancho": 1.4 }, { "clave": "estado", "titulo": "Estado", "alineacion": "centro", "ancho": 1 } ], "filas": [ { "fecha": "2026-09-01T09:00:00-05:00", "numero": "T-1030", "sucursal": "Aeropuerto", "cajera": "Laura Gómez", "cliente": "Ana Pérez", "documento": "CC 1037000001", "tipo": "Venta", "moneda": "USD", "cantidad": 1500, "tasa": 3950.5, "totalCop": 5925750, "estado": "Completada" }, { "fecha": "2026-09-01T10:07:00-05:00", "numero": "T-1031", "sucursal": "El Poblado", "cajera": "Valentina Ospina", "cliente": "Juan Carlos Mejía", "documento": "CC 1037000138", "tipo": "Compra", "moneda": "EUR", "cantidad": 820.5, "tasa": 4310.75, "totalCop": 3536970.38, "estado": "Completada" }, { "fecha": "2026-09-02T11:14:00-05:00", "numero": "T-1032", "sucursal": "Laureles", "cajera": "Camila Restrepo", "cliente": "Luisa Fernanda Arango", "documento": "CC 1037000275", "tipo": "Venta", "moneda": "USD", "cantidad": 300, "tasa": 3951, "totalCop": 1185300, "estado": "Completada" }, { "fecha": "2026-09-02T12:21:00-05:00", "numero": "T-1033", "sucursal": "Aeropuerto", "cajera": "Laura Gómez", "cliente": "Pedro Salazar", "documento": "CC 1037000412", "tipo": "Compra", "moneda": "USD", "cantidad": 2000, "tasa": 3890.25, "totalCop": 7780500, "estado": "Completada" }, { "fecha": "2026-09-03T13:28:00-05:00", "numero": "T-1034", "sucursal": "El Poblado", "cajera": "Valentina Ospina", "cliente": "María José Tobón", "documento": "CC 1037000549", "tipo": "Venta", "moneda": "EUR", "cantidad": 450, "tasa": 4380, "totalCop": 1971000, "estado": "Completada" }, { "fecha": "2026-09-03T14:35:00-05:00", "numero": "T-1035", "sucursal": "Laureles", "cajera": "Camila Restrepo", "cliente": "Andrés Felipe Ríos", "documento": "CC 1037000686", "tipo": "Compra", "moneda": "USD", "cantidad": 1200.75, "tasa": 3890, "totalCop": 4670917.5, "estado": "Completada" }, { "fecha": "2026-09-04T15:42:00-05:00", "numero": "T-1036", "sucursal": "Aeropuerto", "cajera": "Laura Gómez", "cliente": "Ana Pérez", "documento": "CC 1037000823", "tipo": "Venta", "moneda": "USD", "cantidad": 95, "tasa": 3950.5, "totalCop": 375297.5, "estado": "Completada" }, { "fecha": "2026-09-04T16:49:00-05:00", "numero": "T-1037", "sucursal": "El Poblado", "cajera": "Valentina Ospina", "cliente": "Juan Carlos Mejía", "documento": "CC 1037000960", "tipo": "Compra", "moneda": "EUR", "cantidad": 640, "tasa": 4310.75, "totalCop": 2758880, "estado": "Completada" }, { "fecha": "2026-09-05T09:56:00-05:00", "numero": "T-1038", "sucursal": "Laureles", "cajera": "Camila Restrepo", "cliente": "Luisa Fernanda Arango", "documento": "CC 1037001097", "tipo": "Venta", "moneda": "USD", "cantidad": 1500, "tasa": 3951, "totalCop": 5926500, "estado": "Completada" }, { "fecha": "2026-09-05T10:03:00-05:00", "numero": "T-1039", "sucursal": "Aeropuerto", "cajera": "Laura Gómez", "cliente": "Pedro Salazar", "documento": "CC 1037001234", "tipo": "Compra", "moneda": "USD", "cantidad": 820.5, "tasa": 3890.25, "totalCop": 3191950.12, "estado": "Completada" }, { "fecha": "2026-09-06T11:10:00-05:00", "numero": "T-1040", "sucursal": "El Poblado", "cajera": "Valentina Ospina", "cliente": "María José Tobón", "documento": "CC 1037001371", "tipo": "Venta", "moneda": "EUR", "cantidad": 300, "tasa": 4380, "totalCop": 1314000, "estado": "Completada" }, { "fecha": "2026-09-06T12:17:00-05:00", "numero": "T-1041", "sucursal": "Laureles", "cajera": "Camila Restrepo", "cliente": "Andrés Felipe Ríos", "documento": "CC 1037001508", "tipo": "Compra", "moneda": "USD", "cantidad": 2000, "tasa": 3890, "totalCop": 7780000, "estado": "Completada" }, { "fecha": "2026-09-07T13:24:00-05:00", "numero": "T-1042", "sucursal": "Aeropuerto", "cajera": "Laura Gómez", "cliente": "Ana Pérez", "documento": "CC 1037001645", "tipo": "Venta", "moneda": "USD", "cantidad": 450, "tasa": 3950.5, "totalCop": 1777725, "estado": "Completada" }, { "fecha": "2026-09-07T14:31:00-05:00", "numero": "T-1043", "sucursal": "El Poblado", "cajera": "Valentina Ospina", "cliente": "Juan Carlos Mejía", "documento": "CC 1037001782", "tipo": "Compra", "moneda": "EUR", "cantidad": 1200.75, "tasa": 4310.75, "totalCop": 5176133.06, "estado": "Completada" }, { "fecha": "2026-09-08T15:38:00-05:00", "numero": "T-1044", "sucursal": "Laureles", "cajera": "Camila Restrepo", "cliente": "Luisa Fernanda Arango", "documento": "CC 1037001919", "tipo": "Venta", "moneda": "USD", "cantidad": 95, "tasa": 3951, "totalCop": 375345, "estado": "Completada" }, { "fecha": "2026-09-08T16:45:00-05:00", "numero": "T-1045", "sucursal": "Aeropuerto", "cajera": "Laura Gómez", "cliente": "Pedro Salazar", "documento": "CC 1037002056", "tipo": "Compra", "moneda": "USD", "cantidad": 640, "tasa": 3890.25, "totalCop": 2489760, "estado": "Completada" } ], "totales": { "fecha": "16 operaciones", "totalCop": 56236028.56 }, "moneda": "COP", "notas": "" } } }, "informe": { "summary": "/examples/informe.json", "value": { "type": "informe", "plantilla": "premium", "data": { "yourCompany": { "name": "Casa de Cambio Ejemplo S.A.S.", "nit": "900111222-4", "address": "Calle 10 # 40-20, local 5, Medellín - Antioquia", "phone": "6044445566", "email": "operaciones@ejemplo.com", "web": "www.ejemplo.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "informe": { "titulo": "Consolidado por sucursal", "subtitulo": "Operaciones completadas", "alcance": "Todas las sucursales", "periodo": { "desde": "2026-09-01", "hasta": "2026-09-15" }, "generadoEn": "2026-09-15T14:30:00-05:00", "generadoPor": "Andrés Montoya", "orientacion": "vertical" }, "columnas": [ { "clave": "grupo", "titulo": "Sucursal", "alineacion": "izquierda", "formato": "texto" }, { "clave": "operaciones", "titulo": "Operaciones", "alineacion": "derecha", "formato": "numero" }, { "clave": "compras", "titulo": "Compras", "alineacion": "derecha", "formato": "numero" }, { "clave": "ventas", "titulo": "Ventas", "alineacion": "derecha", "formato": "numero" }, { "clave": "totalCop", "titulo": "Total", "alineacion": "derecha", "formato": "moneda" }, { "clave": "participacion", "titulo": "Participación", "alineacion": "derecha", "formato": "porcentaje" } ], "filas": [ { "grupo": "Aeropuerto", "operaciones": 12, "compras": 7, "ventas": 5, "totalCop": 45000000, "participacion": 63.38 }, { "grupo": "El Poblado", "operaciones": 5, "compras": 2, "ventas": 3, "totalCop": 17500000, "participacion": 24.65 }, { "grupo": "Laureles", "operaciones": 3, "compras": 3, "ventas": 0, "totalCop": 8500000, "participacion": 11.97 } ], "totales": { "grupo": "Total", "operaciones": 20, "compras": 12, "ventas": 8, "totalCop": 71000000, "participacion": 100 }, "moneda": "COP", "notas": "Cifras de las operaciones completadas; no incluye las anuladas ni las pendientes de pago." } } }, "nota-credito": { "summary": "/examples/nota-credito.json", "value": { "type": "nota-credito", "plantilla": "premium", "data": { "yourCompany": { "name": "Piensa IT S.A.S.", "nit": "902001989-5", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "billTo": { "nit": "901456782-3", "name": "NOVA RETAIL S.A.S.", "country": "Colombia", "city": "La Estrella / Antioquia", "address": "CR 48 10 SUR 52", "email": "facturacion@novaretail.co", "contact": "Laura Restrepo Ochoa" }, "invoice": { "number": "NC-0001", "generatedAt": "12-09-2026 10:32:15 AM", "cude": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef", "qr": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=0123456789abcdef" }, "reference": { "number": "FV-0001", "date": "04-09-2026", "cufe": "cafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafe" }, "correction": { "code": "3", "description": "Rebaja o descuento parcial o total" }, "items": [ { "code": "LIC-ERP-001", "name": "Rebaja sobre la licencia anual de CoreLink ERP", "quantity": 1, "amount": 9640000, "discount": 0, "taxRate": 19, "total": 9640000 } ], "totals": { "gross": 9640000, "taxableBase": 9640000, "tax": 1831600, "withholding": 0, "discount": 0, "surcharge": 0, "total": 11471600 }, "selectedCurrency": "COP", "notes": "Rebaja acordada por la entrega tardía del módulo de nómina.", "legalNotes": [ "Esta nota crédito modifica la factura de venta referida en este documento y se lee junto con ella." ], "software": { "manufacturer": "CoreLink by Piensa IT S.A.S.", "name": "CoreLink Facturación Electrónica", "version": "1.0", "web": "www.corelink.com.co" }, "fields": [ { "label": "Vendedor", "value": "Mariana Gómez Uribe" }, { "label": "Orden de compra", "value": "OC-2026-0448" } ], "sideNotes": [ "Documento generado por computador. No requiere firma autógrafa.", "CoreLink by Piensa IT S.A.S." ] } } }, "nota-debito": { "summary": "/examples/nota-debito.json", "value": { "type": "nota-debito", "plantilla": "premium", "data": { "yourCompany": { "name": "Piensa IT S.A.S.", "nit": "902001989-5", "taxRegime": "Responsables de IVA · No autorretenedores", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "billTo": { "nit": "901456782-3", "name": "NOVA RETAIL S.A.S.", "country": "Colombia", "city": "La Estrella / Antioquia", "address": "CR 48 10 SUR 52", "email": "facturacion@novaretail.co", "contact": "Laura Restrepo Ochoa" }, "invoice": { "number": "ND-0001", "generatedAt": "12-09-2026 10:32:15 AM", "cude": "fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210", "qr": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=fedcba9876543210" }, "reference": { "number": "FV-0001", "date": "04-09-2026", "cufe": "cafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafecafe" }, "correction": { "code": "1", "description": "Intereses" }, "items": [ { "code": "INT-MORA", "name": "Intereses de mora sobre la factura FV-0001", "quantity": 1, "amount": 1250000, "discount": 0, "taxRate": 0, "total": 1250000 } ], "totals": { "gross": 1250000, "taxableBase": 1250000, "tax": 0, "withholding": 0, "discount": 0, "surcharge": 0, "total": 1250000 }, "selectedCurrency": "COP", "notes": "Intereses por el pago de la factura FV-0001 fuera del plazo acordado.", "legalNotes": [ "Esta nota débito modifica la factura de venta referida en este documento y se lee junto con ella." ], "software": { "manufacturer": "CoreLink by Piensa IT S.A.S.", "name": "CoreLink Facturación Electrónica", "version": "1.0", "web": "www.corelink.com.co" }, "fields": [ { "label": "Vendedor", "value": "Mariana Gómez Uribe" } ], "sideNotes": [ "Documento generado por computador. No requiere firma autógrafa.", "CoreLink by Piensa IT S.A.S." ], "paymentLegend": "Realice su pago en la cuenta corriente Bancolombia n.º 123-123123-12, a nombre de Piensa IT S.A.S., o desde su banco a la llave 123123123. También puede pagar en línea con el botón de pago.", "payment": { "enlace": "https://www.pse.com.co/persona-tu-primer-pago-por-pse", "textoDelEnlace": "Pagar en línea por PSE" } } } }, "recibo-de-caja-premium": { "summary": "/examples/recibo-de-caja-premium.json", "value": { "type": "recibo-de-caja", "plantilla": "premium", "data": { "yourCompany": { "name": "Piensa IT S.A.S.", "nit": "902001989-5", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "billTo": { "nit": "901456782-3", "name": "NOVA RETAIL S.A.S.", "country": "Colombia", "city": "La Estrella / Antioquia", "address": "CR 48 10 SUR 52", "email": "facturacion@novaretail.co", "contact": "Laura Restrepo Ochoa" }, "invoice": { "number": "RC-0091", "date": "11-09-2026" }, "payment": { "form": "Contado", "method": "Transferencia bancaria", "reference": "BC-77412" }, "appliedInvoices": [ { "number": "FV-0231", "date": "04-08-2026", "amount": 4200000, "previouslyPaid": 0, "applied": 4200000, "balance": 0 }, { "number": "FV-0244", "date": "20-08-2026", "amount": 3100000, "previouslyPaid": 1100000, "applied": 800000, "balance": 1200000 } ], "totals": { "total": 5000000 }, "notes": "Este recibo cancela la FV-0231 y abona a la FV-0244.", "selectedCurrency": "COP", "sideNotes": [ "Documento generado por computador. No requiere firma autógrafa.", "CoreLink by Piensa IT S.A.S." ] } } }, "recibo-de-caja": { "summary": "/examples/recibo-de-caja.json", "value": { "type": "recibo-de-caja", "data": { "yourCompany": { "name": "PIENSA IT", "nit": "902001989-5", "address": "Carrera 49 # 50-22 OF 805A, Medellín - Antioquia", "phone": "3125655293", "email": "info@piensait.com", "web": "www.piensait.com", "logo": "https://docsgen.piensait.com/logo.png" }, "billTo": { "name": "Empresa Cliente S.A.S", "nit": "901234567-8", "address": "Calle 10 #20-30, Medellín" }, "invoice": { "number": "RC-0118", "date": "2026-09-10" }, "items": [ { "name": "Desarrollo de la integración", "quantity": 1, "amount": 1800000, "total": 1800000 }, { "name": "Soporte mensual", "quantity": 2, "amount": 350000, "total": 700000 } ], "subTotal": 2500000, "grandTotal": 2500000, "payment": { "form": "Contado", "method": "Transferencia bancaria", "amount": 2500000 }, "notes": "Abono a las facturas relacionadas.", "selectedCurrency": "COP" } } }, "salida-de-inventario": { "summary": "/examples/salida-de-inventario.json", "value": { "type": "salida-de-inventario", "plantilla": "premium", "data": { "yourCompany": { "name": "Casa de Cambio Ejemplo S.A.S.", "nit": "900111222-4", "address": "Calle 10 # 40-20, local 5, Medellín - Antioquia", "phone": "6044445566", "email": "operaciones@ejemplo.com", "web": "www.ejemplo.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "documento": { "numero": "SAL-000087", "fecha": "2026-09-15", "motivo": "Venta de divisas", "referencia": "Transacción T-1051", "observaciones": "" }, "bodega": { "nombre": "Sucursal El Poblado", "codigo": "POB", "direccion": "Calle 10 # 40-20, local 5" }, "tercero": { "rol": "Cliente", "nombre": "Juan Carlos Mejía", "documento": "CC 71650432" }, "items": [ { "codigo": "USD", "descripcion": "Dólar estadounidense", "cantidad": 820.5, "unidad": "USD", "costoUnitario": 3890.25, "costoTotal": 3191950.13 }, { "codigo": "EUR", "descripcion": "Euro", "cantidad": 200, "unidad": "EUR", "costoUnitario": 4310.75, "costoTotal": 862150 } ], "totales": { "costo": 4054100.13 }, "moneda": "COP" } } }, "traslado-de-inventario": { "summary": "/examples/traslado-de-inventario.json", "value": { "type": "traslado-de-inventario", "plantilla": "premium", "data": { "yourCompany": { "name": "Casa de Cambio Ejemplo S.A.S.", "nit": "900111222-4", "address": "Calle 10 # 40-20, local 5, Medellín - Antioquia", "phone": "6044445566", "email": "operaciones@ejemplo.com", "web": "www.ejemplo.com", "logo": "https://docsgen.piensait.com/logo.png", "city": "Medellín - Antioquia" }, "documento": { "numero": "TRA-000031", "fecha": "2026-09-15", "motivo": "Reposición de existencias", "referencia": "Solicitud SOL-0209", "observaciones": "Viaja en maleta sellada con el precinto 004512." }, "origen": { "nombre": "Sucursal El Poblado", "codigo": "POB", "direccion": "Calle 10 # 40-20, local 5" }, "destino": { "nombre": "Sucursal Aeropuerto", "codigo": "AER", "direccion": "Aeropuerto José María Córdova, local 14" }, "traslado": { "responsable": "Transportadora de valores Atlas · Carlos Ruiz", "fechaSalida": "2026-09-15", "fechaLlegada": "" }, "items": [ { "codigo": "USD", "descripcion": "Dólar estadounidense", "cantidad": 5000, "unidad": "USD", "lote": "", "serie": "" }, { "codigo": "EUR", "descripcion": "Euro", "cantidad": 1200, "unidad": "EUR" }, { "codigo": "GBP", "descripcion": "Libra esterlina", "cantidad": 450, "unidad": "GBP" } ], "moneda": "COP" } } } } } } }, "responses": { "200": { "description": "The PDF", "headers": { "content-disposition": { "schema": { "type": "string" }, "description": "attachment; filename=…" }, "x-docgen-estilo": { "schema": { "type": "string" }, "description": "Style the document was drawn with: `factura/premium@v3` or `factura/premium@codigo`." }, "x-docgen-cifrado": { "schema": { "type": "string", "enum": [ "true" ] }, "description": "Present only when the payslip was encrypted." } }, "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Unknown type or design, missing `data`, invalid JSON, missing required fields (`faltan`) or invalid `cifrar`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Faltan datos obligatorios para colilla-de-nomina: empleado.nombre.", "faltan": [ "empleado.nombre" ] } } } }, "401": { "description": "Missing `authorization` header, or unknown or revoked key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Clave ausente o desconocida." } } } }, "405": { "description": "Method not allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Use POST, o GET para ver el catálogo." } } } }, "500": { "description": "The document could not be composed. Quote `referencia` when reporting it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "…", "referencia": "3f9c2a1b" } } } }, "503": { "description": "The key could not be checked, or the service has no keys configured.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "La función no tiene claves configuradas." } } } } } } } }, "security": [ { "bearer": [] } ], "components": { "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer", "description": "One key per integrating application. Write to info@piensait.com to get one." } }, "schemas": { "Peticion": { "type": "object", "required": [ "type", "data" ], "properties": { "type": { "type": "string", "enum": [ "factura", "nota-credito", "nota-debito", "cuenta-de-cobro", "contrato", "recibo-de-caja", "estado-de-cuenta", "colilla-de-nomina", "informe", "entrada-de-inventario", "salida-de-inventario", "traslado-de-inventario" ], "description": "Document type." }, "plantilla": { "type": "string", "enum": [ "estandar", "premium", "moderna", "clasica", "minimalista", "profesional", "corporativa", "serena", "basica", "destacada", "tirilla", "tirilla-destacada", "tirilla-clasica", "tirilla-minimalista", "tirilla-corporativa", "tirilla-moderna", "tirilla-estandar", "azul", "esmeralda", "violeta", "grafito", "ambar" ], "description": "`factura`: `estandar`, `premium`, `moderna`, `clasica`, `minimalista`, `profesional`, `corporativa`, `serena`, `basica`, `destacada`, `tirilla`, `tirilla-destacada`, `tirilla-clasica`, `tirilla-minimalista`, `tirilla-corporativa`, `tirilla-moderna`, `tirilla-estandar` (default `estandar`). `nota-credito`: `premium` (default `premium`). `nota-debito`: `premium` (default `premium`). `cuenta-de-cobro`: `estandar` (default `estandar`). `contrato`: `estandar` (default `estandar`). `recibo-de-caja`: `estandar`, `premium` (default `estandar`). `estado-de-cuenta`: `premium` (default `premium`). `colilla-de-nomina`: `azul`, `esmeralda`, `violeta`, `grafito`, `ambar`, `premium` (default `azul`). `informe`: `premium` (default `premium`). `entrada-de-inventario`: `premium` (default `premium`). `salida-de-inventario`: `premium` (default `premium`). `traslado-de-inventario`: `premium` (default `premium`)" }, "cifrar": { "type": "boolean", "description": "Only for `colilla-de-nomina`: encrypt with `empleado.numeroDocumento` as password." }, "data": { "type": "object", "additionalProperties": true, "description": "The document data, as described in each document type guide." } } }, "Catalogo": { "type": "object", "properties": { "documentos": { "type": "array", "items": { "type": "object", "properties": { "tipo": { "type": "string", "enum": [ "factura", "nota-credito", "nota-debito", "cuenta-de-cobro", "contrato", "recibo-de-caja", "estado-de-cuenta", "colilla-de-nomina", "informe", "entrada-de-inventario", "salida-de-inventario", "traslado-de-inventario" ] }, "nombre": { "type": "string" }, "descripcion": { "type": "string" }, "plantillas": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "nombre": { "type": "string" }, "descripcion": { "type": "string" }, "porDefecto": { "type": "boolean" }, "estilizable": { "type": "boolean" }, "esquemaDeEstilo": { "type": [ "string", "null" ] }, "estiloDelCodigo": { "type": [ "object", "null" ] }, "estilo": { "type": [ "object", "null" ] }, "versionDeEstilo": { "type": [ "integer", "null" ] } } } } } } } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "string" }, "faltan": { "type": "array", "items": { "type": "string" } }, "referencia": { "type": "string" }, "tiposDisponibles": { "type": "array", "items": { "type": "string" } } } } } } }