Ir para o conteúdo
clabor Manual do ERPia

Perfis fiscais e cadastro fiscal da loja#

Esta página resolve duas coisas que precisam estar prontas antes de qualquer emissão: a identidade fiscal de cada loja (CNPJ, UF, regime, certificado, ambiente, série, CSC) e a tributação que a loja pratica em cada operação. Quem opera: o responsável fiscal ou o contador, com o responsável da loja para os dados cadastrais.

Antes de começar — você precisa de:

  • permissão fiscal.perfil_fiscal para ver e editar perfis fiscais e fiscal.perfil_fiscal_homologar para homologar ou excluir;
  • permissão retaguarda.loja_gerenciar para os dados da loja, o certificado e a aba NFE/NFCe;
  • permissão fiscal.configuracao para salvar a declaração na aba Fiscal;
  • o arquivo do certificado A1 (.pfx ou .p12) e a senha dele em mãos;
  • o ID token e o CSC da NFC-e, se a loja emite NFC-e;
  • a orientação do contador sobre CST, CSOSN, CFOP e alíquotas aplicáveis.

Parte 1 — Cadastro fiscal da loja#

O caminho de menu Fiscal > Cadastro fiscal da loja e Administração > Certificado A1 abrem a lista de lojas; a ficha tem quatro abas: Dados, Fiscal, Certificado e NFE/NFCe.

Passo a passo#

  1. Abra Administração > Lojas (ou Fiscal > Cadastro fiscal da loja) e clique na loja.
  2. Preencha a aba Dados, com razão social, CNPJ, inscrição estadual, UF e endereço da loja.
  3. Abra a aba Fiscal e informe Regime federal, CRT e Vale a partir de, conforme a declaração do contador.
  4. Informe o regime estadual especial, se houver, e responda às cinco perguntas sobre as operações da loja.
  5. Clique em Salvar declaração fiscal e confira a situação apresentada.
  6. Abra a aba Certificado e envie o arquivo A1 com a senha.
  7. Abra a aba NFE/NFCe e defina ambiente, fuso horário fiscal, série da NF-e (modelo 55), prazo de contingência e, se houver NFC-e, o ID token e o CSC.
  8. Salve cada aba. A aba Certificado mostra o resultado da leitura do A1 — titular, CNPJ, emissor, série e vigência.
  9. Confira se o CNPJ do certificado confere com o CNPJ da loja: o sistema compara os dois e avisa quando divergem.

Campos e o que significam#

Aba Dados#

CampoO que éObservação
Código *identificador curto da lojaex.: 001 na matriz, 002 na filial
TipoMatriz ou Filialsó existe uma matriz por empresa
Razão social *nome jurídico do estabelecimentoinforme como consta no CNPJ
Nome fantasianome de operaçãoaté 60 caracteres
Matriz vinculadaa matriz à qual a filial pertencesó aparece quando o tipo é Filial
Espelhar preços de (só na criação)loja de origem dos preçossó vale na criação; depois disso não muda
Regime tributário *regime inicial do cadastrodepois da declaração, o regime é mantido na aba Fiscal
CNPJCNPJ do estabelecimentoé conferido contra o titular do certificado A1
Inscrição estadualIE da loja, ou isentoentra no XML fiscal
UF *sigla da unidade federativaobrigatória; o sistema não presume o estado fiscal
Município / Cód. município (IBGE)município e código IBGEo código IBGE entra no XML
Logradouro, Número, Bairro, CEPendereço fiscallido e gravado junto da configuração fiscal da loja
Limite de caixas desta lojaquantos PDVs a loja pode ter0 = ilimitado, distribuindo os caixas do plano
Logo da lojaimagem PNG/JPG/WebPidentidade visual, não fiscal
Loja ativase a loja está em operaçãoloja não é apagada: é desativada e o histórico fiscal fica preservado

Aba Fiscal#

