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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(No se muestran 29 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
==Objeto:factura==
+
==Objeto:invoice==
 
Es el objeto raiz, del sistema de envio de <b>facturas</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/>
 
Es el objeto raiz, del sistema de envio de <b>facturas</b> de nuestra '''API''', es importante respetar todos los elementos aquí contemplados.<br/>
 
<br><br>
 
<br><br>
Línea 12: Línea 12:
 
=====Ejemplo de Factura=====
 
=====Ejemplo de Factura=====
  
{
+
    {
        "factura":{
+
      "invoice":{
             "fechaEmision":"20250830",
+
             "issueDate":"20250830",
             "horaEmision":"203845",
+
             "issueTime":"203845",
             "intID":"12",
+
             "intID":"12EJS21",
             "nota":"Notas adicionales al RIDE de la Factura",
+
             "note":"Notas adicionales al RIDE de la Factura",
             "rango":{
+
             "prefix":"001001",
                 "estab":"001",
+
            "customer":{
                 "punto":"001"
+
                 "documentType":"04",
 +
                "name":"Gomez y Solorzano",
 +
                "documentNumber":"1234567890123",
 +
                "email":"[email protected]",
 +
                 "add1":"Datos especiales"
 
             },
 
             },
             "comprador":{
+
             "additionalInfo":{
                "tipo":"04",
 
                "razonSocial":"Gomez y Solorzano",
 
                "id":"1234567890123",
 
                "correo":"[email protected]",
 
                "adicional1":"Datos especiales"
 
            },
 
            "infoAdicional":{
 
 
                 "uno":"01",
 
                 "uno":"01",
 
                 "dos":"02"
 
                 "dos":"02"
 
             },
 
             },
             "totales":{
+
             "amounts":{
                 "subtotal":"40.00",
+
                 "totalAmount":"30.00",
                 "impuestos":"5.40",
+
                 "taxAmount":"4.20",
                 "descuentos":"4.00",
+
                 "discountAmount":"2.00",
                 "propina":"1.60",
+
                 "tipAmount":"1.80",
                "total":"43.00",
+
                 "payAmount":"34.00",
                "retIva":"4.00",
+
                 "currency":"DOLAR",
                 "retRenta":"3.00",
+
                 "payments":[
                 "moneda":"DOLAR",
 
                 "pagos":[
 
 
                       {
 
                       {
                         "forma":"01",
+
                         "type":"01",
                         "total":"43.00",
+
                         "total":"34.00",
                         "plazo":"0",
+
                         "term":"0",
                         "unidad":"dias"
+
                         "unit":"dias"
 
                       }
 
                       }
 
                 ]
 
                 ]
 
             },
 
             },
             "detalle":[
+
             "items":[
 
                 {
 
                 {
                   "codigoPrincipal":"0001",
+
                   "code":"0001",
                   "codigoAuxiliar":"0002",
+
                   "subCode":"0002",
                   "descripcion":"Esta es la descripcion",
+
                   "description":"Análisis Operativo Interno",
                   "cantidad":"4.00",
+
                   "quantity":"3.00",
                   "unitario":"10.00",
+
                   "unitPrice":"10.00",
                   "descuento":"2.00",
+
                   "discount":"2.00",
 
                   "total":"28.00",
 
                   "total":"28.00",
                   "complementos":{
+
                   "data":{
 
                         "marca":"TAS",
 
                         "marca":"TAS",
 
                         "modelo":"GARF",
 
                         "modelo":"GARF",
 
                         "estado":"Nuevo"
 
                         "estado":"Nuevo"
 
                   },
 
                   },
                   "impuestos":[
+
                   "taxes":[
 
                           {
 
                           {
                             "id":"2",
+
                             "ID":"2",
                             "cod":"4",
+
                             "code":"4",
                             "tarifa":"15.00",
+
                             "percent":"15.00",
                             "base":"28.00",
+
                             "taxableAmount":"28.00",
                             "valor":"4.20"
+
                             "taxAmount":"4.20"
                          }
+
                          }
                  ]
+
                    ]
      }
+
                }
            ]
+
              ]
          }
+
            }
        }
+
          }
  
 
=====Explicacion=====
 
=====Explicacion=====
 
----
 
----
  
Se está solicitando la creación de una factura por un total de $134.240 Pesos, para el cliente Pepito Perez y Compañía SA, con:<br><br>
+
Se está solicitando la creación de una factura por un total de $34.00 Dólares, para el cliente Gomez y Solorzano, con:<br><br>
 
Item 1:  
 
Item 1:  
* 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000
+
* 3 Horas de Análisis operativo interno con un costo unitario de $10.00, para un total de $30.00 (Este total no es anotado en el item pero representado en el subtotal)
* A estas 5 horas se les hizo un descuento del 4% ($4.000), para un total de $96.000
+
* A estas 3 horas se les hizo un descuento del $2.00, para un total antes de impuestos de $28.00
* Se le aplicó el IVA al valor de la línea ($18.240)<br>
+
* Se le aplicó el IVA al valor de la línea (15%) equivalente a 4.20<br>
 
 
Item 2:
 
* 1 Hora de servicio sin IVA por un valor de $20.000<br>
 
  
 
Totales:
 
Totales:
* El total antes de impuestos es de $116.000<br>
+
* El subtotal antes de impuestos es de $30.00<br>
* Los impuestos son: $ 18.240<br>
+
* Los impuestos son: $ 4.20<br>
 +
* Los descuentos son: $ 2.00<br>
 +
* Se agregó una propina de: $ 1.80 <br/>
 
   
 
   
* El total en factura en: $ 134.240<br><br/>
+
* El total en factura es: $ 34.00 Dólares<br><br/>
 
 
Adicionalmente en el correo enviado al cliente va un boton de "PAGAR", que lleva a un link.
 
(Esta opción NO está disponible para todos los clientes)
 
  
 
=====Campos=====
 
=====Campos=====
Línea 104: Línea 95:
 
{| 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
|-
 
| 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
 
|-
 
| 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
 
|-
 
| 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
 
|-
 
| issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> La Hora debe ser GMT -5 || cadena || SI || F/DS/DE
 
|-
 
| 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>Contado->1 / Credito->2</small> || cadena || SI || F/DS/DE
 
 
|-
 
|-
| paymentCode || Medio de pago<small><br/>[[API_LaFactura.co:Tabla_Tipos_Medios_Pago|consultar tabla]]</small> || cadena || SI || F/DS/DE
+
| issueDate || Fecha del documento<br><small>(YYYYMMDD) Ejemplo: 20200321<br><small>Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5)</small>|| cadena || NO
 
|-
 
|-
| 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
+
| issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430<br><small>Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5)</small></small> || cadena || NO
 
