15. Converter um TXT em XML da NF-e
15.3. TXT em XML da versão 3.10 da NF-e [19-02-15]
15.2. TXT em XML da versão 2.00 da NF-e [28-09-13]
« Anterior
15.4. TXT em XML da versão 3.10 (NT2015/003) [14-12-15]
Próximo »

15.3. TXT em XML da versão 3.10 da NF-e [19-02-15]

Funcionalidade que permite converter um arquivo Texto gerado no padrão do emissor gratuito da NF-e em XML da NF-e.

Assinatura

string Txt2XML310(string txt, int geraChaveNFe, string codigoSeguranca, out string txtNumerado, out int resultado, out string erros, out int qtErros, out string msgResultado)

Não existe garantia que esta funcionalidade será atualizada para a próxima alteração do leiaute da NF-e, pois a SEFAZ/SP demora para liberar o leiaute do TXT, assim recomendos o uso das funcionalidades de geração do XML oferecido pela DLL que é atualizado a cada mudança de versão do leiaute.

Registro ID evento tag tam observação
A Alt versao 4 alteração do conteúdo para 3.10
Inc pk_nItem - acréscimo do pk_nItem - informar qualquer valor ou omitir
B B06 Alt mod 2 alteração de valor (novo domínio):
55=NF-e emitida em substituição a Nota Fiscal modelo 1/1A;
65=NFC-e, utilizada nas operações de vendas no varejo, onde não for exigida a NF-e por dispositivo legal
B09 Sub dhEmi (ex dEmi) 23 alteração do nome da tag e do conteúdo para informar a data e hora da emissão no formato UTC ("AAAA-MM-DDThh:mm:ss-zz:zz").
Exemplo: "2014-09-14T12:00:00-03:00", para informar data: 14/09/2014, horário: 12:00:00 e fuso horário de Brasília: -03:00.
B10 Sub dhSaiEnt (ex dSaiEnt) 23 alteração do nome da tag e do conteúdo para informar a data e hora de entrada ou saída(s) da(s) mercadoria(s) no formato UTC ("AAAA-MM-DDThh:mm:ss-zz:zz").
Exemplo: "2014-09-14T12:00:00-03:00", para informar data: 14/09/2014, horário: 12:00:00 e fuso horário de Brasília: -03:00.
B10a Exc hSaiEnt - tag eliminada, a hora de saída ou entrada passa a ser informada na tag dhSaiEnt.
B11a Inc idDest 1 nova tag para informar o local de destino da operação.
Valores válidos:
1=Operação interna;
2=Operação interestadual;
3=Operação com exterior.
B21 Alt tpImp 1 alteração de valor (novo domínio):
0=Sem geração de DANFE;
1=DANFE normal, Retrato;
2=DANFE normal, Paisagem;
3=DANFE Simplificado;
4=DANFE NFC-e;
5=DANFE NFC-e em mensagem eletrônica.
Nota: O envio de mensagem eletrônica pode ser feita de forma simultânea com a impressão do DANFE. Usar o tpImp=5 na NFC-e quando esta for a única forma de disponibilização do DANFE.
B22 Alt tpEmis 1 alteração de valor (novo domínio):
1=Emissão normal (não em contingência);
2=Contingência FS-IA, com impressão do DANFE em formulário de segurança obsoleto;
3=Contingência SCAN (Sistema de Contingência do Ambiente Nacional)obsoleto;
4=Contingência DPEC (Declaração Prévia da Emissão em Contingência)obsoleto;
5=Contingência FS-DA, com impressão do DANFE em formulário de segurança;
6=Contingência SVC-AN (SEFAZ Virtual de Contingência do AN);
7=Contingência SVC-RS (SEFAZ Virtual de Contingência do RS);
9=Contingência off-line da NFC-e;
Nota: Para a NFC-e somente estão disponíveis e são válidas as opções de contingência 5 e 9.
B25 Alt finNFe 1 alteração de valor (novo domínio): 1=NF-e normal;
2=NF-e complementar;
3=NF-e de ajuste;
4=Devolução de mercadoria.
B25a Inc indFinal 1 nova tag para indicar operação com Consumidor final.
Valores válidos: 0=Normal; 1=Consumidor final;
B25b Inc indPres 1 nova tag para indicar a presença do comprador no estabelecimento comercial no momento da operação.
Valores válidos:
0=Não se aplica (por exemplo, para a Nota Fiscal complementar ou de ajuste);
1=Operação presencial;
2=Operação não presencial, pela Internet;
3=Operação não presencial, Teleatendimento;
4=NFC-e em operação com entrega em domicílio;
9=Operação não presencial, outros.
Nota: Para a NFC-e, somente são aceitas as opções 1 e 4;
B28 Sub dhCont 23 alteração para inclusão do fuso horário na data e hora da entrada em contingência no formato UTC ("AAAA-MM-DDThh:mm:ss-zz:zz").
Exemplo: "2014-09-14T12:00:00-03:00", para informar data: 14/09/2014, horário: 12:00:00 e fuso horário de Brasília: -03:00.
B13 BA02 Alt - - alteração na identificação do registro
B14 BA03 Alt - - alteração na identificação do registro
B20a BA10 Alt - - alteração na identificação do registro
B20d BA13 Alt - - alteração na identificação do registro
B20e BA14 Alt - - alteração na identificação do registro
B20i BA19 Alt - - alteração na identificação do registro
B20j BA20 Alt - - alteração na identificação do registro
E E16a Inc idIEDest 1 nova tag para indicar da IE do Destinatário.
Valores válidos:
1=Contribuinte ICMS (informar a IE do destinatário);
2=Contribuinte isento de Inscrição no cadastro de Contribuintes do ICMS;
9=Não Contribuinte, que pode ou não possuir Inscrição Estadual no Cadastro de Contribuintes do ICMS;
Nota 1: No caso de NFC-e informar indIEDest=9 e não informar a tag IE do destinatário;
Nota 2: No caso de operação com o Exterior informar indIEDest=9 e não informar a tag IE do destinatário;
Nota 3: No caso de Contribuinte Isento de Inscrição (indIEDest=2), não informar a tag IE do destinatário.
E03a Inc idEstrangeiro 1 nova tag para informar a identificação do destinatário no caso de comprador estrangeiro.
Informar esta tag no caso de operação com o exterior, ou para comprador estrangeiro.
Informar o número do passaporte ou outro documento legal para identificar pessoa estrangeira (campo aceita valor nulo "").
GA Inc - - acréscimo de novo grupo de informação: Autorização para obter XML
GA02 Inc CNPJ 14 nova tag para informar o CNPJ da pessoa autorizada a ter acesso ao XML da NF-e.
Não informar o CNPJ do destinatário, rementente ou transportar.
GA03 Inc CPF 11 nova tag para informar o CPF da pessoa autorizada a ter acesso ao XML da NF-e.
Não informar o CNPJ do destinatário, rementente ou transportar.
I I05a Inc NVE 6 nova tag para informar "NVE - Nomenclatura de Valor Aduaneiro e Estatística" para complementar o NCM.
I70 Inc nFCI 37 nova tag para informar número do nFCI -Conteúdo de Importação, informação relacionada com a Resolução 13/2012 do Senado Federal. Formato: Algarismos, letras maiúsculas de "A" a "F" e o caractere hífen.
Exemplo: B01F70AF-10BF-4B1F-848C-65FF57F616FE
I08 I23a Inc tpViaTransp 1-2 nova tag para informar a Via de transporte internacional informada na Declaração de Importação (DI). Valores válidos:
1=Marítima;
2=Fluvial;
3=Lacustre;
4=Aérea;
5=Postal;
6=Ferroviária;
7=Rodoviária;
8=Conduto / Rede Transmissão;
9=Meios Próprios; 10=Entrada / Saída ficta;
I23b Inc vAFRMM 13v2 nova tag para informar o Valor da AFRMM - Adicional ao Frete para Renovação da Marinha Mercante quando se tratar de via de trasnporte maritíma.
I23c Inc tpIntermedio 1 nova tag para informar a Forma de importação quanto a intermediação.
Valores válidos:
1=Importação por conta própria;
2=Importação por conta e ordem;
3=Importação por encomenda;
I23d Inc CNPJ 14 nova tag para informar o CNPJ do adquirente ou do encomendante.
Informação obrigatória no caso de importação por conta e ordem ou por encomenda. Informar os zeros não significativos.
I23e Inc UFTerceiro 2 nova tag para informar a sigla da UF do adquirente ou do encomendante.
Informação obrigatória no caso de importação por conta e ordem ou por encomenda. Não aceita o valor "EX".
I25 I29a Inc nDraw 11 nova tag para informar o número do Número do ato concessório de Drawback.
I50 I51 Inc nDraw 11 novo grupo de informação detExport, informar o número do Número do ato concessório de Drawback.
I52 I53 Inc nRE 12 nova tag para informar o Número do Registro de Exportação
I54 Inc chNFe 44 nova tag para informar a Chave de Acesso da NF-e recebida com fim específico de exportação.
I55 Inc qExport 11v4 nova tag para informar a Quantidade do item realmente exportado.
A unidade de medida desta quantidade é a unidade de comercialização deste item
LA LA03 Inc pMixGN 2v4 nova tag para informar o Percentual de Gás Natural para o produto GLP (cProdANP=210203001).
LB LB01 Inc nRECOPI 20 nova tag para informar o Número do RECOPI.
N04 N27a Inc vICMSDeson 13v2 nova tag para informar o Valor do ICMS desonerado quando a tag motDesICMS for informado com: 3, 9 ou 12.
N04 N28 Inc motDesICMS 1-2 nova tag para informar o Motivo da desoneração do ICMS, preencher somente os seguintes motivos da desoneração:
3=Uso na agropecuária;
9=Outros;
12=Órgão de fomento e desenvolvimento agropecuário.
N05 N27a Inc vICMSDeson 13v2 nova tag para informar o Valor do ICMS desonerado quando a tag motDesICMS for informado com:
6, 7 ou 9.
N05 N28 Inc motDesICMS 1-2 nova tag para informar o Motivo da desoneração do ICMS, preencher somente os seguintes motivos da desoneração:
6=Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio (Resolução 714/88 e 790/94 - CONTRAN e suas alterações);
7=SUFRAMA;
9=Outros;
N06 N27a Inc vICMSDeson 13v2 nova tag para informar o Valor do ICMS desonerado quando preencher apenas nas operações:
Informar apenas nas operações:
a) com produtos beneficiados com a desoneração condicional do ICMS.
b) destinadas à SUFRAMA, informando-se o valor que seria devido se não houvesse isenção;
c) de venda a órgão da administração pública direta e suas fundações e autarquias com isenção do ICMS;
N06 N28 Inc motDesICMS 1-2 nova tag para informar o Motivo da desoneração do ICMS:
1=Táxi;
3=Produtor Agropecuário;
4=Frotista/Locadora;
5=Diplomático/Consular;
6=Utilitários e Motocicletas da Amazônia Ocidental e Áreas de Livre Comércio (Resolução 714/88 e 790/94 - CONTRAN e suas alterações);
7=SUFRAMA; 8=Venda a Órgão Público;
9=Outros;
10=Deficiente Condutor (Convênio ICMS 38/12);
11=Deficiente Não Condutor (Convênio ICMS 38/12).
Nota: Revogada a partir da versão 3.01 a possibilidade de usar o motivo 2=Deficiente Físico.
N07 N16a Inc vICMSOp 13v2 nova tag para informar o Valor do ICMS da Operação caso não houvesse diferimento.
N07 N16b Inc pDif 3v2-4 nova tag para informar o percentual do diferimento, informar 100 no caso de diferimento total.
N07 N16c Inc vICMSDif 13v2 nova tag para informar o Valor do ICMS da Operação que foi diferido.
N09 N27a Inc vICMSDeson 13v2 nova tag para informar o Valor do ICMS desonerado quando a tag motDesICMS for informado com: 3, 9 ou 12.
N09 N28 Inc motDesICMS 1-2 nova tag para informar o Motivo da desoneração do ICMS, preencher somente os seguintes motivos da desoneração:
3=Uso na agropecuária;
9=Outros;
12=Órgão de fomento e desenvolvimento agropecuário.
N10 N27a Inc vICMSDeson 13v2 nova tag para informar o Valor do ICMS desonerado quando a tag motDesICMS for informado.
N10 N28 Inc motDesICMS 1-2 nova tag para informar o Motivo da desoneração do ICMS.
U01 U07 Inc vDeducao 13v2 nova tag para informar o Valor dedução para redução da Base de Cálculo.
U08 Inc vOutro 13v2 nova tag para informar o Valor outras retenções.
U09 Inc vDescIncond 13v2 nova tag para informar o Valor desconto incondicionado.
U10 Inc vDescCond 13v2 nova tag para informar o Valor desconto condicionado.
U11 Inc vISSRet 13v2 nova tag para informar o Valor retenção ISS.
U12 Inc indISS 1-2 nova tag para informar o Indicador da exigibilidade do ISS. Valores válidos:
1=Exigível,
2=Não incidência;
3=Isenção;
4=Exportação;
5=Imunidade;
6=Exigibilidade Suspensa por Decisão Judicial;
7=Exigibilidade Suspensa por Processo Administrativo.
U13 Inc cServico 1-20 nova tag para informar o Código do serviço prestado dentro do município.
U14 Inc cMun 7 nova tag para informar o Código do Município de incidência do imposto.
Tabela do IBGE. Informar "9999999" para serviço fora do País
U15 Inc cPais 7 nova tag para informar o Código do Município de incidência do imposto.
Tabela do BACEN. Infomar somente se o município da prestação do serviço for "9999999".
U16 Inc nProcesso 1-30 nova tag para informar o Número do processo judicial ou administrativo de suspensão da exigibilidade.
Informar somente quando declarada a suspensão da exigibilidade do ISSQN.
U17 Inc indIncentivo 1 nova tag para informar o Indicador de incentivo Fiscal: 1=Sim; 2=Não;
UA01 Inc - - acréscimo de novo grupo de informação: Informação do Imposto devolvido
UA02 Inc pDevol 3v2 nova tag para informar Percentual da mercadoria devolvida.
Nota: O valor máximo deste percentual é 100%, no caso de devolução total da mercadoria.
UA04 Inc vIPIDevol 13v2 nova tag para informar o Valor do IPI devolvido.
W01 W04a Inc vICMSDeson 13v2 nova tag para informar o Valor Total do ICMS desonerado.
W17 W22a Inc dCompet 10 nova tag para informar a Data da prestação do serviço. Formato: "AAAA-MM-DD".
W22b Inc vDeducao 13v2 nova tag para informar o Valor total dedução para redução da Base de Cálculo.
W22c Inc vOutro 13v2 nova tag para informar o Valor total outras retenções.
W22d Inc vDescIncond 13v2 nova tag para informar o Valor total desconto incondicionado.
W22e Inc vDescCond 13v2 nova tag para informar o Valor total desconto condicionado.
W22f Inc vISSRet 13v2 nova tag para informar o Valor total retenção ISS .
W22g Inc cRegTrib 1-2 nova tag para informar o Código do Regime Especial de Tributação. Valores válidos:
1=Microempresa Municipal;
2=Estimativa;
3=Sociedade de Profissionais;
4=Cooperativa;
5=Microempresário Individual (MEI);
6=Microempresário e Empresa de Pequeno Porte (ME/EPP).
YA Inc - - acréscimo de novo grupo de informação: Formas de pagamento (exclusivo da NFC-e)
YA02 Inc tPag 2 nova tag para informar a Forma de pagamento. Valores válidos: 01=Dinheiro;
02=Cheque;
03=Cartão de Crédito;
04=Cartão de Débito;
05=Crédito Loja;
10=Vale Alimentação;
11=Vale Refeição;
12=Vale Presente;
13=Vale Combustível;
99=Outros.
YA03 Inc vPag 13v2 nova tag para informar o Valor do Pagamento.
YA05 Inc CNPJ 14 nova tag para informar o Informar o CNPJ da Credenciadora de cartão de crédito / débito.
YA06 Inc tBand 14 nova tag para informar o Informar a Bandeira da operadora de cartão de crédito e/ou débito.
01=Visa;
02=Mastercard;
03=American Express;
04=Sorocred;
99=Outros.
YA07 Inc cAut 1-20 nova tag para informar o Número de autorização da operação cartão de crédito e/ou débito.
Identifica o número da autorização da transação da operação com cartão de crédito e/ou débito.


