- 16.5. Local de Retirada
16.5.2. local de retirada 2G - 16.5.1. local de retirada
« Anterior - 16.6. Local de Entrega
Próximo »
16.5.2. local de retirada 2G
Funcionalidade para gerar o XML do grupo de informações do local de retirada
Assinatura
string localRetirada(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 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 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 NFe_Util_2G.Util Set objNFeUtil = New 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;
- 16.5.2. local de retirada 2G
16.5. Local de Retirada - « Anterior
16.5.1. local de retirada - Próximo »
16.6. Local de Entrega