API LaFactura.co:Items

Objeto:items

Es un objeto usado en invoice. Contiene el detalle de las líneas de la factura. Es importante tener encuenta que todo item, que genere impuesto, lo debe tener incluido a nivel de linea.

Ejemplo

     "items":[
        {
          "quantity":"5.00",
          "unitPrice":"20000.00",
          "total":"96000.00",
          "description":"Horas de soporte remoto",
          "brand":"LF",
          "model":"Soporte",
          "standard": "999",
          "agency": "990",
          "code": "1000",
          "allowance":[
               {
                 "charge":"false",
                 "reasonCode":"11",
                 "description":"Es un super descuento por hoy",
                 "baseAmount":"100000.00",
                 "amount":"4000.00",
                 "percent":"4.00"
               }                    
          ],
          "taxes":[
               {
                 "ID":"01",
                 "taxAmount":"18240.00",
                 "percent":"19.00"
               }
           ]
        },
        {
          "quantity":"1.00",
          "unitPrice":"20000.00",
          "total":"20000.00",
          "description":"Servicio sin IVA",
          "brand":"LF",
          "model":"Serv1",
          "standard": "999",
          "agency": "990",
          "code": "1"
        }
     ]

Explicacion

Se están facturando 2 Items:

Item 1:

• Cantidad: 5.00
• Precio Unitario: 20000.00
• Total de la linea: 96000.00 (Tener presente cargos, descuentos e impuestos)
• descripcion: Horas de soporte remoto
• marca: LF
• modelo: Soporte
• standard del codigo del producto: 999 (propio)
• agencia que se encarga del standard: 990 (para el standard propio, puede ser cualquier numero)
• código del producto en dicho standard: 1000
• cargos y descuentos (mirar el objeto interno para explicacion)
• impuestos (mirar el objeto interno para explicacion)

Item 2:

• cantidad: 1
• precio unitario: 20000.00
• descripcion: Servicio sin IVA
• marca: LF
• modelo: Serv1
• standard": 999
• agencia que se encarga del standard: 990
• código del producto en dicho standard: 1
  

Campos

---

Parámetro	Descripción	Tipo	Obligatorio	Notas	API
quantity	Cantidad vendida (Debe incluir dos decimales)	cadena	SI		v2.0 / v3.0
unitPrice	Precio unitario del articulo (Debe incluir dos decimales)	cadena	SI		v2.0 / v3.0
total	valor total del articulo (quantity*unitPrice-descuentos+cargos, con dos decimales)	cadena	SI		v2.0 / v3.0
pricingReference	valor real de la linea del detalle si su precio de venta es 0.00 Se debe enviar unicamente si el valor total del venta es 0.00 Su valor debe ser mayor que 0.00 (es numérico con dos decimales)	cadena	SI	Solo si total=0.00	v2.0 / v3.0
description	Descripcion del producto completo	cadena	SI		v2.0 / v3.0
brand	Marca del producto	cadena	SI		v2.0 / v3.0
model	Modelo del producto	cadena	SI		v2.0 / v3.0
standard	Standard usado para codificar el producto 001 -> UNSPSC 010 -> GTIN 020 -> Partida arancelaria 999 -> Standard propio (Valor por omision en API v3.0)	cadena	SI -> Para API v2.0 NO -> Para API v3.0		v2.0 / v3.0
agency	Código de la agencia encargada de dicho standard 10 -> Para standard 001 9 -> Para standard 010 195 -> para standard 020 cualquier valor -> Para standard 999 Automático en API v3.00	cadena	SI -> Para API v2.0 NO -> Para API v3.0		v2.0 / v3.0
code	Código unificado del producto, según standard seleccionado Para standard 001, 010 y 020 debe ser numérico Para standard 999 es alfanumérico - sin espacios	cadena	SI		v2.0 / v3.0
transporteCarga	Objeto en relacionado con operaciones de transporte de carga (Deben estar incluidos si se deseas crear un documento de transporte de Carga) Ir a : items transporte de carga	cadena	SI		v3.0
allowance	Cargos o descuentos (Deben estar incluidos si se aplica algún descuento en el item) Ir a: allowance	objeto	SI/NO		v2.0 / v3.0
taxes	Impuestos calculados a nivel de producto (Deben estar incluidos si se aplica algún impuesto en el item) Ir a: taxes	objeto	SI/NO		v2.0 / v3.0

Notas para migrantes de API v2.0 a v3.0:

---

El standard ahora se asume "999" / antes era obligatorio
El campo agency ahora se calcula automáticamente

A Tener presente

---

• Este objeto está SIEMPRE compuesto de arreglos, así solo se envíe 1 linea de detalle

Objetos empleados

• allowance (Cargos y Descuentos)
• taxes (Impuestos)

Usado por

Los siguientes recursos:

• Generar Factura
• Generar Nota Crédito

Los siguientes objetos:

• invoice (Factura)
• creditNote (Nota Crédito)

Temas complementarios

• Facturación
• Nota Crédito

Enlaces

• LaFactura.co: https://lafactura.co
• GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co