Diferencia entre revisiones de «API LaFactura.co:Invoice ec»
Ir a la navegación
Ir a la búsqueda
| (No se muestran 25 ediciones intermedias del mismo usuario) | |||
| Línea 1: | Línea 1: | ||
| − | ==Objeto: | + | ==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</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/> | ||
<br><br> | <br><br> | ||
| Línea 13: | Línea 13: | ||
{ | { | ||
| − | " | + | "invoice":{ |
| − | " | + | "issueDate":"20250830", |
| − | " | + | "issueTime":"203845", |
"intID":"12EJS21", | "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", | "uno":"01", | ||
"dos":"02" | "dos":"02" | ||
}, | }, | ||
| − | " | + | "amounts":{ |
| − | " | + | "totalAmount":"30.00", |
| − | " | + | "taxAmount":"4.20", |
| − | " | + | "discountAmount":"2.00", |
| − | " | + | "tipAmount":"1.80", |
| − | " | + | "payAmount":"34.00", |
| − | " | + | "currency":"DOLAR", |
| − | + | "payments":[ | |
| − | |||
| − | " | ||
{ | { | ||
| − | " | + | "type":"01", |
"total":"34.00", | "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", | "total":"28.00", | ||
| − | " | + | "data":{ |
"marca":"TAS", | "marca":"TAS", | ||
"modelo":"GARF", | "modelo":"GARF", | ||
"estado":"Nuevo" | "estado":"Nuevo" | ||
}, | }, | ||
| − | " | + | "taxes":[ |
{ | { | ||
| − | " | + | "ID":"2", |
| − | " | + | "code":"4", |
| − | " | + | "percent":"15.00", |
| − | " | + | "taxableAmount":"28.00", |
| − | " | + | "taxAmount":"4.20" |
} | } | ||
] | ] | ||
| Línea 82: | Línea 77: | ||
---- | ---- | ||
| − | Se está solicitando la creación de una factura por un total de $ | + | Se está solicitando la creación de una factura por un total de $34.00 Dólares, para el cliente Gomez y Solorzano, con:<br><br> |
Item 1: | 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 | + | * 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 ( | + | * Se le aplicó el IVA al valor de la línea (15%) equivalente a 4.20<br> |
| − | |||
| − | |||
| − | |||
Totales: | Totales: | ||
| − | * El | + | * El subtotal antes de impuestos es de $30.00<br> |
| − | * Los impuestos son: $ | + | * Los impuestos son: $ 4.20<br> |
| + | * Los descuentos son: $ 2.00<br> | ||
| + | * Se agregó una propina de: $ 1.80 <br/> | ||
| − | * El total en factura | + | * El total en factura es: $ 34.00 Dólares<br><br/> |
| − | |||
| − | |||
| − | |||
=====Campos===== | =====Campos===== | ||
| Línea 104: | Línea 95: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| − | ! Parámetro !! Descripción !! Tipo !! Obligatorio | + | ! Parámetro !! Descripción !! Tipo !! Obligatorio |
|- | |- | ||
| − | | | + | | issueDate || Fecha del documento<br><small>(YYYYMMDD) Ejemplo: 20200321<br><small>Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5)</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 |
|- | |- | ||
| − | | | + | | 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 |
|- | |- | ||
| − | | | + | | note || Nota adicional a agregar en el PDF || string || NO |
|- | |- | ||
| − | | | + | | 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 |
|- | |- | ||
| − | | | + | | additionalInfo || Información adicional a adjuntar en el XML y PDF <small>'''[[API_LaFactura.co:Adicional_ec|additionalInfo]]'''</small> || objeto || NO |
|- | |- | ||
| − | | | + | | amounts || Totales del documento <small>'''[[API_LaFactura.co:Totales_ec|amounts]]'''</small> || objeto || SI |
|- | |- | ||
| − | + | | items || Detalle del documento <small>'''[[API_LaFactura.co:Detalle_ec|items]]'''</small> || objeto || SI | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | | items || | ||
| − | |||
| − | |||
| − | |||
| − | |||
|} | |} | ||
| Línea 165: | Línea 120: | ||
=====Resultados===== | =====Resultados===== | ||
---- | ---- | ||
| − | Devuelve un objeto '''[[API_laFactura.co: | + | Devuelve un objeto '''[[API_laFactura.co:resultado_ec|invoiceResult]]''' con el resultado de la operación<br/> |
| − | <i>Importante: Verifica toda la informacion que | + | <i>Importante: Verifica toda la informacion que resultado devuelve ingresando al objeto.</i> |
{ | { | ||
| Línea 172: | Línea 127: | ||
"status":{ | "status":{ | ||
"code":200, | "code":200, | ||
| − | "text":" | + | "text":"Procesado con éxito" |
}, | }, | ||
| − | " | + | "documento":{ |
| − | "type":" | + | "type":"invoice", |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
"process":"0", | "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===== | =====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) | * 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 | + | * 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== | ==Enlaces== | ||
| − | *LaFactura. | + | *LaFactura.ec: https://lafactura.ec |
| − | |||
==Importante== | ==Importante== | ||
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br> | Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br> | ||
'''Si deseas tener un usuario y contraseña , comunícate con nosotros.''' | '''Si deseas tener un usuario y contraseña , comunícate con nosotros.''' | ||
Revisión actual del 11:15 4 dic 2025
Sumario
Objeto:invoice
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
{
"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":"30.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
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 |
| 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 customer | objeto | SI |
| 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 |
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.