Esta aba registra a declaração do contador sobre o regime e as operações desta loja. Ela não substitui o certificado, a configuração de emissão ou os perfis fiscais dos produtos.

CampoO que preencherRegra da tela
Regime federal *Simples Nacional, MEI, Lucro Presumido ou Lucro Realprecisa ser compatível com o CRT
CRT *código declarado pelo contadorSimples: 1 ou 2; MEI: 4; Presumido e Real: 3
Vale a partir de *data em que regime e CRT passaram a valernão aceita data futura
Regime estadual especial (código)código do benefício ou enquadramento concedido, se houverdeixe vazio quando não houver
Ato que concede o regime especialidentificação do ato concessórioobrigatório quando informar regime especial
Regime especial: inícioinício da vigência do atoobrigatório quando informar regime especial
Regime especial: fimtérmino da vigência, quando houvernão pode ser anterior ao início

O registro de um regime especial nesta aba declara sua existência. O efeito nos itens depende de uma exceção fiscal homologada.

Operações praticadas pela loja

Cada pergunta oferece Pendente (ainda não informado), Pratica e Não pratica. Escolha conforme as operações reais da loja e a orientação do contador. Pendente não equivale a Não pratica.

Pergunta da abaO que declarar
Emite NF-e de venda (B2B)?se a loja realiza essa emissão
Vende para outro estado (NF-e com entrega fora da UF)?se realiza vendas com entrega em outra UF
Escritura as notas de entrada (crédito de ICMS, PIS e COFINS)?se realiza essa escrituração
Importa, compra importado por encomenda ou industrializa (equiparado a industrial, IPI)?se pratica alguma dessas operações
Fabrica ou importa bens sujeitos ao Imposto Seletivo?se pratica essa fabricação ou importação

Clique em Salvar declaração fiscal. Reabra a aba e confira regime, CRT, data e respostas. A mensagem de situação mostra a declaração e a quantidade de capacidades ainda pendentes.

Se aparecer um aviso sobre CRT 2 ou 4 e a atualização do PDV, encaminhe-o ao suporte antes de considerar a configuração concluída. O aviso distingue o comportamento da NF-e do comportamento da NFC-e no caixa.

Aba Certificado#

CampoO que éObservação
Certificado A1 (.pfx / .p12)arquivo do certificado digitalaceita .pfx e .p12
Senha do certificado *senha do A1o aviso da aba diz: a senha nunca é exibida e só é aberta em memória durante uma operação fiscal

Depois de salvar, a aba mostra a leitura do certificado: titular, CNPJ, emissor, número de série e vigência.

Aba NFE/NFCe#

CampoO que éObservação
AmbienteHomologação (teste) ou Produção (valendo)define em que ambiente a loja emite
Fuso horário fiscal *fuso usado no carimbo fiscalobrigatório; precisa ser um fuso brasileiro válido
Série NF-e (modelo 55)série da NF-e de saída da lojaprecisa ser maior que zero. Não é a série da NFC-e: a série da NFC-e é de cada PDV, para separar as faixas de numeração de cada caixa
Prazo contingência (h)horas de prazo de envio da nota emitida em contingênciao rótulo sugere 24; o prazo efetivo é o cadastrado aqui
Permite contingência offlinese a loja pode emitir NFC-e offlinesem isso a contingência fica bloqueada no caixa
ID token CSC (somente NFC-e)identificador do CSC"não é usado na NF-e"
CSC (somente NFC-e)código de segurança do contribuinte"não é usado na NF-e"

Os dados cadastrais vêm da aba Dados. Regime federal, CRT e operações vêm da aba Fiscal. O certificado vem da aba Certificado, e o CSC só é necessário para NFC-e.