|-
 
|-
| note2 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small>|| cadena || NO || 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
 
|-
 
|-
| note3 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small> || cadena || NO || F/DS/DE
+
| note || Nota adicional a agregar en el PDF || string || NO
 
|-
 
|-
| note4 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small> || cadena || NO || F/DS/DE
+
| prefix || Informacion de Establecimiento y Punto de Venta (6 digitos) <small></small> || string || SI
 
|-
 
|-
| 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
+
| customer || Datos propios del comprador consulta <small>'''[[API_LaFactura.co:Comprador_ec|customer]]'''</small> || objeto || SI
 
|-
 
|-
| 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
+
| additionalInfo || Información adicional a adjuntar en el XML y PDF <small>'''[[API_LaFactura.co:Adicional_ec|additionalInfo]]'''</small> || objeto || NO
 
|-
 
|-
| 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
+
| amounts || Totales del documento <small>'''[[API_LaFactura.co:Totales_ec|amounts]]'''</small> || objeto || SI
 
|-
 
|-
| 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
+
| items || Detalle del documento <small>'''[[API_LaFactura.co:Detalle_ec|items]]'''</small> || objeto || SI
|-
 
| 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 165: Línea 120:
 
=====Resultados=====
 
=====Resultados=====
 
----
 
----
Devuelve un objeto '''[[API_laFactura.co:invoiceResult|invoiceResult]]''' con el resultado de la operación<br/>
+
Devuelve un objeto '''[[API_laFactura.co:resultado_ec|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 resultado devuelve ingresando al objeto.</i>
  
 
   {
 
   {
Línea 172: Línea 127:
 
         "status":{
 
         "status":{
 
           "code":200,
 
           "code":200,
           "text":"Operación realizada con exito"
+
           "text":"Procesado con éxito"
 
         },
 
         },
         "document":{
+
         "documento":{
           "type":"Factura",
+
           "type":"invoice",
          "mode":"Creation",
 
          "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-v301",
 
          "intID":"1",
 
          "document":"SETP-2092092",
 
          "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
 
 
           "process":"0",
 
           "process":"0",
           "retries":"0"
+
           "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-veca",
        },
+
          "serial":"3008202501171332850600110010010000001081322991315",
        "prefix":{
+
          "intID":"12EJS21",
            "prefix":"SETP",
+
          "document":"001-001-000000108",
            "from":"990000000",
+
          "document_number":{
            "to":"995000000",
+
              "unit":"001",
            "last":"990000102",
+
              "subUnit":"001",
            "remaining":"4999898",
+
              "secuence":"000000108"
            "firstDate":"20200223",
+
          }
            "lastDate":"20210223",
+
        }
            "description":"",
+
    }
            "DIANKey":"0934092940390932093292309023",
+
  }
            "auth":"18760000001"
 
        }
 
    }
 
  }
 
  
 
=====A tener presente=====
 
=====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)
 
* 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'''
+
* No se debe considerar un documento como válido por la SRI, hasta que el resultado de una verificación del documento, muestre a estado 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==
 
