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

Revisión actual del 15:20 24 sep 2024

Sumario

1 Objeto:items
2 Objetos empleados
3 Usado por
4 Temas complementarios
5 Enlaces

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:

Los siguientes objetos:

invoice (Factura)
creditNote (Nota Crédito)

Temas complementarios

Enlaces

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

@@ Línea 13: / Línea 13: @@
             "brand":"LF",
             "model":"Soporte",
-           "standard": "999",
-           "agency": "990",
             "code": "1000",
             "allowance":[
@@ Línea 22: / Línea 20: @@
                    "description":"Es un super descuento por hoy",
                    "baseAmount":"100000.00",
-                   "amount":"4000.00",
+                   "amount":"4000.00"
-                  "percent":"4.00"
                  }
             ],
@@ Línea 41: / Línea 38: @@
             "brand":"LF",
             "model":"Serv1",
-           "standard": "999",
-           "agency": "990",
             "code": "1"
           }
@@ Línea 58: / Línea 53: @@
 *marca: LF
 *modelo: Soporte
-*standard del codigo del producto: 999 (propio)
+*código del producto: 1000
-*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)
@@ Línea 70: / Línea 63: @@
 *marca: LF
 *modelo: Serv1
-*standard": 999
+*código del producto: 1<br/>
-*agencia que se encarga del standard: 990
-*código del producto en dicho standard: 1<br/>
 =====Campos=====
