Í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 el request: 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 — mínimo 0.000001 |
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 | E725. 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 |
paisOrigen | string | No | Código ISO del país de origen (para mercaderías importadas) |
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.