==Enlaces==
*LaFactura.co: https://lafactura.co
+
*LaFactura.ec: https://lafactura.ec
*GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
 
  
 
==Importante==
 
==Importante==
 
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br>
 
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br>
 
'''Si deseas tener un usuario y contraseña , comunícate con nosotros.'''
 
'''Si deseas tener un usuario y contraseña , comunícate con nosotros.'''

Revisión actual del 11:15 4 dic 2025

Objeto:invoice

Es el objeto raiz, del sistema de envio de facturas de nuestra API, es importante respetar todos los elementos aquí contemplados.


    Ingreso:     
    https://***.tas-la.com/facturacion.ec/invoice/
           
    Solicita tu usuario y contraseña +57-601-7466664
    No cobramos por el proceso de pruebas o desarrollo
    Y puedes empezar inmediatamente (sin certificados o papeleos)


Ejemplo de Factura
   {
     "invoice":{
           "issueDate":"20250830",
           "issueTime":"203845",
           "intID":"12EJS21",
           "note":"Notas adicionales al RIDE de la Factura",
           "prefix":"001001",
           "customer":{
               "documentType":"04",
               "name":"Gomez y Solorzano",
               "documentNumber":"1234567890123",
               "email":"[email protected]",
               "add1":"Datos especiales"
           },
           "additionalInfo":{
               "uno":"01",
               "dos":"02"
           },
           "amounts":{
               "totalAmount":"30.00",
               "taxAmount":"4.20",
               "discountAmount":"2.00",
               "tipAmount":"1.80",
               "payAmount":"34.00",
               "currency":"DOLAR",
               "payments":[
                     {
                       "type":"01",
                       "total":"34.00",
                       "term":"0",
                       "unit":"dias"
                     }
               ]
           },
           "items":[
               {
                  "code":"0001",
                  "subCode":"0002",
                  "description":"Análisis Operativo Interno",
                  "quantity":"3.00",
                  "unitPrice":"10.00",
                  "discount":"2.00",
                  "total":"28.00",
                  "data":{
                       "marca":"TAS",
                       "modelo":"GARF",
                       "estado":"Nuevo"
                  },
                  "taxes":[
                         {
                            "ID":"2",
                            "code":"4",
                            "percent":"15.00",
                            "taxableAmount":"28.00",
                            "taxAmount":"4.20"
                         }
                   ]
               }
             ]
           }
         }
Explicacion

Se está solicitando la creación de una factura por un total de $34.00 Dólares, para el cliente Gomez y Solorzano, con:

Item 1:

  • 3 Horas de Análisis operativo interno con un costo unitario de $10.00, para un total de $30.00 (Este total no es anotado en el item pero representado en el subtotal)
  • A estas 3 horas se les hizo un descuento del $2.00, para un total antes de impuestos de $28.00
  • Se le aplicó el IVA al valor de la línea (15%) equivalente a 4.20

Totales:

  • El subtotal antes de impuestos es de $30.00
  • Los impuestos son: $ 4.20
  • Los descuentos son: $ 2.00
  • Se agregó una propina de: $ 1.80
  • El total en factura es: $ 34.00 Dólares

Campos

Parámetro Descripción Tipo Obligatorio
issueDate Fecha del documento
(YYYYMMDD) Ejemplo: 20200321
Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5)
cadena NO
issueTime Hora del documento
(HHMMSS) Ejemplo: 175430
Si no se envia en conjunto con la hora de emison, se usará la hora actual (GMT-5)
cadena NO
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
note Nota adicional a agregar en el PDF string NO
prefix Informacion de Establecimiento y Punto de Venta (6 digitos) string SI
customer Datos propios del comprador consulta customer objeto SI
additionalInfo Información adicional a adjuntar en el XML y PDF additionalInfo objeto NO
amounts Totales del documento amounts objeto SI
items Detalle del documento items objeto SI


Resultados

Devuelve un objeto invoiceResult con el resultado de la operación
Importante: Verifica toda la informacion que resultado devuelve ingresando al objeto.

 {
   "invoiceResult":{
       "status":{
          "code":200,
          "text":"Procesado con éxito"
       },
       "documento":{
          "type":"invoice",
          "process":"0",
          "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-veca",
          "serial":"3008202501171332850600110010010000001081322991315",
          "intID":"12EJS21",
          "document":"001-001-000000108",
          "document_number":{
              "unit":"001",
              "subUnit":"001",
              "secuence":"000000108"
          }
       }
    }
  }
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 SRI, hasta que el resultado de una verificación del documento, muestre a estado con: 2

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.