API LaFactura.co:Invoice ec
Sumario
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",
"moneda":"DOLAR",
"pagos":[
{
"forma":"01",
"total":"34.00",
"plazo":"0",
"unidad":"dias"
}
]
},
"detalle":[
{
"codigoPrincipal":"0001",
"codigoAuxiliar":"0002",
"descripcion":"Análisis Operativo Interno",
"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 $34.00 Dólares, para el cliente Gomez y Solorzano, con:
Item 1:
- 3 Horas de Análisis operativo interno con un costo unitario de $10.00, para un total de $30.00 (Este total no es anotado en el item pero representado en el subtotal)
- A estas 3 horas se les hizo un descuento del $2.00, para un total antes de impuestos de $28.00
- Se le aplicó el IVA al valor de la línea (15%) equivalente a 4.20
Totales:
- El subtotal antes de impuestos es de $30.00
- Los impuestos son: $ 4.20
- Los descuentos son: $ 2.00
- Se agregó una propina de: $ 1.80
- El total en factura es: $ 34.00 Dólares
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:
Temas complementarios
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.
