14. Gerar XML da NF-e
14.5. local de retirada NT201805
14.4. Destinatário da NF-e 3.10
« Anterior
14.6. local de entrega NT201805
Próximo »

14.5. local de retirada NT201805 [09/03/19]

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

Assinatura

string localRetiradaNT201805(string CNPJ, string CPF, string xNome_Opc, string xLgr, string nro, string xCpl_Opc, string xBairro, string cMun, string xMun, string UF, string CEP_Opc, string cPais_Opc, string xPais_Opc, string fone_Opc, string email_Opc, string IE_Opc)

Descrição:

Funcionalidade para gerar o XML do grupo de informações do local de retirada da versão 4.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
xNome_Opc string 2-60 não informar o Razão Social ou Nome do Recebedor
(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
CEP_Opc string 8 não informar Código do CEP com os zeros não significativos.
(campo novo)
cPais_Opc string 4 não informar o Código do País.
Utilizar a Tabela do BACEN (Anexo IX - Tabela de UF, Município e País).
(campo novo)
xPais_Opc string 2-60 não informar o Nome do País
(campo novo)
fone_Opc string 6-14 não informar o Telefone
Preencher com o Código DDD + número do telefone. Nas operações com exterior é permitido informar o código do país + código da localidade + número do telefone
(campo novo)
email_Opc string 1-60 não informar o Endereço de e-mail do Recebedor
(campo novo)
IE_Opc string 2-14 não informar Inscrição Estadual do Estabelecimento Recebedor
Informar somente os algarismos, sem os caracteres de formatação (ponto, barra, hífen, etc.).
(campo novo)

Diagrama:

DiagramaLocalRetirada

Dica

Os campos com contorno tracejado podem ser omitidos se a operação não exigir a informação.

Retorno:

Um string com o grupo XML do Local de Retirada

XML:

Exemplo de XML compatível com a versão anterior do grupo retirada

 
<retirada>
    <CPF>00000000191</CPF>
    <xLgr>Rua Libero Badaro</xLgr>
    <nro>280</nro>
    <xCpl>10 andar</xCpl>
    <xBairro>CENTRO</xBairro>
    <cMun>3550308</cMun>
    <xMun>SAO PAULO</xMun>
    <UF>SP</UF>
</retirada>

Exemplo de XML da versão completa do grupo retirada

 
<retirada>
    <CPF>00000000191</CPF>
    <xNome>Fulano de Tal</xNome>
    <xLgr>Rua Libero Badaro</xLgr>
    <nro>280</nro>
    <xCpl>10 andar</xCpl>
    <xBairro>CENTRO</xBairro>
    <cMun>3550308</cMun>
    <xMun>SAO PAULO</xMun>
    <UF>SP</UF>
    <CEP>01100100</CEP>
    <cPais>105</cPais>
    <xPais>Brasil</xPais>
    <fone>11332001234</fone>
    <email>fulano@tal.com.br</email>
</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 = ""                               ' CNPJ sem máscara de formatação
locRet_CPF = "00000000191"                     ' CPF sem máscara de formatação
locRet_xNome = ""                              ' Nome expedidor
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
locRet_CEP = ""                                ' CEP
locRet_cPais = ""                              ' código do país
locRet_xPais = ""                              ' nome do país
locRet_fone = ""                               ' telefone DDNNNNNNNNN
locRet_email = ""                              ' e-mail
locRet_IE = ""                                 ' Inscrição Estadual
'
'   gera grupo do local de Retirada
'
locRetirada = objNFeUtil.localRetiradaNT201805(locRet_CNPJ, locRet_CPF, locRet_xNome, locRet_xLgr, locRet_nro, locRet_xCpl, locRet_xBairro, locRet_cMun, locRet_xMun, locRet_UF, locRet_CEP, locRet_cPais, locRet_xPais, locRet_fone, locRet_email, locRet_IE)
 
MsgBox "local de retirada: " + locRetirada, vbInformation, "Resultado"

Exemplo de geração do XML completo do grupo retirada

 
' 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 = ""                               ' CNPJ sem máscara de formatação
locRet_CPF = "00000000191"                     ' CPF sem máscara de formatação
locRet_xNome = "Fulano de Tal"                 ' Nome expedidor
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
locRet_CEP = "011001001"                       ' CEP
locRet_cPais = "1058"                          ' código do país
locRet_xPais = "Brasil"                        ' nome do país
locRet_fone = "11332001234"                    ' telefone DDNNNNNNNNN
locRet_email = "fulano@tal.com.br"             ' e-mail
locRet_IE = ""                                 ' Inscrição Estadual
'
'   gera grupo do local de Retirada
'
locRetirada = objNFeUtil.localRetiradaNT201805(locRet_CNPJ, locRet_CPF, locRet_xNome, locRet_xLgr, locRet_nro, locRet_xCpl, locRet_xBairro, locRet_cMun, locRet_xMun, locRet_UF, locRet_CEP, locRet_cPais, locRet_xPais, locRet_fone, locRet_email, locRet_IE)
 
MsgBox "local de retirada: " + locRetirada, vbInformation, "Resultado"
14.5. local de retirada NT201805
14. Gerar XML da NF-e
« Anterior
14.4. Destinatário da NF-e 3.10
Próximo »
14.6. local de entrega NT201805