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 97: Línea 97:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
|-
 
|-
| fechaEmision || 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
+
| 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
 
|-
 
|-
| horaEmision || 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
+
| 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
 
|-
 
|-
 
| 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
 
| 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
 
|-
 
|-
| nota || Nota adicional a agregar en el PDF || string || NO
+
| note || Nota adicional a agregar en el PDF || string || NO
 
|-
 
|-
| rango || Informacion de Establecimiento y Punto de Venta <small>'''[[API_LaFactura.co:Rango_ec|rango]]'''</small> || objeto || SI
+
| prefix || Informacion de Establecimiento y Punto de Venta (6 digitos) <small>'''[[API_LaFactura.co:Rango_ec|rango]]'''</small> || string || SI
 
|-
 
|-
| comprador || Datos propios del comprador consulta <small>'''[[API_LaFactura.co:Comprador_ec|comprador]]'''</small> || objeto || SI
+
| customer || Datos propios del comprador consulta <small>'''[[API_LaFactura.co:Comprador_ec|comprador]]'''</small> || objeto || SI
 
|-
 
|-
| infoAdicional || Información adicional a adjuntar en el XML y PDF <small>'''[[API_LaFactura.co:Adicional_ec|info adicional]]'''</small> || objeto || NO
+
| additionalInfo || Información adicional a adjuntar en el XML y PDF <small>'''[[API_LaFactura.co:Adicional_ec|info adicional]]'''</small> || objeto || NO
 
|-
 
|-
| totales || Totales del documento <small>'''[[API_LaFactura.co:Totales_ec|totales]]'''</small> || objeto || SI
+
| amounts || Totales del documento <small>'''[[API_LaFactura.co:Totales_ec|totales]]'''</small> || objeto || SI
 
|-
 
|-
| detalle || Detalle del documento <small>'''[[API_LaFactura.co:Detalle_ec|detalle]]'''</small> || objeto || SI
+
| items || Detalle del documento <small>'''[[API_LaFactura.co:Detalle_ec|detalle]]'''</small> || objeto || SI
 
|}
 
|}
  

Revisión del 13:37 17 oct 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
   {
     "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) rango string SI
customer Datos propios del comprador consulta comprador objeto SI
additionalInfo Información adicional a adjuntar en el XML y PDF info adicional objeto NO
amounts Totales del documento totales objeto SI
items Detalle del documento detalle objeto SI


Resultados

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

 {
   "resultado":{
       "estado":{
          "codigo":200,
          "error":"Procesado con éxito"
       },
       "documento":{
          "tipo":"fc",
          "estado":0,
          "tascode":"fc-16fc1cfdd2d42f27492691ba30cee903382f2-veca",
          "clave":"3008202501171332850600110010010000001081322991315",
          "intID":"12EJS21",
          "documento":{
              "estab":"001",
              "punto":"001",
              "secuencial":"000000108",
              "completo":"001-001-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: 3

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.