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 (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
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:

---

Se agregó orderID (no necesario en muchos casos)
Se agregó un nuevo objeto para el sector salud "ms"
Se eliminó el objeto usuarios.ms (El cual pasó a ser parte del objeto "ms")
Se agregó el objeto documento.gn, para aquellos usuarios que administran su propio consecutivo.

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