Cómo editar una categoría fiscal
Actualiza el nombre, porcentaje, descripción y país de un tipo impositivo existente en una organización o ubicación. La edición cambia la definición fiscal que usan productos y catálogos, pero no reasigna productos ni cambia el propietario de la categoría.
En este artículo
Las categorías fiscales viven dentro de los catálogos de producto. En Marea Gran Via, el equipo puede abrir Tipos impositivos, revisar una categoría editable y ajustar sus datos sin salir del flujo de catálogo.
La actualización respeta el ámbito real de la categoría: si pertenece a la ubicación se guarda como dato de ubicación, y si es heredada de organización se guarda en organización cuando el usuario tiene permiso para gestionarla.
Antes de empezar
- Iniciar sesión con una organización seleccionada; para trabajar en ubicación, debe estar seleccionada Marea Gran Via u otra ubicación válida.
- Tener acceso a la pestaña de categorías fiscales desde los catálogos de organización o ubicación.
- Tener `catalog:manage` para guardar cambios; con `catalog:view` se puede consultar el detalle en solo lectura.
- Usar una categoría existente, accesible y editable. Las categorías de sistema no se pueden modificar.
- Para capturas de documentación, disponer de un `taxCategoryId` temporal y editable del runtime demo ES.
Instrucciones
- 1.
Abrir Tipos impositivos
Desde Catálogos, abre la pestaña de categorías fiscales. La lista muestra los tipos impositivos disponibles con nombre, porcentaje, país y propietario.
- 2.
Elegir una categoría editable
Localiza la categoría que quieres cambiar y usa la acción Editar. Si la fila es de sistema, la app permite verla, pero no editarla.
- 3.
Revisar el formulario
El formulario carga Nombre, Porcentaje, Descripción y País. Si la API no devuelve país, la app muestra ES como valor visual por defecto.
- 4.
Modificar los campos necesarios
Cambia uno o varios campos. El porcentaje puede introducirse con coma o punto decimal; la descripción puede quedar vacía si no aporta información útil.
- 5.
Guardar la actualización
Pulsa Guardar. La app envía los cambios al ámbito real de la categoría, muestra la notificación de actualización y vuelve a la pestaña de categorías fiscales.
- 6.
Resolver errores o bloqueos
Si el sistema rechaza la actualización, conserva los datos introducidos. Revisa permisos, campos obligatorios, porcentaje, país soportado y si la categoría pertenece a un ámbito editable.
Validaciones y límites
- `catalog:view` permite consultar; `catalog:manage` es necesario para guardar.
- Las categorías de sistema son legibles, pero no editables.
- Nombre, Porcentaje y País son obligatorios en el formulario de la app.
- El porcentaje debe poder convertirse a número; el backend valida que esté entre 0 y 100.
- Nombre y descripción se guardan recortados; una descripción vacía se envía como valor opcional.
- El país se selecciona desde los países soportados por el modelo de mercado y se envía en mayúsculas.
- La edición conserva el propietario existente de la categoría; no la mueve entre organización y ubicación.
- Antes de actualizar una categoría editable, el sistema puede congelar snapshots de catálogos del mismo ámbito para preservar servicios ya versionados.
- Si no hay cambios reales, Guardar permanece deshabilitado y no se envía ninguna actualización.
- Si falta organización o ubicación activa para el ámbito abierto, la pantalla no carga el formulario esperado.
Resultado esperado
La categoría fiscal queda actualizada en su ámbito real, las listas y el detalle se refrescan, y los productos que ya apuntan a esa categoría pasan a usar la nueva definición fiscal sin ser reasignados.