Descrição:

Funcionalidade que permite converter um arquivo Texto gerado no padrão do emissor gratuito da NF-e em XML da NF-e.

Parâmetros:

nome tipo fluxo descrição
txt string entrada informar a string com o TXT gerado de acordo com o leiaute da string TXT do Manual de importação-exportação TXT da NF-e (versão 3.1.0 - 24/11/2014)
IMPORTANTE: veja o quadro Dicas para conhecer as diferenças no leiaute.
geraChaveNFe inteiro entrada indicador para gerar a chave de acesso: 0 - não / 1 - sim
codigoSeguranca string entrada código de seguranca, o emissor deve adotar uma frase qualquer para dificultar que 3ºs descubram o Código Numérico que compõe a Chave de Acesso - cNF
txtNumerado string saída retorno o txt de entrada numerado para facilitar a localização do erro
resultado inteiro saída retorna o resultado da chamada da funcionalidade
erros string saída retorna a lista de erros ocorridos na conversão
qtErros int saída retorna a quantidade de erros encontrada
msgResultado string saída retorna a literal do resultado da chamada do WS

Dica

Crie o arquivo TXT de acordo com o Manual de importação-exportação TXT da NF-e (versão 3.1.0 - 24/11/2014)

O Anexo I - Leiaute da NF-e do Manual de Integração do Contribuinte é o documento que define os campos da NF-e.

