Antes da primeira emissão, habilite o CNPJ no Portal GNRE, confira o certificado digital e prepare os códigos aceitos pela UF favorecida. Depois disso, o Mestre pode iniciar a guia a partir da NF-e, reaproveitando os dados do documento e os valores dos impostos. Resumo Ativar a automação no Portal GNRE é apenas uma parte da preparação. O e-CNPJ usado pelo Mestre deve estar habilitado no portal, o certificado e o ambiente da DFe precisam estar configurados, o parâmetro de geração automática deve estar ativo, as receitas permitidas para cada UF devem estar atualizadas e os dados do Contas a Pagar precisam ser preenchidos. A guia sempre deve ser conferida antes da transmissão, pois uma GNRE já emitida não possui cancelamento manual no portal. |
Dados financeiros obrigatórios: ao finalizar a GNRE, o Mestre alimenta o Contas a Pagar. Informe a data de pagamento, escolha o compromisso e preencha todos os campos habilitados para ele. Conforme o compromisso selecionado, o sistema exigirá Caixa, Banco e Conta ou, no pagamento com cheque, Banco, Conta, número e vencimento do cheque. Sem essas informações, a gravação ou a finalização é bloqueada. |
Importante — não existe cancelamento manual de GNRE emitida: segundo o Portal GNRE, as guias emitidas e não pagas são canceladas pelo próprio sistema. Se a guia saiu errada e ainda não foi paga, descarte-a e gere outra com os dados corretos. O cancelamento automático da guia não elimina um tributo efetivamente devido: quando houver imposto a recolher, emita e pague a guia correta. |
Visão rápida- Portal: habilite para o Web Service o mesmo CNPJ existente no certificado digital usado pelo Mestre.
- Mestre: configure certificado e ambiente da DFe e ative a geração automática na finalização da NF-e.
- Emissão: confira código da receita, UF, documento, vencimento, valores, campos exigidos e dados do Contas a Pagar; depois use F10 - Finalizar.
- Correção: se uma guia emitida estiver errada e não tiver sido paga, não procure uma opção de cancelamento no portal; gere outra corretamente.
1. Prepare o acesso ao Portal GNRENa área Automação do Portal GNRE, solicite o uso do Web Service para o CNPJ responsável pela transmissão. Faça os testes em homologação e, depois da validação, solicite o acesso de produção. | Situação do certificado | O que habilitar no portal |
|---|
| Matriz e filiais usam o mesmo e-CNPJ da matriz | Cadastre o CNPJ contido nesse certificado. | | Cada filial transmite com o próprio e-CNPJ | Cadastre cada CNPJ que será usado para assinar e transmitir. |
O certificado deve ser ICP-Brasil, do tipo A1 ou A3, conter o CNPJ do titular e estar válido. Ativar outro CNPJ no portal não libera o certificado que efetivamente assina a transmissão. 2. Confira as configurações no MestreA GNRE utiliza as mesmas configurações da DFe para certificado, ambiente, comunicação segura, tempo de espera, tentativas e pasta de XML. - Abra Certificados Digitais e confirme validade, titular e acesso ao certificado.
- Abra Documentos fiscais eletrônicos - Configuração e confira o ambiente: use homologação para testes e produção somente para guias válidas.
- Em Parâmetros → Finalização, marque Gerar GNRE automaticamente após a transmissão da nota fiscal.
- Confirme que a estação possui acesso à internet.
3. Valide os códigos usados na emissãoO Mestre usa receitas padrão para iniciar as guias mais comuns da NF-e. A disponibilidade de cada receita continua dependendo da configuração oficial da UF favorecida. | Código | Descrição | Uso no Mestre |
|---|
| 10009-9 | ICMS Substituição Tributária por Operação | Receita padrão da automação de ICMS-ST da NF-e. | | 10010-2 | ICMS Consumidor Final não Contribuinte de Outra UF por Operação | Receita padrão da automação de DIFAL da NF-e. | | 10012-9 | ICMS Fundo Estadual de Combate à Pobreza por Operação | Receita padrão da automação de FCP da NF-e. | | 10003-0 | ICMS Transporte | Receita utilizada na GNRE originada de CT-e quando o imposto do frete é devido. | | 10015-3 | ICMS Monofásico por Operação | Disponível no portal para AL, BA, DF, MT, PA e TO; use somente quando a operação exigir. | | 10016-1 | ICMS Monofásico por Apuração | Disponível no portal para AL, BA, DF, MT, PA, PE, RO e TO; use somente quando a apuração exigir. |
Para conferir as permissões no Mestre, abra GNRE - Guia Nacional de Recolhimento Estadual e use a opção Alterar permissões de Receita, Tipo de documento e Detalhamento para o Estado. Se o portal exibir um código que não aparece no Mestre, não substitua por outro: solicite a atualização do catálogo. Como o Mestre faz Após a autorização da NF-e, o Mestre verifica se existem valores de ICMS-ST, ICMS para consumidor final de outra UF ou FCP. Quando encontra valor e receita padrão correspondente, inicia a GNRE e abre a tela para conferência. A automação não paga nem transmite silenciosamente a guia. O operador ainda precisa conferir os dados, preencher os campos exigidos pela UF e completar o bloco Contas a pagar antes de usar F10 - Finalizar. A finalização bem-sucedida sempre chama o lançamento financeiro; o Mestre grava o retorno, permite imprimir ou exportar o PDF e alimenta o Contas a Pagar com os dados informados. |
4. Confira e finalize a guia- Na NF-e, abra a guia GNRE. Para uma guia avulsa, procure no menu por GNRE - Guia Nacional de Recolhimento Estadual.
- Confira destinatário, UF favorecida, receita e valor principal.
- Confira detalhamento, produto, tipo e número do documento de origem. Quando permitido pela UF, o Mestre utiliza a chave da NF-e.
- Informe período e ano de referência, vencimento e data de pagamento. A data de pagamento é obrigatória.
- Preencha os campos adicionais marcados como obrigatórios para aquela UF e receita.
- No bloco Contas a pagar, selecione obrigatoriamente o Compromisso e complete todos os campos que o Mestre habilitar para ele: Caixa; Banco e Conta; ou Banco, Conta, Cheque e Vencimento. Informe também Despesa e Centro de custo para compor o rateio financeiro.
- Grave e pressione F10 - Finalizar. Se o lote ficar em processamento, use Consultar situação da GNRE antes de tentar emitir outra guia.
5. Corrija ou substitua uma guia com segurançaA FAQ oficial do Portal GNRE informa que não existe opção para cancelar uma guia emitida. Use a orientação correspondente à situação: | Situação | Procedimento |
|---|
| Guia errada e ainda não paga | Não há cancelamento manual no portal. A guia não paga será cancelada pelo próprio sistema; gere outra com os dados corretos. | | Lote processado, mas não pago | O lote também não pode ser cancelado. As guias não pagas serão canceladas pelo sistema e, segundo o portal, não geram obrigação por sua simples emissão. | | Guia vencida que ainda precisa ser paga | Gere outra guia informando o vencimento original e a data em que pretende pagar. A UF favorecida poderá retornar juros e multa. Se o débito já estiver encaminhado ou inscrito em Dívida Ativa, procure a UF antes de emitir, pois poderá ser exigido outro documento de arrecadação. | | Guia paga com informação errada ou em duplicidade | Não descarte a guia nem faça outro pagamento por tentativa. Consulte a SEFAZ da UF favorecida sobre retificação, compensação ou restituição. | | Cancelamento pelo F11 no Mestre | O F11 altera somente a situação interna da GNRE e o respectivo lançamento financeiro. Ele não envia um pedido de cancelamento ao Portal GNRE. |
Antes de substituir a guia: confirme que não houve pagamento. O cancelamento automático trata apenas da guia não paga; ele não cancela a operação fiscal nem o imposto devido. 6. Observe outras regras do Portal GNRE- São Paulo e Espírito Santo: a FAQ do Portal GNRE informa que essas UFs não geram GNRE no portal nacional; siga o procedimento estadual.
- Homologação: a guia com a marca d'água Guia Inválida para Pagamento é apenas de teste. Se for paga, o recolhimento não será baixado pela UF e será necessário solicitar restituição.
- Destinatário em branco: não é erro quando a receita escolhida não exige esses campos.
- Contingência: uma guia gerada em contingência pode ser paga normalmente, pois será repassada à UF favorecida.
- Forma de pagamento: use o código de barras somente em banco credenciado pela UF favorecida. O PIX pode ser usado quando a própria GNRE exibir o QR Code.
7. Entenda quando a automação não inicia a GNREA geração automática da NF-e não é executada quando: - a NF-e ainda não está autorizada ou não possui número;
- a operação foi marcada como presencial;
- a empresa possui inscrição estadual de substituto tributário na UF de destino;
- não existe valor de ICMS-ST, DIFAL ou FCP a recolher;
- a guia correspondente já foi gerada;
- a receita padrão ou a permissão da UF não está configurada.
UF fora do Portal GNRE nacional: a FAQ oficial informa que São Paulo e Espírito Santo não geram GNRE no portal nacional. Quando a UF estiver configurada no Mestre como não participante, a guia é finalizada sem transmissão ou consulta nacional e deve ser emitida pelo procedimento estadual. Para São Paulo, o Mestre também pode oferecer a exportação do arquivo TXT. |
Checklist de conferência- O CNPJ do certificado usado pelo Mestre está habilitado no Web Service da GNRE.
- Certificado válido, ambiente correto e internet disponíveis.
- Parâmetro de geração automática ativado, quando desejado.
- Receita e permissões conferidas para a UF favorecida.
- Documento de origem, referência, vencimento, data de pagamento e valores revisados.
- Campos adicionais obrigatórios preenchidos.
- Compromisso e todos os campos de pagamento habilitados para ele preenchidos.
- Despesa e Centro de custo informados para o rateio financeiro.
- Ambiente de produção confirmado antes de pagar; guia de homologação nunca deve ser paga.
- Em caso de substituição, pagamento da guia anterior confirmado como inexistente.
- Retorno processado, guia impressa ou salva e compromisso financeiro conferido.
Erros comuns e como evitar - CNPJ não habilitado: confirme se o CNPJ liberado no portal é o mesmo do certificado que assina a transmissão e se o acesso solicitado corresponde ao ambiente usado.
- Receita ou campo não encontrado: consulte as Configurações UF's do portal e solicite a atualização do catálogo do Mestre; não escolha outro código por tentativa.
- Rejeição de campo obrigatório: revise detalhamento, produto, documento de origem, referência e a aba de campos adicionais conforme a UF e a receita.
- Dados do Contas a Pagar incompletos: informe a data de pagamento, o Compromisso e todos os campos habilitados para ele. O Mestre valida esses dados antes de gravar ou finalizar e não conclui a operação quando falta uma informação exigida.
- Guia emitida com erro: se ainda não foi paga, gere outra corretamente e abandone a anterior; o portal não oferece cancelamento manual.
- F11 interpretado como cancelamento no portal: o comando cancela apenas o registro e o lançamento financeiro no Mestre; a guia nacional não recebe um evento de cancelamento.
- Lote em processamento: use a consulta de situação com o recibo existente; não gere uma segunda guia sem confirmar a primeira.
- Guia de homologação: não efetue o pagamento. A UF não dará baixa no imposto e a recuperação do valor exigirá pedido de restituição.
|
FontesFluxo em uma linha Habilite o CNPJ no Portal GNRE → confira certificado e ambiente da DFe → ative a geração automática → valide receita e permissões da UF → confira a guia e o Contas a pagar → F10 - Finalizar. |
Revisão: 19/08/2026 — Portal GNRE, Perguntas Frequentes oficiais, Manual de Integração para Contribuintes v2.15, leiaute XML 2.00 e fluxo vigente do ERP Mestre. |