Bem-vindo(a) ao Suporte da Tecnospeed

Em que podemos ajudar? :)

Artigos nessa seção

Exibir mais

Geral - Gerando o TX2 complementar da GNRE

Avatar
Diego de Oliveira
  • Atualizado
Seguir

TX2 Complementar

 O TX2 trata-se de um arquivo de leiaute próprio da Tecnospeed sendo baseado em arquivo texto (.txt), contendo comandos e campos com seus valores. 

No caso da GNRE, ele é usado para informar dados complementares que são exigidos por alguns estados, e também para informar manualmente dados que normalmente são obtidos do XML da NF-e ou gerados automaticamente.

Antes de gerar o TX2, acesse este link e veja as orientações de boas práticas para a geração deste tipo de arquivo.

 

1 - Web Services

Existem 2 servidores de GNRE atualmente e para cada um desses servidores é usado um layout diferente de TX2: 

  1.  Servidor Nacional, que suporta a maioria dos estados (exceto SP e ES) ;
  2. Servidor do Espírito Santo - ES. 

* O estado de São Paulo não possui webservice de GNRE, para mais informações acesse a documentação Emissão de GNRE para UF Favorecida São Paulo

* A partir da Versão Manual 2.0, o servidor do RJ não estará disponível, passando a utilizar o Servidor Nacional. 

 

1.1 - Layout para UF´s do Servidor Nacional

A obrigatoriedade dos campos varia de estado para estado, e recomenda-se não informar um campo no tx2 que não seja exigido pela UF Favorecida. 

Segue abaixo a lista dos campos existentes:

CAMPO DESCRIÇÃO OBSERVAÇÕES
c01_UfFavorecida Sigla da UF favorecida.  
c02_receita Código da receita.

As receitas que são usadas pelo Componente GNRE são:

100099 - Substituição Tributária;

100102 - Partilha de ICMS;

100129 - Fundo de Combate a Pobreza;

100030 - Transporte.

OBS: caso não seja informada a receita será preenchida automaticamente.

*Obs 1
c25_detalhamentoReceita Código 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 (clique em "Detalhamento das Receitas").

*Obs 1
c26_produto Código do produto

A relação dos códigos de produto para cada UF está informado no Portal da GNRE (clique em "Produtos").

Exigido para as guias de Substituição Tributária (100099) nas UF's: AC, AL, AM, BA, CE, DF, GO, MA, MS, PE, PI, RN, RR, SC, SE e TO.

*Obs 1
c28_tipoDocOrigem Código do tipo de documento de origem.

A relação dos códigos está informado no Portal da GNRE (clique em "Documentos de Origem").

*Obs 1
c04_docOrigem Número do documento de origem

Como no momento só é suportado Nota Fiscal, pode-se informar o número/chave da Nota Fiscal ou NF-e.

Para clientes Manager Saas, este campo é gerado automaticamente.

*Obs 1
c14_dataVencimento Data de vencimento da guia

Caso não informado, é usado o mesmo dia da geração da guia. (Formato: AAAA-MM-DD)

(OBS: Necessário informar a mesma data na tag c33_dataPagamento)

*Obs 1
c15_convenio Número do convênio.

Campo de texto livre (Máximo 30 caracteres)

*Atualmente exigido apenas para RN nas guias de FCP

*Obs 1
c03_CnpjContribuinteEmitente CNPJ do contribuinte emitente.

 
c03_CpfContribuinteEmitente CPF do contribuinte emitente

 
c16_razaoSocialEmitente Nome da firma ou a razão social do contribuinte

 
c17_inscricaoEstadualEmitente Inscrição Estadual do emitente.

 
c18_enderecoEmitente Endereço completo do contribuinte

Não pode haver espaços nem no começo nem no final do endereço
c19_municipioEmitente Código do IBGE do município do contribuinte

