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_fiscalpara ver e editar perfis fiscais efiscal.perfil_fiscal_homologarpara homologar ou excluir; - permissão
retaguarda.loja_gerenciarpara os dados da loja, o certificado e a aba NFE/NFCe; - permissão
fiscal.configuracaopara salvar a declaração na aba Fiscal; - o arquivo do certificado A1 (
.pfxou.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#
- Abra
Administração > Lojas(ouFiscal > Cadastro fiscal da loja) e clique na loja. - Preencha a aba Dados, com razão social, CNPJ, inscrição estadual, UF e endereço da loja.
- Abra a aba Fiscal e informe Regime federal, CRT e Vale a partir de, conforme a declaração do contador.
- Informe o regime estadual especial, se houver, e responda às cinco perguntas sobre as operações da loja.
- Clique em Salvar declaração fiscal e confira a situação apresentada.
- Abra a aba Certificado e envie o arquivo A1 com a senha.
- 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.
- Salve cada aba. A aba Certificado mostra o resultado da leitura do A1 — titular, CNPJ, emissor, série e vigência.
- 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#
| Campo | O que é | Observação |
|---|---|---|
| Código * | identificador curto da loja | ex.: 001 na matriz, 002 na filial |
| Tipo | Matriz ou Filial | só existe uma matriz por empresa |
| Razão social * | nome jurídico do estabelecimento | informe como consta no CNPJ |
| Nome fantasia | nome de operação | até 60 caracteres |
| Matriz vinculada | a matriz à qual a filial pertence | só aparece quando o tipo é Filial |
| Espelhar preços de (só na criação) | loja de origem dos preços | só vale na criação; depois disso não muda |
| Regime tributário * | regime inicial do cadastro | depois da declaração, o regime é mantido na aba Fiscal |
| CNPJ | CNPJ do estabelecimento | é conferido contra o titular do certificado A1 |
| Inscrição estadual | IE da loja, ou isento | entra no XML fiscal |
| UF * | sigla da unidade federativa | obrigatória; o sistema não presume o estado fiscal |
| Município / Cód. município (IBGE) | município e código IBGE | o código IBGE entra no XML |
| Logradouro, Número, Bairro, CEP | endereço fiscal | lido e gravado junto da configuração fiscal da loja |
| Limite de caixas desta loja | quantos PDVs a loja pode ter | 0 = ilimitado, distribuindo os caixas do plano |
| Logo da loja | imagem PNG/JPG/WebP | identidade visual, não fiscal |
| Loja ativa | se a loja está em operação | loja 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.
| Campo | O que preencher | Regra da tela |
|---|---|---|
| Regime federal * | Simples Nacional, MEI, Lucro Presumido ou Lucro Real | precisa ser compatível com o CRT |
| CRT * | código declarado pelo contador | Simples: 1 ou 2; MEI: 4; Presumido e Real: 3 |
| Vale a partir de * | data em que regime e CRT passaram a valer | não aceita data futura |
| Regime estadual especial (código) | código do benefício ou enquadramento concedido, se houver | deixe vazio quando não houver |
| Ato que concede o regime especial | identificação do ato concessório | obrigatório quando informar regime especial |
| Regime especial: início | início da vigência do ato | obrigatório quando informar regime especial |
| Regime especial: fim | término da vigência, quando houver | nã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 aba | O 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#
| Campo | O que é | Observação |
|---|---|---|
| Certificado A1 (.pfx / .p12) | arquivo do certificado digital | aceita .pfx e .p12 |
| Senha do certificado * | senha do A1 | o 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#
| Campo | O que é | Observação |
|---|---|---|
| Ambiente | Homologação (teste) ou Produção (valendo) | define em que ambiente a loja emite |
| Fuso horário fiscal * | fuso usado no carimbo fiscal | obrigatório; precisa ser um fuso brasileiro válido |
| Série NF-e (modelo 55) | série da NF-e de saída da loja | precisa 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ência | o rótulo sugere 24; o prazo efetivo é o cadastrado aqui |
| Permite contingência offline | se a loja pode emitir NFC-e offline | sem 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
MatrizouFilial, o regime tributário eAtivaouInativa. - 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#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Informe um código curto para identificar a loja (ex.: 001 para matriz, 002 para filial)." | campo Código vazio | preencha o código |
| "Informe o nome da loja antes de salvar." | campo Razão social vazio | preencha a razão social |
| "Tipo de loja deve ser matriz ou filial." | tipo inválido | escolha Matriz ou Filial |
| "Selecione o regime tributário da loja. O sistema não pode presumir o regime fiscal." | Regime tributário vazio | escolha 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.configuracao | peça ao administrador para conferir o acesso de quem fará a declaração |
| "Informe o CRT (1 a 4)." | CRT ausente ou inválido | informe 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 futuro | use a data comprovada da vigência; não antecipe uma declaração futura |
| Regime e CRT incompatíveis | a combinação não corresponde às opções permitidas | confira os dois campos com o contador |
| Regime especial incompleto | código, ato ou início ausente | complete a declaração do ato, ou deixe todos os campos vazios se não houver regime especial |
| Capacidades ainda pendentes | alguma pergunta ficou em Pendente | confira 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 vazia | informe a sigla |
| "Já existe uma loja com esse código, ou já há uma matriz cadastrada." | código repetido ou segunda matriz | corrija o código, ou torne a loja existente filial |
| "Selecione o arquivo do certificado (.pfx/.p12)." | nenhum arquivo escolhido na aba Certificado | selecione o arquivo |
| "Informe a senha do certificado." | senha vazia | informe 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 abrem | reenvie 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 falhou | reenvie o par arquivo + senha |
| "Selecione um fuso horário fiscal brasileiro válido." | fuso fora da lista | escolha 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 0 | informe 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 preenchido | preencha os dois, ou nenhum |
| "Certificado A1 ausente." / "Salve primeiro o certificado A1 na aba Certificado." | tentou salvar CSC sem A1 | salve o certificado primeiro |
| O certificado tem CNPJ diferente do CNPJ da loja | A1 de outro estabelecimento | envie 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:
| Aba | Operação |
|---|---|
| Entrada | compra / entrada de mercadoria |
| Saida estadual | venda dentro do estado |
| Saida interestadual | venda para outro estado |
Passo a passo#
- Abra
Fiscal > Perfis fiscais. - Clique em Novo perfil fiscal.
- Na aba Dados, informe nome, regime tributário, vigência e a fonte da regra.
- 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.
- Salve. O perfil nasce como rascunho e não emite.
- Clique em Homologar e confirme. O sistema revalida tudo contra o catálogo fiscal vigente antes de homologar.
- Se a homologação for recusada, corrija os pontos apontados e homologe de novo.
Campos e o que significam#
Aba Dados#
| Campo | O que é | Observação |
|---|---|---|
| Nome do perfil fiscal * | nome de negócio | ex.: "Bebidas venda varejo" |
| Codigo | código do perfil | gerado pelo nome quando fica vazio |
| Modelo inicial (opcional) | ponto de partida do cadastro | os modelos não trazem CFOP, CST ou alíquota prontos: eles só organizam o cadastro |
| Abrangencia | Toda a empresa ou uma loja | perfil de loja específica aparece marcado como "loja especifica" na lista |
| Regime tributario * | Simples Nacional, Lucro Presumido ou Lucro Real | determina se a operação usa CSOSN ou CST de ICMS |
| Vigente a partir de * | início da vigência | homologar com data futura é recusado |
| Vigente ate | fim da vigência | vazio = sem data de fim |
| Fonte da regra * | de onde veio a regra | ex.: "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.
| Campo | O que é | Observação |
|---|---|---|
| Tabela A * | tabela do catálogo oficial | escolhida na lista do catálogo |
| Tabela B * | tabela do catálogo oficial | escolhida na lista do catálogo |
| Tributo de referencia * | ICMS ou IPI | tributo de referência da operação |
| Base de calculo * | Valor dos produtos ou Valor dos produtos + frete rateado | muda a base do destaque |
| Aliquota (%) * | alíquota do tributo de referência | aceita vírgula ou ponto como decimal |
| CFOP * | código fiscal de operações e prestações | só 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 mercadoria | lista de 0 - Nacional a 8 - Nacional, conteudo de importacao acima de 70% |
| CSOSN * | situação tributária do Simples Nacional | aparece somente quando o regime é Simples Nacional |
| CST ICMS * | situação tributária do ICMS | aparece somente nos regimes Lucro Presumido e Lucro Real |
| Credito do Simples - pCredSN (%) * | alíquota de crédito do Simples | aparece 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 IPI | base e alíquota só aparecem quando o CST escolhido permite alíquota |
| CST PIS *, Base de calculo PIS, Aliquota PIS (%) | grupo do PIS | idem |
| Natureza da receita PIS | natureza da receita do PIS | aparece quando o CST escolhido exige natureza da receita |
| CST COFINS *, Base de calculo COFINS, Aliquota COFINS (%) | grupo do COFINS | idem |
| Natureza da receita COFINS | natureza da receita do COFINS | aparece quando o CST escolhido exige natureza da receita |
| CST IBS/CBS | situação tributária do IBS/CBS | lista do catálogo oficial de IBS/CBS |
| cClassTrib | código de classificação tributária do IBS/CBS | as 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 CBS | ver Reforma tributária |
| Incide Imposto Seletivo | marca incidência de Imposto Seletivo | caixa 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 NacionalparaLucro 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#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O botão Homologar não aparece na linha | falta a permissão fiscal.perfil_fiscal_homologar | peça a permissão ao administrador |
| "sem permissao para homologar tributacoes" | idem, em chamada direta | idem |
| "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 futuro | ajuste a data para hoje ou para uma data passada |
| "Informe o regime tributario da loja antes de homologar a tributacao." | regime tributário vazio | escolha 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 ambiente | acione 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 antiga | escolha 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álogo | escolha 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ção | escolha 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 ST | confirme 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álido | escolha um par que a lista ofereça |
| "O catalogo oficial de cClassTrib esta indisponivel…" | catálogo de cClassTrib não carregado | acione o suporte |
| "sem permissao para excluir" / erro ao excluir perfil já usado | o perfil já foi usado em venda | não exclua: crie uma nova versão |
| A lista mostra o perfil como substituido e ele não abre para edição | perfil é histórico | crie 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émem_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 cadastro | Como a tela mostra | Cor |
|---|---|---|
homologado | homologada | ok |
em_revisao | em revisao | atenção |
inativo | inativo | risco |
substituido | substituido | risco |
| qualquer outro | rascunho | atençã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.
Como conferir que deu certo#
| O que conferir | Onde | O que caracteriza sucesso |
|---|---|---|
| O perfil saiu do rascunho | situação do perfil | etiqueta Homologada, não Rascunho |
| O perfil é o que emite | produtos que usam o perfil | o produto aponta para o perfil homologado, não para a versão substituída |
| O cadastro fiscal da loja fecha | aba NFE/NFCe do cadastro | ambiente, série, CSC e autorizador preenchidos para a UF da loja |
| O CNPJ do certificado é o da loja | cadastro fiscal | o sistema comparou os dois e não avisou divergência |
| A mudança chegou aos produtos | fila fiscal | os produtos que dependiam do perfil antigo voltaram para a fila, como esperado |
| Nada foi alterado por engano | histórico do perfil | a versão nova existe; a que já emitiu continua preservada como estava |