Diferencia entre revisiones de «API LaFactura.co:Invoice mx»
(No se muestran 5 ediciones intermedias del mismo usuario) | |||
Línea 10: | Línea 10: | ||
<br> | <br> | ||
− | =====Ejemplo===== | + | =====Ejemplo - Ticket===== |
{ | { | ||
Línea 49: | Línea 49: | ||
---- | ---- | ||
− | La Fecha de creación es: | + | La Fecha de creación es: 2025.03.17 - Marzo 17 de 2.025<br/> |
+ | La Hora de creación es: 10:05:21<br/> | ||
+ | El Tipo de pago es: PUE -> Pago en una sola exhibición<br/> | ||
+ | El Medio de pago es: 01 -> Efectivo<br/> | ||
− | Se está solicitando la creación de un ticket por un total de $348.00 Pesos con:<br><br> | + | Se está solicitando la creación de un ticket por un total de $348.00 Pesos con:<br/><br/> |
Item 1: | Item 1: | ||
* 2 Playeras con un costo unitario de $150.00, para un total de $300.000 | * 2 Playeras con un costo unitario de $150.00, para un total de $300.000 | ||
Línea 66: | Línea 69: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | ! Parámetro !! Descripción !! Tipo !! Obligatorio !! <small> | + | ! Parámetro !! Descripción !! Tipo !! Obligatorio !! <small>Ticket (TK)</small> |
|- | |- | ||
− | | prefix || Prefijo | + | | prefix || Prefijo de rango de tickets a ser utilizado<br/><small>Los prefijos disponibles los puedes obtener usando el servicio de [[API_LaFactura.co:Rangos_Disponibles_MX|getRanges]]|| cadena || SI || TK |
|- | |- | ||
− | | 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|| TK |
|- | |- | ||
− | | issueDate || Fecha del documento<br><small>(YYYYMMDD) Ejemplo: 20200321< | + | | issueDate || Fecha del documento<br><small>(YYYYMMDD) Ejemplo: 20200321</small>|| cadena || SI || TK |
|- | |- | ||
− | | issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> | + | | issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> || cadena || SI || TK |
|- | |- | ||
− | | | + | | paymentType || Tipo de pago<br><small>PUE-> Una Sola Exhibición</small> || cadena || SI || TK |
|- | |- | ||
− | | | + | | paymentCode || Medio de pago<br/><small><br/>[[API_LaFactura.co:Tabla_Tipos_Medios_Pago_MX|consultar tabla]]</small> || cadena || SI || TK |
|- | |- | ||
− | | | + | | note1 || Valor del documento en letras<br/><small>Esto se hace para ayudar a tener una representación gráfica de alta calidad para el cliente final</small> || cadena || SI || TK |
|- | |- | ||
− | | | + | | note2 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small>|| cadena || NO || TK |
|- | |- | ||
− | | | + | | amounts || Totales del documento<br><small>Ir a: [[API_laFactura.co:amounts_MX|amounts]]</small> || objeto || SI || TK |
|- | |- | ||
− | + | | items || Líneas del documento<br><small>(Debe existir almenos una)<br>Ir a: [[API_LaFactura.co:items_MX|items]]</small> || objeto || SI || TK | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | items || Líneas del documento<br><small>(Debe existir almenos una)<br>Ir a: [[API_LaFactura.co: | ||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
Línea 127: | Línea 96: | ||
=====Resultados===== | =====Resultados===== | ||
---- | ---- | ||
− | Devuelve un objeto '''[[API_laFactura.co: | + | Devuelve un objeto '''[[API_laFactura.co:invoiceResult_MX|invoiceResult]]''' con el resultado de la operación<br/> |
<i>Importante: Verifica toda la informacion que invoiceResult devuelve ingresando al objeto.</i> | <i>Importante: Verifica toda la informacion que invoiceResult devuelve ingresando al objeto.</i> | ||
Línea 137: | Línea 106: | ||
}, | }, | ||
"document":{ | "document":{ | ||
− | "type":" | + | "type":"Ticket", |
"mode":"Creation", | "mode":"Creation", | ||
− | "tascode":" | + | "tascode":"tk-16fc1cfdd2d42f27492691ba30cee903382f2-mx", |
"intID":"1", | "intID":"1", | ||
− | "document":" | + | "document":"E3A-TK-2197", |
− | |||
"process":"0", | "process":"0", | ||
"retries":"0" | "retries":"0" | ||
− | + | } | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
} | } | ||
} | } |
Revisión actual del 14:25 5 mar 2025
Sumario
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 - Ticket
{ "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 | Ticket (TK) |
---|---|---|---|---|
prefix | Prefijo de rango de tickets a ser utilizado Los prefijos disponibles los puedes obtener usando el servicio de getRanges |
cadena | SI | TK |
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 | TK |
issueDate | Fecha del documento (YYYYMMDD) Ejemplo: 20200321 |
cadena | SI | TK |
issueTime | Hora del documento (HHMMSS) Ejemplo: 175430 |
cadena | SI | TK |
paymentType | Tipo de pago PUE-> Una Sola Exhibición |
cadena | SI | TK |
paymentCode | Medio de pago consultar tabla |
cadena | SI | TK |
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 | TK |
note2 | Nota para ser agregada en el documento Aparece en el PDF |
cadena | NO | TK |
amounts | Totales del documento Ir a: amounts |
objeto | SI | TK |
items | Líneas del documento (Debe existir almenos una) Ir a: items |
objeto | SI | TK |
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":"Ticket", "mode":"Creation", "tascode":"tk-16fc1cfdd2d42f27492691ba30cee903382f2-mx", "intID":"1", "document":"E3A-TK-2197", "process":"0", "retries":"0" } } }
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.