Conforme a Tabela de Códigos de Municípios do IBGE
c20_ufEnderecoEmitente Sigla da UF do município do contribuinte.

 
c21_cepEmitente CEP do endereço do contribuinte

 
c22_telefoneEmitente Número de telefone do contribuinte.

 
c35_CnpjContribuinteDest CNPJ do contribuinte destinatário

*Obs 1
c35_CpfContribuinteDest CNPJ do contribuinte destinatário.

*Obs 1
c36_inscricaoEstadualDest Inscrição Estadual do destinatário

*Obs 1
c37_razaoSocialDestinatario Razão Social do destinatário.

*Obs 1
c38_municipioDestinatario Município do destinatário

*Obs 1
c33_dataPagamento Data prevista para pagamento informada pelo contribuinte.

Caso não informado, será gerado com o mesmo dia da geração da guia. (Formato: AAAA-MM-DD)

(OBS: Necessário informar a mesma data na tag c14_dataVencimento)
c05_referencia_periodo Código do período de apuração da guia

Valores válidos:

0: mensal;

1: 1ª quinzena;

2: 2ª quinzena;

3: 1º decêndio;

4: 2º decêndio;

5: 3º decêndio.

Para as receitas suportadas no momento, somente será aceito o período mensal ("0").

*Obs 1
c05_referencia_ano Ano de referência da apuração da guia

*Obs 1

c05_referencia_mes

 Mês de referência da apuração da guia.

*Obs 1

c05_referencia_parcela

 Parcela de referência da apuração da guia

*Obs 1

c42_identificadorGuia

 Identificador da guia.

 

c39_camposExtras_Codigo

 Código do campo extra.

*Obs 2

c39_camposExtras_Valor

 Valor extra necessário

Pode-se informar uma observação sobre a guia.

Exigido apenas na UF TO.

*Obs 2

 

Obs 1: Atenção a esses campos que passaram a ser por item a partir da versão manual 2.00, então é necessário que no TX2 complementar eles sejam declarados dentro da seção INCLUIRITEM / SALVARITEM, e essa seção por sua vez deverá ficar dentro da seção INCLUIR / SALVAR, como no exemplo a seguir (abaixo).

Obs 2: Atenção a esses campos da seção de campos extras, que passaram a ser por item a partir da versão manual 2.00, então é necessário que no TX2 complementar eles sejam declarados dentro da seção INCLUIRCAMPOEXTRA / SALVARCAMPOEXTRA, e essa seção por sua vez deverá ficar dentro da seção INCLUIRTEM / SALVARITEM, como no exemplo a seguir (abaixo).

No momento, os campos da seção extra são necessários apenas para quando a UF for TO.

 

1.1.1 - Exemplo de TX2 Complementar para o Servidor Nacional - 2.00

Componente:

formato=tx2
INCLUIR
c33_dataPagamento=2020-12-31
INCLUIRITEM
c26_produto=3
c25_detalhamentoReceita=000012
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=50
c39_camposExtras_Valor=Observacao da guia
SALVARCAMPOEXTRA
SALVARITEM
SALVAR

**Os campos disponíveis para preenchimento no TX2 complementar, podem ser verificados dentro do arquivo de mapping.txt que existe na pasta de esquemas de cada versão.

Manager Saas:

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 presentes na nota fiscal.

No TX2 complementar as quebras de linha devem ser substituídas pelo literal '\n' ao fazer o envio, como no exemplo abaixo:

Receita=PartilhaICMS,FCP
tx2complementargnre=formato=tx2\nINCLUIR\nc33_dataPagamento=2020-12-31\nINCLUIRITEM\nc26_produto=3\nc25_detalhamentoReceita=000012\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Codigo=50\nc39_camposExtras_Valor=Observacao-da-guia\nSALVARCAMPOEXTRA\nSALVARITEM\nSALVAR
<XML da NFe> ou chave=41191008187168000160570010000146441652195689

*O exemplo acima geraria apenas as guias referente a Partilha de ICMS e FCP, mesmo que existisse ST no XML.

 