Resultado esperado#

  • A lista de lojas mostra a loja com as etiquetas Matriz ou Filial, o regime tributário e Ativa ou Inativa.
  • A aba Certificado mostra o titular, o CNPJ formatado, o emissor, o número de série, a vigência e uma mensagem de situação dizendo que o CNPJ foi conferido com a loja e que certificado e senha estão disponíveis para operações fiscais.
  • A aba NFE/NFCe mostra o ambiente escolhido e, quando há CSC salvo para o ambiente corrente, o status informa "CSC configurado para este ambiente".
  • A aba Fiscal mostra a declaração gravada. Confira também os avisos de vigência, CRT e capacidades pendentes.
  • Salvar as abas não comprova sozinho que a emissão está liberada. Uma loja sem matriz cadastrada aparece com o aviso "Nenhuma matriz cadastrada — defina a matriz para o fiscal funcionar".

Se algo der errado#

SintomaCausa provávelO que fazer
"Informe um código curto para identificar a loja (ex.: 001 para matriz, 002 para filial)."campo Código vaziopreencha o código
"Informe o nome da loja antes de salvar."campo Razão social vaziopreencha a razão social
"Tipo de loja deve ser matriz ou filial."tipo inválidoescolha Matriz ou Filial
"Selecione o regime tributário da loja. O sistema não pode presumir o regime fiscal."Regime tributário vazioescolha o regime da loja
"Somente quem tem a permissão de configuração fiscal declara o regime e o CRT da loja."falta a permissão fiscal.configuracaopeça ao administrador para conferir o acesso de quem fará a declaração
"Informe o CRT (1 a 4)."CRT ausente ou inválidoinforme o CRT declarado pelo contador
"A data nao pode ser futura. Declare a mudanca no dia em que ela passar a valer."Vale a partir de está no futurouse a data comprovada da vigência; não antecipe uma declaração futura
Regime e CRT incompatíveisa combinação não corresponde às opções permitidasconfira os dois campos com o contador
Regime especial incompletocódigo, ato ou início ausentecomplete a declaração do ato, ou deixe todos os campos vazios se não houver regime especial
Capacidades ainda pendentesalguma pergunta ficou em Pendenteconfira as operações da loja e preencha a resposta correta
"Informe a UF da loja. O sistema não pode presumir o estado fiscal."UF vaziainforme a sigla
"Já existe uma loja com esse código, ou já há uma matriz cadastrada."código repetido ou segunda matrizcorrija o código, ou torne a loja existente filial
"Selecione o arquivo do certificado (.pfx/.p12)."nenhum arquivo escolhido na aba Certificadoselecione o arquivo
"Informe a senha do certificado."senha vaziainforme a senha do A1
"O A1 armazenado não pôde ser validado: … Reenvie o arquivo e a senha para substituir o cadastro inválido."arquivo ou senha não abremreenvie o par arquivo + senha
"O registro do certificado existe, mas a leitura segura no banco falhou. Reenvie o arquivo A1 e a senha…"leitura do segredo falhoureenvie o par arquivo + senha
"Selecione um fuso horário fiscal brasileiro válido."fuso fora da listaescolha um fuso brasileiro da lista
"A série da NFC-e deve ser maior que zero."Série NF-e (modelo 55) em branco ou 0informe a série da NF-e. Ver a divergência de rótulo abaixo
"Informe o ID token e o CSC juntos."só um dos dois campos preenchidopreencha os dois, ou nenhum
"Certificado A1 ausente." / "Salve primeiro o certificado A1 na aba Certificado."tentou salvar CSC sem A1salve o certificado primeiro
O certificado tem CNPJ diferente do CNPJ da lojaA1 de outro estabelecimentoenvie o A1 do CNPJ desta loja

Divergência conhecida#

A mensagem de validação da série diz "A série da NFC-e deve ser maior que zero.", mas o campo que ela valida é rotulado "Série NF-e (modelo 55)" e o próprio código registra que a série da NFC-e é de cada PDV, não da loja. Ao ver esse erro, o campo a corrigir é o da NF-e (modelo 55) — a série da NFC-e se ajusta no cadastro do caixa.


Parte 2 — Perfis fiscais#