NF-e - versão 3.10 Nota Técnica 2013.005 - v1.21

Diferenças de preenchimento de registros:

1. registro F e G

O registros do tipo F e G devem ser informados sem o CNPJ:

Exemplo: informar:

F|XLgr|Nro|XCpl|XBairro|CMun|XMun|UF|

ao invés de:

F|CNPJ|XLgr|Nro|XCpl|XBairro|CMun|XMun|UF|

2. registros N10, N10a e N10h

o pRedBC deve ser informando antes de vBC, na mesma ordem adotada nos registros tipo: N04, N07 e N09.

Exemplo:

N10h|Orig|CSOSN|modBC|pRedBC|vBC|pICMS|vICMS|modBCST|pMVAST|pRedBCST|vBCST|pICMSST|vICMSST|pCredSN|vCredICMSSN|

ao invés de:

N10h|Orig|CSOSN|modBC|vBC|pRedBC|pICMS|vICMS|modBCST|pMVAST|pRedBCST|vBCST|pICMSST|vICMSST|pCredSN|vCredICMSSN|

o pRedBC deve ser informando antes de vBC, na mesma ordem adotada nos registros tipo: N04, N07, N09, N10 e N10a.

3. registro N10g

O registro tipo N10g deve ser informado como:

N10g|Orig|CSOSN|vBCSTRet|vICMSSTRet|