Atenção! Critérios adotados na forma de preencher o TX2 complementar com vários itens:

  • Se informar mais (+)  de 1 item, será obrigatório informar a receita (c02_receita) para cada item, pois só com a receita é possível localizar corretamente a guia do xml. E só aplicaremos o conteúdo nas guias que forem localizadas.
  • Se informar 1 item e não informar a receita neste item, vamos aplicar o conteúdo deste item em todas possíveis guias do xml.
  • Se informar 1 item e informar uma receita que exista no xml, vamos aplicar o conteúdo deste item apenas na guia desta receita informada.
  • Se informar 1 item e informar uma receita que não exista no xml, vamos aplicar o conteúdo deste item em todas possíveis guias do xml, inclusive a própria receita será alterada. *Regra válida apenas para o Componente.

 

1.2 - Layout do TX2 do Espírito Santo

Segue abaixo a lista dos campos existentes:

 
UF Campos exigidos
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

* Nenhum dos campos acima é obrigatório.

 

1.2.1 - Exemplos de TX2 Complementar para o Servidor do ES 

 

Componente:

formato=tx2 
INCLUIR 
dRef=2016-03 
dVen=2016-03-18 
dPag=2016-03-18 
xInf=Teste de Informacoes Complementares 
qtde=1 
xIde=Nome da Empresa Emitente 
versao=1.00 
SALVAR

Manager Saas:

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\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

 

 

1.3 - Outros exemplos de TX2 para o servidor Nacional

 

1.3.1 - Alagoas

Segue um exemplo de arquivo TX2 Complementar para Alagoas:

Componente:

formato=tx2
INCLUIR
c22_telefoneEmitente=1234567890
INCLUIRITEM
c26_produto=68
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=108
c39_camposExtras_Valor=35200507099389000113550010000390961011901028
SALVARCAMPOEXTRA
SALVARITEM
SALVAR

Manager Saas:

Tx2ComplementarGNRE=formato=tx2\nINCLUIR\nc22_telefoneEmitente=1234567890\nINCLUIRITEM\nc26_produto=68\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Codigo=108\nc39_camposExtras_Valor=35200507099389000113550010000390961011901028\nSALVARCAMPOEXTRA\nSALVARITEM\nSALVAR

Observações: O campo de produto para Alagoas é obrigatório

 

1.3.2 - Mato Grosso

Segue um exemplo de arquivo TX2 Complementar para MT- Produção

Componente:

formato=tx2
INCLUIR
c33_dataPagamento=2020-12-18
INCLUIRITEM
c02_receita=100099
c25_detalhamentoReceita=000022
INCLUIRCAMPOEXTRA 
c39_camposExtras_Codigo=17
c39_camposExtras_Valor=123456789123456789123456789
SALVARCAMPOEXTRA 
SALVARITEM
SALVAR

Manager Saas:

Tx2ComplementarGNRE=formato=tx2\nINCLUIR\nc33_dataPagamento=2020-12-18\nINCLUIRITEM\nc02_receita=100099\nc25_detalhamentoReceita=000022\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Codigo=17\nc39_camposExtras_Valor=123456789123456789123456789\nSALVARCAMPOEXTRA\nSALVARITEM\nSALVAR

 

1.3.3 - Minas Gerais

Segue um exemplo de arquivo TX2 Complementar para MG:

Componente:

formato=tx2
INCLUIR
INCLUIRITEM
c25_detalhamentoReceita=000052
SALVARITEM
SALVAR

Manager Saas:

Tx2ComplementarGNRE=formato=tx2\nINCLUIR\nINCLUIRITEM\nc25_detalhamentoReceita=000052\nSALVARITEM\nSALVAR\n

Observações: O campo de DetalhamentoReceita é obrigatório 

 

1.3.4 - Rio Grande do Sul

Segue um exemplo de arquivo TX2 Complementar para RS:

Componente:

