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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
Línea 100: Línea 100:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
! 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
+
| fechaEmision || 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
 
|-
 
|-
| 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
+
| horaEmision || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> La Hora debe ser GMT -5 || cadena || SI
 
|-
 
|-
| 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
+
| intID || 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
 
|-
 
|-
| issueTime || Hora del documento<br><small>(HHMMSS) Ejemplo: 175430</small> La Hora debe ser GMT -5 || cadena || SI
+
| comprador || 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
 
|-
 
|-
| 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
+
| totales || 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
 
|-
 
|-
| paymentType || Tipo de pago<br><small>Contado->1 / Credito->2</small> || cadena || SI
+
| detalle || Tipo de pago<br><small>Contado->1 / Credito->2</small> || cadena || SI
 
|-
 
|-
| paymentCode || Medio de pago<small><br/>[[API_LaFactura.co:Tabla_Tipos_Medios_Pago|consultar tabla]]</small> || cadena || SI
+
| rango || Medio de pago<small><br/>[[API_LaFactura.co:Tabla_Tipos_Medios_Pago|consultar tabla]]</small> || cadena || SI
|-
 
| 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
 
|-
 
| note2 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small>|| cadena || NO
 
|-
 
| note3 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small> || cadena || NO
 
|-
 
| note4 || Nota para ser agregada en el documento<br/><small>Aparece en el PDF</small> || cadena || NO
 
|-
 
| 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
 
|-
 
| 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
 
|-
 
| 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
 
 
|}
 
|}
  

Revisión del 23:32 11 sep 2025

Objeto:factura

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
   {
     "factura":{
           "fechaEmision":"20250830",
           "horaEmision":"203845",
           "intID":"12EJS21",
           "nota":"Notas adicionales al RIDE de la Factura",
           "rango":{
               "estab":"001",
               "punto":"001"
           },
           "comprador":{
               "tipo":"04",
               "razonSocial":"Gomez y Solorzano",
               "id":"1234567890123",
               "correo":"[email protected]",
               "adicional1":"Datos especiales"
           },
           "infoAdicional":{
               "uno":"01",
               "dos":"02"
           },
           "totales":{
               "subtotal":"30.00",
               "impuestos":"4.20",
               "descuentos":"2.00",
               "propina":"1.80",
               "total":"34.00",
               "moneda":"DOLAR",
               "pagos":[
                     {
                       "forma":"01",
                       "total":"34.00",
                       "plazo":"0",
                       "unidad":"dias"
                     }
               ]
           },
           "detalle":[
               {
                  "codigoPrincipal":"0001",
                  "codigoAuxiliar":"0002",
                  "descripcion":"Análisis Operativo Interno",
                  "cantidad":"3.00",
                  "unitario":"10.00",
                  "descuento":"2.00",
                  "total":"28.00",
                  "complementos":{
                       "marca":"TAS",
                       "modelo":"GARF",
                       "estado":"Nuevo"
                  },
                  "impuestos":[
                         {
                            "id":"2",
                            "cod":"4",
                            "tarifa":"15.00",
                            "base":"28.00",
                            "valor":"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
fechaEmision 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
horaEmision Hora del documento
(HHMMSS) Ejemplo: 175430 La Hora debe ser GMT -5
cadena SI
intID Prefijo del rango a ser utilizado
Los prefijos disponibles los puedes obtener usando el servicio de getRanges
cadena SI
comprador 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
totales 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
detalle Tipo de pago
Contado->1 / Credito->2
cadena SI
rango Medio de pago
consultar tabla
cadena SI


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":"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

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.