Como configurar e emitir GNRE pelo Mestre
16 min
Criado por Ernesto Santos em 19/08/2026 17:30
Atualizado por Felipe Mateus Hoffmann em 01/09/2026 12:16
GNRE
Como configurar e emitir GNRE pelo Mestre

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 GNRE

Na á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 certificadoO que habilitar no portal
Matriz e filiais usam o mesmo e-CNPJ da matrizCadastre o CNPJ contido nesse certificado.
Cada filial transmite com o próprio e-CNPJCadastre 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 Mestre

A GNRE utiliza as mesmas configurações da DFe para certificado, ambiente, comunicação segura, tempo de espera, tentativas e pasta de XML.

  1. Abra Certificados Digitais e confirme validade, titular e acesso ao certificado.
  2. Abra Documentos fiscais eletrônicos - Configuração e confira o ambiente: use homologação para testes e produção somente para guias válidas.
  3. Em Parâmetros → Finalização, marque Gerar GNRE automaticamente após a transmissão da nota fiscal.
  4. Confirme que a estação possui acesso à internet.

3. Valide os códigos usados na emissão

O 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ódigoDescriçãoUso no Mestre
10009-9ICMS Substituição Tributária por OperaçãoReceita padrão da automação de ICMS-ST da NF-e.
10010-2ICMS Consumidor Final não Contribuinte de Outra UF por OperaçãoReceita padrão da automação de DIFAL da NF-e.
10012-9ICMS Fundo Estadual de Combate à Pobreza por OperaçãoReceita padrão da automação de FCP da NF-e.
10003-0ICMS TransporteReceita utilizada na GNRE originada de CT-e quando o imposto do frete é devido.
10015-3ICMS Monofásico por OperaçãoDisponível no portal para AL, BA, DF, MT, PA e TO; use somente quando a operação exigir.
10016-1ICMS Monofásico por ApuraçãoDisponí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

  1. Na NF-e, abra a guia GNRE. Para uma guia avulsa, procure no menu por GNRE - Guia Nacional de Recolhimento Estadual.
  2. Confira destinatário, UF favorecida, receita e valor principal.
  3. Confira detalhamento, produto, tipo e número do documento de origem. Quando permitido pela UF, o Mestre utiliza a chave da NF-e.
  4. Informe período e ano de referência, vencimento e data de pagamento. A data de pagamento é obrigatória.
  5. Preencha os campos adicionais marcados como obrigatórios para aquela UF e receita.
  6. 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.
  7. 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ça

A 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çãoProcedimento
Guia errada e ainda não pagaNã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 pagoO 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 pagaGere 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 duplicidadeNã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 MestreO 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 GNRE

A 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.

Fontes

Fluxo 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.

Este artigo foi útil para você?
Últimos artigos visitados