|
|
| Línea 16: |
Línea 16: |
| | Contiene los siguientes recursos: | | Contiene los siguientes recursos: |
| | * [[API_LaFactura.co:Generar_Factura|Generar Factura]] | | * [[API_LaFactura.co:Generar_Factura|Generar Factura]] |
| − | * [[API_LaFactura.co:Verificar_Factura|Verificar Factura]] | + | * [[API_LaFactura.co:Verificar_Factura|Verificar Factura]] |
| − | | |
| − | ==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.<br><br>
| |
| − | =====Ejemplo=====
| |
| − | | |
| − | {
| |
| − | "invoice":
| |
| − | {
| |
| − | "rangeKey":"219832728",
| |
| − | "issueDate":"20200317",
| |
| − | "issueTime":"100521",
| |
| − | "dueDate" : "20200417",
| |
| − | "note1" : "Esta es una nota en la factura",
| |
| − | "customizationID" : "01",
| |
| − | "customer" : {
| |
| − | "additionalAccountID":"01",
| |
| − | "name":"Pepito Perez y Cia SAS",
| |
| − | "city":"Bogotá"
| |
| − | "address":"Av 19 No. 11-11 Of 40-09",
| |
| − | "document":"900900651",
| |
| − | "documentType":"01",
| |
| − | "phone":"3112196942",
| |
| − | | |
| − | },
| |
| − | "amounts":{
| |
| − | "totalAmount":"120000.00",
| |
| − | "taxAmount":"19000.00",
| |
| − | "payAmount":"139000.00"
| |
| − | },
| |
| − | "taxes":{
| |
| − | [
| |
| − | "ID":"IVA",
| |
| − | "taxableAmount":"100000.00",
| |
| − | "taxAmount":"19000.00",
| |
| − | "percent":"19.00"
| |
| − | ]
| |
| − | },
| |
| − | "items":{
| |
| − | [
| |
| − | "quantity":"5.00",
| |
| − | "unitPrice":"20000.00",
| |
| − | "total":"100000.00",
| |
| − | "description":"Horas de soporte remoto",
| |
| − | "brand":"LF",
| |
| − | "model":"Soporte",
| |
| − | "taxes":{
| |
| − | [
| |
| − | "ID":"IVA",
| |
| − | "taxableAmount":"100000.00",
| |
| − | "taxAmount":"19000.00",
| |
| − | "percent":"19.00"
| |
| − | ]
| |
| − | }
| |
| − | ],
| |
| − | [
| |
| − | "quantity":"1.00",
| |
| − | "unitPrice":"20000.00",
| |
| − | "total":"20000.00",
| |
| − | "description":"Servicio sin IVA",
| |
| − | "brand":"LF",
| |
| − | "model":"Serv1",
| |
| − | ]
| |
| − | }
| |
| − | }
| |
| − | }
| |
| − | | |
| − | =====Explicación=====
| |
| − | Se está solicitando la creación de una factura por un total de $139.000 Pesos, para el cliente Pepito Perez y Compañía SAS, con:<br><br>
| |
| − | * 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000 + IVA ($19.000)<br>
| |
| − | * 1 Hora de servicio sin IVA por un valor de $20.000<br>
| |
| − | * El total antes de impuestos es de $120.000<br>
| |
| − | * Los impuestos son: $ 19.000<br>
| |
| − | * El total en factura en: $ 139.000<br>
| |
| − | | |
| − | =====Resultados=====
| |
| − | Devuelve un objeto '''invoiceResult''' con el resultado de la operación
| |
| − | | |
| − | {
| |
| − | "invoiceResult":{
| |
| − | "status":{
| |
| − | "code":"200",
| |
| − | "text":"Operación realizada con exito",
| |
| − | },
| |
| − | "document":{
| |
| − | "tascode":"fc-54984309jtr0ret90jjrg",
| |
| − | "document":"FC-2092092",
| |
| − | "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
| |
| − | "process":"1"
| |
| − | }
| |
| − | }
| |
| − | }
| |
| − | | |
| − | =====Objetos que emplea=====
| |
| − | *invoice: [[API_laFactura.co:invoice|Factura]]
| |
| − | *invoiceResult: [[API_laFactura.co:invoiceResult|Resultado Factura]]
| |
| − | *exchange: [[API_laFactura.co:exchange|Tasa]]
| |
| − | *customer: [[API_laFactura.co:customer|Cliente]]
| |
| − | *amounts [[API_laFactura.co:amounts|Montos]]
| |
| − | *taxes [[API_laFactura.co:taxes|Impuestos]]
| |
| − | *items [[API_laFactura.co:items|Lineas]]
| |
| − | *allowance [[API_laFactura.co:allowance|Descuentos y cargos]]
| |
| − | | |
| − | ===Verificar factura===
| |
| − | Si deseas saber como está el proceso de elaboración actual de la factura, y su último status, puedes hacer la consulta usando GET en la URL del servicio e incluir el siguiente objeto.
| |
| − | | |
| − | {
| |
| − | "verifyStatus":{
| |
| − | "tascode":"fc-945809458409504958435098"
| |
| − | }
| |
| − | }
| |
| − | | |
| − | Este retorna, un objeto '''invoiceResult''' con el estado.
| |
| − | | |
| − | =====Objetos que emplea=====
| |
| − | *verifyStatus: [[API_laFactura.co:verifyStatus|Verificar]]
| |
| − | *invoiceResult: [[API_laFactura.co:invoiceResult|Resultado Factura]]
| |
API de Facturacion
Esta API, termite el manejo facturas en nuestro sistema. Está diseñado para hacer el proceso de una forma sencilla y amigable. Utilizando simples comandos via HTTP.
URL Base
Para realizar el proceso, debes hacer tus solicitudes en la siguiente URL:
https://playground.lafactura.co/api2.0/invoice
La API de LaFactura.co trabaja bajo HTTPS. para asegurar privacidad en el envío de información, por lo tanto HTTP, no es soportado.
(*)La URL presentada en este lugar, es la que se utiliza para pruebas, la dirección en modo de operación varía exclusivamente en el dominio utilizado.
(**)Recuerda que debes autenticarte con usuario y contraseña durante el envío de la petición.
Opciones del recurso
Este recurso requiere el envío de información en formato JSON como parte de la petición, y debe incluir en su encabezado los siguientes parámetros:
- Content-Type: application/json
- Content-Legnth: Tamaño de la petición enviada en bytes
Contiene los siguientes recursos:
