Motor de Impuestos

El cálculo de impuestos varía según el país, la provincia y el tipo de producto. vXeller maneja un sistema fiscal flexible que cumple con la normativa de cada jurisdicción.

Zonas de Impuesto

Las zonas de impuesto (`tax_zones) definen dónde aplican ciertas tasas:

• País — ej: Argentina.
• Provincia — ej: Buenos Aires, Córdoba.
• Prioridad — para resolver conflictos entre zonas.

Cada zona puede tener una o más tasas.

Tasas de Impuesto

Cada tasa (tax_rates) dentro de una zona tiene:

Campo	Qué define
Nombre	IVA, IIBB, etc.
Porcentaje	Alícuota (ej: 21%)
Prioridad	Para composición de impuestos
Compuesto	Si se calcula sobre la base + otros impuestos
Impuesto sobre envío	Si afecta al costo de envío
afip_iva_id	Vínculo con la facturación electrónica (ARCA)

Impuesto Compuesto

Un impuesto compuesto se calcula sobre la base ya incrementada por otros impuestos. Ejemplo:

1. IVA 21% sobre $1.000 → $210
2. IIBB 3% compuesto sobre $1.210 (base + IVA) → $36.30

Esto es obligatorio en algunas jurisdicciones.

Overrides por Producto y Colección

Podés crear exenciones o tasas alternativas para productos o colecciones específicas:

• Producto exento — no paga IVA (ej: productos esenciales).
• Tasa alternativa — tasa distinta a la general (ej: IVA reducido).
• Por colección — todos los productos de una colección tienen la tasa alternativa.

Modo de Precios con Impuesto Incluso

vXeller puede funcionar en dos modos:

Modo	Cómo se muestra el precio
Sin impuesto incluido	Precio + impuesto al final (ej: "$1.000 + $210 IVA")
Con impuesto incluido	El precio ya incluye el impuesto (ej: "$1.210")

El ajuste TAX_PRICES_INCLUDE_TAX controla esto.

Impuesto sobre el Envío

El parámetro TAX_SHIPPING_TAXABLE define si el costo de envío es gravable:

• Sí — el impuesto se aplica también al envío.
• No — el envío está exento.

Exención Fiscal por Cliente

Cada cliente puede tener la bandera tax_exempt:

• true — el cliente no paga impuestos (exento).
• false — paga impuestos normalmente.

Útil para clientes diplomáticos, organizaciones exentas o B2B con exención.

Cálculo de Impuestos

El sistema calcula impuestos bajo demanda:

1. El cliente llega al checkout.
2. Se resuelve la zona de impuesto según la dirección.
3. Se aplican las tasas (incluyendo compuestos y overrides).
4. Las líneas de impuesto se snapshotean en el pedido.
5. El cliente ve el desglose: POST /tax/calculate.

Vínculo con Facturación (AFIP)

Cada tasa tiene un afip_iva_id que la vincula con el sistema de facturación electrónica. Esto permite que al emitir un comprobante, el IVA se calcule correctamente.

Casos de Uso

• IVA 21% en Argentina con override exento para ciertos productos.
• Precios con impuesto incluido para B2C.
• IIBB compuesto en jurisdicciones que lo exigen.
• Cliente exento de impuestos (diplomático, ONG).

Consejos

1. Configurá las zonas antes de cargar productos. El impuesto depende del destino.
2. Verificá los overrides — si un producto es exento, marcalo. No confíes en que el operador lo recuerde.
3. Problá el modo "precios con impuesto" antes de activarlo. Afecta cómo se muestran todos los precios.
4. Revisá el vínculo con AFIP — cada tasa debe tener su afip_iva_id para facturar correctamente.
5. Actualizá tasas cuando cambien las alícuotas oficiales.