Um perfil fiscal é a regra da sua empresa para uma combinação de regime tributário × operação. Ele vale para toda a empresa ou para uma loja específica, tem vigência e precisa ser homologado antes de valer. Perfil em rascunho não emite.

As três operações obrigatórias#

Toda tributação é configurada três vezes, uma por operação. As três abas são obrigatórias antes da homologação:

AbaOperação
Entradacompra / entrada de mercadoria
Saida estadualvenda dentro do estado
Saida interestadualvenda para outro estado

Passo a passo#

  1. Abra Fiscal > Perfis fiscais.
  2. Clique em Novo perfil fiscal.
  3. Na aba Dados, informe nome, regime tributário, vigência e a fonte da regra.
  4. Percorra as abas Entrada, Saida estadual e Saida interestadual; em cada uma escolha Tabela A, Tabela B, CFOP, origem, CST/CSOSN e as alíquotas aplicáveis.
  5. Salve. O perfil nasce como rascunho e não emite.
  6. Clique em Homologar e confirme. O sistema revalida tudo contra o catálogo fiscal vigente antes de homologar.
  7. Se a homologação for recusada, corrija os pontos apontados e homologe de novo.

Campos e o que significam#

Aba Dados#

CampoO que éObservação
Nome do perfil fiscal *nome de negócioex.: "Bebidas venda varejo"
Codigocódigo do perfilgerado pelo nome quando fica vazio
Modelo inicial (opcional)ponto de partida do cadastroos modelos não trazem CFOP, CST ou alíquota prontos: eles só organizam o cadastro
AbrangenciaToda a empresa ou uma lojaperfil de loja específica aparece marcado como "loja especifica" na lista
Regime tributario *Simples Nacional, Lucro Presumido ou Lucro Realdetermina se a operação usa CSOSN ou CST de ICMS
Vigente a partir de *início da vigênciahomologar com data futura é recusado
Vigente atefim da vigênciavazio = sem data de fim
Fonte da regra *de onde veio a regraex.: "Matriz revisada pelo contador em 21/07/2026". É exigida para homologar

Campos repetidos nas três abas de operação#

Cada uma das três abas tem os mesmos 27 campos.

CampoO que éObservação
Tabela A *tabela do catálogo oficialescolhida na lista do catálogo
Tabela B *tabela do catálogo oficialescolhida na lista do catálogo
Tributo de referencia *ICMS ou IPItributo de referência da operação
Base de calculo *Valor dos produtos ou Valor dos produtos + frete rateadomuda a base do destaque
Aliquota (%) *alíquota do tributo de referênciaaceita vírgula ou ponto como decimal
CFOP *código fiscal de operações e prestaçõessó entram CFOPs do catálogo oficial compatíveis com a aba: a Entrada aceita CFOP de entrada; Saida estadual aceita saída interna; Saida interestadual aceita saída interestadual
Origem da mercadoria (0-8)origem da mercadorialista de 0 - Nacional a 8 - Nacional, conteudo de importacao acima de 70%
CSOSN *situação tributária do Simples Nacionalaparece somente quando o regime é Simples Nacional
CST ICMS *situação tributária do ICMSaparece somente nos regimes Lucro Presumido e Lucro Real
Credito do Simples - pCredSN (%) *alíquota de crédito do Simplesaparece apenas nos CSOSN que o catálogo marca como "com permissão de crédito"
CST IPI, Base de calculo IPI, Aliquota IPI (%)grupo do IPIbase e alíquota só aparecem quando o CST escolhido permite alíquota
CST PIS *, Base de calculo PIS, Aliquota PIS (%)grupo do PISidem
Natureza da receita PISnatureza da receita do PISaparece quando o CST escolhido exige natureza da receita
CST COFINS *, Base de calculo COFINS, Aliquota COFINS (%)grupo do COFINSidem
Natureza da receita COFINSnatureza da receita do COFINSaparece quando o CST escolhido exige natureza da receita
CST IBS/CBSsituação tributária do IBS/CBSlista do catálogo oficial de IBS/CBS
cClassTribcódigo de classificação tributária do IBS/CBSas opções vêm em pares CST / cClassTrib; a lista é filtrada para o documento NF-e
Aliquota IBS estadual (%), Aliquota IBS municipal (%), Aliquota CBS (%)alíquotas do IBS e da CBSver Reforma tributária
Incide Imposto Seletivomarca incidência de Imposto Seletivocaixa de seleção

