Por que a homologação existe
Antes de aceitar notas com validade fiscal, a prefeitura (ou o Emissor Nacional) precisa comprovar que a integração da sua empresa funciona: certificado correto, credenciais válidas, códigos de serviço aceitos, alíquota no formato certo. Essa prova é a homologação — uma emissão feita no ambiente de teste, que percorre o caminho real de ponta a ponta sem gerar uma nota valendo.
É uma proteção sua: nenhum erro de configuração vira uma nota fiscal real. Por isso, toda empresa nova nasce no ambiente de homologação, e a produção fica bloqueada até a prova acontecer.
O fluxo completo, passo a passo
Cadastre a empresa (Fiscal → Configurações → Cadastrar empresa). Ao concluir, o aviso confirma: “Empresa e perfil fiscal cadastrados para a etapa de homologação.” Na lista, a empresa aparece com o selo homologação pendente.
Emita 1 nota de teste. Vá em Fiscal → Notas fiscais e use “Emitir nota” normalmente (valor e descrição podem ser simbólicos). Na revisão, o painel deixa claro o ambiente: homologação — nota de teste. Essa nota não vale fiscalmente — serve para a prefeitura aprovar a integração.
Aguarde a autorização. A nota de teste passa pelos mesmos estados de uma nota real (processando → autorizada ou com erro). Quando ela é autorizada, o sistema marca a homologação da empresa como concluída automaticamente — você não precisa avisar ninguém.
Troque o ambiente para produção. Abra a empresa (Fiscal → Configurações → toque na empresa) e, na seção Ambiente de emissão, mude de Homologação para Produção. A opção só destrava depois da prova — a dica da tela confirma: “Homologação concluída: a produção pode ser ativada.”
Pronto: as notas valem. A partir daí, cada emissão sai com validade fiscal real, e a revisão de cada nota passa a indicar produção — a nota terá validade fiscal.
A Rita guia cada passo
Você não precisa decorar esse fluxo: nas telas Notas fiscais e Configurações, a Rita mostra um balão por vez, sempre com o próximo passo real da sua empresa — cada balão com um botão que executa o passo:
Antes da primeira nota, eu preparo a sua empresa para emitir. É um cadastro único, guiado passo a passo. → botão Cadastrar empresa;
Falta 1 passo para liberar as notas com validade fiscal: emita uma nota de teste no ambiente de homologação. Ela não vale fiscalmente — serve para a prefeitura aprovar a integração. → botão Emitir nota de teste;
A homologação foi aprovada! Troque o ambiente da empresa para produção e suas notas passam a valer fiscalmente. → botão Trocar para produção;
Sua empresa está no ambiente de produção — as notas saem com validade fiscal. Pode emitir quando precisar. → botão Emitir nota.
Se alguma nota precisar de revisão, o balão de revisão passa na frente e oferece o filtro “ver com erro”.
Cidades sem ambiente de teste: a validação cadastral
Nem toda prefeitura oferece ambiente de homologação. Quando a sua cidade não oferece, o painel avisa desde o cadastro: Esta cidade não oferece nota de teste. O fluxo registra e valida o cadastro, mas não o chama de homologado. Nesse caso:
o lugar da homologação é ocupado pela validação cadastral — o cadastro é enviado e validado sem nota de teste;
ao ativar a produção, o painel exige uma confirmação explícita: o interruptor “Ativar produção sem nota de teste”, deixando claro que as próximas notas poderão ter validade fiscal real.
Onde ver em que pé está
Na tela Configurações, cada empresa carrega um selo honesto: emissão pronta, homologação pendente, validação cadastral, atenção (ex.: certificado expirado) ou inativa. A mesa Fiscal usa a mesma régua — a mesma empresa nunca tem dois diagnósticos.
Dentro da empresa, a aba Configuração lista as pendências em português: “Conclua uma emissão autorizada em homologação.”, “Crie e confirme um perfil fiscal para a empresa.”, entre outras.
As notas de teste ficam no extrato com o ambiente homologação indicado — e nunca somam no faturamento: o resumo fiscal filtra pelo ambiente da empresa, então nota de teste jamais aparece como receita real.
O que faz a homologação recomeçar
A prova vale para a configuração que foi provada. Se o contrato fiscal muda, a prova anterior deixa de valer e a empresa volta para homologação (ou validação cadastral) — o painel avisa antes de salvar: Validação fiscal será reiniciada: as regras principais mudaram. Reiniciam a homologação:
trocar o município, o trilho (municipal ↔ nacional), o regime tributário, o modo de configuração ou a inscrição municipal;
enviar um novo certificado A1 ou novas credenciais da prefeitura;
salvar um perfil fiscal ou usar “usar como padrão” em outro perfil — o perfil que vale nas notas mudou, então a prova é refeita.
Em todos os casos, o caminho de volta é o mesmo: emitir uma nova nota de teste e, autorizada, reativar a produção.
Problemas comuns
O que aparece | Por que acontece | O que fazer |
“A produção fica bloqueada até uma emissão de homologação ser confirmada.” | Ainda não existe nota de teste autorizada para a configuração atual. | Emita a nota de teste e aguarde a autorização; depois volte à empresa e troque o ambiente. |
A nota de teste terminou com erro | A prefeitura recusou a emissão — normalmente um dado do perfil (código, alíquota) ou do acesso (certificado, senha). | Abra a nota: a ocorrência vem explicada, com um botão que leva direto ao conserto (revisar o perfil, revisar o acesso). Corrija e emita outra nota de teste. |
A nota de teste foi autorizada, mas a empresa continua “homologação pendente” | A configuração fiscal mudou depois daquela emissão — a prova antiga não vale para a configuração nova. | Emita uma nova nota de teste com a configuração atual. |
“Aguarde a validação do cadastro antes de ativar produção; esta cidade não oferece nota de teste.” | Sua cidade usa validação cadastral e ela ainda não foi concluída. | Aguarde; a pendência some da lista quando a validação termina. |
“Confirme que deseja ativar a produção sem emitir uma nota de teste.” | Cidade sem ambiente de teste exige a confirmação explícita. | Ligue o interruptor “Ativar produção sem nota de teste” e salve. |
O balão da Rita não aparece | Os guias de ação aparecem só para o titular da conta, e somem quando há filtros ativos na tela. | Entre como titular e limpe os filtros; o fluxo continua disponível pelas telas normais. |