Diferencia entre revisiones de «API LaFactura.co:Ticket mx»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
Línea 73: Línea 73:
 
|-
 
|-
 
| 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
 
| 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  

Revisión del 11:57 6 mar 2025

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)
  • 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

Usado por

Los siguientes recursos:

Temas complementarios

Enlaces

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.