Diferencia entre revisiones de «API LaFactura.co:Ticket mx»
(Página creada con «==Objeto:ticket== Es el objeto raiz, del sistema de envio de <b>Tickets</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/> <br><b…») |
|||
(No se muestran 8 ediciones intermedias del mismo usuario) | |||
Línea 21: | Línea 21: | ||
"paymentType" : "PUE", | "paymentType" : "PUE", | ||
"paymentCode" : "01", | "paymentCode" : "01", | ||
+ | "note1":"Trescientos cuarenta y ocho pesos", | ||
"amounts":{ | "amounts":{ | ||
"totalAmount":"300.00", | "totalAmount":"300.00", | ||
Línea 71: | Línea 72: | ||
! Parámetro !! Descripción !! Tipo !! Obligatorio !! <small>Ticket (TK)</small> | ! Parámetro !! Descripción !! Tipo !! Obligatorio !! <small>Ticket (TK)</small> | ||
|- | |- | ||
− | | prefix || Prefijo de rango de tickets a ser utilizado<br/><small>Los prefijos disponibles los puedes obtener usando el servicio de [[API_LaFactura.co: | + | | 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_Documentos_MX|getRanges]]|| cadena || SI || TK |
+ | |- | ||
+ | | number || Consecutivo del ticket a ser utilizado<br/><small>Solo puede ser utilizado si el rango se encuentra en manual<br/>debe ser numérico || cadena || SI/NO || 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|| 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|| TK | ||
Línea 79: | Línea 82: | ||
| 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</small> || cadena || SI || TK | + | | 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><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 | ||
Línea 108: | Línea 111: | ||
"type":"Ticket", | "type":"Ticket", | ||
"mode":"Creation", | "mode":"Creation", | ||
− | "tascode":"tk-16fc1cfdd2d42f27492691ba30cee903382f2- | + | "tascode":"tk-16fc1cfdd2d42f27492691ba30cee903382f2-vmx", |
"intID":"1", | "intID":"1", | ||
− | "document":" | + | "document":"3E9-TK-2197", |
− | " | + | "date":"2025-03-08 09:58:00", |
− | " | + | "url":"https://xxx.com?i=3E9-TK-2197" |
} | } | ||
} | } | ||
Línea 120: | Línea 123: | ||
---- | ---- | ||
* 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) | ||
− | |||
==Objetos empleados== | ==Objetos empleados== |
Revisión actual del 13:52 6 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", "note1":"Trescientos cuarenta y ocho pesos", "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 |
number | Consecutivo del ticket a ser utilizado Solo puede ser utilizado si el rango se encuentra en manual debe ser numérico |
cadena | SI/NO | 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-vmx", "intID":"1", "document":"3E9-TK-2197", "date":"2025-03-08 09:58:00", "url":"https://xxx.com?i=3E9-TK-2197" } } }
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)
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.