API LaFactura.co:Invoice

Objeto:invoice

Es el objeto raiz, del sistema de envio de facturas de nuestra API, es importante respetar todos los elementos aquí contemplados.

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",
     "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"
     },
     "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"
         }
      ]
   }
 }

Campos

Parámetro	Descripción	Tipo	Obligatorio
rangeKey	Identificador único, del rango de facturación a ser usado (Tomado de nuestro sistema)	cadena	SI
issueDate	Fecha de la factura (YYYYMMDD) Ejemplo: 20200321	cadena	SI
issueTime	Hora de facturacion (HHMMSS) Ejemplo: 175430	cadena	SI
dueDate	Fecha de vencimiento (YYYYMMDD) Ejemplo: 20200421	cadena	SI
note1	Valor de la factura en letras	cadena	SI
note2	Nota para ser agregada en la factura	cadena	NO
note3	Nota para ser agregada en la factura	cadena	NO
note4	Nota para ser agregada en la factura	cadena	NO
exchangeRate	Tasas de cambio (Solo se requiere cuando se trata de una moneda diferente al Peso Colombiano) Ir a: exchangeRate	objeto	NO
customer	Datos del cliente Ir a: customer	objeto	SI
amounts	Totales del documento Ir a: amounts	objeto	SI
items	Líneas de la factura (Debe existir almenos una) Ir a: items	objeto	SI

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

• exchangeRate (Tasas - Para ventas en Dólares)
• customer (Cliente)
• amounts (Montos)
• items (Lineas de la factura)

Usado por

Los siguientes recursos:

• Generar Factura

Temas complementarios

• Facturación

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.