Duas regras de comportamento que evitam erro silencioso:

  • Quando um campo deixa de se aplicar (por exemplo, trocar o regime de Simples Nacional para Lucro Real), o valor antigo é limpo. Sem isso, o CSOSN do regime anterior continuaria sendo reenviado escondido e travaria a homologação.
  • Os campos de alíquota, base e natureza de receita aparecem conforme o catálogo, não conforme uma lista fixa na tela.

Filtros e o que a lista mostra#

Chips da lista: Todas, Rascunhos, Em revisao, Homologadas, Simples, Presumido, Real. Os cartões de topo são Perfis fiscais, Homologadas ("prontas para sombra"), Em revisao ("com contador") e Rascunhos ("nao emitem").

Cada perfil na lista mostra o status (homologada, em revisao, rascunho, inativo ou substituido), a etiqueta de cada CFOP preenchido, o regime por extenso e a vigência, mais "loja especifica" ou "toda a empresa".

Resultado esperado#

  • O perfil aparece na lista com a etiqueta homologada em verde.
  • O cartão Homologadas passa a contá-lo.
  • O resumo da tela diz que "os perfis fiscais homologados podem ser avaliados em sombra. Nenhum deles troca a emissao atual ate o corte fiscal ser validado".
  • As ações Homologar e Excluir desaparecem da linha quando você não tem fiscal.perfil_fiscal_homologar.

Se algo der errado#

SintomaCausa provávelO que fazer
O botão Homologar não aparece na linhafalta a permissão fiscal.perfil_fiscal_homologarpeça a permissão ao administrador
"sem permissao para homologar tributacoes"idem, em chamada diretaidem
"A homologacao futura ainda nao e suportada: os catalogos fiscais precisam ser revalidados na data em que o perfil entrar em vigor."Vigente a partir de está no futuroajuste a data para hoje ou para uma data passada
"Informe o regime tributario da loja antes de homologar a tributacao."regime tributário vazioescolha o regime
"O catalogo fiscal oficial esta indisponivel. Mantenha a tributacao em rascunho ate a fonte ser carregada."catálogo fiscal não carregado no ambienteacione o suporte; não homologe no escuro
"A tabela A informada para \<operação\> nao existe no catalogo fiscal oficial vigente."Tabela A/B digitada ou de versão antigaescolha de novo na lista do catálogo
"O CFOP \<código\> nao pertence ao catalogo operacional vigente para \<operação\>."CFOP incompatível com a aba (sentido/abrangência) ou fora do catálogoescolha um CFOP da lista da própria aba
"O CST informado nao existe no catalogo fiscal vigente para \<operação\>."CST/CSOSN que não existe para aquela operaçãoescolha na lista
"O CST \<código\> nao determina com seguranca se a operacao usa substituicao tributaria. Mantenha a tributacao em rascunho…"o catálogo não classifica o CST quanto a STconfirme a classificação com o contador antes de homologar
"A combinacao CST IBS/CBS \<CST\> e cClassTrib \<código\> nao existe no catalogo oficial publicado para NFe em \<operação\>."par CST + cClassTrib inválidoescolha um par que a lista ofereça
"O catalogo oficial de cClassTrib esta indisponivel…"catálogo de cClassTrib não carregadoacione o suporte
"sem permissao para excluir" / erro ao excluir perfil já usadoo perfil já foi usado em vendanão exclua: crie uma nova versão
A lista mostra o perfil como substituido e ele não abre para ediçãoperfil é históricocrie um perfil novo

