API LaFactura.co:Items
Sumario
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",
"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",
"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 |
| 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
Usado por
Los siguientes recursos:
Los siguientes objetos:
- invoice (Factura)
- creditNote (Nota Crédito)
Temas complementarios
Enlaces
- LaFactura.co: https://lafactura.co
- GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
