- 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:
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 < &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. ' 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 < &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. // 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]