Skip to main content
La configuración fiscal controla cómo el sistema clasifica los productos a efectos tributarios y cómo cada punto de venta emite documentos fiscales. Navega a Restaurant OS → Menu & Products → Fiscal Configuration en el backoffice. La página tiene cuatro pestañas: Fiscal groups, Fiscal categories, Product categories y Settings.

​
Categorías Fiscales

Una categoría fiscal identifica un producto a efectos tributarios. Cada producto debe pertenecer a exactamente una categoría fiscal.

​
Ver la lista

Haz clic en la pestaña Fiscal categories para ver todas las categorías de la cuenta seleccionada.
Lista de categorías fiscales
Cada fila muestra:
  • Name — etiqueta interna usada en el backoffice y en la matriz fiscal.
  • NCM — el código de 8 dígitos de la Nomenclatura Comum do Mercosul, obligatorio en los documentos fiscales.
  • Active — indica si la categoría está disponible para asignar a productos.
  • Updated — fecha y hora del último cambio.
Usa la barra de búsqueda para filtrar por nombre o NCM. El filtro All permite mostrar solo las categorías activas o solo las inactivas.

​
Crear una categoría fiscal

  1. Haz clic en + New fiscal category (esquina superior derecha).
  2. Se abre el diálogo de creación.
Diálogo nueva categoría fiscal
  1. Completa los campos:
    • Name — cualquier etiqueta que identifique claramente el tipo de producto (ej. Carne procesada 0210.12).
    • NCM — el código de clasificación de 8 dígitos. Ingresa solo dígitos; los puntos se agregan automáticamente en la visualización.
    • Active — deja el toggle activado para que la categoría pueda asignarse de inmediato.
  2. Haz clic en Save.
La categoría aparece en la lista al instante y queda disponible para asignación a productos y para incluirse en la matriz fiscal de los grupos.
El sistema pre-carga una configuración tributaria predeterminada para cada categoría nueva. Las tasas reales se completan al agregar la categoría a la matriz fiscal de un grupo.

​
Editar una categoría fiscal

Haz clic en View en cualquier fila para abrir el panel de detalle, luego cambia a la pestaña Edit. Modifica Name, NCM o el toggle Active y haz clic en Save.
Cambiar el NCM de una categoría afecta a todos los productos asignados a ella y a todas las entradas de matrices fiscales que la referencian. Verifica el nuevo código antes de guardar.

​
Desactivar una categoría fiscal

Abre la pestaña de edición y desactiva el toggle Active. La categoría deja de aparecer en los selectores de asignación, pero las asignaciones existentes se conservan.

​
Grupos Fiscales

Un grupo fiscal define cómo una o más tiendas facturan las órdenes. Contiene el régimen tributario, la UF (estado brasileño), la lista de tiendas vinculadas y la matriz fiscal que relaciona cada categoría fiscal con los códigos y tasas aplicables.

​
Ver la lista

Haz clic en la pestaña Fiscal groups.
Lista de grupos fiscales
Cada fila muestra Name, External ID, UF y Tax regime. Haz clic en View para abrir el panel de detalle de un grupo.

​
Ver el detalle de un grupo

Panel de detalle del grupo fiscal
El panel de detalle muestra un Summary con:
  • ID — UUID interno.
  • External ID — identificador que usa el motor fiscal.
  • Name, UF, Tax regime — configuración básica del grupo.
  • Stores — las tiendas vinculadas al grupo, mostradas como tarjetas con su ID y nombre.
  • Tax matrix — la lista de categorías fiscales y sus configuraciones. Haz clic en cualquier fila de categoría para expandirla y ver las tasas individuales.
Haz clic en Edit (arriba a la derecha) para modificar el grupo, o en Delete (abajo) para eliminarlo.

​
Crear un grupo fiscal

  1. Haz clic en + New fiscal group (esquina superior derecha de la lista).
  2. Se abre el formulario de creación.
Formulario nuevo grupo fiscal
  1. Completa los campos del encabezado:
    • External ID — el identificador que usa el motor fiscal para reconocer este grupo. Se establece una sola vez; no puede modificarse después de la creación.
    • Name — una etiqueta legible (ej. KFC ABC MARUM (SP)).
    • UF — el código de dos letras del estado brasileño donde se emitirán los documentos (ej. SP).
    • Tax regime — el régimen tributario aplicable (ej. Simples, Lucro Presumido).
  2. En la sección Stores, usa el desplegable Agregar tienda para buscar y seleccionar cada tienda que deba usar este grupo. Cada tienda agregada muestra su ID (vendor.store_number) y nombre. Haz clic en × para quitarla.
  3. Construye la Matriz fiscal (ver más abajo).
  4. Haz clic en Save.

​
Editar un grupo fiscal

Haz clic en View en un grupo y luego en Edit, o navega directamente. El formulario de edición es idéntico al de creación, excepto que External ID está bloqueado.
Formulario editar grupo fiscal
Modifica cualquier campo, agrega o quita tiendas, actualiza la matriz fiscal y haz clic en Save.

​
Eliminar un grupo fiscal

Abre el panel de detalle del grupo y haz clic en Delete al final. Confirma la acción. Las tiendas previamente vinculadas al grupo quedan sin configuración fiscal; la emisión de documentos fiscales fallará hasta que se asignen a otro grupo.

​
Matriz Fiscal

La matriz fiscal es el núcleo de un grupo fiscal. Relaciona cada categoría fiscal con los códigos y tasas de impuestos que aplican a las órdenes emitidas por las tiendas del grupo.

​
Agregar una categoría a la matriz

  1. En el formulario del grupo (creación o edición), desplázate a Tax matrix (JSON).
  2. Usa el desplegable Select category… para encontrar la categoría fiscal.
  3. Haz clic en + Add.
La fila se crea con el campo NCM pre-completado desde la categoría y todas las tasas en 0. Expande la fila y completa los campos según la legislación aplicable.

​
Campos de la matriz

​
Filtrar la matriz

Usa el campo Filter by key code (contains) para buscar una categoría específica dentro de una matriz extensa.

​
Eliminar una categoría de la matriz

Haz clic en Delete en la fila de la categoría. La entrada se elimina solo de este grupo; la categoría fiscal en sí no se ve afectada.
Si la categoría fiscal de un producto no tiene entrada en la matriz del grupo activo, la emisión del documento fiscal fallará para órdenes de las tiendas de ese grupo. Agrega siempre una entrada para cada categoría asignada a productos vendidos en el grupo.

​
Flujos de trabajo habituales

​
Agregar un nuevo tipo de producto en un nuevo estado

  1. Verifica si ya existe una categoría fiscal con el NCM correcto. Si no, créala en la pestaña Fiscal categories.
  2. Verifica si ya existe un grupo fiscal para la UF y el régimen objetivo. Si no, créalo y vincula las tiendas correspondientes.
  3. Agrega la categoría fiscal a la matriz del grupo y completa las tasas correctas.
  4. Asigna la categoría fiscal a los productos en Catálogo → Productos.

​
Mover una tienda a un grupo fiscal diferente

  1. Abre el grupo fiscal actual y haz clic en × junto a la tienda en la lista de Stores. Guarda.
  2. Abre el grupo fiscal nuevo y agrega la tienda. Guarda.
  3. La tienda usará la matriz del nuevo grupo en su próximo documento fiscal.

​
Corregir un NCM incorrecto

  1. Abre la categoría fiscal y actualiza el campo NCM. Guarda.
  2. Abre cada grupo fiscal que incluya esta categoría, expande su entrada en la matriz y verifica el campo NCM. Actualiza si es necesario. Guarda cada grupo.