Perfis com aceite herdado da migração#

A aprovação herdada declarada pelo dono pode resultar em uma tributação homologada no modelo normal do ERPia. Na ficha do produto, a opção apresenta (aceite herdado). O campo Aceite herdado da migração explica a origem e a vigência do vínculo. Não é necessário repetir a homologação dos mesmos dados apenas pela troca de sistema.

Um agrupador da importação com aprovação herdada não é uma tributação pronta para seleção. Se a ficha mostrar essa mensagem, a equipe de migração deve disponibilizar os perfis correspondentes. Não homologue esse agrupador nem altere sua abrangência para liberar a seleção.

Como funciona por dentro#

  • O status não é escolhido por quem edita: ele é derivado do que está gravado. Editar um perfil homologado o devolve para em_revisao; editar de novo mantém em_revisao.
  • A lista não pergunta se o perfil já vendeu. Essa checagem acontece no ato de excluir, onde a linha está travada.
  • Um perfil substituído não é editável, e um perfil homologado só é editável por quem tem a permissão de homologar.

Perfil não homologado não emite — o sistema bloqueia. Não importa o rótulo: qualquer status diferente de homologada (inativo, substituido, em_revisao, rascunho) é recusado na resolução fiscal, com a mensagem "A tributacao selecionada ainda nao foi homologada." e a ação "Peça ao contador ou administrador fiscal para revisar e homologar a regra.". O mesmo resolvedor ainda recusa perfil de outro regime e perfil de outra loja.

Na lista, os status aparecem assim:

Status no cadastroComo a tela mostraCor
homologadohomologadaok
em_revisaoem revisaoatenção
inativoinativorisco
substituidosubstituidorisco
qualquer outrorascunhoatenção

Conclusão prática: um perfil inativo ou substituido continua visível na lista, mas não emite — nem por engano. Se a emissão falha com "não foi homologada", o problema é o status do perfil, não o produto.

Divergência conhecida#

O projeto de conformidade fiscal do Clabor registra um redesenho não implementado para esta tela: 89 campos hoje, com proposta de manter apenas o ICMS por operação e mover PIS/COFINS, IBS/CBS, IPI, origem, Tabela A/B e pCredSN para outros lugares, renomeando as abas para "Compras (entrada)", "Venda no estado" e "Venda para outro estado". Nada disso está no produto descrito acima: as abas continuam Entrada, Saida estadual e Saida interestadual.

CICLO DE VIDA DO PERFIL FISCAL Rascunho Editável à vontade. Homologar Homologada Esta é a que emite. usar em venda Imutável — só nova versão "ja foi usado em venda emitida; nao pode ser alterado" editar tributação homologada Produtos voltam para a fila fiscal Efeito em cascata e imediato. Inativo · Substituído Visível na lista, mas não emite. O status não muda por edição: homologar é ação própria, com a permissão fiscal.perfil_fiscal_homologar.
Perfil fiscal: rascunho, homologada, e imutável depois de emitir. Inativo e substituído não emitem.

Como conferir que deu certo#

O que conferirOndeO que caracteriza sucesso
O perfil saiu do rascunhosituação do perfiletiqueta Homologada, não Rascunho
O perfil é o que emiteprodutos que usam o perfilo produto aponta para o perfil homologado, não para a versão substituída
O cadastro fiscal da loja fechaaba NFE/NFCe do cadastroambiente, série, CSC e autorizador preenchidos para a UF da loja
O CNPJ do certificado é o da lojacadastro fiscalo sistema comparou os dois e não avisou divergência
A mudança chegou aos produtosfila fiscalos produtos que dependiam do perfil antigo voltaram para a fila, como esperado
Nada foi alterado por enganohistórico do perfila versão nova existe; a que já emitiu continua preservada como estava