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:
- Servidor Nacional, que suporta a maioria dos estados (exceto SP e ES) ;
- 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\nc01_UfFavorecida=RJ\nc03_CnpjContribuinteEmitente=00000000000000\nc16_razaoSocialEmitente=NOME EMITENTE COM DEVIDOS ESPAÇAMENTOS\nc18_enderecoEmitente=ENDEREÇO COM DEVIDO ESPAÇAMENTOS\nc20_ufEnderecoEmitente=INFORMAR SIGLA UF\nINCLUIRITEM\nc02_receita=INFORMAR Nº RECEITA DEVIDA\nINCLUIRCAMPOEXTRA\nc39_camposExtras_Codigo=117\nc39_camposExtras_Valor=2025-06-04(DT EMISSÃO DOCUMENTO ELETRONICO)\nSALVARCAMPOEXTRA\nSALVARITEM\nINCLUIRVALOR\nc06_valorPrincipal=VALOR PRINCIPAL DO DOCUMENTO ELETRONICO\nSALVARVALOR\nSALVAR
chave='00000000000000000000000000000000000000000000'
1.3.8 - Bahia
Segue um exemplo de arquivo TX2 Complementar para BA:
Componente:
formato=tx2
INCLUIR
c33_dataPagamento=
INCLUIRITEM
c14_dataVencimento=
c28_tipoDocOrigem=
c04_docOrigem=
SALVARITEM
SALVAR
Manager Saas:
tx2complementargnre=formato=tx2\nINCLUIR\nc33_dataPagamento=AAAA-MM-DD\nINCLUIRITEM\nc14_dataVencimento=AAAA-MM-DD\nc28_tipoDocOrigem=INFORMAR\nc04_docOrigem=00000000000000000000000000000000000000000000\nSALVARITEM\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:
- Códigos de Detalhamento de Receita de Transporte permitidas por UF - CTe
- Códigos de Receita e Detalhamento de Receita permitidas por UF - NFe
- Informações no Preenchimento
Comentários
0 comentário
Por favor, entre para comentar.