API LaFactura.co:Invoice

Objeto:invoice

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

    Ingreso:     
    https://***.tas-la.com/facturacion.v30/invoice/
           
    Solicita tu usuario y contraseña +57-601-7466664
    No cobramos por el proceso de pruebas o desarrollo
    Y puedes empezar inmediatamente (sin certificados o papeleos)

• Los "Documentos Soporte", Solo están presentes en el API v3.0

Ejemplo

 {
   "invoice":
   {
     "rangeKey":"219832728",
     "intID":"1",
     "issueDate":"20200317",
     "issueTime":"100521",
     "dueDate" : "20200417",
     "paymentType" : "2",
     "paymentCode"  : "1",
     "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":"120000.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",
           "standard": "999",
           "agency": "990",
           "code": "1000",
           "allowance":[
                {
                  "charge":"false",
                  "reasonCode":"11",
                  "description":"Es un super descuento por hoy",
                  "baseAmount":"100000.00",
                  "amount":"4000.00",
                  "percent":"4.00"
                }                    
           ],
           "taxes":[
                {
                  "ID":"01",
                  "taxAmount":"18240.00",
                  "percent":"19.00"
                }
            ]
         },
         {
           "quantity":"1.00",
           "unitPrice":"20000.00",
           "total":"20000.00",
           "description":"Servicio sin IVA",
           "brand":"LF",
           "model":"Serv1",
           "standard": "999",
           "agency": "990",
           "code": "1001"
         }
     ]
   }
}

Explicacion

---

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
  
  

Adicionalmente en el correo enviado al cliente va un boton de "PAGAR", que lleva a un link. (Esta opción NO está disponible para todos los clientes)

Campos

---

Parámetro	Descripción	Tipo	Obligatorio	Factura (F) Documento Soporte (DS) Documento Equivalente (DE)
rangeKey	Identificador único, del rango de facturación/Documento soporte a ser usado Esta valor es el resultado del servicio: Obtener Rangos	cadena	SI	F/DS/DE
intID	Identificador único, de este documento en tu base de datos Esta valor se utiliza como control para evitar repetir documentos en el sistema	cadena	SI	F/DS/DE
issueDate	Fecha del documento (YYYYMMDD) Ejemplo: 20200321 No puede ser: Menor de 10 dias a la fecha actual o mayor en 5 Dias	cadena	SI	F/DS/DE
issueTime	Hora del documento (HHMMSS) Ejemplo: 175430	cadena	SI	F/DS/DE
dueDate	Fecha de vencimiento (YYYYMMDD) Ejemplo: 20200421 Nunca deberá ser menor a la fecha de la factura	cadena	SI	F/DS/DE
paymentType	Tipo de pago Contado->1 / Credito->2 Por omisión el sistema supone Credito -> "2"	cadena	NO	F/DS/DE
paymentCode	Medio de pago Por omisión supone Instrumento No Definido -> "1" consultar tabla	cadena	NO	F/DS/DE
note1	Valor del documento en letras Esto se hace para ayudar a tener una representación gráfica de alta calidad para el cliente final	cadena	SI	F/DS/DE
note2	Nota para ser agregada en el documento Aparece en el PDF	cadena	NO	F/DS/DE
note3	Nota para ser agregada en el documento Aparece en el PDF	cadena	NO	F/DS/DE
note4	Nota para ser agregada en el documento Aparece en el PDF	cadena	NO	F/DS/DE
order	Datos correspondientes a la orden de compra del cliente (Solo en facturas) Ir a: order	objeto	NO	F/DE
additionalOrder	Datos correspondientes a la orden de compra del cliente (Solo en facturas) Ir a: order	objeto	NO	F/DE
period	Periodo de facturación (Solo en facturas) Grupo adicional para informar un Periodo de facturación Importante: debe ir incluido si se usa el objeto "salud" Ir a: period	objeto	NO	F
prepaid	Pagos anticipados Grupo adicional para informar un Pago Anticipado Ir a: prepaid	objeto	NO	F/DE
exchangeRate	Tasas de cambio Solo se requiere cuando se trata de un documento generado a un extranjero (Empresa o Persona) Si se envía y el cliente es Colombiano, es rechazado Ir a: exchangeRate	objeto	NO	F/DS/DE
AIU	Facturas de tipo AIU Grupo adicional para informar facturas de AIU (Administración / Imprevistos / Utilidad) * No se envia en conjuncion con supplier, salud o equivalente Ir a: AIU	objeto	NO	F
equivalente	Manejo de informacion complementaria (Documentos equivalentes - Proximo a Salir) Generación de documentos equivalentes Información complementara requerida para generar documentos equivalentes * Lamentablemente la resolución de la DIAN definitiva del documento técnico v1.9 NO ha salido y la plataforma de pruebas de la DIAN no está activa para pruebas * No se envia en conjunción con AIU, supplier o salud Ir a: equivalente	objeto	NO	DE
customer	Datos del cliente (Para generar facturas) * Se envia únicamente cuando se trata de factura * NO se envia cuando se trata de documento soporte. Ir a: customer	objeto	SI/NO	F/DE
supplier	Datos del proveedor (Para generar documento soporte) * Se envia únicamente cuando se trata de documento soporte * NO se envia cuando se trata de factura. Ir a: supplier	objeto	SI/NO	DS
whTaxes	Retenciones efectuadas al documento (para NO autoretenedores) Ir a: whTaxes	objeto	NO	F/DS/DE
amounts	Totales del documento Ir a: amounts	objeto	SI	F/DS/DE
items	Líneas del documento (Debe existir almenos una) Ir a: items	objeto	SI/NO Algunos casos no lo requieren: (AIU)	F/DS/DE
salud	Manejo de informacion complementaria (Facturas del sector salud) (Solo en facturas) Conjunto de informacion requerida para emisión de facturas del sector salud * No se envia en conjunción con AIU o supplier Ir a: salud	objeto	NO	F
additional	Objeto con elementos complementarios Relaciona elementos específicos para algunos clientes especiales Objetos: documento_gn (Requerido para usuarios que manejan su consecutivo de facturación) formatos (Para utilizar formatos PDF de documentos condicionados) pagos (Para enviar un enlace de pagos en el correo de facturación)	objeto	NO	F/DS

Resultados

---

Devuelve un objeto invoiceResult con el resultado de la operación
Importante: Verifica toda la informacion que invoiceResult devuelve ingresando al objeto.

 {
   "invoiceResult":{
       "status":{
          "code":200,
          "text":"Operación realizada con exito"
       },
       "document":{
          "type":"Factura",
          "mode":"Creation",
          "tascode":"fc-54984309jtr0ret90jjrg",
          "intID":"1",
          "document":"FC-2092092",
          "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
          "process":"0",
          "retries":"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.