API LaFactura.co:Invoice mx - Historial de revisiones

Srvadmin: /* Ejemplo */

2025-03-05T14:25:09Z

Ejemplo

Srvadmin: /* Resultados */

2025-03-05T12:07:34Z

Resultados

Srvadmin: /* Resultados */

2025-03-05T12:07:17Z

Resultados

Srvadmin: /* Campos */

2025-03-05T12:05:48Z

Campos

Srvadmin: /* Explicacion */

2025-03-05T11:59:30Z

Explicacion

Srvadmin en 11:58 5 mar 2025

2025-03-05T11:58:52Z

Srvadmin: /* Explicacion */

2025-03-05T11:55:35Z

Explicacion

Srvadmin: /* Ejemplo */

2025-03-05T11:55:09Z

Ejemplo

Srvadmin: Página creada con «==Objeto:invoice== Es el objeto raiz, del sistema de envio de Tickets de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.

<…»

2025-03-05T11:54:44Z

Página creada con «==Objeto:invoice== Es el objeto raiz, del sistema de envio de Tickets de nuestra '''API''', es importante respetar todos los elementos aquí contemplados. <…»

Página nueva

==Objeto:invoice==
Es el objeto raiz, del sistema de envio de Tickets de nuestra '''API''', es importante respetar todos los elementos aquí contemplados. 
 
Ingreso:
<nowiki>https://***.tas-la.com/facturacion.mx/invoice/</nowiki>

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=====

{
"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=====
----

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

 

=====Resultados=====
----
Devuelve un objeto '''[[API_laFactura.co:invoiceResult|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":"Factura",
"mode":"Creation",
"tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-v301",
"intID":"1",
"document":"SETP-2092092",
"CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
"process":"0",
"retries":"0"
},
"prefix":{
"prefix":"SETP",
"from":"990000000",
"to":"995000000",
"last":"990000102",
"remaining":"4999898",
"firstDate":"20200223",
"lastDate":"20210223",
"description":"",
"DIANKey":"0934092940390932093292309023",
"auth":"18760000001"
}
}
}

=====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==
*[[API_laFactura.co:exchangeRate|exchangeRate]] (Tasas - Para ventas en Dólares)
*[[API_laFactura.co:customer|customer]] (Cliente)
*[[API_laFactura.co:amounts|amounts]] (Montos)
*[[API_laFactura.co:items|items]] (Lineas de la factura)

==Usado por==
Los siguientes recursos:
* [[API_LaFactura.co:Generar_Factura|Generar Factura]]

==Temas complementarios==
* [[API_LaFactura.co:Facturacion|Facturación]]

==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.'''

@@ Línea 10: / Línea 10: @@
 <br>
-=====Ejemplo=====
+=====Ejemplo - Ticket=====
+   {

@@ Línea 108: / Línea 108: @@
             "type":"Ticket",
             "mode":"Creation",
-            "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-mx",
+            "tascode":"tk-16fc1cfdd2d42f27492691ba30cee903382f2-mx",
             "intID":"1",
             "document":"E3A-TK-2197",

@@ Línea 69: / Línea 69: @@
 {| 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
 |}

@@ Línea 49: / Línea 49: @@
 ----
-La Fecha de creación es:  2025.03.17 - Marzo 17 de 2.025
+La Fecha de creación es:  2025.03.17 - Marzo 17 de 2.025<br/>
-La Hora de creación es: 10:05:21
+La Hora de creación es: 10:05:21<br/>
-El Tipo de pago es: PUE -> Pago en una sola exhibición
+El Tipo de pago es: PUE -> Pago en una sola exhibición<br/>
-El Medio de pago es: 01 -> Efectivo
+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:
 * 2 Playeras con un costo unitario de $150.00, para un total de $300.000

@@ 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
 Se está solicitando la creación de un ticket por un total de $348.00 Pesos con:<br><br>

@@ Línea 96: / Línea 96: @@
 =====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>
@@ Línea 106: / Línea 106: @@
          },
          "document":{
-            "type":"Factura",
+            "type":"Ticket",
             "mode":"Creation",
-            "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-v301",
+            "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-mx",
             "intID":"1",
-            "document":"SETP-2092092",
+            "document":"E3A-TK-2197",
             "process":"0",
             "retries":"0"
-         },
+     }
+   }

@@ Línea 48: / Línea 48: @@
 =====Explicacion=====
 ----
 Se está solicitando la creación de un ticket por un total de $348.00 Pesos con:<br><br>

@@ Línea 20: / Línea 20: @@
        "issueTime":"100521",
        "paymentType" : "PUE",
-       "paymentCode"  : "01",
+       "paymentCode" : "01",
        "amounts":{
             "totalAmount":"300.00",

API LaFactura.co:Invoice mx - Historial de revisiones

Srvadmin: /* Ejemplo */

Srvadmin: /* Resultados */

Srvadmin: /* Resultados */

Srvadmin: /* Campos */

Srvadmin: /* Explicacion */

Srvadmin en 11:58 5 mar 2025

Srvadmin: /* Explicacion */

Srvadmin: /* Ejemplo */

Srvadmin: Página creada con «==Objeto:invoice== Es el objeto raiz, del sistema de envio de Tickets de nuestra '''API''', es importante respetar todos los elementos aquí contemplados. <…»

Srvadmin: Página creada con «==Objeto:invoice== Es el objeto raiz, del sistema de envio de Tickets de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.

<…»