Roteiro GNRE

Neste documento, você irá encontrar as informações necessárias para a implementação e utilização da GNRE.

O Projeto da GNRE é desenvolvido pela SEFAZ/PE e pode ser acessado através dos link’s dos ambientes de produção ou homologação.

Este projeto tem como objetivo automatizar a geração em lote das Guias da GNRE, assim como sua consulta e impressão através do portal.

O manual completo, pode ser baixado no tópico “Manual de integração” localizado no menu automação do portal.

Informações técnicas

A partir da versão 2.00 da GNRE, é possível gerar guias de acordo com o layout da versão 1.00 e/ou 2.00, observando as regras das Receitas estabelecidas pelas UF’s e a versão de cada guia que pretende gerar.

O processo da GNRE, está dividido em 3 etapas, sendo:

Geração do XML: função NFeGerarXMLGNRE;
Envio do XML: função NFeEnviarGNRE;
Busca do resultado do processamento: função NFeBuscarGNRE.

Além das 3 etapas descritas acima, temos a função NFeConsultaConfigGNRE, que realiza a consulta das configurações específicas da UF desejada.

Disponibilidade

É possível verificar a disponibilidade do serviço para cada UF através do portal no menu "Disponibilidade" ou clicando aqui.

Até o momento em que este documento foi feito as UF’s do Espírito Santo e São Paulo, não tinham aderido à GNRE.

Habilitação de uso para GNRE

Para que seja possível a emissão da GNRE, primeiramente é necessário solicitar a habilitação do CNPJ.

Isto pode ser realizado pelo portal no menu "Automação" e deve ser realizada nos ambientes nos quais se deseja usar a GNRE, ou seja, para o ambiente de produção e/ou homologação.

Na página de portal procure pelo link "Solicitar Uso do WebService".

Geração do XML

Para a geração do XML, iremos utilizar a função NFeGerarXMLGNRE.

Move (NFeGerarXMLGNRE(&vParams)) to sRetArquivo

No parâmetro vParams, existe o campo "vtNFeTDadosGNRE" que é a estrutura que corresponde ao layout da GNRE.

Este, deve ser preenchido de acordo com o “Manual para Preenchimento do XML de Lote”, localizado no Portal da GNRE respeitando os requesitos de cada Receita e atendendo as particularidades das UF’s, as quais podem ser obtidas utilizando a função NFeConsultaConfigGNRE, que irá retornar um XML com as informações necessárias.

Após executar a geração do XML, a função irá retornar o nome do local onde o arquivo XML foi salvo. Caso o XML não tenha sido gerado, a função irá retornará vazio, sendo necessário consultar o campo “sRetMsgResultado” para identificar o problema ocorrido.

Envio do XML

Em posse do arquivo XML, devemos enviá-lo à SEFAZ/PE, utilizando a função NFeEnviarGNRE.

Move (NFeEnviarGNRE(&vParams)) to bOk

Se a recepção do arquivo for bem sucedida, será gerado um número de protocolo, entre outras informações. Neste caso, é necessário armazenar ao menos o número do protocolo de recebimento, pois ele será usado para realizar a busca do resultado do envio, já que este processo é assíncrono.

Busca do resultado do envio

Enviado o XML, devemos verificar o resultado do processamento. Para isso, vamos utilizar a função NFeBuscarGNRE.

Move (NFeBuscarGNRE(&vParams)) to bOk

Ao preencher o parâmetro desta função, devemos nos atentar ao campo “sNomeCompletoArqRetornoXML”. Seu preenchimento é opcional, porém, caso o mesmo não seja informado, o XML retornado não será salvo em disco, ficando a cargo do desenvolver realizar o tratamento do XML.

Consultas no portal da GNRE

Após os procedimentos acima descritos, será possível realizar as seguintes atividades no Portal da GNRE:

Consultar e imprimir a situação da guia

Utilizando o menu “Consultar GNRE”, é possível obter diversas informações, conforme imagem abaixo:

Consultar e imprimir uma ou mais guias de um determinado lote através do menu “Consultar Lote”, conforme imagens abaixo:

Na workspace de exemplos, você encontra exemplos de como implementar cada uma destas funções.

Para mais detalhes de como implementar cada uma das funções, favor verificar a documentação correspondente, clicando no nome da mesma.

voltar ao topo