Appearance
Categoria IVA - Resource
DOCUMENTACION RETROSPECTIVA - Generada a partir de codigo implementado el 2026-02-09
Modulo: Ventas Tipo: Resource (solo lectura) Estado: Implementado Fecha: 2026-02-09
Descripcion General
La Categoria de IVA representa las alicuotas del Impuesto al Valor Agregado definidas por ARCA (Administracion Federal de Ingresos Publicos de Argentina, anteriormente AFIP). Cada categoria tiene un codigo oficial asignado por ARCA, un nombre descriptivo y un porcentaje de alicuota.
Este recurso funciona como un catalogo de referencia fiscal utilizado en la facturacion electronica y en la configuracion de productos. Las categorias de IVA se aplican a los productos para determinar el porcentaje de impuesto que se calcula en cada comprobante de venta o compra.
Proposito de negocio: Proveer un catalogo centralizado y estandarizado de alicuotas de IVA que cumpla con la normativa fiscal vigente de ARCA, permitiendo su consulta desde cualquier modulo que requiera informacion de alicuotas (Ventas, Compras).
Entidades de Negocio
Categoria IVA (Alicuota)
Representa una alicuota de IVA oficialmente reconocida por ARCA.
| Dato | Descripcion | Obligatorio |
|---|---|---|
| Codigo | Codigo numerico oficial asignado por ARCA | Si |
| Nombre | Denominacion descriptiva de la alicuota | Si |
| Porcentaje | Porcentaje de la alicuota (ej: 21.00, 10.50, 0.00) | Si |
Registros conocidos (extraidos del seed de datos):
| Codigo ARCA | Nombre | Porcentaje |
|---|---|---|
| 3 | Exento | 0.00% |
| 4 | IVA 10.50% | 10.50% |
| 5 | IVA 21% | 21.00% |
| 6 | IVA 27% | 27.00% |
| 8 | IVA 5% | 5.00% |
| 9 | IVA 2.50% | 2.50% |
Operaciones Principales
Consultar todas las categorias de IVA
El usuario puede visualizar el listado completo de categorias de IVA disponibles en el sistema. La vista presenta una tabla con las columnas Codigo y Nombre.
Acceso: Menu Ventas > Bases > Categoria IVA (?loc=mvcia)
Consultar categoria por codigo
Permite obtener una categoria de IVA especifica a partir de su codigo ARCA. Esta operacion se utiliza internamente por otros modulos (por ejemplo, al configurar productos).
Consultar categoria por porcentaje
Permite obtener una categoria de IVA especifica a partir de su porcentaje. Utilizado en procesos de importacion de datos y facturacion.
[REQUIERE VALIDACION]: No se encontraron operaciones de alta, baja o modificacion implementadas para este recurso. Se infiere que las categorias de IVA son datos de referencia fija definidos por ARCA y solo se actualizan a traves de migraciones de base de datos cuando cambia la normativa fiscal.
Reglas de Negocio
RN-01: Codigos oficiales de ARCA
Los codigos de las categorias de IVA corresponden a los codigos oficiales establecidos por ARCA (RG 5616/2024 y normativa vigente). No pueden ser modificados arbitrariamente.
RN-02: Alicuotas fijas por normativa
Los porcentajes de alicuota estan determinados por la legislacion tributaria argentina. Las alicuotas vigentes son: 0% (Exento), 2.5%, 5%, 10.5%, 21% y 27%.
RN-03: Codigo unico
Cada categoria de IVA tiene un codigo unico que la identifica en el sistema y en la comunicacion con ARCA.
RN-04: Recurso compartido a nivel empresa
Las categorias de IVA son las mismas para todas las sucursales y cajas de una empresa. No varian por ubicacion geografica.
RN-05: Habilitacion por modulo
Las categorias de IVA estan disponibles cuando el modulo de Ventas o Compras esta habilitado en la empresa.
Validaciones
Validaciones del DTO
- codigo: Obligatorio, debe ser entero
- porcentaje: Obligatorio, debe ser numerico
- nombre: Obligatorio, maximo 100 caracteres
Relaciones con Otras Entidades
Producto
Las categorias de IVA se asignan a los productos para determinar la alicuota de IVA que se aplica en la facturacion. Un producto tiene una categoria de IVA asociada.
Comprobante de Venta/Compra
Durante la emision de comprobantes (facturas, notas de credito, notas de debito), las categorias de IVA se utilizan para calcular y discriminar los importes de IVA por alicuota.
Condicion de IVA (recurso relacionado)
La "Condicion de IVA" (?loc=mvci) es un recurso separado pero complementario que define las condiciones fiscales de los sujetos (Responsable Inscripto, Consumidor Final, Exento, Monotributo, etc.). La condicion de IVA del cliente/proveedor determina el tipo de comprobante a emitir y como se discriminan las alicuotas de IVA (categorias).
[REQUIERE VALIDACION]: Confirmar la relacion exacta de negocio entre Categoria IVA y Condicion IVA.
Casos de Uso
Caso 1: Consultar catalogo de alicuotas de IVA
Actor: Usuario del modulo Ventas o Compras
Precondiciones:
- El usuario debe estar autenticado
- El modulo Ventas o Compras debe estar habilitado
Flujo principal:
- El usuario navega a Ventas > Bases > Categoria IVA
- El sistema muestra una tabla con todas las categorias de IVA registradas
- La tabla presenta codigo y nombre de cada categoria
- La tabla permite exportar datos a Excel o PDF
Postcondiciones:
- El usuario visualiza las categorias de IVA disponibles
Caso 2: Busqueda de categoria por codigo (uso interno)
Actor: Sistema (modulos internos)
Precondiciones:
- Se conoce el codigo ARCA de la alicuota buscada
Flujo principal:
- Un modulo del sistema solicita la informacion de una categoria de IVA por su codigo
- El sistema retorna la categoria con su nombre y porcentaje
- El modulo utiliza esta informacion para calculos fiscales
Postcondiciones:
- Se obtiene la informacion de la alicuota para su uso en procesos de facturacion
Flujos alternativos:
- Codigo no encontrado: Si el codigo no existe, se retorna resultado vacio
Caso 3: Busqueda de categoria por porcentaje (importacion)
Actor: Sistema (proceso de importacion de productos)
Precondiciones:
- Se conoce el porcentaje de alicuota de IVA
Flujo principal:
- Durante la importacion masiva de productos, el sistema busca la categoria de IVA por porcentaje
- Si encuentra coincidencia exacta, asigna la categoria al producto importado
- Si no encuentra, el proceso de importacion reporta el error
Postcondiciones:
- Los productos importados tienen su categoria de IVA correctamente asignada
Consideraciones
Seguridad
- El acceso al catalogo de categorias de IVA es de solo lectura
- No se requieren permisos especiales mas alla de la autenticacion general
- Los datos son publicos (normativa fiscal) y no contienen informacion sensible
Auditoria
- No se registran operaciones de auditoria dado que es un recurso de solo lectura
- Las modificaciones a los datos se realizan exclusivamente via migraciones de base de datos (controladas por desarrollo)
Rendimiento
- El catalogo es pequeno (6 registros conocidos)
- No se requiere paginacion ni optimizaciones especiales
- Los datos son estables y raramente cambian
Dependencias
Funcionalidades relacionadas
- Facturacion electronica: Utiliza las categorias de IVA para calcular alicuotas en comprobantes
- Productos: Cada producto tiene una categoria de IVA asociada
- Importacion de productos: Busca categorias de IVA por porcentaje para asignacion automatica
- Condicion de IVA: Recurso complementario que define condiciones fiscales de sujetos
- ARCA (organismo fiscal): Los codigos corresponden a la codificacion oficial de ARCA
Servicios externos
- ARCA (Webservice WSFE): En la facturacion electronica, los codigos de alicuota de IVA se envian a ARCA segun su codificacion oficial
Criterios de Aceptacion
- [x] AC-001: El sistema muestra el listado completo de categorias de IVA en formato tabular
- [x] AC-002: La tabla presenta al menos las columnas Codigo y Nombre
- [x] AC-003: Los datos se cargan automaticamente al acceder a la vista
- [x] AC-004: Se pueden exportar los datos a Excel y PDF
- [x] AC-005: Los codigos corresponden a la codificacion oficial de ARCA
- [ ] AC-006: [REQUIERE VALIDACION] El porcentaje deberia mostrarse como columna en la tabla
Preguntas Pendientes
Hay preguntas sobre esta funcionalidad que requieren validacion. Ver: Preguntas sobre Categoria IVA
Preguntas criticas pendientes:
- Es intencional que sea solo lectura? (no hay operaciones CUD)
- Cual es la relacion exacta con Condicion IVA?
- Los datos son inmutables, definidos solo por ARCA?
- Deberia mostrarse el porcentaje en la tabla?
Referencias Tecnicas
NOTA IMPORTANTE: Esta documentacion fue generada automaticamente analizando el codigo implementado. Se recomienda validar con stakeholders de negocio para confirmar que refleja fielmente los requisitos originales. En particular, se deben revisar las preguntas pendientes sobre la naturaleza de solo lectura del recurso y su relacion con la Condicion de IVA.