Diferencia entre revisiones de «API LaFactura.co:Facturacion»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(No se muestran 45 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
−
==API de Facturacion==
+
==API de Facturacion y Documentos Soporte==
−
Esta API, termite el manejo facturas en nuestro sistema. Está diseñado para hacer el proceso de una forma sencilla y amigable. Utilizando simples comandos via HTTP.
+
Esta '''API''', termite el manejo facturas y documentos soporte en nuestro sistema. Está diseñado para hacer el proceso de una forma sencilla y amigable. Utilizando simples comandos via HTTP.
 +
 
 
==URL Base==
 
==URL Base==
 
Para realizar el proceso, debes hacer tus solicitudes en la siguiente URL:
 
Para realizar el proceso, debes hacer tus solicitudes en la siguiente URL:
−
<br><br><br>
+
<br><br>
−
<span style='background-color:#212121;color:#98d487;margin:3rem;padding:1.5rem;width:80%;border-radius:4px'><nowiki>https://playground.lafactura.co/api2.0/invoice</nowiki></span>
+
    Ingreso:    
−
<br><br><br>
+
    <nowiki>https://***.tas-la.com/facturacion.v30/invoice/</nowiki>
−
La API de LaFactura.co trabaja bajo HTTPS. para asegurar privacidad en el envío de información, por lo tanto HTTP, no es soportado.<br>
+
     
 +
    <b>Solicita tu usuario y contraseña +57-601-7466664</b>
 +
    No cobramos por el proceso de pruebas o desarrollo
 +
    Y puedes empezar inmediatamente (sin certificados o papeleos)
 +
<br>
 +
La API de LaFactura.co trabaja bajo '''HTTPS'''. para asegurar privacidad en el envío de información, por lo tanto HTTP, no es soportado.<br>
 
(*)La URL presentada en este lugar, es la que se utiliza para pruebas, la dirección en modo de operación varía exclusivamente en el dominio utilizado.<br>
 
(*)La URL presentada en este lugar, es la que se utiliza para pruebas, la dirección en modo de operación varía exclusivamente en el dominio utilizado.<br>
 
(**)Recuerda que debes autenticarte con usuario y contraseña durante el envío de la petición.
 
(**)Recuerda que debes autenticarte con usuario y contraseña durante el envío de la petición.
  
 
==Opciones del recurso==
 
==Opciones del recurso==
−
Este recurso requiere el envío de información en formato JSON como parte de la petición, y debe incluir en su encabezado los siguientes parámetros:<br>
+
Este recurso requiere el envío de información en formato '''JSON''' como parte de la petición, y debe incluir en su encabezado los siguientes parámetros:<br>
 
* Content-Type: application/json<br>
 
* Content-Type: application/json<br>
−
* Content-Legnth: Tamaño de la petición enviada en bytes<br>
+
* Content-Length: Tamaño de la petición enviada en bytes<br>
 
Contiene los siguientes recursos:
 
Contiene los siguientes recursos:
−
* [[API_LaFactura.co:Generar_Factura|Generar Factura]]
+
* [[API_LaFactura.co:Generar_Factura|Generar Factura / Documento Soporte <small>(Documento soporte solo en API v3.0)</small>]]
−
 
+
* [[API_LaFactura.co:Verificar_Factura|Verificar Documento <small>(Cualquier tipo de documento)</small>]]
−
==Generar factura==
+
* [[API_LaFactura.co:Anular_Factura|Anular Factura <small>(En API v2.0 - en API v3.0 se movió a Notas Crédito)</small>]]
−
Para generar una factura a través de la API y realizar los procesos de verificación, elaboracion, firmado y envío a la DIAN, debes realizar una petición '''POST''', a la URL incluyendo el formato JSON con la información propia de la factura a ser generada.<br><br>
+
* [[API_LaFactura.co:Eventos_Documento|Eventos del Documento <small>(Cualquier tipo de documento)</small>]]
−
=====Ejemplo=====
 
−
 
 
−
  {
 
−
    "invoice":
 
−
    {
 
−
      "rangeKey":"219832728",
 
−
      "issueDate":"20200317",
 
−
      "issueTime":"100521",
 
−
      "dueDate" : "20200417",
 
−
      "note1" : "Esta es una nota en la factura",
 
−
      "customizationID" : "01",
 
−
      "customer" : {
 
−
          "additionalAccountID":"01",
 
−
          "name":"Pepito Perez y Cia SAS",
 
−
          "city":"Bogotá"
 
−
          "address":"Av 19 No. 11-11 Of 40-09",
 
−
          "document":"900900651",
 
−
          "documentType":"01",
 
−
          "phone":"3112196942",
 
−
          "email":"[email protected]"
 
−
      },
 
−
      "amounts":{
 
−
          "totalAmount":"120000.00",
 
−
          "taxAmount":"19000.00",
 
−
          "payAmount":"139000.00"
 
−
      },
 
−
      "taxes":{
 
−
          [
 
−
            "ID":"IVA",
 
−
            "taxableAmount":"100000.00",
 
−
            "taxAmount":"19000.00",
 
−
            "percent":"19.00"
 
−
          ]
 
−
      },
 
−
      "items":{
 
−
          [
 
−
            "quantity":"5.00",
 
−
            "unitPrice":"20000.00",
 
−
            "total":"100000.00",
 
−
            "description":"Horas de soporte remoto",
 
−
            "brand":"LF",
 
−
            "model":"Soporte",
 
−
            "taxes":{
 
−
                [
 
−
                  "ID":"IVA",
 
−
                  "taxableAmount":"100000.00",
 
−
                  "taxAmount":"19000.00",
 
−
                  "percent":"19.00"
 
−
                ]
 
−
            }
 
−
          ],
 
−
          [
 
−
            "quantity":"1.00",
 
−
            "unitPrice":"20000.00",
 
−
            "total":"20000.00",
 
−
            "description":"Servicio sin IVA",
 
−
            "brand":"LF",
 
−
            "model":"Serv1",
 
−
          ]
 
−
      }
 
−
    }
 
−
  }
 
−
 
 
−
=====Explicación=====
 
−
Se está solicitando la creación de una factura por un total de $139.000 Pesos, para el cliente Pepito Perez y Compañía SAS, con:<br><br>
 
−
* 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000 + IVA ($19.000)<br>
 
−
* 1 Hora de servicio sin IVA por un valor de $20.000<br>
 
−
* El total antes de impuestos es de $120.000<br>
 
−
* Los impuestos son: $ 19.000<br>
 
−
* El total en factura en: $ 139.000<br>
 
−
 
 
−
=====Resultados=====
 
−
Devuelve un objeto '''invoiceResult''' con el resultado de la operación
 
−
 
 
−
  {
 
−
    "invoiceResult":{
 
−
        "status":{
 
−
          "code":"200",
 
−
          "text":"Operación realizada con exito",
 
−
        },
 
−
        "document":{
 
−
          "tascode":"fc-54984309jtr0ret90jjrg",
 
−
          "document":"FC-2092092",
 
−
          "CUFE":"43059843095203948093248093483048039248093403298409328490348903483094",
 
−
          "process":"1"
 
−
        }
 
−
    }
 
−
  }
 
−
 
 
−
=====Objetos que emplea=====
 
−
*invoice: [[API_laFactura.co:invoice|Factura]]
 
−
*invoiceResult: [[API_laFactura.co:invoiceResult|Resultado Factura]]
 
−
*exchange: [[API_laFactura.co:exchange|Tasa]]
 
−
*customer: [[API_laFactura.co:customer|Cliente]]
 
−
*amounts [[API_laFactura.co:amounts|Montos]]
 
−
*taxes [[API_laFactura.co:taxes|Impuestos]]
 
−
*items [[API_laFactura.co:items|Lineas]]
 
−
*allowance [[API_laFactura.co:allowance|Descuentos y cargos]]
 
−
 
 
−
===Verificar factura===
 
−
Si deseas saber como está el proceso de elaboración actual de la factura, y su último status, puedes hacer la consulta usando GET en la URL del servicio e incluir el siguiente objeto.
 
  
−
  {
+
==Temas complementarios==
−
      "verifyStatus":{
+
* [[Página_principal|Nuestra API]]
−
            "tascode":"fc-945809458409504958435098"
 
−
      }
 
−
  }
 
  
−
Este retorna, un objeto '''invoiceResult''' con el estado.
+
==Enlaces==
 +
*LaFactura.co: https://lafactura.co
 +
*GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
  
−
=====Objetos que emplea=====
+
==Importante==
−
*verifyStatus: [[API_laFactura.co:verifyStatus|Verificar]]
+
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.<br>
−
*invoiceResult: [[API_laFactura.co:invoiceResult|Resultado Factura]]
+
'''Si deseas tener un usuario y contraseña , comunícate con nosotros.'''

Revisión actual del 13:28 23 sep 2021

API de Facturacion y Documentos Soporte

Esta API, termite el manejo facturas y documentos soporte en nuestro sistema. Está diseñado para hacer el proceso de una forma sencilla y amigable. Utilizando simples comandos via HTTP.

URL Base

Para realizar el proceso, debes hacer tus solicitudes en la siguiente URL: 

    Ingreso:     
    https://***.tas-la.com/facturacion.v30/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)


La API de LaFactura.co trabaja bajo HTTPS. para asegurar privacidad en el envío de información, por lo tanto HTTP, no es soportado.
(*)La URL presentada en este lugar, es la que se utiliza para pruebas, la dirección en modo de operación varía exclusivamente en el dominio utilizado.
(**)Recuerda que debes autenticarte con usuario y contraseña durante el envío de la petición.

Opciones del recurso

Este recurso requiere el envío de información en formato JSON como parte de la petición, y debe incluir en su encabezado los siguientes parámetros:

  • Content-Type: application/json
  • Content-Length: Tamaño de la petición enviada en bytes

Contiene 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.

Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:Facturacion&oldid=2025»