Í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 |
afectacionTributaria | enum | Sí | GRAVADO, EXENTO, EXONERADO, GRAVADO_PARCIAL |
tasaIVA | integer | Condicional | 5 o 10 — obligatorio cuando afectacionTributaria = GRAVADO |
descuentoParticular | number | No | Descuento absoluto aplicado a este ítem |
descuentoPorcentaje | number | No | Porcentaje de descuento global aplicado por ítem |
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.
Valores comunes de unidadMedida
| Valor | Significado |
|---|---|
UNI | Unidad |
KG | Kilogramo |
LT | Litro |
MT | Metro |
M2 | Metro cuadrado |
M3 | Metro cúbico |
HORA | Hora (servicios) |
DIA | 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": "HORA",
"precioUnitario": 50000,
"afectacionTributaria": "EXENTO"
}