API LaFactura.co:Invoice

De API LaFactura.co
Ir a la navegación Ir a la búsqueda

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":
   {
     "prefix":"SETP",
     "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.",
          "city":"Bogotá D.C.",
          "countrySubentity":"11001",
          "addressLine":"Av 25 No. 8-47",
          "documentNumber":"900900651",
          "documentType":"31",
          "telephone":"3112196952",
          "email":"[email protected]"
     },
     "amounts":{
          "totalAmount":"120000.00",
          "discountAmount":"4000.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",
           "code": "1000",
           "allowance":[
                {
                  "charge":"false",
                  "reasonCode":"11",
                  "description":"Es un super descuento por hoy",
                  "baseAmount":"100000.00",
                  "amount":"4000.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",
           "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 (Obsoleto - Seguirá activo para el que lo desee usar - Recomendamos usar prefix en su lugar)
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
prefix Prefijo del rango a ser utilizado
Este campo hace innecesario el uso del rangeKey
Si envias este campo, NO DEBES ENVIAR rangeKey		 cadena NO F
intID Identificador único, de este documento en tu base de datos
Esta valor se utiliza como control para evitar repetir documentos en el sistema (Alfanumerico)		 cadena SI F/DS/DE
issueDate Fecha del documento
(YYYYMMDD) Ejemplo: 20200321
No puede ser: Menor de 8 dias a la fecha actual o mayor al daia de hoy
 cadena SI F/DS/DE
issueTime Hora del documento
(HHMMSS) Ejemplo: 175430 La Hora debe ser GMT -5		 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		 cadena SI F/DS/DE
paymentCode Medio de pago

consultar tabla		 cadena SI 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 Documentos equivalentes
Generación de documentos equivalentes
Información complementara requerida para generar documentos equivalentes
La resolución de la DIAN definitiva del documento técnico v1.9 Salió en noviembre de 2.023 La plataforma de pruebas de la DIAN no está haciendo validaciones completas en pruebas. Sin embargo, las opciones estarán gradualmente disponibles en nuestra API para pruebas.
Esperamos antes del 30 de Noviembre de 2.023 tener todos los tipos de documentos listos para desarrollo. Y antes del 10 de Diciembre en producción. (Esto último depende de la DIAN)
* 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)
email (Para utilizar un formato completamente personalizado de correo electrónico -Requiere autorizacion-)		 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-16fc1cfdd2d42f27492691ba30cee903382f2-v301",
          "intID":"1",
          "document":"FC-2092092",
          "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
          "process":"0",
          "retries":"0"
       },
       "prefix":{
           "prefix":"SETP",
           "from":"990000000",
           "to":"995000000",
           "last":"990000102",
           "remaining":"4999898",
           "firstDate":"20200223",
           "lastDate":"20210223",
           "description":"",
           "DIANKey":"0934092940390932093292309023",
           "auth":"18760000001"
        }
   }
 }
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

Usado por

Los siguientes recursos:

Temas complementarios

Enlaces

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.

Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:Invoice&oldid=2684»