Diferencia entre revisiones de «API LaFactura.co:Invoice ec»
Ir a la navegación
Ir a la búsqueda
| (No se muestran 12 ediciones intermedias del mismo usuario) | |||
| Línea 1: | Línea 1: | ||
==Objeto:invoice== | ==Objeto:invoice== | ||
| − | Es el objeto raiz, del sistema de envio de <b>facturas</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/> | + | Es el objeto raiz, del sistema de envio de <b>facturas / liquidación de compras</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/> |
<br><br> | <br><br> | ||
Ingreso: | Ingreso: | ||
| Línea 31: | Línea 31: | ||
}, | }, | ||
"amounts":{ | "amounts":{ | ||
| − | "totalAmount":" | + | "totalAmount":"28.00", |
"taxAmount":"4.20", | "taxAmount":"4.20", | ||
"discountAmount":"2.00", | "discountAmount":"2.00", | ||
| Línea 90: | Línea 90: | ||
* El total en factura es: $ 34.00 Dólares<br><br/> | * El total en factura es: $ 34.00 Dólares<br><br/> | ||
| + | |||
| + | =====Ejemplo de Liquidación ===== | ||
| + | |||
| + | { | ||
| + | "liquidacion":{ | ||
| + | "issueDate":"20250830", | ||
| + | "issueTime":"203845", | ||
| + | "intID":"12EJS21", | ||
| + | "note":"Notas adicionales al RIDE de la Factura", | ||
| + | "prefix":"001001", | ||
| + | "provider":{ | ||
| + | "documentType":"04", | ||
| + | "name":"Prada y Cia", | ||
| + | "documentNumber":"1234567890123", | ||
| + | "email":"[email protected]", | ||
| + | "add1":"Datos especiales" | ||
| + | }, | ||
| + | "additionalInfo":{ | ||
| + | "uno":"01", | ||
| + | "dos":"02" | ||
| + | }, | ||
| + | "amounts":{ | ||
| + | "totalAmount":"28.00", | ||
| + | "taxAmount":"4.20", | ||
| + | "discountAmount":"2.00", | ||
| + | "payAmount":"32.20", | ||
| + | "currency":"DOLAR", | ||
| + | "payments":[ | ||
| + | { | ||
| + | "type":"01", | ||
| + | "total":"32.20", | ||
| + | "term":"0", | ||
| + | "unit":"dias" | ||
| + | } | ||
| + | ] | ||
| + | }, | ||
| + | "items":[ | ||
| + | { | ||
| + | "code":"0001", | ||
| + | "subCode":"0002", | ||
| + | "description":"Análisis Operativo Interno", | ||
| + | "quantity":"3.00", | ||
| + | "unitPrice":"10.00", | ||
| + | "discount":"2.00", | ||
| + | "total":"28.00" | ||
| + | "taxes":[ | ||
| + | { | ||
| + | "ID":"2", | ||
| + | "code":"4", | ||
| + | "percent":"15.00", | ||
| + | "taxableAmount":"28.00", | ||
| + | "taxAmount":"4.20" | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | |||
| + | =====Explicacion===== | ||
| + | ---- | ||
| + | Se está solicitando la creación de una liquidación de compra por un total de $34.00 Dólares, con el <b>"proveedor"</b> Prada y Cia, con:<br><br> | ||
| + | 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<br> | ||
| + | |||
| + | Totales: | ||
| + | * El subtotal antes de impuestos es de $30.00<br> | ||
| + | * Los impuestos son: $ 4.20<br> | ||
| + | * Los descuentos son: $ 2.00<br> | ||
| + | * Se agregó una propina de: $ 1.80 <br/> | ||
| + | |||
| + | * El total en la compra es de: $ 34.00 Dólares<br><br/> | ||
=====Campos===== | =====Campos===== | ||
| Línea 100: | Línea 174: | ||
|- | |- | ||
| issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430<br><small>Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5)</small></small> || cadena || NO | | issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430<br><small>Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5)</small></small> || cadena || NO | ||
| + | |- | ||
| + | | highPrecision || Manejo de precisión de decimales en el documento<br><small>false -> a dos decimales <b>(por omisión)</b><br/>true -> hasta 6 decimales de precisión (Puedes escribir valores con de 2 a 6 digitos en los campos correspondientes)</small> || cadena || NO | ||
|- | |- | ||
| intID || Identificador único, de este documento en tu base de datos<br><small>Esta valor se utiliza como control para evitar repetir documentos en el sistema (Alfanumerico)</small>|| cadena || SI | | intID || Identificador único, de este documento en tu base de datos<br><small>Esta valor se utiliza como control para evitar repetir documentos en el sistema (Alfanumerico)</small>|| cadena || SI | ||
| Línea 107: | Línea 183: | ||
| prefix || Informacion de Establecimiento y Punto de Venta (6 digitos) <small></small> || string || SI | | prefix || Informacion de Establecimiento y Punto de Venta (6 digitos) <small></small> || string || SI | ||
|- | |- | ||
| − | | customer || Datos propios del comprador consulta <small>'''[[API_LaFactura.co:Comprador_ec|customer]]'''</small> || objeto || SI | + | | customer || Datos propios del comprador consulta<br><small><b>(Solo para facturas)</b><br/>'''[[API_LaFactura.co:Comprador_ec|customer]]'''</small> || objeto || SI (Factura) |
| + | |- | ||
| + | | provider || Datos propios del proveedor<br><small><b>(Solo para liquidación de compras)</b><br/>'''[[API_LaFactura.co:Comprador_ec|provider]]'''</small> || objeto || SI (Liquidación) | ||
|- | |- | ||
| additionalInfo || Información adicional a adjuntar en el XML y PDF <small>'''[[API_LaFactura.co:Adicional_ec|additionalInfo]]'''</small> || objeto || NO | | additionalInfo || Información adicional a adjuntar en el XML y PDF <small>'''[[API_LaFactura.co:Adicional_ec|additionalInfo]]'''</small> || objeto || NO | ||
| Línea 121: | Línea 199: | ||
=====Resultados===== | =====Resultados===== | ||
---- | ---- | ||
| − | Devuelve un objeto ''' | + | Devuelve un objeto '''invoiceResult''' con el resultado de la operación<br/> |
<i>Importante: Verifica toda la informacion que resultado devuelve ingresando al objeto.</i> | <i>Importante: Verifica toda la informacion que resultado devuelve ingresando al objeto.</i> | ||
| Línea 132: | Línea 210: | ||
"documento":{ | "documento":{ | ||
"type":"invoice", | "type":"invoice", | ||
| − | "process": | + | "process": 0, |
"tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-veca", | "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-veca", | ||
"serial":"3008202501171332850600110010010000001081322991315", | "serial":"3008202501171332850600110010010000001081322991315", | ||
| Línea 141: | Línea 219: | ||
"subUnit":"001", | "subUnit":"001", | ||
"secuence":"000000108" | "secuence":"000000108" | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
} | } | ||
} | } | ||
Revisión actual del 20:17 3 nov 2026
Sumario
Objeto:invoice
Es el objeto raiz, del sistema de envio de facturas / liquidación de compras 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
{
"invoice":{
"issueDate":"20250830",
"issueTime":"203845",
"intID":"12EJS21",
"note":"Notas adicionales al RIDE de la Factura",
"prefix":"001001",
"customer":{
"documentType":"04",
"name":"Gomez y Solorzano",
"documentNumber":"1234567890123",
"email":"[email protected]",
"add1":"Datos especiales"
},
"additionalInfo":{
"uno":"01",
"dos":"02"
},
"amounts":{
"totalAmount":"28.00",
"taxAmount":"4.20",
"discountAmount":"2.00",
"tipAmount":"1.80",
"payAmount":"34.00",
"currency":"DOLAR",
"payments":[
{
"type":"01",
"total":"34.00",
"term":"0",
"unit":"dias"
}
]
},
"items":[
{
"code":"0001",
"subCode":"0002",
"description":"Análisis Operativo Interno",
"quantity":"3.00",
"unitPrice":"10.00",
"discount":"2.00",
"total":"28.00",
"data":{
"marca":"TAS",
"modelo":"GARF",
"estado":"Nuevo"
},
"taxes":[
{
"ID":"2",
"code":"4",
"percent":"15.00",
"taxableAmount":"28.00",
"taxAmount":"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
Ejemplo de Liquidación
{
"liquidacion":{
"issueDate":"20250830",
"issueTime":"203845",
"intID":"12EJS21",
"note":"Notas adicionales al RIDE de la Factura",
"prefix":"001001",
"provider":{
"documentType":"04",
"name":"Prada y Cia",
"documentNumber":"1234567890123",
"email":"[email protected]",
"add1":"Datos especiales"
},
"additionalInfo":{
"uno":"01",
"dos":"02"
},
"amounts":{
"totalAmount":"28.00",
"taxAmount":"4.20",
"discountAmount":"2.00",
"payAmount":"32.20",
"currency":"DOLAR",
"payments":[
{
"type":"01",
"total":"32.20",
"term":"0",
"unit":"dias"
}
]
},
"items":[
{
"code":"0001",
"subCode":"0002",
"description":"Análisis Operativo Interno",
"quantity":"3.00",
"unitPrice":"10.00",
"discount":"2.00",
"total":"28.00"
"taxes":[
{
"ID":"2",
"code":"4",
"percent":"15.00",
"taxableAmount":"28.00",
"taxAmount":"4.20"
}
]
}
]
}
}
Explicacion
Se está solicitando la creación de una liquidación de compra por un total de $34.00 Dólares, con el "proveedor" Prada y Cia, 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 la compra es de: $ 34.00 Dólares
Campos
| Parámetro | Descripción | Tipo | Obligatorio |
|---|---|---|---|
| issueDate | Fecha del documento (YYYYMMDD) Ejemplo: 20200321 Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5) |
cadena | NO |
| issueTime | Hora del documento (HHMMSS) Ejemplo: 175430 Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5) |
cadena | NO |
| highPrecision | Manejo de precisión de decimales en el documento false -> a dos decimales (por omisión) true -> hasta 6 decimales de precisión (Puedes escribir valores con de 2 a 6 digitos en los campos correspondientes) |
cadena | NO |
| 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 |
| note | Nota adicional a agregar en el PDF | string | NO |
| prefix | Informacion de Establecimiento y Punto de Venta (6 digitos) | string | SI |
| customer | Datos propios del comprador consulta (Solo para facturas) customer |
objeto | SI (Factura) |
| provider | Datos propios del proveedor (Solo para liquidación de compras) provider |
objeto | SI (Liquidación) |
| additionalInfo | Información adicional a adjuntar en el XML y PDF additionalInfo | objeto | NO |
| amounts | Totales del documento amounts | objeto | SI |
| items | Detalle del documento items | objeto | SI |
| 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) |
objeto | NO |
Resultados
Devuelve un objeto invoiceResult con el resultado de la operación
Importante: Verifica toda la informacion que resultado devuelve ingresando al objeto.
{
"invoiceResult":{
"status":{
"code":200,
"text":"Procesado con éxito"
},
"documento":{
"type":"invoice",
"process": 0,
"tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-veca",
"serial":"3008202501171332850600110010010000001081322991315",
"intID":"12EJS21",
"document":"001-001-000000108",
"document_number":{
"unit":"001",
"subUnit":"001",
"secuence":"000000108"
}
}
}
}
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 SRI, hasta que el resultado de una verificación del documento, muestre a estado con: 2
Enlaces
- LaFactura.ec: https://lafactura.ec
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.
