# Ítem (/docs/referencia/modelos/item)



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.

<Callout type="info">
  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`.
</Callout>

## Schema [#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](/docs/referencia/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`, salvo que se informe `porcentajeExento`. En el resto de las afectaciones se ignora        |
| `porcentajeExento`     | `number`  | No          | Alternativa a `propIVA` con `GRAVADO_PARCIAL`: porcentaje del total del ítem, IVA incluido, que va como exento. Mayor a `0` y menor a `100`; Sifende deriva `propIVA`. No se informa junto con `propIVA` |
| `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 [#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](/docs/referencia/modelos/factura-electronica#compras-públicas).

## Identificación y trazabilidad [#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](/docs/referencia/modelos/nota-remision#mercaderías-items). `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 [#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](/docs/referencia/modelos/factura-electronica#documentos-asociados-y-anticipos).

## Vehículos nuevos [#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 [#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](/docs/guias/moneda-extranjera).

## Valores comunes de `unidadMedida` [#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](/docs/referencia/enumeraciones#unidadmedida).

## Ejemplo — Producto gravado IVA 10% [#ejemplo--producto-gravado-iva-10]

```json
{
  "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 [#ejemplo--servicio-exento]

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

## Ejemplo — Ítem gravado parcialmente [#ejemplo--ítem-gravado-parcialmente]

```json
{
  "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.

## Próximos pasos [#próximos-pasos]

* [Modelo Factura Electrónica](/docs/referencia/modelos/factura-electronica)
* [Concepto: Ítems e IVA](/docs/conceptos/items-iva)
* [Enumeraciones SIFEN](/docs/referencia/enumeraciones)
