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",
          "code": "1000",
          "allowance":[
               {
                 "charge":"false",
                 "reasonCode":"11",
                 "description":"Es un super descuento por hoy",
                 "baseAmount":"100000.00",
                 "amount":"4000.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",
          "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
• código del producto: 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
• código del producto: 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
unit	Unidad de medida 94 -> Por unidad GLL -> Galón LTR -> Litro MTQ -> Métro cúbico LM -> Métro lineal Por omision -> 94 Si necesitas una específica favor informar	cadena	NO		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
poa	Determina si este item es por "mandato" "true" -> mandato "false" -> No es de mandato Es obligatorio para facturas por mandato, en ningún otro tipo de facturas es aceptado o requerido	cadena	SI/NO		v3.0
supplier	Objeto en relacionado con operaciones de documento soporte (Deben estar incluidos si se deseas crear un documento soporte) Ir a : items documento soporte	cadena	NO	Debe Ir en Documento Soporte	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	NO		v3.0
allowance	Cargos o descuentos (Deben estar incluidos si se aplica algún descuento en el item) Ir a: allowance	objeto	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	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