ao invés de:

N10g|Orig|CSOSN|modBCST|vBCSTRet|vICMSSTRet|

Retorno:

Um string com o XML da NF-e resultado da conversão

O parâmetro resultado retorna um código numérico com os seguintes significados:

código Mensagem origem regra
6901 Conversão realizada com sucesso. DLL -
6902 Erro: txt informado sem conteúdo. DLL -
6903 Erro: geraChaveNFe com valor inválido [{0:0}]. DLL -
6904 Erro: código de segurança deve ser informado para geraChaveNFe=1. DLL -
6905 Erro: erro inexperado no tratamento do txt de entrada. [{0:0}] DLL -
6906 Erro: falha no preenchimento dos campos txt - qtde [{0:0}]. DLL -
6907 Erro: txt informado não tem nennhuma nota fiscal válida. DLL -
6908 Erro: txt informado tem mais de 1 nota fiscal. DLL -
6909 Erro: falha na conversão do TXT em XML. DLL -

Histórico de atualização:

15.3. TXT em XML da versão 3.10 da NF-e [19-02-15]
15. Converter um TXT em XML da NF-e
« Anterior
15.2. TXT em XML da versão 2.00 da NF-e [28-09-13]
Próximo »
15.4. TXT em XML da versão 3.10 (NT2015/003) [14-12-15]