Estrutura Simples das Tags do XML
Estrutura de tags | ||||||
Nome | Pai | Tipo | Tam | Obrigatório | Máscara | Descrição |
gnre id=”rps:xxxx” tssversao =”2.00” | -- | -- | -- | Sim | -- | Tag raiz do XML. Informe o atributo ID. (Ex.: rps id=”rps:1016”) e o atributo versão (Ex: tssversao=”2.00”) |
identgnre | gnre | -- | -- | Sim | -- | Tag raiz que agrupará as tags pertinentes a nota fiscal. |
uf | identgnre | Alfanumérico | 2 | Sim | -- | Código da Unidade federativa Favorecida. (Utilize a tabela do IBGE). |
numerognre | identgnre | Alfanumérico | 10 | Sim | -- | Número identificador da GNRE. |
codarea | identgnre | Alfanumérico | 1 | Não | -- | Código da área de serviço. |
receita | identgnre | Numérico | 6 | Sim | -- | Código da receita. |
detreceita | identgnre | Numérico | 6 | Sim | -- | Código do Detalhamento da Receita. |
produto | identgnre | Alfanumérico | 10 | Sim | -- | Código do Produto. |
vencimento | identgnre | Data | 10 | Sim | AAAA-MM-DD |
Data de vencimento da guia. |
convenio | identgnre | Numérico | 30 | Não | -- | Número do convênio. |
pagamento | identgnre | Data | 10 | Sim | AAAA-MM-DD | Data de pagamento da guia. |
tipodocorig | identgnre | Alfanumérico | 2 | Sim | -- | Código do Tipo de Documento de Origem. |
fatogerador | identgnre | Data | 1 | Não | AAAA-MM-DD | Data do fato gerador. |
observacoes | identgnre | Alfanumérico | 255 | Não | -- | Valor de observações. |
informacoes | identgnre | Alfanumérico | 255 | Sim | -- | Valor de informações. |
infcompl | identgnre | Alfanumérico | 255 | Sim | -- | Informações a serem adicionadas. |
dtsaimerc | identgnre | Alfanumérico | 44 | Sim | -- | ID da NFS-e no ERP a ser substituída. |
diavencimento | identgnre | Data | 2 | Sim | -- | Dia do vencimento. |
tipoimport | identgnre | Alfanumérico | 10 | Não | -- | Tipo de importação. |
banco | identgnre | Alfanumérico | 5 | Não | -- | Dados do banco. |
agencia | identgnre | Alfanumérico | 6 | Não | -- | Dados da agência. |
docorigem | identgnre | Numérico | 20 | Não | -- | Número do documento de origem. |
numproc | identgnre | Numérico | 30 | Sim | -- | Número do processo. |
cnpjcpfnf | identgnre | Numérico | 14 | Sim | -- | CNPJ da nota fiscal. |
dataemissaonf | identgnre | Data | 10 | Não | AAAA-MM-DD | Data de emissão da nota fiscal. |
numeronf | identgnre | Alfanumérico | 9 | Não | -- | Número da nota fiscal. |
serienf | identgnre | Alfanumérico | 3 | Não | -- | Série da Nota fiscal. |
tiponf | identgnre | Numérico | 2 | Não | -- | Tipo de nota fiscal. |
chavenf | identgnre | Numérico | 25 | Não | -- | Chave da nota fiscal. |
emitente | gnre | Numérico | 1 | Não | -- | -- |
cnpjcpf | emitente | Numérico | 14 | Sim | -- | CNPJ do emitente. |
nome | emitente | Alfanumérico | 30 | Sim | -- | Nome do emitente. |
ie | emitente | Alfanumérico | 14 | Sim | -- | Inscrição estadual do emitente. |
endereco | emitente | Alfanumérico | 100 | Sim | -- | Endereço do emitente. |
municipio | emitente | Alfanumérico | 7 | Não | -- | Código do município do emitente. |
uf | emitente | Alfanumérico | 2 | Sim | -- | UF do emitente. |
cep | emitente | Numérico | 2 | Não | -- | Cep do emitente. |
telefone | emitente | Numérico | 2 | Não | -- | Telefone do emitente. |
emitente | Numérico | 10 | Sim | -- | E-mail do emitente. | |
inscufavorecida | emitente | -- | 01 | Não | -- | Inscrição da UF favorecida. |
valores | gnre | Alfanumérico | -- | Sim | -- | -- |
qtde | valores | Numérico | 5 | Não | -- | Quantidade de guia. |
atumonetaria | valores | Numérico | 15 | Não | -- | Atualização Monetária. |
juros | valores | Numérico | 15 | Não | -- | Juros |
multa | valores | Numérico | 15 | Não | -- | Multa |
valordeducao | valores | Numérico | 15 | Não | -- | Valor dedução. |
atualizacao | valores | Numérico | 15 | Não | -- | Valor de quando há variação da VRTE. |
principal | valores | Numérico | 15 | Sim | -- | Valor principal. |
total | valores | Numérico | 10 | Sim | -- | Valor total. |
destinatario | gnre | Alfanumérico | -- | -- | -- | -- |
cnpjcpf | destinatario | Numérico | 14 | Sim | -- | CNPJ do destinatário. |
ie | destinatario | Numérico | 14 | Sim | -- | Inscrição estadual do destinatário. |
nome | destinatario | Alfanumérico | 50 | Sim | -- | Nome do destinatário. |
municipio | destinatario | Numérico | 5 | Sim | -- | Código do Município do destinatário. |
inscufavorecida | destinatario | Numérico | 01 | Não | -- | Inscrição da UF favorecida. 1 - Sim 2 - Não |
referencia | gnre | Alfanumérico | -- | -- | -- | -- |
periodo | referencia | Numérico | 14 | Sim | -- | Tipo de período. Os valores válidos são: · 0 – Mensal; · 1 – 1° Quinzena; · 2 – 2° Quinzena; · 3 – 1° Decêndio; · 4 – 2° Decêndio; · 5 – 3° Decêndio. |
mes | referencia | Data | 02 | Não | 99 | Mês de referência. |
ano | referencia | Data | 04 | Não | 9999 | Ano de referência. |
parcela | referencia | Numérico | 3 | Não | -- | Parcela |
transporte | gnre | -- | -- | -- | -- | -- |
manifcarga | transporte | Alfanumérico | 20 | Não | -- | Manifesto de Carga. |
cti | transporte | Alfanumérico | 120 | Sim | -- | Razão social do tomador. |
dtdesmbaraco | transporte | Data | 10 | Não | -- | Data do desembarque. |
valoradua | transporte | Numérico | 14 | Não | -- | Valor aduaneiro. |
sintegra | gnre | Alfanumérico | 9 | Não | -- | Sintegra |
protocoloTED | sintegra | Alfanumérico | 10 | Não | -- | Protocolo TED de transmissão do Sintegra. |
justificativa | sintegra | Sintegra | 100 | Não | -- | Justificativa |
camposadic | gnre | -- | -- | -- | -- | -- |
campoadic | camposadic | -- | -- | -- | -- | -- |
cod | campoadic | Numérico | 2 | Não | -- | Código do campo adicional. |
tipo | campoadic | Alfanumérico | 1 | Não | -- | Tipo do campo adicional. |
valor | campoadic | Alfanumérico | 100 | Não | -- | Valor do campo adicional. |
Avisos:
Estrutura Simples das Tags do XML
Estrutura de tags (Tags utilizadas para GNRE ambiente nacional.) |
||||||
Nome | Pai | Tipo | Tam | Obrigatório | Máscara | Descrição |
gnre id=”rps:xxxx” tssversao =”2.00” | -- | -- | -- | Sim | -- | Tag raiz do XML. Informe o atributo ID. (Ex.: rps id=”rps:1016”) e o atributo versão (Ex: tssversao=”2.00”) |
versaoGuia | raiz | Alfanumérico | 4 | Sim | 1.00 ou 2.00 | Informar a versão da Guia que está sendo utilizada. (GNRE 2.0 permite o envio do layout da GNRE 1.0) |
dadosGNRE | raiz | -- | -- | Sim | -- | TAG de grupo que contém as informações da GNR-e. |
tipoGnre | dadosGNRE | C | 1 | 1-1 | -- | 0 - GNRE Simples 1 - GNRE Multiplos Doc. de Origem 2 - GNRE Multiplas Receitas |
uf | dadosGNRE | C | 1 | 1-1 | -- | Código da UF Favorecida. (Utilizar a Tabela do IBGE). |
numeroGNRE | dadosGNRE | N | 10 | 0-1 | -- | Número Identificador da Guia. |
emitente | dadosGNRE | raiz | -- | 0-1 | -- | TAG de grupo que contém as informações do Emitente da GNRE. |
cnpjcpf | emitente | N | 14 | 0-1 | -- | CNPJ do emitente. |
nome | emitente | Alfanumérico | 60 | 0-1 | -- | Nome da firma ou a Razão Social do Contribuinte. |
ie | emitente | Alfanumérico | 14 | 1-1 | Inscrição Estadual do emitente. | |
endereco | emitente | Alfanumérico | 100 | 0-1 | -- | Endereço do contribuinte. |
municipio | emitente | N | 7 | 0-1 | -- | Código do Município de localização do Contribuinte.(Utilizar a tabela do IBGE) |
uf | emitente | C | 2 | 0-1 | -- | UF do Contribuinte. |
cep | emitente | N | 8 | 0-1 | -- | CEP do Contribuinte. |
telefone | emitente | N | 6-11 | 0-1 | [0-9] | Telefone do contribuinte. |
inscufavorecida | emitente | Numérico | 01 | Sim | -- | Inscrição da UF favorecida. 1 - Sim 2 - Não |
itensGNRE | dadosGNRE | raiz | -- | 0-1 | -- | TAG de grupo que contém os itens da GNRE. |
item | itensGNRE | -- | -- | 1-100 | -- | TAG que agrupa os detalhes do item. |
identgnre | item | -- | -- | Sim | -- | -- |
receita | identgnre | N | 6 | Sim | -- | Código da receita. |
detreceita | identgnre | N | 6 | Sim | -- | Código do Detalhamento da Receita. |
docorig | identgnre | N | 1-44 | 0-1 | [0-9] | Número do Documento de Origem. |
tipodocorig | identgnre | N | 2 | 0-1 | [0-9] | Tipo do Documento de Origem. ** |
produto | identgnre | Alfanumérico | -- | 0-1 | [1-9]{1}[0-9]{0,3} | Código do Produto. |
dataemissaonf | identgnre | Data | 10 | Não | AAAA-MM-DD | Data de emissão da nota fiscal. |
numeronf | identgnre | Alfanumérico | 9 | Não | -- | Número da nota fiscal. |
chavenf | identgnre | Numérico | 25 | Não | -- | Chave da nota fiscal. |
vencimento | identgnre | Data | 10 | 0-1 | AAAA-MM-DD | Data de vencimento da guia. |
convenio | identgnre | Alfanumérico | 30 | Não | -- | Número do convênio. |
valores | item | raiz | -- | -- | -- | Valores detalhados da Guia. Tipo: 11 - Valor Principal ICMS |
atumonetaria | valores | N | -- | 0-2 | <atumonetaria tipo="código"> | Tag para informar o valor de atualização monetária e detalhar seu tipo pelo código. |
juros | valores | N | -- | 0-2 | <juros tipo="código"> | Tag para informar o valor de juros e detalhar seu tipo pelo código. |
multa | valores | N | -- | 0-2 | <multa tipo="código"> | Tag para informar o valor de multa e detalhar seu tipo pelo código. |
principal | valores | Alfanumérico | -- | 0-2 | <principal tipo="código"> | Tag para informar o valor principal e detalhar seu tipo pelo código. |
total | valores | N | 10 | 0-2 | <total tipo="código"> | Tag para informar o valor total e detalhar seu tipo pelo código. |
destinatario | item | raiz | -- | 0-1 | -- | Tag para agrupar informações do contribuinte destinatário. |
cnpjcpf | destinatario | Numérico | 14 | Sim | -- | CNPJ do destinatário. |
ie | destinatario | Numérico | 14 | Sim | -- | Inscrição estadual do destinatário. |
nome | destinatario | Alfanumérico | 50 | Sim | -- | Nome do destinatário. |
municipio | destinatario | Numérico | 5 | Sim | -- | Código do Município de Destino.(Utilizar a tabela do IBGE). |
inscufavorecida | destinatario | Numérico | 01 | Sim | -- | Inscrição da UF favorecida. 1 - Sim 2 - Não |
referencia | item | raiz | -- | 0-1 | TAG para agrupar Informações de período de apuração. | |
periodo | referencia | N | 2 | 0-1 | [0-5] | Indicador do Período: 0 – mensal; 1 - 1a. quinzena; 2 - 2a. quinzena; 3 - 1o. decêndio; 4 - 2o. decêndio; 5 - 3o. decêndio; |
mes | referencia | N | 2 | 0-1 | MM - [01-12] | Mês de referência da Apuração. |
ano | referencia | N | 4 | 0-1 | AAAA | Ano de referência da Apuração. |
parcela | referencia | C | -- | 0-1 | [1-9]{1}[0-9]{0,2} | Parcela de referência da Apuração. |
camposadic | item | raiz | -- | -- | -- | Tag para agrupar informações adicionais. |
campoadic | camposadic | -- | -- | 0-3 | -- | -- |
cod | campoadic | Numérico | 2 | 1-1 | -- | Código do campo adicional. |
tipo | campoadic | Alfanumérico | 1 | 0-1 | -- | Tipo do campo adicional. |
valor | campoadic | Alfanumérico | 100 | 1-1 | -- | Observação do valor do campo adicional. |
numeroControle | item | Alfanumérico | 1-20 | 0-1 | [0-9] | Número de controle |
numeroControleFecp | item | Alfanumérico | 1-20 | 0-1 | [0-9] | Número de controle do FECP |
valorGNRE | dadosGNRE | N | 13,2 | 0-1 | -- | Valor da Guia. |
pagamento | dadosGNRE | Data | 10 | 10 | AAAA-MM-DD | Data prevista de pagamento informada pelo contribuinte. |
incluirArquivoPagamento | dadosGNRE | Alfanumérico | 1 | 0-1 | -- | Indica se o Arquivo de Pagamento das Guias do Lote deve ser incluído no retorno da consulta do Lote. Valores aceitos: S, N ou não informar o campo. |
Tipo de documento de origem <tipodocorig>
Caso não seja informado a tag <tipodocorig> ou seja informada com conteúdo em branco o TSS irá verificar o retorno do método GETCONFGNREUF¹ e irá alimentar essa tag com a informação esperada pela SEFAZ.²
¹ método que verifica os campos esperados no XML conforme Receita+UF informados
² somente irá alimentar a TAG quando a combinação Receita+UF espere apenas 01 (um) tipo de documento de origem.
<gnre id="gnre:935004013" tssversao="2.00"> <versaoGuia>2.00</versaoGuia> <dadosGNRE> <tipoGnre></tipoGnre> <uf></uf> <numerognre></numerognre> <emitente></emitente> <itensGNRE></itensGNRE> <valorGNRE></valorGNRE> <pagamento></pagamento> </dadosGNRE> </gnre>