- 16.4. Destinatário da NF-e
16.4.2. Destinatário da NF-e 2G - 16.4.1. Destinatário da NF-e
« Anterior - 16.5. Local de Retirada
Próximo »
16.4.2. Destinatário da NF-e 2G
Funcionalidade para gerar o XML do grupo do Destinatário da NF-e da versão 2.00 do Leiaute
Assinatura
string destinatario2G(string CNPJ, string CPF, string xNome, string xLgr, string nro, string xCpl, string xBairro, string cMun, string xMun, string UF, string CEP, string cPais, string xPais, string fone, string IE, string IESUF, string eMail)
Descrição:
Funcionalidade para gerar o XML do grupo do Destintário da NF-e da versão 2.00 do leiaute da NF-e.
Parâmetros:
| nome | tipo | tam. | obrig. | descrição |
|---|---|---|---|---|
| CNPJ | string | 14 | sim | informar o CNPJ do destinatário, sem formatação ou máscara |
| CPF | string | 11 | sim | CPF do destinatário, sem formatação ou máscara |
| xNome | string | 2-60 | sim | informar a razão social do destinatário |
| xLgr | string | 2-60 | sim | informar o logradouro do destinatário |
| nro | string | 1-60 | sim | informar o número do endereço do destinatário, campo obrigatório. Informar S/N ou . (ponto) ou - (traço) para evitar falha de schema XML quando não houver número. |
| xCpl | string | 1-60 | não | informar o complemento do endereço do destinatário, pode ser omitido |
| xBairro | string | 2-60 | sim | informar o bairro do endereço do destinatário |
| cMun | string | 7 | sim | informar o código do município na codificação do IBGE com 7 dígitos |
| xMun | string | 2-60 | sim | informar o nome do município |
| UF | string | 2 | sim | informar a sigla da UF |
| CEP | string | 8 | não | informar o CEP, sem formatação ou máscara, pode ser omitido |
| cPais | string | 4 | não | informar o código do pais na codificação do BCB, se informado deve ser 1058 |
| xPais | string | 6 | não | informar o nome do país, se informado deve ser Brasil ou BRASIL |
| fone | string | 6-14 | não | informar o telefone com DDD + número, sem formatação (tamanho do campo aumentado) |
| IE | string | 0-14 | sim | informar a IE do destinatário, sem formatação ou máscara |
| ISUF | string | 8-9 | não | informar a Inscrição SUFRAMA do destinatário, sem formatação ou máscara, se existir. |
| string | 1-60 | não | informar o e-mail do destinatário, pode ser omitido (campo novo) |
Diagrama:
Dica
Os campos com contorno tracejado podem ser omitidos se a operação não exigir a informação.
Os campos em verde são tags novas ou tags que sofreram alteração na definição na versão 2.00 do leiaute.
Retorno:
Um string com o grupo XML do destinatário
XML:
Exemplo de XML da versão 2.00 do leiaute da NF-e
<dest> <CNPJ>00000000000191</CNPJ> <xNome>DISTRIBUIDORA DE AGUAS MINERAIS</xNome> <enderDest> <xLgr>AV DAS FONTES</xLgr> <nro>1777</nro> <xCpl>10 ANDAR</xCpl> <xBairro>PARQUE FONTES</xBairro> <cMun>5030801</cMun> <xMun>Sao Paulo</xMun> <UF>SP</UF> <CEP>13950000</CEP> <cPais>1058</cPais> <xPais>BRASIL</xPais> <fone>1932011234</fone> </enderDest> <IE></IE> <email>contato@nf-eletronica.com</email> <!-- acrescimo do email do destinatario, para maiores detalhes veja item 9.12 da NT 2009/006 --> </dest>
Importante
O trecho do XML foi formatado para uma melhor visualização, a mensagem original não tem formatação.
Vale observar que a formatação pode corromper a assinatura digital, além de ocupar espaço e ser desnecessária, pois os browser exibem formatado.
Exemplos de uso:
Visual Basic 6.0
' inicializar variáveis '............................................... Dim objNFeUtil As NFe_Util_2G.Util Set objNFeUtil = New NFe_Util_2G.Util ' '========grupo de identificação do destinatario (grupo E do Manual de Integração - versão 3.00 - páginas 99)======= ' ' <>&" são caracteres reservados do XML e devem ser evitados ou substituídos ' por < &gy; & " ' ' Vale ressaltar que as aplicações das UF devem mostrar DIAS & DIAS TENTANDO S/A, ' pois não entedem & como &, assim talvez seja melhor substituir o & por e. ' dest_CNPJ = "00000000000191" ' CNPJ do destinatario sem máscara de formatação dest_CPF = "" ' CPF do destinatario sem máscara de formatação dest_xNome = "Banco do Brasil S/A" ' Razão social do destinatario, evitar caracteres acentuados e & dest_xLgr = "Rua Libero Badaro" ' logradouro dest_nro = "280" ' número, informar S/N quando inexistente para evitar erro de Schema XML dest_xCpl = "10 andar" ' complemento do endereço, o conteúdo pode ser omitido dest_xBairro = "CENTRO" ' bairro dest_cMun = "3550308" ' código do município (vide página 141 do manual), deve ser compatível com a UF dest_xMun = "SAO PAULO" ' nome do município dest_UF = "SP" ' sigla da UF dest_CEP = "01315000" ' CEP - sem máscara dest_cPais = "1058" ' código do pais - deve fixo em 1058 - Brasil dest_xPais = "Brasil" ' nome do pais (Brasil ou BRASIL) dest_fone = "1133221234" ' número do telefone sem máscara dest_IE = "123456789011" ' Inscrição Estadual do destinatario sem máscara dest_IESUF = "" ' Inscrição SUFRAMA dest_eMail = "contato@bb.com.br" ' e-mail do destinatário ' ' gera grupo do destinatário ' dest = objNFeUtil.destinatario2G(dest_CNPJ, dest_CPF, dest_xNome, dest_xLgr, dest_nro, dest_xCpl, dest_xBairro, dest_cMun, dest_xMun, dest_UF, dest_CEP, dest_cPais, dest_xPais, dest_fone, dest_IE, dest_IESUF, dest_eMail)
Delphi
procedure TForm1.Button5Click(Sender: TObject); var Util: Olevariant; //====== Dados do Destinatário========== dest: widestring; dest_CNPJ: widestring; dest_CPF: widestring; dest_xNome: widestring; dest_xLgr: widestring; dest_nro: widestring; dest_xCpl: widestring; dest_xBairro: widestring; dest_cMun: widestring; dest_xMun: widestring; dest_UF: widestring; dest_CEP: widestring; dest_cPais: widestring; dest_xPais: widestring; dest_fone: widestring; dest_IE: widestring; dest_IESUF: widestring; //========================== campos novos dest_eMail:widestring; begin // //========grupo de identificação do destinatario (grupo E do Manual de Integração - versão 3.00 - páginas 99)======= // // <>&'; são caracteres reservados do XML e devem ser evitados ou substituídos // por < &gy; & " // // Vale ressaltar que as aplicações das UF devem mostrar DIAS & DIAS TENTANDO S/A, // pois não entedem & como &, assim talvez seja melhor substituir o & por e. // dest_CNPJ := '00000000000191'; // CNPJ do destinatario sem máscara de formatação dest_CPF := ''; // CPF do destinatario sem máscara de formatação dest_xNome := 'Banco do Brasil S/A'; // Razão social do destinatario, evitar caracteres acentuados e & dest_xLgr := 'Rua Libero Badaro'; // logradouro dest_nro := '280'; // número, informar S/N quando inexistente para evitar erro de Schema XML dest_xCpl := '10 andar'; // complemento do endereço, o conteúdo pode ser omitido dest_xBairro := 'CENTRO'; // bairro dest_cMun := '3550308'; // código do município (vide página 141 do manual), deve ser compatível com a UF dest_xMun := 'SAO PAULO'; // nome do município dest_UF := 'SP'; // sigla da UF dest_CEP := '01315000'; // CEP - sem máscara dest_cPais := '1058'; // código do pais - deve fixo em 1058 - Brasil dest_xPais := 'Brasil'; // nome do pais (Brasil ou BRASIL) dest_fone := '1133221234'; // número do telefone sem máscara dest_IE := '123456789011'; // Inscrição Estadual do destinatario sem máscara dest_IESUF := ''; // Inscrição SUFRAMA dest_eMail := 'contato@bb.com.br'; // e-mail do destinatário // // gera grupo do destinatário // Util := CreateOleObject('NFe_util_2G.util'); dest := Util.destinatario2G(dest_CNPJ, dest_CPF, dest_xNome, dest_xLgr, dest_nro, dest_xCpl, dest_xBairro, dest_cMun, dest_xMun, dest_UF, dest_CEP, dest_cPais, dest_xPais, dest_fone, dest_IE, dest_IESUF, dest_eMail); end;
- 16.4.2. Destinatário da NF-e 2G
16.4. Destinatário da NF-e - « Anterior
16.4.1. Destinatário da NF-e - Próximo »
16.5. Local de Retirada