API de GNRE para recolher DIFAL e ICMS-ST em qualquer UF
Gere a Guia Nacional de Recolhimento de Tributos Estaduais pela REST API. A guia volta com linha digitável, código de barras, PIX copia e cola e o PDF oficial do Portal GNRE.
curl --request POST \ --url "https://api.brasilnfe.com.br/services/Fiscal/EnviarGnre" \ --header 'Content-Type: application/json' \ --header 'Token: seu_token_aqui' \ --data '{ "TipoAmbiente": 2, "UfFavorecida": "SP", "Itens": [ { "Receita": "100102", "DocumentoOrigem": "35261012345678000199550010000012341...", "ValorPrincipal": 150.37, "ValorPrincipalFcp": 15.00 } ] }'
O que é a GNRE (Guia Nacional de Recolhimento de Tributos Estaduais)?
A GNRE (Guia Nacional de Recolhimento de Tributos Estaduais) é a guia usada para recolher o ICMS devido a uma UF diferente da do contribuinte. Ela é gerada no Portal GNRE, que valida a guia com a UF favorecida e devolve o código de barras para pagamento no banco e, nas UFs que aceitam, o PIX.
O caso mais comum é o DIFAL da venda interestadual para consumidor final não contribuinte do ICMS (EC 87/2015). Quando o vendedor não tem inscrição estadual de substituto tributário (IE-ST) na UF de destino, o diferencial de alíquota é recolhido a cada operação, antes da saída, e a guia acompanha a mercadoria. O mesmo vale para o ICMS-ST devido por operação na venda para outra UF e para o FCP que a UF de destino cobra junto.
Gerar a guia à mão no portal, nota a nota, toma tempo e é fácil errar a receita, o código do documento de origem ou os campos que cada UF exige. Com a API do Brasil NFe, o seu sistema gera a GNRE no mesmo fluxo da nota: consulta as regras da UF, envia a guia e recebe o resultado por consulta ou webhook.
A GNRE não substitui a nota fiscal: ela recolhe o imposto da operação que a NF-e documenta. As regras de cálculo do DIFAL e da partilha entre as UFs estão na documentação do DIFAL.
A Brasil NFe cuida do que muda de UF para UF: as receitas aceitas, o código de cada tipo de documento de origem, os campos adicionais e se o FCP vai no mesmo item. O emitente da guia é sempre a sua empresa, identificada pela inscrição estadual quando ela é inscrita na UF favorecida.
Como funciona com a API do Brasil NFe
Três passos para gerar a GNRE com código de barras, PIX e o PDF oficial do Portal GNRE.
Cadastre-se
Crie sua conta gratuita no painel do Brasil NFe. O ambiente de homologação é liberado para testes sem custo.
Consulte as regras da UF
Cada UF define as receitas que aceita e os campos de cada uma. A API devolve essas regras prontas para o seu sistema montar a guia certa.
Gere a guia pronta para pagar
Envie a guia e receba, por consulta ou webhook, a linha digitável, o código de barras, o PIX copia e cola e o PDF oficial.
{
"Id": 1520,
"Situacao": "Gerada",
"UfFavorecida": "SP",
"Valor": 165.37,
"LinhaDigitavel": "85800000001665370270...",
"PixCopiaECola": "00020101021226...",
"Base64Pdf": "JVBERi0xLjQ...",
"status": 1
}
Por que escolher Brasil NFe para GNRE
Uma API que tira do seu sistema as diferenças entre as UFs e entrega a guia pronta para pagar.
Guia direto da NF-e
No painel, o botão Gerar GNRE de uma NF-e emitida abre a guia já preenchida com a UF, a chave, o destinatário e o valor do DIFAL ou do ICMS-ST.
Regras de cada UF
A API traz do Portal GNRE as receitas aceitas por UF e o que cada uma exige: documento de origem, referência, valores, FCP e campos adicionais.
PIX e código de barras
A guia volta com linha digitável, código de barras e, nas UFs que aceitam, o PIX copia e cola, além do PDF oficial gerado pelo Portal GNRE.
Resultado por webhook
O portal processa a guia em segundo plano. A Brasil NFe acompanha o processamento e avisa o seu sistema pelo webhook gnre.processada.
Sem liberar o seu CNPJ no portal
O Portal GNRE só aceita CNPJ liberado por ele. Use o certificado da sua empresa ou transmita pelo certificado da Brasil NFe, sem pedir acesso ao web service.
Suporte especializado
Equipe técnica que acompanha as regras do Portal GNRE e das UFs e auxilia na integração. Suporte por WhatsApp, e-mail e painel, com plantão 24h para problemas críticos.
Plano GNRE
Valor fixo mensal com geração ilimitada de guias. Sem surpresas na fatura.
GNRE
- 1 CNPJ por serviço
- Geração ilimitada de GNRE
- Linha digitável, código de barras e PIX copia e cola
- PDF oficial do Portal GNRE
- Webhook de guia processada
- Ambiente de homologação gratuito
- Suporte com plantão 24h
Perguntas frequentes sobre GNRE
Tire suas dúvidas sobre a Guia Nacional de Recolhimento de Tributos Estaduais e a integração via API.
gnre.processada. Guias com pendência na UF podem levar até 1 hora.
Pronto para gerar GNRE sem entrar no portal?
Crie sua conta, teste grátis e automatize o recolhimento do DIFAL e do ICMS-ST.