Documentación del Sistema

Appearance

Alícuotas de IVA (ARCA) ​

Módulo: General
Tipo: Resource
Estado: Implementado
Fecha: 2026-04-01

Descripción ​

aliva es el catálogo oficial de alícuotas de Impuesto al Valor Agregado (IVA) definido por ARCA (ex-AFIP) bajo la normativa RG 5616/2024. Provee los códigos estandarizados y tasas porcentuales que el sistema utiliza para registrar y validar la aplicación fiscal correcta del IVA en operaciones comerciales.

Valor para el negocio:

  • Garantiza que las tasas de IVA utilizadas en operaciones fiscales estén alineadas con la normativa vigente de ARCA.
  • Evita errores en cálculos de impuestos que podrían invalidar comprobantes ante organismos de control.
  • Permite que múltiples módulos (Ventas, Compras, CtaCte, etc.) compartan un catálogo único y centralizado de tasas autorizadas.
  • Facilita la selección de la alícuota correcta en líneas de comprobantes y en cálculos de retenciones y percepciones.

Contexto:

  • Los códigos y tasas porcentuales son fijos y provienen de la tabla oficial de ARCA. El sistema no los genera ni los modifica arbitrariamente.
  • Este catálogo es obligatorio en cualquier operación que requiera aplicar IVA: emisión de facturas, notas de crédito/débito, cálculo de retenciones, y registros contables.
  • La tabla es compartida por toda la empresa (no varía por sucursal).
  • Una única alícuota puede marcarse como predeterminada para acelerar la selección en formularios (típicamente IVA 21%).

Catálogo de Alícuotas de IVA ​

Los 6 códigos ARCA reconocidos:

CódigoDescripciónTasa (%)Predeterminada
3IVA 0 % (Exento)0.00No
4IVA 10.5 %10.50No
5IVA 21 %21.00Sí
6IVA 27 %27.00No
8IVA 5 %5.00No
9IVA 2.5 %2.50No

Predeterminada: IVA 21 % (código 5) — la alícuota general estándar en Argentina.

Reglas de Negocio ​

RN-001: Catálogo cerrado — sin altas ni bajas

  • Las alícuotas de IVA son definidas por ARCA. El sistema no permite crear nuevas tasas ni eliminar las existentes.
  • Las operaciones de alta (POST) y baja (DELETE) no están disponibles.

RN-002: Código y tasa porcentual oficial ARCA

  • El código de cada alícuota y su tasa porcentual son oficiales de ARCA. No son generados ni modificables por el sistema.
  • No se permite cambiar el código ni el porcentaje de ninguna alícuota.

RN-003: Control de visibilidad mediante activo

  • El campo activo controla si una alícuota aparece disponible para selección en formularios.
  • Desactivar una alícuota no la elimina del sistema; sólo la oculta en los selectores de alta/edición.
  • El único dato que puede modificarse por operación de gestión es el estado activo/inactivo y la designación de predeterminada.

RN-004: Filtrado por módulos consumidores

  • Todos los módulos que presenten un selector de alícuota de IVA (líneas de facturas, ajustes, etc.) deben filtrar por activo = verdadero para mostrar únicamente las alícuotas habilitadas.
  • La lista completa (incluyendo inactivas) está disponible sólo para consultas administrativas.

RN-005: Obligatoriedad en operaciones fiscales

  • La alícuota de IVA es un dato obligatorio al registrar líneas de comprobantes (facturas, notas de crédito/débito).
  • Cada línea debe tener explícitamente asignada una alícuota del catálogo.

RN-006: Una única predeterminada

  • Solo una alícuota puede tener defecto = true en simultáneo.
  • Al marcar una alícuota como predeterminada, las demás automáticamente pierden ese estado.
  • La operación es atómica — si falla cualquier parte, ningún cambio persiste.

Operaciones Disponibles ​

Consultar lista de alícuotas de IVA ​

Devuelve el catálogo completo de alícuotas de IVA según tabla ARCA RG 5616/2024.

  • Incluye: códigos, descripciones, tasas porcentuales y estado de predeterminada.
  • Ordenamiento: por defecto DESC (predeterminada primero), luego por codigo ASC.
  • Filtro opcional por estado activo: se puede solicitar únicamente las alícuotas habilitadas (útil para poblar selectores en formularios).
  • El resultado es de solo lectura — es tabla de referencia normativa.

Consultar alícuota de IVA por código ​

Devuelve una alícuota de IVA específica dado su código ARCA.

  • Si el código no existe en el catálogo, se informa que no fue encontrado (HTTP 404).
  • Funciona para cualquier código, incluyendo inactivos.
  • Respuesta incluye el estado de predeterminada.

Marcar alícuota como predeterminada ​

Permite establecer una alícuota como predeterminada (para acelerar selecciones en formularios).

  • Solo se puede modificar el estado defecto. Código, descripción y porcentaje son de solo lectura.
  • Si se establece una alícuota como predeterminada (defecto = true), todas las demás automáticamente pierden ese estado.
  • Operación es atómica — ejecutada en una única transacción.
  • Si el código no existe, devuelve HTTP 404.

Restricciones ​

