Endereço de Entrega em NFe
🚀 Novidade — disponível a partir da versão 18.0
O envio automático do endereço de entrega na NFe foi liberado nos módulos edoo_br_nfe 18.0.1.5.0 e edoo_br_edocs_schemas 18.0.1.1.0. Se o seu ambiente estiver em uma versão anterior, fale com a Edoo para atualizar.
O que mudou
Em muitas operações, a mercadoria não é entregue no endereço do destinatário da nota: venda com entrega em obra, filial ou centro de distribuição, e-commerce com endereço de entrega próprio, remessa a terceiros. A legislação da NF-e prevê exatamente para isso o grupo Local de Entrega no arquivo transmitido ao governo.
A partir desta versão, quando a nota fiscal eletrônica possui um contato de Entrega diferente do Partner (destinatário), o Edoo Fiscal escreve automaticamente os campos do endereço de entrega no arquivo de envio da NFe — sem nenhuma digitação adicional.
Como funciona
- O documento eletrônico (NFe) possui dois contatos: Partner (destinatário da nota) e Entrega (local onde a mercadoria será entregue). O campo Entrega é herdado automaticamente da fatura/pedido de venda.
- Se o contato de Entrega for diferente do Partner, ao criar o arquivo da nota (e também no envio pelo botão Enviar Agora) o sistema inclui os campos
*_entregalogo após os dados principais da NFe. - A regra vale somente para NFe modelo 55 (mercadorias). NFCe, NFSe e NFCom não são afetadas.
- Se a Entrega for igual ao Partner (ou estiver vazia), nada muda: o arquivo continua exatamente como antes.
- O documento de identificação acompanha o tipo do contato de entrega: CNPJ para pessoa jurídica ou CPF para pessoa física — nunca os dois.
Notas Fiscais
FAT/2026/00123
| Tipo Edoc | Internal | Tipo de Operação | Saída |
| Modelo | 55 - NFe | Posição Fiscal | 5102/6102 - Revenda de Mercadorias |
| Partner | Maria Exemplo da Silva | Natureza da Operação | 5102/6102 - Revenda de Mercadorias |
| CNPJ/CPF | 123.456.789-09 | ||
| Entrega | LOGISTICA MODELO LTDA |
✔️ Neste exemplo, o contato de Entrega é diferente do Partner — os campos do endereço de entrega serão incluídos automaticamente no arquivo da NFe.
O que é enviado ao governo
Os campos abaixo passam a compor o arquivo da NFe, logo após os dados principais da nota (dados fictícios):
"cpf_destinatario": "12345678909",
"nome_destinatario": "Maria Exemplo da Silva",
"municipio_destinatario": "São Paulo",
"uf_destinatario": "SP",
"modalidade_frete": "9",
"cnpj_entrega": "12345678000190",
"codigo_municipio_entrega": "3509502",
"nome_entrega": "LOGISTICA MODELO LTDA",
"logradouro_entrega": "Avenida Exemplo",
"numero_entrega": "1000",
"municipio_entrega": "Campinas",
"bairro_entrega": "Distrito Industrial",
"uf_entrega": "SP",
"cep_entrega": "13000000",
"duplicatas": [ ... ],
"items": [ ... ]
Configuração dos campos (ação da equipe Edoo)
A lista de campos de entrega enviados ao governo é definida no schema de campos da posição fiscal, no novo objeto JSON "NFE Entrega". Cada campo aponta para a informação correspondente do contato de entrega — por exemplo:
| Objeto JSON | Campo | Campo de Objeto Referência |
| NFE Entrega | cnpj_entrega | partner_shipping_id.l10n_br_cnpj_cpf |
| NFE Entrega | nome_entrega | partner_shipping_id.l10n_br_legal_name |
| NFE Entrega | logradouro_entrega | partner_shipping_id.street |
| NFE Entrega | numero_entrega | partner_shipping_id.l10n_br_number |
| NFE Entrega | bairro_entrega | partner_shipping_id.l10n_br_district |
| NFE Entrega | municipio_entrega | partner_shipping_id.city_id.name |
| NFE Entrega | codigo_municipio_entrega | partner_shipping_id.city_id.l10n_br_ibge_code_full |
| NFE Entrega | uf_entrega | partner_shipping_id.state_id.code |
| NFE Entrega | cep_entrega | partner_shipping_id.zip |
🛠️ Importante: a configuração dos campos de "NFE Entrega" no schema é uma ação da equipe de suporte da Edoo. Se a sua operação emite notas com local de entrega diferente do destinatário e você deseja ativar este recurso, solicite pelo e-mail [email protected] informando a(s) posição(ões) fiscal(is) utilizada(s).
Perguntas frequentes
Preciso preencher algo na hora de emitir a nota?
Não. Basta o pedido/fatura ter um endereço de entrega diferente do destinatário — o campo Entrega da NFe é preenchido automaticamente e os dados vão no arquivo.
E se a entrega for no próprio endereço do cliente?
Nada muda: quando Entrega e Partner são o mesmo contato, o grupo de entrega não é incluído no arquivo, como manda a regra da NF-e.
Vale para NFCe e NFSe?
Não. O recurso é exclusivo da NFe modelo 55 (circulação de mercadorias).
O endereço de entrega precisa estar completo no cadastro?
Sim. Os dados enviados vêm do cadastro do contato de entrega (endereço, município, CEP, CNPJ/CPF) — mantenha esse cadastro completo para evitar rejeições do governo.
Ficou com dúvida? Fale com a gente pela Central de Ajuda ou pelo e-mail [email protected].