Ver categoría fiscal
Consulta la ficha de una categoría fiscal existente, como un IVA de Marea Gran Via, para revisar nombre, porcentaje, descripción y país dentro del catálogo activo.
En este artículo
Las categorías fiscales ayudan a mantener el catálogo preparado para vender productos con el IVA correcto. Desde la ficha puedes comprobar qué tipo se aplicará sin modificar productos ni otros registros.
La pantalla puede abrirse desde Catálogos de organización o de ubicación. Si el usuario solo tiene permiso de consulta, o la categoría viene heredada de otro scope, la ficha queda en modo lectura.
Antes de empezar
- Sesión iniciada con una organización seleccionada; para la ruta de ubicación también debe existir una ubicación activa, por ejemplo Marea Gran Via.
- Tener acceso `catalog:view` o un perfil que permita abrir la consulta de catálogos. `catalog:manage` también puede abrir la pantalla y habilitar edición si la categoría pertenece al scope editable.
- Debe existir una categoría fiscal visible desde el contexto actual: de sistema, de la organización o de la ubicación.
- Para capturas del runtime ES, resolver antes un `TAX_CATEGORY_ID` real desde el listado o desde `GET /api/app/{ORG_ID}/{LOCATION_ID}/tax-categories`, porque `maestro-env.json` no lo incluye.
Instrucciones
- 1.
Abrir tipos impositivos
Entra en Catálogos de la ubicación u organización y abre la pestaña de categorías fiscales. En el demo ES conviene usar Marea Gran Via y filtrar por `IVA` para localizar categorías como `IVA 10%` o `IVA 21%`.
- 2.
Seleccionar la categoría
Abre una fila visible o usa la acción disponible para ver o editar la categoría. La ruta de detalle debe incluir un `id`; abrir `/location/catalogs/tax-category-item` o `/organization/catalogs/tax-category-item` sin `id` corresponde a creación.
- 3.
Revisar la ficha
Comprueba `Nombre`, `Porcentaje`, `Descripción` y `País`. En el demo español el país esperado es España (`ES`) y los porcentajes habituales del seed son 10%, 21% o 0%.
- 4.
Interpretar el modo de acceso
Si la categoría pertenece al scope editable y el usuario tiene `catalog:manage`, la misma pantalla puede presentarse como edición. Si es heredada, de sistema o el usuario solo puede consultar, los controles quedan en modo lectura.
- 5.
Volver al listado
Usa la acción de volver para regresar a Catálogos con la pestaña de categorías fiscales y el contexto de organización o ubicación activo.
Validaciones y límites
- El detalle solo carga cuando existen `id`, contexto de scope y permiso suficiente.
- Sin `catalog:view` ni acceso equivalente en la UI, la pantalla muestra `noAccess` y no ejecuta la consulta de detalle.
- El backend de detalle usa `PermCatalogView` y rechaza registros que no pasan la comprobación de lectura del scope.
- Una categoría de sistema o de otro scope puede consultarse si es visible, pero no se edita ni se elimina desde este formulario.
- La categoría fiscal no admite imagen en este formulario.
- La consulta de detalle no modifica productos; los productos solo referencian la categoría mediante `tax_category_id`.
- El parámetro genérico `occurrence_id` no tiene comportamiento histórico específico para categorías fiscales en el backend analizado.
Resultado esperado
El responsable de catálogo confirma qué IVA o categoría fiscal aplica, con sus campos principales visibles y sin alterar el catálogo ni los productos relacionados.