14.6. Local de Retirada
14.6.1. local de retirada 2G
14.6. Local de Retirada
« Anterior
14.6.2. local de retirada NT201805 [09/03/19]
Próximo »

14.6.1. local de retirada 2G

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

Assinatura

string localRetirada2G(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 retirada 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 retirada seja diferente do endereço do remetente, 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 r (campo novo)
xLgr string 2-60 sim informar o logradouro do local de retirada
nro string 1-60 sim informar o número do endereço do local de retirada, 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 retirada, pode ser omitido
xBairro string 2-60 sim informar o bairro do endereço do local de retirada
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:

DiagramaLocalRetirada

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 Retirada

XML:

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

    <retirada>
      <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>
    </retirada>

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 Retirada(grupo F 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.
'
locRet_CNPJ = "00000000000191"                 ' CNPJ sem máscara de formatação
locRet_CPF = ""                                ' CPF sem máscara de formatação
locRet_xLgr = "Rua Libero Badaro"              ' logradouro
locRet_nro = "280"                             ' número, informar S/N quando inexistente para evitar erro de Schema XML
locRet_xCpl = "10 andar"                       ' complemento do endereço, o conteúdo pode ser omitido
locRet_xBairro = "CENTRO"                      ' bairro
locRet_cMun = "3550308"                        ' código do município, deve ser compatível com a UF
locRet_xMun = "SAO PAULO"                      ' nome do município
locRet_UF = "SP"                               ' sigla da UF

'
'   gera grupo do local de Retirada
'
locRetirada = objNFeUtil.localRetirada2G(locRet_CNPJ, locRet_CPF, locRet_xLgr, locRet_nro, locRet_xCpl, locRet_xBairro, locRet_cMun, locRet_xMun, locRet_UF)

Delphi

 
procedure TForm1.Button6Click(Sender: TObject);
 
var
Util: Olevariant;
 
//======  Dados do Local de Retirada==========
locRetirada: widestring;
locRet_CPF: widestring;
locRet_xNome: widestring;
locRet_xLgr: widestring;
locRet_nro: widestring;
locRet_xCpl: widestring;
locRet_xBairro: widestring;
locRet_cMun: widestring;
locRet_xMun: widestring;
locRet_UF: widestring;
 
//
//========================== campo novo
//
 
locRet_CNPJ: widestring;
 
 
begin
//
//========grupo de informações do local de Retirada(grupo F 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.
//
locRet_CNPJ := '00000000000191';                 // CNPJ sem máscara de formatação
locRet_CPF := '';                                // CPF sem máscara de formatação
locRet_xLgr := 'Rua Libero Badaro';              // logradouro
locRet_nro := '280';                             // número, informar S/N quando inexistente para evitar erro de Schema XML
locRet_xCpl := '10 andar';                       // complemento do endereço, o conteúdo pode ser omitido
locRet_xBairro := 'CENTRO';                      // bairro
locRet_cMun := '3550308';                        // código do município, deve ser compatível com a UF
locRet_xMun := 'SAO PAULO';                      // nome do município
locRet_UF := 'SP';                               // sigla da UF
 
//
//   gera grupo do local de Retirada
//
 
Util := CreateOleObject('NFe_util_2G.util');
 
locRetirada :=Util.localRetirada2G(locRet_CNPJ, locRet_CPF, locRet_xLgr, locRet_nro, locRet_xCpl, locRet_xBairro, locRet_cMun, locRet_xMun, locRet_UF);
 
end;
14.6.1. local de retirada 2G
14.6. Local de Retirada
« Anterior
14.6. Local de Retirada
Próximo »
14.6.2. local de retirada NT201805 [09/03/19]