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, é 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.
Layouts
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.
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.
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.
Layout para UF´s do Servidor Nacional
Segue um exemplo de arquivo TX2 Complementar para UF´s do servidor nacional (usado até a versão manual 1.00):
formato=tx2
INCLUIR
c26_produto=3
c25_detalhamentoReceita=000012
c33_dataPagamento=2020-12-31
INCLUIRCAMPOEXTRA
c39_camposExtras_Valor=Observacao da guia
SALVARCAMPOEXTRA
SALVAR
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 :
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
A exigência dos campos varia de estado para estado, e recomenda-se não informar um campo que não é exigido. Quando não é exigido nenhum campo, não é necessário informar o TX2 Complementar.
Os campos possíveis de serem informados são:
- c01_UfFavorecida: Sigla da UF favorecida.
- c02_receita: código da receita. As receitas que são usadas pelo Componente GNRE são: Partilha de ICMS (100102), Substituição Tributária (100099), Fundo de Combate a Pobreza (100129) e Transporte (100030). OBS: caso não seja informada a receita será preenchida automaticamente. *Obs 1
- 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 (clique em "Detalhamento das Receitas"). 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). *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"). Tipicamente exigido para as guias de Substituição Tributária (100099). *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. *Obs 1
- c14_dataVencimento: data de vencimento da guia. Caso não informada é usado o mesmo dia da geração da guia. (Formato yyyy-mm-dd) *Obs 1
- c15_convenio: número do convênio. *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: últimos 5 dígitos do código IBGE do município do contribuinte.
- 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: Cpf 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 de pagamento informada pelo contribuinte. Caso não informada é usado o mesmo dia da geração da guia. (Formato yyyy-mm-dd)
- c05_referencia_periodo: código do período de apuração da guia. Os códigos são: 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 é suportado 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. *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 abaixo.
formato=tx2
INCLUIR
c33_dataPagamento=2021-12-31
INCLUIRITEM
c26_produto=3
c25_detalhamentoReceita=000012
SALVARITEM
SALVAR
formato=tx2
INCLUIR
c33_dataPagamento=2021-12-31
INCLUIRITEM
c26_produto=3
c25_detalhamentoReceita=000012
SALVARITEM
SALVAR
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 abaixo.
No momento, os campos da seção extra estão sendo necessários apenas para quando a UF for TO.
formato=tx2
INCLUIR
c33_dataPagamento=2021-12-31
INCLUIRITEM
c26_produto=3
c25_detalhamentoReceita=000012
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=50
c39_camposExtras_Valor=Observacao da guia
SALVARCAMPOEXTRA
SALVARITEM
SALVAR
Atenção! Critérios adotados na forma de preencher o TX2 complementar com vários itens:
-
Se informar + 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.
Segue abaixo a relação das receitas aceitas por cada UF:
UF | Receita(s) |
AC | PartilhaICMS, ST e Transporte |
AL | PartilhaICMS, ST, FCP e Transporte |
AM | PartilhaICMS, ST, FCP e Transporte |
AP | PartilhaICMS, ST e Transporte |
BA | PartilhaICMS, ST, FCP e Transporte |
CE | PartilhaICMS, ST, FCP e Transporte |
DF | PartilhaICMS, ST, FCP e Transporte |
GO | PartilhaICMS, ST e Transporte |
MA | PPartilhaICMS, ST, FCP e Transporte |
MG | PartilhaICMS, ST, FCP e Transporte |
MS | PartilhaICMS, ST, FCP e Transporte |
MT | PartilhaICMS, ST, FCP e Transporte |
PA | PartilhaICMS, ST e Transporte |
PB | PartilhaICMS, ST, FCP e Transporte |
PE | PartilhaICMS, ST, FCP e Transporte |
PI | PartilhaICMS, ST, FCP e Transporte |
PR | PartilhaICMS, ST e Transporte |
RJ | PartilhaICMS, ST e Transporte |
RN | PartilhaICMS, ST, FCP e Transporte |
RO | PartilhaICMS, ST e Transporte |
RR | PartilhaICMS, ST e Transporte |
RS | PartilhaICMS, ST, FCP e Transporte |
SC | PartilhaICMS, ST e Transporte |
SE | PartilhaICMS, ST, FCP e Transporte |
TO | PartilhaICMS, ST, FCP e Transporte |
Segue abaixo a relação dos campos exigidos para cada UF:
UF | Campos exigidos | Receita que exige * |
AC | c26_produto | ST |
AL | c26_produto | ST |
AM | c26_produto | ST |
AP | Nenhum | |
BA | c26_produto | ST |
CE | c26_produto | ST |
DF | c26_produto | ST |
GO | c26_produto | ST |
MA | c25_detalhamentoReceita, c26_produto | ST |
MG | c25_detalhamentoReceita | FCP |
MS | c25_detalhamentoReceita (opcional), c26_produto | Partilha e ST, respectivamente |
MT | Nenhum | |
PA | Nenhum | |
PB | Nenhum | |
PE | c26_produto | ST |
PI | c26_produto | ST |
PR | Nenhum | |
RJ | Nenhum | |
RN | c26_produto | ST |
RO | Nenhum | |
RR | c26_produto | ST |
RS | Nenhum | |
SC | c26_produto | ST |
SE | c26_produto | ST |
TO | c26_produto, c39_camposExtras_Valor | ST e FCP, respectivamente |
* Partilha: Partilha de ICMS; ST: Substituição Tributária; FCP: Fundo de Combate a Pobreza).
Layout do TX2 do Espírito Santo
Segue um exemplo de arquivo TX2 Complementar para ES:
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
Descrição dos campos:
- 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.
Layout do TX2 de Alagoas (GNRe 2.0)
Segue um exemplo de arquivo TX2 Complementar para AL:
formato=tx2
INCLUIR
c22_telefoneEmitente=1234567890
INCLUIRITEM
c26_produto=68
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=108
c39_camposExtras_Valor=35200507099389000113550010000390961011901028
SALVARCAMPOEXTRA
SALVARITEM
SALVAR
Observações:
- O campo de produto para Alagoas é obrigatório
Layout do TX2 de Mato Grosso (GNRe 2.0)
Segue um exemplo de arquivo TX2 Complementar para MT- Produção
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
Layout do TX2 de Minas Gerais (GNRe 2.0)
Segue um exemplo de arquivo TX2 Complementar para MG:
formato=tx2
INCLUIR
INCLUIRITEM
c25_detalhamentoReceita=000052
SALVARITEM
SALVAR
Observações:
- O campo de DetalhamentoReceita é obrigatório
Layout do TX2 de Rio Grande do Sul (GNRe 2.0)
Segue um exemplo de arquivo TX2 Complementar para RS:
formato=tx2
INCLUIR
INCLUIRITEM
c04_docOrigem=35201162525647000194550030000297651005410451
c28_tipoDocOrigem=22
SALVARITEM
SALVAR
Layout do TX2 de Tocantins (GNRe 2.0)
Segue um exemplo de arquivo TX2 Complementar para TO - Produção
formato=tx2
INCLUIR
INCLUIRITEM
c26_produto=33
c25_detalhamentoReceita=000005
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=72
c39_camposExtras_Valor=OBSERVACAO
SALVARCAMPOEXTRA
SALVARITEM
SALVAR
Segue um exemplo de arquivo TX2 Complementar para TO - Homologação
formato=tx2
INCLUIR
INCLUIRITEM
c26_produto=33
c25_detalhamentoReceita=000005
INCLUIRCAMPOEXTRA
c39_camposExtras_Codigo=108
c39_camposExtras_Valor=OBSERVACAO
SALVARCAMPOEXTRA
SALVARITEM
SALVAR
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.