OperaciónPermitidaMotivo
Consultar listaSíAcceso de referencia para todos los módulos
Consultar por códigoSíAcceso unitario para validaciones
Marcar como predeterminadaSíGestión de alícuota por defecto en formularios
Crear nueva alícuotaNoTabla cerrada — los códigos los define ARCA
Modificar código/porcentajeNoLos datos son de normativa ARCA, no editables
Eliminar alícuotaNoNo se borra información fiscal de referencia

Casos de Uso ​

UC-001: Seleccionar alícuota al crear línea de factura ​

Actor: Vendedor registrando una factura

Precondiciones:

  • El catálogo tiene al menos 2 alícuotas habilitadas.
  • Una alícuota está marcada como predeterminada (IVA 21%).

Flujo principal:

  1. El vendedor abre el formulario de nueva factura.
  2. Al agregar una línea, el sistema presenta un selector con las alícuotas habilitadas.
  3. La alícuota predeterminada (IVA 21%) aparece preseleccionada.
  4. El vendedor puede cambiarla si es necesario (ej.: producto exento → IVA 0%).
  5. La línea se registra con la alícuota seleccionada.

Postcondiciones:

  • La línea tiene una alícuota válida y habilitada asignada.
  • El cálculo del IVA utiliza la tasa porcentual correcta.

UC-002: Cambiar alícuota predeterminada ​

Actor: Administrador del sistema

Precondiciones:

  • El catálogo tiene varias alícuotas habilitadas.
  • IVA 21% (código 5) es la predeterminada actual.
  • El administrador necesita cambiarla a IVA 10.5% (código 4) por cambio normativo temporal.

Flujo principal:

  1. El administrador accede al listado de alícuotas de IVA.
  2. Ubica la alícuota IVA 10.5% (código 4).
  3. Marca el checkbox o botón "Predeterminada".
  4. El sistema actualiza: código 4 ahora tiene defecto = true, código 5 ahora tiene defecto = false.
  5. Confirmación visual de cambio exitoso.

Postcondiciones:

  • IVA 10.5% es la nueva predeterminada en formularios.
  • IVA 21% sigue activa pero no preseleccionada.
  • Todas las operaciones futuras usan IVA 10.5% como default.

UC-003: Desactivar una alícuota poco usada ​

Actor: Administrador del sistema

Precondiciones:

  • La alícuota IVA 2.5% (código 9) está activa.
  • Se requiere deshabilitarla porque la normativa la suspendió temporalmente.

Flujo principal:

  1. El administrador consulta el listado completo de alícuotas (incluyendo inactivas).
  2. Identifica la alícuota IVA 2.5%.
  3. Desactiva el estado activo.
  4. La alícuota queda oculta en selectores de formularios.

Postcondiciones:

  • IVA 2.5% no aparece en selectores de nuevas operaciones.
  • Operaciones históricas con IVA 2.5% siguen siendo consultables.
  • La alícuota puede reactivarse cuando la normativa lo permita.

Criterios de Aceptación ​

  • [ ] El catálogo contiene los 6 códigos ARCA con sus tasas porcentuales correctas.
  • [ ] IVA 21 % (código 5) está marcado como predeterminado por defecto.
  • [ ] Los selectores de formulario en módulos consumidores muestran únicamente alícuotas con estado activo.
  • [ ] Consultar un código inexistente retorna HTTP 404 con mensaje claro.
  • [ ] Un administrador puede marcar cualquier alícuota como predeterminada.
  • [ ] Al marcar una alícuota como predeterminada, todas las demás pierden ese estado (máximo una simultáneamente).
  • [ ] No es posible crear nuevas alícuotas a través del sistema.
  • [ ] No es posible modificar el código ni la tasa porcentual de una alícuota existente.
  • [ ] No es posible eliminar una alícuota del catálogo.
  • [ ] Cualquier módulo puede consultar la lista completa o filtrada por estado activo.
  • [ ] El endpoint GET retorna alícuotas ordenadas: predeterminada primero, luego por código ASC.

Dependencias ​

Módulos consumidores ​

  • Ventas (Facturas/Recibos): usa el catálogo para asignar IVA a líneas de comprobantes.
  • Compras (Facturas de Proveedor): usa el catálogo para registrar IVA en compras.
  • CtaCte (Movimientos): usa el catálogo en ajustes y operaciones especiales.
  • Contabilidad (Asientos): usa el catálogo en registros de impuestos.
  • Retenciones/Percepciones: base para cálculos de impuestos especiales.

Servicios externos ​

  • ARCA (ex-AFIP): fuente de verdad de los códigos y tasas. Los datos del catálogo reflejan la normativa oficial RG 5616/2024.

Dependencias de datos ​

  • Debe existir el catálogo cargado antes de que módulos como Ventas o Compras puedan registrar operaciones.

Notas Adicionales ​

  • El catálogo se carga una sola vez durante la inicialización de la base de datos. Si ya tiene datos, la carga se omite automáticamente para evitar duplicados.
  • ARCA puede en el futuro modificar tasas o agregar códigos nuevos. Cualquier cambio normativo se incorpora mediante migraciones SQL controladas por el equipo técnico, no a través de operaciones de usuario.
  • El campo defecto existe para mejorar la experiencia del usuario — permite preseleccionar la alícuota más común sin eliminar la flexibilidad de cambiarla.
  • Históricamente, Argentina ha mantenido 4 alícuotas principales (0%, 10.5%, 21%, 27%), aunque la normativa autoriza tasas diferenciales (5%, 2.5%) para casos especiales.