Envia
A rota Envia será utilizada para autorizarmos uma GNR-e, junto à Sefaz, a partir de um XML Destinatário de NF-e ou CT-e autorizada ou de sua Chave e as envia para autorização junto a SEFAZ. A comunicação é síncrona, portanto o retorno da requisição que fizermos, será a resposta do SaaS dizendo se a guia foi autorizada ou rejeitada.
Na GNRe é necessário utilizar, o XML de NFe ou CTe que esteja autorizado ou a chave autorizada de um desses dois documentos no Tx2 Complementar. O TX2 é um arquivo próprio da Tecnospeed, ele é basicamente um arquivo texto contendo campos e seus valores. No caso da GNRe, ele é utilizado para informar dados complementares que são exigidos por alguns Estados.
Existem 2 servidores de GNRE atualmente: o servidor nacional, que suporta a maioria dos estados (exceto SP e ES) e o servidor do ES (SP não possui webservice de GNRE). Para cada um desses servidores é usado um layout diferente de TX2.
ATENÇÃO! A partir da Versão Manual 2.0, o servidor do RJ não estará disponível, passando a utilizar o Servidor Nacional. Nossa API já vai tratar essa alteração.
POST
https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/gnre/envia
Headers
Nome | Descrição | Exemplo |
Content-Type | Indica o tipo de arquivo | application/x-www-form-urlencoded |
Authorization | Este usuário e senha são os seus dados para logar como administrador em um grupo do SaaS | Basic YWRtaW46MTIzbXVkYXI= |
Body
Nome | Descrição |
Grupo | Nome do grupo |
CNPJ | CNPJ do emitente da NFe, apenas números |
Arquivo |
Este parâmetro deve ser preenchido com o TX2 complementar da GNRe seguido de: 1 - XML da NFe autorizada OU 2 - Chave de uma NFe autorizada, que tenha sido emitida ou importada pelo SaaS |
Observação: No TX2 complementar as quebras de linha devem ser substituídas pelo literal '\n' ao fazer o envio, como no exemplo abaixo:
tx2complementargnre=formato=tx2\nINCLUIR\nINCLUIRITEM\nc26_produto=3\nc25_detalhamentoReceita=000012\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Valor=Observacao da guia\nSALVARCAMPOEXTRA\nSALVARITEM\nSALVAR
<XML da NFe> ou chave=41191008187168000160570010000146441652195689
Ao enviar um XML de NFe, o Manager irá tentar gerar guias de todas as receitas disponíveis no arquivo, porém disponibilizamos o parâmetro Receita dentro do arquivo (antes do TX2 Complementar), com as seguintes opções: PartilhaICMS, FCP, ST.
Este é um parâmetro opcional, portanto se não for enviado, considere a geração de todas as receitas disponíveis.
Exemplo:
Receita=PartilhaICMS
tx2complementargnre=formato=tx2\nINCLUIR\nINCLUIRITEM\nc26_produto=3\nc25_detalhamentoReceita=000012\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Valor=Observacao da guia\nSALVARCAMPOEXTRA\nSALVARITEM\nSALVAR
<XML da NFe> ou chave=41191008187168000160570010000146441652195689
O exemplo acima geraria apenas a guia referente a Partilha de ICMS, mesmo que existam mais impostos no XML.
Segue um exemplo de arquivo TX2 Complementar para UF´s do servidor nacional (usado até a versão manual 1.00):
Segue um exemplo de arquivo TX2 Complementar para UF´s do servidor nacional (usado a partir da versão manual 2.00), podemos constatar que vários campos agora são por item :
SALVAR
Campos do TX2 para o formato Nacional:
Nome | Descrição |
c26_produto | Código do produto. A relação dos códigos de produto para cada UF está informado no Portal da GNRE. Normalmente exigido para as guias de Substituição Tributária (100099) |
c25_detalhamentoReceita | Códigos de detalhamento da receita. A relação dos códigos de detalhamento de receita para cada UF e para cada receita está informado no Portal da GNRE. As receitas que são usadas pelo Componente GNRE são: Partilha de ICMS (100102), Substituição Tributária (100099) e Fundo de Combate a Pobreza (100129) |
c33_dataPagamento |
Contém a data que o contribuinte irá pagar o tributo .Formato: AAAA-MM-DD. (OBS: Necessário informar a mesma data na tag c14_dataVencimento) |
c14_dataVencimento |
Contém a data que o contribuinte deve pagar o tributo de acordo com a legislação de cada UF. Formato: AAAA-MM-DD. (OBS: Necessário informar a mesma data na tag c33_dataPagamento) |
c15_convenio |
Campo de texto livre (Máximo 30 caractetes) *Atualmente exigido apenas para RN nas guias de FCP |
c39_camposExtras_Valor |
Valor extra necessário. No momento, é necessário somente para TO (informar com uma observação sobre a guia) |
Lembrando que todos os campos são opcionais ou seja, na maioria das UF's você poderá autorizar guias sem informar o TX2 Complementar.
Exemplo de TX2 para o Espírito Santo:
Tx2ComplementarGNRE=formato=tx2\nINCLUIR\ndRef=2016-03\ndVen=2016-03-18\ndPag=2016-03-18\nxInf=Teste de Informacoes Complementares\nqtde=1\nxIde=Nome da Empresa Emitente\nversao=1.00\nSALVAR
<XML da NFe> ou chave=41191008187168000160570010000146441652195689
Campos do TX2 no formato Espírito Santo:
Nome | Descrição |
dRef | Data de referência no formato AAAA-MM |
dVen | Data de vencimento no formato AAAA-MM-DD |
dPag | Data de pagamento no formato AAAA-MM-DD |
xInf | Informações Complementares |
qtde | Quantidade do serviço informado |
xIde | Identificação do cliente solicitante |
versao | Versão do leiaute |
Exemplo de TX2 para o Rio de Janeiro (até Versão Manual 1.0):
Tx2ComplementarGNRE=formato=tx2\nINCLUIR\nEmail=fabio@tecnospeed.com.br\nINCLUIRDOCUMENTO\nSqDocumento=1\nSALVARDOCUMENTO\nINCLUIRITEMPAGAMENTO\nCodigoProduto=123\nInformacoesComplementares=Teste de informacoes complementares\nInscEstadualRJ=12345678\nNumControleContribuinte=12345\nNumDocOrigem=45678\nDataVencimento=10/10/2000\nSALVARITEMPAGAMENTO\nSALVAR
<XML da NFe> ou chave=41191008187168000160570010000146441652195689
Tags em cinza são Opcionais
Campos do TX2 para o Rio de Janeiro:
Nome | Descrição |
Email do emitente da GNRe (este é o único campo obrigatório) |
Retorno
Exemplo de retorno:
numrecibo, situação, motivo, UF Favorecida, Receita
1842267199,AUTORIZADA,Lote Processado com sucesso,MT,PARTILHA
Exemplo de retorno com erro:
"Palavra Exception", "Classe da Exception", "Mensagem de Exception"
EXCEPTION,EspdGnreRetDadosListException,Nenhuma guia válida encontrada para parsear retorno.
Receitas e Tags consideradas na geração da GNRe
Quando o XML destinatário for referente a uma NFe:
Receita FCP - Código 100129
TAGS
vFCPUFDest;
vFCPST;
RECEITA PARTILHA ICMS - Código 100102
TAGS
vICMSUFDest;
RECEITA ST - Código 100099
TAGS
vST;
Quando o XML destinatário for referente a um CTe:
RECEITA TRANSPORTE - Código 100030
TAGS
vICMSUFFim;
vICMSOutraUF;
vICMS;
Mais detalhes sobre o preenchimento dos dados, consulte a documentação: "Informações no Preenchimento".
Comentários
0 comentário
Por favor, entre para comentar.