Í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, hasta 50 caracteres
`descripcion`	`string`	Sí	Descripción del producto o servicio, hasta 2000 caracteres
`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 con `GRAVADO` y `GRAVADO_PARCIAL`. Con `EXENTO` o `EXONERADO` se omite o se envía `0`; otra tasa recibe `400` en `items[i].tasaIVA`
`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; opcional en cualquier operación
`codigoDncpEspecifico`	`string`	No	De 3 a 4 dígitos; opcional en cualquier operación

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

Identificación y trazabilidad

Estos campos opcionales se incorporan al documento emitido en FE, NCE y NDE:

Campo	Tipo	Regla
`partidaArancelaria`	`string`	4 dígitos
`ncm`	`string`	De 6 a 8 dígitos
`gtin`	`string`	GTIN de 8, 12, 13 o 14 dígitos
`gtinPaquete`	`string`	GTIN del paquete, mismo formato
`paisOrigen`	`enum`	País de origen de la mercadería
`observacion`	`string`	Información de interés del emisor sobre el ítem
`lote`	`string`	De 1 a 80 caracteres
`vencimiento`	`date`	`YYYY-MM-DD`
`numeroSerie`	`string`	De 1 a 10 caracteres
`numeroPedido`	`string`	De 1 a 20 caracteres
`numeroSeguimiento`	`string`	De 1 a 20 caracteres
`numeroRegistroProducto`	`string`	Registro sanitario, de 1 a 20 caracteres
`numeroRegistroEntidadComercial`	`string`	Registro de la entidad comercial, de 1 a 20 caracteres
`nombreProducto`	`string`	De 1 a 30 caracteres

Las tolerancias de quiebra o merma (tolerancia, toleranciaCantidad, toleranciaPorcentaje) sólo existen en la nota de remisión. codigoProductoCPBS no forma parte del documento: usá los códigos DNCP. Informarlos en una FE, NCE o NDE recibe 400 validation-error.

Descuentos y anticipos del ítem

Campo	Tipo	Descripción
`descuentoParticular`	`number`	Descuento por unidad, en importe
`descuentoParticularPorcentaje`	`number`	Alternativa: porcentaje sobre el precio unitario, mayor que 0 y hasta 100. Se informa uno u otro
`anticipoParticular`	`number`	Sólo en FE con `condicionAnticipo: "ANTICIPO_POR_ITEM"`: anticipo aplicado por unidad
`cdcAnticipo`	`string`	CDC de la factura de anticipo del ítem. Obligatorio en cada ítem cuando la factura asocia más de una factura de anticipo electrónica; con una sola se completa solo

El descuento y el anticipo, sumados, no pueden superar el precio unitario. Ver Documentos asociados y anticipos.

Vehículos nuevos

vehiculoNuevo describe un vehículo nuevo vendido en el ítem: tipoOperacion, chasis (17 caracteres alfanuméricos), color, potencia, capacidadMotor, pesoNeto, pesoBruto, tipoCombustible, numeroMotor, capacidadTraccion, anioFabricacion, tipoVehiculo y capacidadPasajeros. Con tipoCombustible: "OTRO" se informa descripcionCombustible, de 3 a 20 caracteres. La cilindrada no se admite.

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
GRAVADO_PARCIAL: propIVA es la proporción gravada de la base. Con t la tasa y p la proporción, la base gravada es 100 × total × p / (10000 + t × p), el IVA es base × t / 100 y la parte exenta es 100 × total × (100 − p) / (10000 + t × p)

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.