+----
 {| class="wikitable"
@@ Línea 80: / Línea 72: @@
 ! Parámetro !! Descripción !! Tipo !! Obligatorio !! Notas !! API
 |-
-| quantity || Cantidad vendida<br><small>(Debe incluir dos decimales)</small>|| cadena || SI || || v2.00 y v3.00
+| quantity || Cantidad vendida<br><small>(Debe incluir dos decimales)</small>|| cadena || SI || || v2.0 / v3.0
 |-
-| unitPrice || Precio unitario del articulo<br><small>(Debe incluir dos decimales)</small> || cadena || SI || || v2.00 y v3.00
+| unitPrice || Precio unitario del articulo<br><small>(Debe incluir dos decimales)</small> || cadena || SI || || v2.0 / v3.0
 |-
-| total || valor total del articulo<br><small>(quantity*unitPrice-descuentos+cargos, con dos decimales)</small> || cadena || SI || || v2.00 y v3.00
+| total || valor total del articulo<br><small>(quantity*unitPrice-descuentos+cargos, con dos decimales)</small> || cadena || SI || || v2.0 / v3.0
 |-
-| pricingReference || valor real de la linea del detalle si su precio de venta es 0.00<br><small>(con dos decimales)</small> || cadena || SI || <small>Solo si total=0.00</small>|| v2.00 y v3.00
+| pricingReference || valor real de la linea del detalle si su precio de venta es 0.00<br><small>Se debe enviar unicamente si el valor total del venta es 0.00<br/>Su valor debe ser mayor que 0.00<br/>(es numérico con dos decimales)</small> || cadena || SI || <small>Solo si total=0.00</small>|| v2.0 / v3.0
 |-
-| description || Descripcion del producto completo || cadena || SI |||| v2.00 y v3.00
+| unit || Unidad de medida<br><small>94 -> Por unidad<br>GLL -> Galón<br>LTR -> Litro<br>MTQ -> Métro cúbico<br>LM -> Métro lineal<br/><b>Por omision -> 94<br/>Si necesitas una específica favor informar</b></small> || cadena || NO || || v3.0
 |-
-| brand || Marca del producto || cadena || SI |||| v2.00 y v3.00
+| description || Descripcion del producto completo || cadena || SI |||| v2.0 / v3.0
 |-
-| model || Modelo del producto || cadena || SI |||| v2.00 y v3.00
+| brand || Marca del producto || cadena || SI |||| v2.0 / v3.0
 |-
-| standard || Standard usado para codificar el producto<br/><small>001 -> UNSPSC<br/>010 -> GTIN<br/>020 -> Partida arancelaria<br/>999 -> Standard propio<br/>(Nuevo Obligatorio)</small> || cadena || SI |||| v2.00 y v3.00
+| model || Modelo del producto || cadena || SI |||| v2.0 / v3.0
 |-
-| agency || Código de la agencia encargada de dicho standard<br/><small>10 -> Para standard 001<br/>9 -> Para standard 010<br/>195 -> para standard 020<br/>cualquier valor -> Para standard 999<br/><b>Campo obsoleto en API v3.00</b></small> || cadena || SI -> Para API v2.0 |||| v2.00 y v3.00
+| standard || Standard usado para codificar el producto<br/><small>001 -> UNSPSC<br/>010 -> GTIN<br/>020 -> Partida arancelaria<br/>999 -> Standard propio <b>(Valor por omision en API v3.0)</b></small> || cadena || <small>SI -> Para API v2.0<br/> NO -> Para API v3.0</small> |||| v2.0 / v3.0
 |-
-| code || Código unificado del producto, según standard seleccionado<br/><small>Para standard 001, 010 y 020 debe ser numérico<br/>Para standard 999 es alfanumérico - sin espacios</small>|| cadena || SI |||| v2.00 y v3.00
+| agency || Código de la agencia encargada de dicho standard<br/><small>10 -> Para standard 001<br/>9 -> Para standard 010<br/>195 -> para standard 020<br/>cualquier valor -> Para standard 999<br/><b>Automático en API v3.00</b></small> || cadena || <small>SI -> Para API v2.0<br/> NO -> Para API v3.0</small> |||| v2.0 / v3.0
 |-
-| 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 || || v2.00 y v3.00
+| code || Código unificado del producto, según standard seleccionado<br/><small>Para standard 001, 010 y 020 debe ser numérico<br/>Para standard 999 es alfanumérico - sin espacios</small>|| cadena || SI |||| v2.0 / v3.0
 |-
-| 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 |||| v2.00 y v3.00
+|poa || Determina si este item es por "mandato"<br/><small>"true" -> mandato<br/>"false" -> No es de mandato<br><b>Es obligatorio para facturas por mandato,<br/>en ningún otro tipo de facturas es aceptado o requerido</b></small>|| cadena || SI/NO |||| v3.0
+|-
+| supplier || Objeto en relacionado con operaciones de documento soporte<br><small>(Deben estar incluidos si se deseas crear un documento soporte)<br>Ir a : [[API_LaFactura.co:itemSoporte|items documento soporte]]</small>|| cadena || NO || Debe Ir en Documento Soporte || v3.0
+|-
+| transporteCarga || Objeto en relacionado con operaciones de transporte de carga<br><small>(Deben estar incluidos si se deseas crear un documento de transporte de Carga)<br>Ir a : [[API_LaFactura.co:itemTransporte|items transporte de carga]]</small>|| cadena || NO |||| v3.0
+|-
+| 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 || NO || || v2.0 / v3.0
+|-
+| 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 || NO |||| v2.0 / v3.0
 |}
+<span style="color:#009999"><b>Notas para migrantes de API v2.0 a v3.0:</b></span>
+----
+El standard ahora se asume "999" / antes era obligatorio<br/>
+El campo agency ahora se calcula automáticamente<br/>
+<br/>
 =====A Tener presente=====
+----
 * Este objeto está '''SIEMPRE''' compuesto de arreglos, así solo se envíe 1 linea de detalle

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

Revisión actual del 15:20 24 sep 2024

Sumario

Objeto:items

Ejemplo

Explicacion

Campos

A Tener presente

Objetos empleados

Usado por

Temas complementarios

Enlaces

Menú de navegación

Herramientas personales

Espacios de nombres

Variantes

Vistas

Más

Buscar

Navegación

Facturación

Generales

Webhooks

Nomina

Whisperer

Recepción Docs

Ejemplos

Enlaces

Herramientas