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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(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>Factura (F)<br/>Documento Soporte (DS)<br/>Documento Equivalente (DE)</small>
+
! Parámetro !! Descripción !! Tipo !! Obligatorio !! <small>Ticket (TK)</small>
 
|-
 
|-
| prefix || Prefijo del rango a ser utilizado<br/><small>Los prefijos disponibles los puedes obtener usando el servicio de [[API_LaFactura.co:Rangos_Facturacion|getRanges]]|| cadena || SI ||  F/DS/DE
+
| 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|| F/DS/DE
+
| 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<br/>No puede ser: <b>Menor de 8 dias a la fecha actual o mayor al dia de hoy</b><br/>|| cadena || SI || F/DS/DE
+
| issueDate || Fecha del documento<br><small>(YYYYMMDD) Ejemplo: 20200321</small>|| cadena || SI || TK
 
|-
 
|-
| issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> La Hora debe ser GMT -5 || cadena || SI || F/DS/DE
+
| issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> || cadena || SI || TK
 
|-
 
|-
| dueDate || Fecha de vencimiento<br><small>(YYYYMMDD) Ejemplo: 20200421<br/><b>En caso de no enviarse, se utilizará el mismo issueDate</b><br/>Nunca deberá ser menor a la fecha de la factura</small> || cadena || NO || F/DS/DE
+
| paymentType || Tipo de pago<br><small>PUE-> Una Sola Exhibición</small> || cadena || SI || TK
 
|-
 
|-
| paymentType || Tipo de pago<br><small>Contado->1 / Credito->2</small> || cadena || SI || F/DS/DE
+
| 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><br/>[[API_LaFactura.co:Tabla_Tipos_Medios_Pago|consultar tabla]]</small> || cadena || SI || F/DS/DE
+
| 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 || F/DS/DE
+
| note2 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small>|| cadena || NO || TK
 
|-
 
|-
| note2 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small>|| cadena || NO || F/DS/DE
+
| amounts || Totales del documento<br><small>Ir a: [[API_laFactura.co:amounts_MX|amounts]]</small> || objeto || SI || TK
 
|-
 
|-
| note3 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small> || cadena || NO || F/DS/DE
+
| items || Líneas del documento<br><small>(Debe existir almenos una)<br>Ir a: [[API_LaFactura.co:items_MX|items]]</small> || objeto || SI || TK
|-
 
| note4 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small> || cadena || NO || F/DS/DE
 
|-
 
| order || Datos correspondientes a la orden de compra del cliente<br/><small>(Solo en facturas)<br/>Ir a: [[API_laFactura.co:order|order]]</small> || objeto || NO || F/DE
 
|-
 
| additionalOrder || Datos correspondientes a la orden de compra del cliente<br/><small>(Solo en facturas)<br/>Ir a: [[API_laFactura.co:order|order]]</small> || objeto || NO || F/DE
 
|-
 
| period || Periodo de facturación<br/><small>(Solo en facturas)<br/>Grupo adicional para informar un Periodo de facturación<br><b>Importante: debe ir incluido si se usa el objeto "salud"</b><br>Ir a: [[API_laFactura.co:period|period]]</small> || objeto || NO || F
 
|-
 
| prepaid || Pagos anticipados<br/><small>Grupo adicional para informar un Pago Anticipado<br>Ir a: [[API_laFactura.co:prePaid|prepaid]]</small> || objeto || NO || F/DE
 
|-
 
| delivery || Datos de envío<br/><small>Grupo adicional para informar Datos y terminos de envío<br>Ir a: [[API_laFactura.co:delivery|delivery]]</small> || objeto || NO || F
 
|-
 
| exchangeRate || Tasas de cambio<small><br>Solo se requiere cuando se trata de un documento generado a una empresa extranjera<br/>Si se envía y es el documentType <> 42 es rechazado<br>Ir a: [[API_laFactura.co:exchangeRate|exchangeRate]]</small> || objeto || NO || F/DS/DE
 
|-
 
| AIU || Facturas de tipo AIU<br/><small>Grupo adicional para informar facturas de AIU (Administración / Imprevistos / Utilidad)<br>* No se envia en conjuncion con supplier, salud o equivalente<br/>Ir a: [[API_laFactura.co:AIU|AIU]]</small> || objeto || NO || F
 
|-
 
| equivalente || <b>Documentos equivalentes</b><br/><b>POS Electrónico, Peajes y demás complementarios</b><br/><small>Información complementara requerida para generar documentos equivalentes<br/>La resolución de la DIAN definitiva del documento técnico v1.9 <b>Salió en noviembre de 2.023</b>. <br/>* No se envia en conjunción con AIU, supplier o salud<br>Ir a: [[API_laFactura.co:equivalente|equivalente]]</small> || objeto || NO || DE
 
|-
 
| poa || <b>(PowerOfAttorney) Datos del mandatario</b><br><small>* Se envia únicamente cuando se trata de factura por mandato</br>Ir a: [[API_laFactura.co:mandato|mandato]]<br/></small> || objeto / cadena || <small>SI/NO</small>||F/DE
 
|-
 
| customer || <b>Datos del cliente (Para generar facturas)</b><br><small>* Se envia únicamente cuando se trata de factura<br/>* NO se envia cuando se trata de documento soporte.</br>Ir a: [[API_laFactura.co:customer|customer]]<br/><b>=============================<br/>En lugar de un objeto, también se puede enviar una cadena "consumidor final"<br/> y nuestro sistema la convertirá en un objeto estándard de customer con los valores por defecto para consumidor final<br/>=============================<br/></b></small> || objeto / cadena || <small>SI/NO</small>||F/DE
 
|-
 
| supplier || <b>Datos del proveedor (Para generar documento soporte)</b><br><small>* Se envia únicamente cuando se trata de documento soporte<br/>* NO se envia cuando se trata de factura.</br>Ir a: [[API_laFactura.co:supplier|supplier]]</small> || objeto || <small>SI/NO</small> ||DS
 
|-
 
| whTaxes || Retenciones efectuadas al documento (para NO autoretenedores)<br><small>Ir a: [[API_laFactura.co:whTaxes|whTaxes]]</small> || objeto || NO || F/DS/DE
 
|-
 
| amounts || Totales del documento<br><small>Ir a: [[API_laFactura.co:amounts|amounts]]</small> || objeto || SI || F/DS/DE
 
|-
 
| items || Líneas del documento<br><small>(Debe existir almenos una)<br>Ir a: [[API_LaFactura.co:items|items]]</small> || objeto || <small>SI/NO<br/>Algunos casos no lo requieren: (AIU)</small> || F/DS/DE
 
|-
 
| salud || <b>Manejo de informacion complementaria (Facturas del sector salud)</b><br/><small>(Solo en facturas)<br/>Conjunto de informacion requerida para emisión de facturas del sector salud<br/>* No se envia en conjunción con AIU o supplier<br/><small>Ir a: [[API_laFactura.co:salud|salud]]</small> || objeto || NO || F
 
|-
 
| additional || Objeto con elementos complementarios<small><br>Relaciona elementos específicos para algunos clientes especiales<br/><b>Objetos:</b><br/>[[API_LaFactura.co:documento.gn|documento_gn]] <b>(Requerido para usuarios que manejan su consecutivo de facturación)</b><br/>[[API_LaFactura.co:email|email]] <b>(Para utilizar un formato completamente personalizado de correo electrónico -Requiere autorizacion-)</b></small>|| objeto || NO || F/DS
 
 
|}
 
|}
  
Línea 127: Línea 96:
 
=====Resultados=====
 
=====Resultados=====
 
----
 
----
Devuelve un objeto '''[[API_laFactura.co:invoiceResult|invoiceResult]]''' con el resultado de la operación<br/>
+
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":"Factura",
+
           "type":"Ticket",
 
           "mode":"Creation",
 
           "mode":"Creation",
           "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-v301",
+
           "tascode":"tk-16fc1cfdd2d42f27492691ba30cee903382f2-mx",
 
           "intID":"1",
 
           "intID":"1",
           "document":"SETP-2092092",
+
           "document":"E3A-TK-2197",
          "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
 
 
           "process":"0",
 
           "process":"0",
 
           "retries":"0"
 
           "retries":"0"
         },
+
         }
        "prefix":{
 
            "prefix":"SETP",
 
            "from":"990000000",
 
            "to":"995000000",
 
            "last":"990000102",
 
            "remaining":"4999898",
 
            "firstDate":"20200223",
 
            "lastDate":"20210223",
 
            "description":"",
 
            "DIANKey":"0934092940390932093292309023",
 
            "auth":"18760000001"
 
        }
 
 
     }
 
     }
 
   }
 
   }

Revisión actual del 14:25 5 mar 2025

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

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.