Pular para conteúdo

Classificação fiscal

Tela do Telvora ERP — Classificação fiscal

Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.

Módulo: Fiscal
Menu: Operações → Fiscal → Tributação
Público: Operador fiscal / Comercial
Status: Publicado
Atualizado: 2026-09-08
Refs técnicas: 01-ARQUITETURA/23-classificacao-fiscal.md · ADR (S14 espelho IXC)

O que faz

Cadastro do grupo tributário (classificação fiscal) usado nos produtos. Na edição, o formulário segue abas no estilo do IXC:

  1. Principal — operação, tipo (ICMS/ISSQN/NT), CFOP, NCM, ICMS, ISS, PIS/COFINS, FUST/FUNTTEL/SPED
  2. Retenções — IRRF (CX/CP), CSLL, INSS, retenções de PIS/COFINS/ISS
  3. CBS/IBS — forma, código de classificação (lista sincronizada), CST, BC, redução, códigos nacional/municipal/NBS
  4. ICMS por UF — regras por origem/destino (somente após salvar a classificação)
  5. Por operação — regras por CFOPs/NCM
  6. ISSQN município — alíquotas por município

Quem pode usar

  • fiscal.tax_classification.read
  • fiscal.tax_classification.create
  • fiscal.tax_classification.update

Pré-requisitos

  • CFOP cadastrado (recomendado) para selecionar nos campos CFOP / interestadual.
  • Códigos CBS/IBS sincronizados para o select da aba CBS/IBS (opcional).
  • Produto vinculado usa esta classificação para herdar o tipo de tributação.

Passo a passo

  1. Abra Operações → Fiscal → Tributação. A lista tem paginação (Anterior / Próxima).
  2. Clique Novo ou dê duplo clique em uma linha. A grade some; o formulário (abas) ocupa a tela. Salvar ou Cancelar devolve a grade.
  3. Na aba Principal, CFOP e CFOP interestadual são autocompletar (digite o código) com lupa para buscar na tabela completa — não é um select limitado.
  4. Preencha a aba Principal e salve.
  5. Nas abas Retenções e CBS/IBS, complete os campos da reforma / retenção e salve de novo.
  6. Nas abas ICMS por UF, Por operação e ISSQN município: a grade da aba some ao clicar Novo ou Editar; Salvar / Cancelar da regra devolve a grade da aba. Na operação, use a lupa de CFOP para o primeiro código da lista CSV.
  7. Vincule a classificação no cadastro do produto.

Regras importantes

  • Tipo de tributação: ICMS, ISSQN ou NT (não tributado).
  • Abas de regras filhas só aparecem depois que a classificação já existe (modo edição).
  • No produto, ao escolher a classificação, o campo ICMS/ISSQN fica somente leitura — a tributação vem do grupo.
  • Se o produto não tiver NCM e a classificação tiver, o NCM é copiado automaticamente.

Sync (TI / deploy)

php artisan telvora:sync-cfop-br --tenant=core3
php artisan telvora:sync-cbs-ibs-codes --tenant=core3
php artisan telvora:sync-tax-classifications-ixc --tenant=core3

Erros / avisos comuns

Mensagem / situação O que fazer
Código já cadastrado Não altere o código; edite a classificação existente
Sem CFOP na lista Cadastre/sincronize CFOPs em Fiscal → CFOP
Select CBS/IBS vazio Rode telvora:sync-cbs-ibs-codes
Abas UF/operação/ISS ausentes Salve a classificação primeiro (nova → edição)

Relacionados

Referências