API LaFactura.co:Facturacion

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

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" : "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",
          "email":"[email protected]"
     },
     "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:

• 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000 + IVA ($19.000)
  
• 1 Hora de servicio sin IVA por un valor de $20.000
  
• El total antes de impuestos es de $120.000
  
• Los impuestos son: $ 19.000
  
• El total en factura en: $ 139.000
  

Resultados

Devuelve un objeto con el resultado de la operación

 {
   "invoiceResult":{
       "status":{
          "code":"200",
          "text":"Operación realizada con exito",
       },
       "document":{
          "tascode":"fc-54984309jtr0ret90jjrg",
          "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
          "process":"1"
       }
   }
 }

Objetos que emplea

• invoice: Factura
• invoiceResult: Resultado Factura
• exchange: Tasa
• customer: Cliente
• amounts Montos
• taxes Impuestos
• items Lineas
• allowance Descuentos y cargos