Cómo crear una categoría fiscal
Crea un tipo impositivo para una ubicación como Marea Gran Via o para la organización. Después queda disponible para asignarlo a productos y para conservar la referencia fiscal en tickets del TPV.
En este artículo
Una categoría fiscal define un tipo impositivo reutilizable dentro del catálogo. En el demo ES, Marea Gran Via puede trabajar con tipos como `IVA 10`, `IVA 21` o `Exento`, y crear uno nuevo cuando necesita documentar un criterio fiscal propio.
El ámbito se decide por la pantalla desde la que se abre el alta: ubicación en `/location` u organización en `/organization`. Crear la categoría no modifica productos existentes; solo deja el tipo fiscal disponible para usos posteriores.
Antes de empezar
- Sesión iniciada en Antylogic con Grupo Marea Demo seleccionado.
- Para crear en ubicación, Marea Gran Via debe estar seleccionada y existir `selectedLocationId`.
- El usuario necesita `catalog:manage` en el ámbito donde va a crear el tipo impositivo.
- Antes de crear, comprueba que no exista ya otra categoría fiscal con el mismo nombre en la misma ubicación u organización.
- En el demo ES, el país inicial del formulario es `ES`.
Instrucciones
- 1.
Abrir Tipo impositivo
Entra en Catálogos de la ubicación u organización y abre la pestaña `Tipo impositivo`. En ubicación, la ruta de entrada es `/location/catalogs?tab=taxCategories`.
- 2.
Iniciar el alta
Pulsa `Crear Tipo impositivo`. La aplicación abre el formulario de categoría fiscal en modo creación, sin identificador previo.
- 3.
Rellenar los datos
Introduce `Nombre`, `Porcentaje` y `País`. Para una captura de documentación en España puede usarse `IVA documentación`, porcentaje `21` y país `ES`; `Descripción` es opcional.
- 4.
Comprobar que se puede guardar
Revisa que el formulario esté modificado y sea válido. El botón `Crear Tipo impositivo` se habilita cuando los campos obligatorios tienen un valor correcto y no hay envío en curso.
- 5.
Crear el tipo impositivo
Pulsa `Crear Tipo impositivo`. La app envía el alta al endpoint del ámbito activo: `POST /api/app/{orgId}/{locationId}/tax-categories` en ubicación o `POST /api/app/{orgId}/tax-categories` en organización.
- 6.
Usarlo después en productos
Tras la confirmación, vuelve al listado de `Tipo impositivo`. La nueva categoría queda disponible para formularios de producto y para que el TPV guarde la referencia fiscal en tickets.
Validaciones y límites
- Con `catalog:view` se puede consultar la lista, pero no iniciar el alta; sin `catalog:manage`, la pantalla directa muestra `noAccess` y el backend también bloquea la creación.
- `name` se recorta y es obligatorio; no puede quedar vacío tras quitar espacios.
- `percentage` debe poder parsearse como decimal y el backend exige un valor entre `0` y `100`.
- `country_code` se normaliza y debe pertenecer a los países soportados; en el formulario es obligatorio y en el demo ES se inicia como `ES`.
- El alcance de creación se deriva de la URL y del contexto, no del payload enviado por el cliente.
- No se documenta creación global o de sistema: estas rutas solo cubren organización y ubicación.
- La base de datos impide nombres duplicados por `org_id` o por `location_id`; el mensaje exacto para duplicados no está determinado por el análisis.
- `taxCategories` no soporta imagen ni copia o duplicado desde el listado.
Resultado esperado
La categoría fiscal queda creada en `tax_categories` para la ubicación u organización activa, la lista se refresca y el tipo impositivo puede seleccionarse después en productos y quedar referenciado por tickets del TPV.