14.7. Local de Entrega
14.7.1. local de entrega 2G
14.7. Local de Entrega
« Anterior
14.7.2. local de entrega NT201805 [09/03/19]
Próximo »

14.7.1. local de entrega 2G

Funcionalidade para gerar o XML do grupo de informações do local de entrega

Assinatura

string localEntrega2G(string CNPJ, string CPF, string xLgr, string nro, string xCpl, string xBairro, string cMun, string xMun, string UF)

Descrição:

Funcionalidade para gerar o XML do grupo de informações do local de entrega da versão 2.00/3.10 do leiaute da NF-e.

Dica

Este grupo de informação só deve ser informado nos casos em que o local de entrega seja diferente do endereço do destinatário, cabendo ressaltar que é necessário que a situação esteja prevista na legislação, como é o caso da obra de construção civil.

Parâmetros:

nome tipo tam. obrig. descrição
CNPJ string 14 sim informar o CNPJ, sem formatação ou máscara
CPF string 11 sim informar o CPF, sem formatação ou máscara (campo novo)
xLgr string 2-60 sim informar o logradouro do local de entrega
nro string 1-60 sim informar o número do endereço do local de entrega, 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 local de entrega, pode ser omitido
xBairro string 2-60 sim informar o bairro do endereço do local de entrega
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

Diagrama:

DiagramaLocalEntrega

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 Local de Entrega

XML:

Exemplo de XML da versão 2.00/3.10 do leiaute da NF-e

    <entrega>
      <CPF>11111111111</CPF>
      <xLgr>AV FARIA LIMA</xLgr>
      <nro>1500</nro>
      <xCpl>15 ANDAR</xCpl>
      <xBairro>PINHEIROS</xBairro>
      <cMun>3550308</cMun>
      <xMun>SAO PAULO</xMun>
      <UF>SP</UF>
    </entrega>

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 Object
 
Set objNFeUtil = CreateObject("NFe_Util_2G.Util")
 
'
'========grupo de informações do local de Entrega (grupo G do Manual de Integração)=========
'
'        <>&" são caracteres reservados do XML e devem ser evitados ou substituídos
'        por &lt; &gy; &amp; &quot;
'
'        Vale ressaltar que as aplicações das UF devem mostrar DIAS &amp; DIAS TENTANDO S/A,
'        pois não entedem &amp; como &, assim talvez seja melhor substituir o & por e.
'
locEnt_CNPJ = "00000000000191"                 ' CNPJ sem máscara de formatação
locEnt_CPF  = ""                               ' CPF sem máscara de formatação
locEnt_xLgr = "Rua Libero Badaro"              ' logradouro
locEnt_nro = "280"                             ' número, informar S/N quando inexistente para evitar o erro de Schema XML
locEnt_xCpl = "10 andar"                       ' complemento do endereço, o conteúdo pode ser omitido
locEnt_xBairro = "CENTRO"                      ' bairro
locEnt_cMun = "3550308"                        ' código do município, deve ser compatível com a UF
locEnt_xMun = "SAO PAULO"                      ' nome do município
locEnt_UF = "SP"                               ' sigla da UF

'
'   gera grupo do local de entrega
'
locEntrega = objNFeUtil.localEntrega2G(locEnt_CNPJ, locEnt_CPF, locEnt_xLgr, locEnt_nro, locEnt_xCpl, locEnt_xBairro, locEnt_cMun, locEnt_xMun, locEnt_UF)

Delphi

 
procedure TForm1.Button7Click(Sender: TObject);
var
Util: Olevariant;
 
//======  Dados do Local de Entrega==========
locEntrega: widestring;
locEnt_CPF: widestring;
locEnt_xNome: widestring;
locEnt_xLgr: widestring;
locEnt_nro: widestring;
locEnt_xCpl: widestring;
locEnt_xBairro: widestring;
locEnt_cMun: widestring;
locEnt_xMun: widestring;
locEnt_UF: widestring;
 
//
//========================== campo novo
//
 
locEnt_CNPJ: widestring;
 
 
begin
//
//========grupo de informações do local de Entrega(grupo G do Manual de Integração)=========
//
//        <>&'; são caracteres reservados do XML e devem ser evitados ou substituídos
//        por &lt; &gy; &amp; &quot;
//
//        Vale ressaltar que as aplicações das UF devem mostrar DIAS &amp; DIAS TENTANDO S/A,
//        pois não entedem &amp; como &, assim talvez seja melhor substituir o & por e.
//
locEnt_CNPJ := '00000000000191';                 // CNPJ sem máscara de formatação
locEnt_CPF := '';                                // CPF sem máscara de formatação
locEnt_xLgr := 'Rua Libero Badaro';              // logradouro
locEnt_nro := '280';                             // número, informar S/N quando inexistente para evitar erro de Schema XML
locEnt_xCpl := '10 andar';                       // complemento do endereço, o conteúdo pode ser omitido
locEnt_xBairro := 'CENTRO';                      // bairro
locEnt_cMun := '3550308';                        // código do município, deve ser compatível com a UF
locEnt_xMun := 'SAO PAULO';                      // nome do município
locEnt_UF := 'SP';                               // sigla da UF
 
//
//   gera grupo do local de Retirada
//
 
Util := CreateOleObject('NFe_util_2G.util');
 
locEntrega :=Util.localEntrega2G(locEnt_CNPJ, locEnt_CPF, locEnt_xLgr, locEnt_nro, locEnt_xCpl, locEnt_xBairro, locEnt_cMun, locEnt_xMun, locEnt_UF);
 
memoXML.Text := StringReplace(locEntrega, '><', '>'+#13+#10+'<',[rfReplaceAll, rfIgnoreCase]);
 
end;
14.7.1. local de entrega 2G
14.7. Local de Entrega
« Anterior
14.7. Local de Entrega
Próximo »
14.7.2. local de entrega NT201805 [09/03/19]