API LaFactura.co:Generar Factura
Sumario
Generar factura
Para generar una factura a través de la API y realizar los procesos de verificación, elaboracion, firmado y envío a la DIAN, debes realizar una petición POST, a la URL incluyendo el formato JSON con la información propia de la factura a ser generada.
Ejemplo
{ "invoice": { "rangeKey":"219832728", "issueDate":"20200317", "issueTime":"100521", "dueDate" : "20200417", "note1" : "CIENTO TREINTA Y CUATRO MIL DOSCIENTOS CUARENTA PESOS", "note2" : "Esta es una nota en la factura", "customizationID" : "01", "customer" : { "additionalAccountID":"1", "name":"Pepito Perez y Compania S.A.", "countryName":"Colombia", "countryCode":"CO", "city":"Bogotá D.C.", "countryEntity":"11", "countrySubentity":"11001", "addressLine":"Av 25 No. 8-47", "documentNumber":"900900651", "documentType":"31", "telephone":"3112196952", "email":"[email protected]" }, "amounts":{ "totalAmount":"116000.00", "discountAmount":"4000.00", "extraAmount":"0.00", "taxAmount":"18240.00", "payAmount":"134240.00" }, "taxes":[ { "ID":"01", "taxableAmount":"96000.00", "taxAmount":"18240.00", "percent":"19.00" } ], "items":[ { "quantity":"5.00", "unitPrice":"20000.00", "total":"96000.00", "description":"Horas de soporte remoto", "brand":"LF", "model":"Soporte", "allowance":[ { "charge":"false", "reasonCode":"11", "description":"Es un super descuento por hoy", "baseAmount":"100000.00", "amount":"4000.00", "percent":"4.00" } ], "taxes":[ { "ID":"01", "taxableAmount":"96000.00", "taxAmount":"18240.00", "percent":"19.00" } ] }, { "quantity":"1.00", "unitPrice":"20000.00", "total":"20000.00", "description":"Servicio sin IVA", "brand":"LF", "model":"Serv1" } ] } }
Consulta todas las opciones de este objeto en invoice
Explicación
Se está solicitando la creación de una factura por un total de $134.240 Pesos, para el cliente Pepito Perez y Compañía SA, con:
Item 1
- 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000
- A estas 5 horas se les hizo un descuento del 4% ($4.000), para un total de $96.000
- Se le aplicó el IVA al valor de la línea ($18.240)
Item 2
- 1 Hora de servicio sin IVA por un valor de $20.000
Totales
- El total antes de impuestos es de $116.000
- Los impuestos son: $ 18.240
- El total en factura en: $ 134.240
Resultados
Devuelve un objeto invoiceResult con el resultado de la operación
{ "invoiceResult":{ "status":{ "code":200, "text":"Operación realizada con exito" }, "document":{ "type":"Factura", "mode":"Creation", "tascode":"fc-54984309jtr0ret90jjrg", "document":"FC-2092092", "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094", "process":0 } } }
A tener presente
- El resultado incluye el campo "tascode", que es el codigo único interno en nuestro sistema e identifica el documento. Es requerido para cualquier acción posterior sobre este documento. (Es importante conservarlo)
- No se debe considerar un documento como válido por la DIAN, hasta que el resultado de una verificación del documento, muestre a process con: 2
Objetos Empleados
- invoice (Factura)
- invoiceResult (Resultado de la factura)
Temas complementarios
Enlaces
- LaFactura.co: https://lafactura.co
- GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
Importante
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.
Si deseas tener un usuario y contraseña , comunícate con nosotros.