Diferencia entre revisiones de «API LaFactura.co:Ticket mx»
(→Campos) |
(→Campos) |
||
Línea 79: | Línea 79: | ||
| issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> || cadena || SI || TK | | issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> || cadena || SI || TK | ||
|- | |- | ||
− | | paymentType || Tipo de pago<br><small>PUE-> Una Sola Exhibición | + | | paymentType || Tipo de pago<br><small>PUE-> Una Sola Exhibición<br/><b>Por omisión -> PUE</b></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 | + | | paymentCode || Medio de pago<br/><small><small><b>Por omisión -> 01 (Efectivo)</b><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 | | 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 |
Revisión del 15:37 5 mar 2025
Sumario
Objeto:ticket
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": { "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 Por omisión -> PUE |
cadena | SI | TK |
paymentCode | Medio de pago Por omisión -> 01 (Efectivo) 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.