Ítem

Schema de un ítem de línea — producto o servicio incluido en el documento electrónico con su afectación tributaria.

Cada documento electrónico contiene un arreglo items con al menos un elemento. Cada ítem representa un producto o servicio facturado, con su precio, cantidad e información tributaria.

Sifende calcula automáticamente todos los totales (subtotales, IVA discriminado, total general). No los mandes en la solicitud: se computan a partir de cantidad, precioUnitario, afectacionTributaria y tasaIVA.

Schema

Campo	Tipo	Requerido	Descripción
`codigo`	`string`	Sí	Código interno del producto en tu sistema
`descripcion`	`string`	Sí	Descripción del producto o servicio
`cantidad`	`number`	Sí	Cantidad entre `0.00000001` y `9999999999.99999999`, con hasta 10 enteros y 8 decimales
`unidadMedida`	`enum`	Sí	`UNI`, `kg`, `LT`, `MT`, etc. — ver enumeraciones
`precioUnitario`	`number`	Sí	Precio unitario con IVA incluido, mayor o igual a `0`
`tipoCambio`	`number`	Condicional	Obligatorio en cada ítem cuando una operación extranjera usa POR_ITEM; no se informa en GLOBAL ni en PYG
`afectacionTributaria`	`enum`	Sí	`GRAVADO`, `EXENTO`, `EXONERADO`, `GRAVADO_PARCIAL`
`tasaIVA`	`integer`	Condicional	`5` o `10` — obligatorio cuando `afectacionTributaria = GRAVADO`
`propIVA`	`number`	Condicional	Porcentaje gravado, mayor a `0` y menor a `100` — obligatorio cuando `afectacionTributaria = GRAVADO_PARCIAL`. En el resto de las afectaciones se ignora
`descuentoParticular`	`number`	No	Importe de descuento por unidad, en la moneda de la operación. Admite hasta 15 enteros y 8 decimales

Códigos de compras públicas

Campo	Tipo	Requerido	Descripción
`codigoDncpGeneral`	`string`	No	Exactamente 8 dígitos; exclusivo de B2G
`codigoDncpEspecifico`	`string`	No	De 3 a 4 dígitos; exclusivo de B2G

Conservá los ceros iniciales, por ejemplo "00123456" y "0123". No envíes estos códigos como números JSON. Ver Compras públicas B2G.

Otros campos opcionales del contrato

Los siguientes campos aparecen en el contrato de ítems de FE/NCE/NDE, pero no se incorporan al documento emitido. No los uses para transmitir estos datos a SIFEN:

Campo	Tipo	Dato que representa
`paisOrigen`	`string`	País de origen de la mercadería
`codigoProductoCPBS`	`string`	Código de producto de compras públicas; usá los códigos DNCP documentados arriba
`tolerancia`	`string`	Relación de tolerancia de la mercadería
`toleranciaCantidad`	`string`	Cantidad de tolerancia
`toleranciaPorcentaje`	`string`	Porcentaje de tolerancia
`lote`	`string`	Identificación de la partida de mercadería
`vencimiento`	`string`	Fecha de vencimiento de la mercadería
`numeroSerie`	`string`	Número de serie
`numeroPedido`	`string`	Número de pedido
`numeroSeguimiento`	`string`	Número de seguimiento

La NRE sí incorpora datos de trazabilidad y tolerancia, con tipos y restricciones propios. Consultá los ítems de NRE.

Cálculo de IVA

Para ítems GRAVADO, Sifende calcula el IVA a partir del precio total:

IVA 10%: iva = total / 11
IVA 5%: iva = total / 21
IVA 0% / EXENTO / EXONERADO: sin IVA discriminado

El precio unitario que enviás es IVA incluido. Esa es la convención SIFEN estándar.

descuentoParticular también es unitario: Sifende lo multiplica por cantidad para obtener el descuento particular total. El descuento global no se informa por ítem; usá descuentoGlobalPorcentaje en el nivel del documento y Sifende derivará el importe correspondiente para cada ítem.

En moneda extranjera, tipoCambio admite hasta 5 enteros y 4 decimales, debe ser positivo y menor que 99999.9999. Si la factura no tiene un tipo de cambio global, todos los ítems deben informarlo; no se permiten modalidades mezcladas ni ítems sin cotización. Ver Facturar en Moneda Extranjera.

Valores comunes de `unidadMedida`

Valor	Significado
`UNI`	Unidad
`kg`	Kilogramo
`LT`	Litro
`MT`	Metro
`M2`	Metro cuadrado
`M3`	Metro cúbico
`Hs`	Hora (servicios)
`Di`	Día

Ver el listado completo en enumeraciones.

Ejemplo — Producto gravado IVA 10%

{
  "codigo": "PROD-001",
  "descripcion": "Resma de papel A4 75g",
  "cantidad": 10,
  "unidadMedida": "UNI",
  "precioUnitario": 11000,
  "afectacionTributaria": "GRAVADO",
  "tasaIVA": 10
}

Total del ítem: 10 × 11.000 = 110.000 PYG (incluye IVA 10% = 10.000 PYG).

Ejemplo — Servicio exento

{
  "codigo": "SRV-EDU-01",
  "descripcion": "Curso de capacitación — 8 horas",
  "cantidad": 8,
  "unidadMedida": "Hs",
  "precioUnitario": 50000,
  "afectacionTributaria": "EXENTO"
}

Ejemplo — Ítem gravado parcialmente

{
  "codigo": "PAQ-001",
  "descripcion": "Paquete turístico — traslado y entradas",
  "cantidad": 1,
  "unidadMedida": "UNI",
  "precioUnitario": 500000,
  "afectacionTributaria": "GRAVADO_PARCIAL",
  "tasaIVA": 10,
  "propIVA": 30
}

El 30% del ítem se grava al 10% y el 70% restante va como exento.