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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
Línea 83: Línea 83:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
|-
 
|-
−
| quantity || Cantidad vendida<br><small>(Debe incluir dos decimales)</small>|| cadena || SI
+
| rangeKey || Identificador Único, del rango de facturación a ser usado|| cadena || SI
 
|-
 
|-
−
| unitPrice || Precio unitario del articulo<br><small>(Debe incluir dos decimales)</small> || cadena || SI
+
| issueDate || Fecha de la factura<br><small>(YYYYMMDD) Ejemplo: 20200321</small> || cadena || SI
 
|-
 
|-
−
| total || valor total del articulo<br><small>(quantity*unitPrice-descuentos+cargos, con dos decimales)</small> || cadena || SI
+
| issueTime || Hora de facturacion<br><small>(HHMMSS) Ejemplo: 175430</small> || cadena || SI
 
|-
 
|-
−
| description || Descripcion del producto completo || cadena || SI
+
| dueDate || Fecha de Vencimiento<br><small>(YYYYMMDD) Ejemplo: 20200421</small> || cadena || SI
 
|-
 
|-
−
| brand || Marca del producto || cadena || SI
+
| note1 || Nota para ser agregada en la factura || cadena || NO
 
|-
 
|-
−
| model || Modelo del producto || cadena || SI
+
| note2 || Nota para ser agregada en la factura || cadena || NO
 
|-
 
|-
−
| allowance || Cargos o descuentos<br><small>(Deben estar incluidos si se aplica algún descuento en el item)<br>Ir a: [[API_LaFactura.co:Allowance|allowance]]</small> || objeto || SI/NO
+
| note3 || Nota para ser agregada en la factura || cadena || NO
 
|-
 
|-
−
| taxes || Impuestos calculados a nivel de producto<br><small>(Deben estar incluidos si se aplica algún impuesto en el item)<br>Ir a: [[API_LaFactura.co:Taxes|taxes]]</small> || objeto || SI/NO
+
| note4 || Nota para ser agregada en la factura || cadena || NO
 +
|-
 +
| customizationID || Tipo de documento generado<br><small>Segun tabla de la DIAN</small>|| cadena || SI
 +
|-
 +
| customer || Datos del cliente<br><small><small> || objeto || SI
 +
|-
 +
| amounts || Totales del documento<br><small><small> || objeto || SI
 +
|-
 +
| taxes || Totales en impuestos<br><small>(Deben estar incluidos si se aplica algún descuento en el item)<br>Ir a: [[API_LaFactura.co:Allowance|allowance]]</small> || objeto || SI/NO
 +
|-
 +
| items || Líneas de la factura<br><small>(Deben estar incluidos si se aplica algún impuesto en el item)<br>Ir a: [[API_LaFactura.co:Taxes|taxes]]</small> || objeto || SI/NO
 
|}
 
|}
  

Revisión del 17:36 15 ene 2020

Objeto:invoice

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.

Ejemplo
 {
   "invoice":
   {
     "rangeKey":"219832728",
     "issueDate":"20200317",
     "issueTime":"100521",
     "dueDate" : "20200417",
     "note1" : "Esta es una nota en la factura",
     "customizationID" : "01",
     "customer" : {
          "additionalAccountID":"1",
          "name":"Pepito Perez y Compania S.A.",
          "countryName":"Colombia",
          "countryCode":"CO",
          "city":"Bogotá D.C.",
          "countryEntity":"11",
          "countrySubentity":"11001",
          "addressLine":"Av 25 No. 8-47",
          "documentNumber":"900900651",
          "documentType":"31",
          "telephone":"3112196952",
          "email":"[email protected]"
     },
     "amounts":{
          "totalAmount":"116000.00",
          "taxAmount":"18240.00",
          "payAmount":"134240.00"
     },
     "taxes":{
         [
           "ID":"01",
           "taxableAmount":"96000.00",
           "taxAmount":"18240.00",
           "percent":"19.00"
         ]
     },
     "items":{
         [
           "quantity":"5.00",
           "unitPrice":"20000.00",
           "total":"96000.00",
           "description":"Horas de soporte remoto",
           "brand":"LF",
           "model":"Soporte",
           "allowance":{
                [
                  "charge":"false",
                  "reasonCode":"11",
                  "description":"Es un super descuento por hoy",
                  "baseAmount":"100000.00",
                  "amount":"4000.00",
                  "percent":"4.00"
                ]                    
           },
           "taxes":{
                [
                  "ID":"01",
                  "taxableAmount":"96000.00",
                  "taxAmount":"18240.00",
                  "percent":"19.00"
                ]
            }
         ],
         [
           "quantity":"1.00",
           "unitPrice":"20000.00",
           "total":"20000.00",
           "description":"Servicio sin IVA",
           "brand":"LF",
           "model":"Serv1",
         ]
      }
   }
 }
Campos
Parámetro Descripción Tipo Obligatorio
rangeKey Identificador Único, del rango de facturación a ser usado cadena SI
issueDate Fecha de la factura
(YYYYMMDD) Ejemplo: 20200321		 cadena SI
issueTime Hora de facturacion
(HHMMSS) Ejemplo: 175430		 cadena SI
dueDate Fecha de Vencimiento
(YYYYMMDD) Ejemplo: 20200421		 cadena SI
note1 Nota para ser agregada en la factura cadena NO
note2 Nota para ser agregada en la factura cadena NO
note3 Nota para ser agregada en la factura cadena NO
note4 Nota para ser agregada en la factura cadena NO
customizationID Tipo de documento generado
Segun tabla de la DIAN		 cadena SI
customer Datos del cliente
 objeto SI
amounts Totales del documento
 objeto SI
taxes Totales en impuestos
(Deben estar incluidos si se aplica algún descuento en el item)
Ir a: allowance		 objeto SI/NO
items Líneas de la factura
(Deben estar incluidos si se aplica algún impuesto en el item)
Ir a: taxes		 objeto SI/NO
A Tener presente
  • Asegúrate de verificar que envias todos los campos requeridos.

Objetos empleados

Usado por

Los siguientes recursos:

Temas complementarios

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