API LaFactura.co:Invoice ec

Objeto:factura

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

    Ingreso:     
    https://***.tas-la.com/facturacion.ec/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)

Ejemplo de Factura

   {
     "factura":{
           "fechaEmision":"20250830",
           "horaEmision":"203845",
           "intID":"12EJS21",
           "nota":"Notas adicionales al RIDE de la Factura",
           "rango":{
               "estab":"001",
               "punto":"001"
           },
           "comprador":{
               "tipo":"04",
               "razonSocial":"Gomez y Solorzano",
               "id":"1234567890123",
               "correo":"[email protected]",
               "adicional1":"Datos especiales"
           },
           "infoAdicional":{
               "uno":"01",
               "dos":"02"
           },
           "totales":{
               "subtotal":"30.00",
               "impuestos":"4.20",
               "descuentos":"2.00",
               "propina":"1.80",
               "total":"34.00",
               "retIva":"4.00",
               "retRenta":"3.00",
               "moneda":"DOLAR",
               "pagos":[
                     {
                       "forma":"01",
                       "total":"34.00",
                       "plazo":"0",
                       "unidad":"dias"
                     }
               ]
           },
           "detalle":[
               {
                  "codigoPrincipal":"0001",
                  "codigoAuxiliar":"0002",
                  "descripcion":"Esta es la descripcion",
                  "cantidad":"3.00",
                  "unitario":"10.00",
                  "descuento":"2.00",
                  "total":"28.00",
                  "complementos":{
                       "marca":"TAS",
                       "modelo":"GARF",
                       "estado":"Nuevo"
                  },
                  "impuestos":[
                         {
                            "id":"2",
                            "cod":"4",
                            "tarifa":"15.00",
                            "base":"28.00",
                            "valor":"4.20"
                         }
                   ]
               }
             ]
           }
         }

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)
prefix	Prefijo del rango a ser utilizado Los prefijos disponibles los puedes obtener usando el servicio de getRanges	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 (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 dia 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 En caso de no enviarse, se utilizará el mismo issueDate Nunca deberá ser menor a la fecha de la factura	cadena	NO	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
delivery	Datos de envío Grupo adicional para informar Datos y terminos de envío Ir a: delivery	objeto	NO	F
exchangeRate	Tasas de cambio Solo se requiere cuando se trata de un documento generado a una empresa extranjera Si se envía y es el documentType <> 42 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 POS Electrónico, Peajes y demás complementarios 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. * No se envia en conjunción con AIU, supplier o salud Ir a: equivalente	objeto	NO	DE
poa	(PowerOfAttorney) Datos del mandatario * Se envia únicamente cuando se trata de factura por mandato Ir a: mandato	objeto / cadena	SI/NO	F/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 ============================= En lugar de un objeto, también se puede enviar una cadena "consumidor final" y nuestro sistema la convertirá en un objeto estándard de customer con los valores por defecto para consumidor final =============================	objeto / cadena	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":"SETP-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

• 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.