API LaFactura.co:Invoice mx

Objeto:invoice

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

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

Ejemplo

 {
   "invoice":
   {
     "prefix":"TK",
     "intID":"1",
     "issueDate":"20250317",
     "issueTime":"100521",
     "paymentType" : "PUE",
     "paymentCode" : "01",
     "amounts":{
          "totalAmount":"300.00",
          "taxAmount":"48.00",
          "payAmount":"348.00"
     },
     "items":[
         {
           "quantity":"2.00",
           "unitPrice":"150.00",
           "total":"300.00",
           "description":"Playera",
           "unit":"H87",
           "code":"53101602",
           "taxes":[
                {
                  "ID":"002",
                  "taxAmount":"48.00",
                  "percent":"16.00"
                }
            ]
         }
     ]
   }
}

Explicacion

---

La Fecha de creación es: 2025.03.17 - Marzo 17 de 2.025 La Hora de creación es: 10:05:21 El Tipo de pago es: PUE -> Pago en una sola exhibición El Medio de pago es: 01 -> Efectivo

Se está solicitando la creación de un ticket por un total de $348.00 Pesos con:

Item 1:

• 2 Playeras con un costo unitario de $150.00, para un total de $300.000
• Se le aplicó el IVA (16.00%) al valor de la línea $48.00
  

Totales:

• El total antes de impuestos es de $300.00
  
• Los impuestos son: $ 48.00
  

• El total en el ticket es: $ 348.00
  
  

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.