formato=tx2
INCLUIR
INCLUIRITEM
c04_docOrigem=35201162525647000194550030000297651005410451
c28_tipoDocOrigem=22
SALVARITEM
SALVAR

Manager Saas:

Tx2ComplementarGNRE=formato=tx2\nINCLUIR\nINCLUIRITEM\nc04_docOrigem=35201162525647000194550030000297651005410451\nc28_tipoDocOrigem=22\nSALVARITEM\nSALVAR\n

 

1.3.5 - Rio Grande do Norte

Segue um exemplo de arquivo TX2 Complementar para RN:

Componente:

formato=tx2
INCLUIR
c22_telefoneEmitente=999999999
INCLUIRITEM
c02_receita=
c26_produto=15
c25_detalhamentoReceita=
c15_convenio=EC 8715
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=97
c39_camposExtras_Valor=35201162525647000194550030000297651005410451
SALVARCAMPOEXTRA
SALVARITEM
SALVAR

Manager Saas:

Tx2ComplementarGNRE=formato=tx2\nINCLUIR\nc22_telefoneEmitente=999999999\nINCLUIRITEM\nc02_receita=\nc26_produto=15\nc25_detalhamentoReceita=\nc15_convenio=EC 8715\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Codigo=97\nc39_camposExtras_Valor=35201162525647000194550030000297651005410451\nSALVARCAMPOEXTRA\nSALVARITEM\nSALVAR

 

1.3.6 - Tocantins  

Segue um exemplo de arquivo TX2 Complementar para TO - Produção

Componente:

formato=tx2
INCLUIR
INCLUIRITEM
c26_produto=33
c25_detalhamentoReceita=000005
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=72
c39_camposExtras_Valor=OBSERVACAO
SALVARCAMPOEXTRA
SALVARITEM
SALVAR

Manager Saas:

Tx2ComplementarGNRE=formato=tx2\nINCLUIR\nINCLUIRITEM\nc26_produto=33\nc25_detalhamentoReceita=000005\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Codigo=72\nc39_camposExtras_Valor=OBSERVACAO\nSALVARCAMPOEXTRA\nSALVARITEM\nSALVAR

 

Segue um exemplo de arquivo TX2 Complementar para TO - Homologação

Componente:

formato=tx2
INCLUIR
INCLUIRITEM
c26_produto=33
c25_detalhamentoReceita=000005
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=108
c39_camposExtras_Valor=OBSERVACAO
SALVARCAMPOEXTRA
SALVARITEM
SALVAR

Manager Saas:

Tx2ComplementarGNRE=formato=tx2\nINCLUIR\nINCLUIRITEM\nc26_produto=33\nc25_detalhamentoReceita=000005\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Codigo=108\nc39_camposExtras_Valor=OBSERVACAO\nSALVARCAMPOEXTRA\nSALVARITEM\nSALVAR

 

1.3.7 - Rio de Janeiro

Segue um exemplo de arquivo TX2 Complementar para RJ:

Componente:

formato=tx2
INCLUIR
c22_telefoneEmitente
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=117
c39_camposExtras_Valor=2025-01-16
SALVARCAMPOEXTRA
SALVAR

Manager Saas:

tx2complementargnre=formato=tx2\nINCLUIR\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Codigo=117\nc39_camposExtras_Valor=2025-01-16\nSALVARCAMPOEXTRA\nSALVAR

 

Receitas e Tags consideradas na geração da GNRe

 

Quando o XML destinatário for referente a uma NFe:

Receita FCP - Código 100129

<vFCPUFDest>
<vFCPST>

Receita PARTILHA ICMS - Código 100102

<vICMSUFDest>

Receita ST - Código 100099

<vST>

 

Quando o XML destinatário for referente a um CTe:

Receita TRANSPORTE - Código 100030

<vICMSUFFim>
<vICMSOutraUF>
<vICMS>

 

Documentações de apoio:

 

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.

Ícone de Chat