Como envio a GNRe pela API?

Você monta um arquivo TXT no padrão ACBr com os dados do recolhimento e chama o método GNReEnviar, informando a UF. A API transmite e devolve o código de status, o motivo, o número do recibo, o XML da SEFAZ e o PDF da guia.

Consigo gerar a segunda via de uma GNRe já transmitida?

Sim. O método GNRePDF gera o PDF a partir da nota fiscal ou do XML da guia guardado, sem transmitir de novo.

API de GNRe
para o seu sistema

Transmita a Guia Nacional de Recolhimento de Tributos Estaduais para qualquer UF e receba o XML e o PDF prontos.
ICMS-ST, DIFAL e FCP sem sair do seu ERP.

Todas as UFsXML + PDFWebServiceDLLTXT

Ver Planos e Preços Documentação da API

A guia estadual emitida direto pelo seu sistema

Transmissão para a SEFAZ da UF

Envie o TXT da guia informando a UF de recolhimento e receba o status, o motivo e o número do recibo.

XML de retorno e PDF da guia

A API devolve o XML da SEFAZ e o PDF pronto para pagamento, sem você montar layout de impressão.

Envio da guia por e-mail

Informe o endereço no envio e a guia segue para o cliente automaticamente.

PDF de guia já transmitida

Precisa da segunda via? O GNRePDF gera o PDF a partir da nota fiscal ou do XML guardado.

Quando o seu cliente precisa de GNRe

Situações do dia a dia em que a guia acompanha a nota

ICMS-ST interestadual

Venda para outro estado com substituição tributária: a guia acompanha a mercadoria.

DIFAL e FCP

Diferencial de alíquota e Fundo de Combate à Pobreza recolhidos na UF de destino.

Antecipação do imposto

Estados que exigem o recolhimento antes da entrada da mercadoria.

Uma guia, na sua linguagem

A mesma chamada, do VB6 ao C#

Visual Basic 6

Dim objGNRe      As New ApiNeXT.clsGNRe
Dim blnOk        As Boolean
Dim lngStatus    As Long
Dim strMotivo    As String, strRecibo As String
Dim strMsg       As String
Dim bytXMLRet()  As Byte
Dim bytPDFGNRe() As Byte

blnOk = objGNRe.GNReEnviar( _
            "11222333000181", "99888777000100", strToken, 2, _
            "SP", bytTXTGNRe, "cliente@empresa.com.br", _
            lngStatus, strMotivo, strRecibo, _
            strMsg, bytXMLRet, bytPDFGNRe)

C# / .NET

var _gnre = new ApiNeXT.Net.clsGNRe();

bool _ok = _gnre.GNReEnviar(
    "11222333000181",         // CNPJ Software House
    "99888777000100",         // CNPJ Cliente
    _token,                   // Token
    2,                        // Ambiente: 2 = Homologacao
    "SP",                     // UF de recolhimento
    _txtGNRe,                 // TXT da GNRe (padrao ACBr)
    "cliente@empresa.com.br", // E-mail (opcional)
    out int _codStatus,
    out string _xMotivo,
    out string _nRec,         // Numero do recibo
    out string _msg,
    out byte[] _xmlRetorno,
    out byte[] _pdfGNRe);     // PDF da guia, pronto

O conteúdo da guia vai num arquivo TXT no padrão ACBr — o mesmo formato que você já usa nos outros documentos da API. Todos os métodos, parâmetros e retornos estão na documentação do GNRe.

Por que emitir GNRe com a API NeXT?

Uma integração, todas as UFs

A UF de recolhimento é só um parâmetro da chamada — não um projeto novo.

Integra com qualquer sistema

Visual FoxPro, VB6, Delphi e Clipper via DLL/EXE/TXT, além de C# e PHP.

A partir de R$ 39/mês

Até 5.000 guias por mês, com CNPJs ilimitados e sem taxa por guia.

Perguntas frequentes

O que é a GNRe?

É a Guia Nacional de Recolhimento de Tributos Estaduais, usada quando a empresa precisa recolher tributo para uma UF diferente da sua — tipicamente ICMS-ST, DIFAL e FCP em operações interestaduais. Em muitos casos a guia acompanha a mercadoria junto com a NF-e.

Quanto custa a API de GNRe?

A partir de R$ 39/mês para até 5.000 guias, com CNPJs ilimitados. As faixas: R$ 69 até 10.000, R$ 119 até 20.000, R$ 199 até 50.000 e R$ 299 até 100.000 guias. Sem taxa por guia avulsa. Veja os planos e preços.

Atende todos os estados?

A UF de recolhimento é um parâmetro da chamada (p_UF). A API trata a comunicação com o ambiente da GNRe e devolve o status e o motivo retornados pela SEFAZ, do mesmo jeito para qualquer estado.

Como envio a guia?

Você monta um arquivo TXT no padrão ACBr com os dados do recolhimento e chama o GNReEnviar, informando a UF. A API transmite e devolve o código de status, o motivo, o número do recibo, o XML da SEFAZ e o PDF da guia.

Consigo gerar a segunda via de uma guia já transmitida?

Sim. O método GNRePDF gera o PDF a partir da nota fiscal ou do XML da guia que você guardou, sem transmitir de novo.

Preciso contratar a API de NF-e junto?

Não. O plano de GNRe é independente. Mas como na prática a guia costuma acompanhar a NF-e, quem usa os dois normalmente prefere o plano API Completa, que inclui todos os serviços a partir de R$ 990/mês.

Funciona em Visual FoxPro, Clipper, VB6 ou Delphi?

Sim. Além do WebService SOAP, a API NeXT entrega uma DLL COM que o Visual FoxPro (CREATEOBJECT), o VB6, o Delphi e o VBA chamam direto, e um executável de linha de comando que grava o retorno em arquivo INI, que é como sistemas Clipper e outros legados integram sem carregar DLL. Veja a página da DLL.

API de GNRepara o seu sistema