PrestaShop Checkout & Pagamento

DataFirefly Address Lookup: Preenchimento Automático de Morada no Checkout PrestaShop 8 e 9

Preenchimento automático de morada no checkout: Google Places para Portugal, API pública gratuita para França

Reduza os erros de morada e acelere a encomenda. O cliente começa a escrever a morada e as sugestões completam a rua, a localidade e o código postal.

PrestaShop 8 e 9 Google Places Conforme o RGPD Sem base de dados
  • Reembolso em 30 dias
  • 12 meses de atualizações
  • Suporte em 24h
www.datafirefly.com/pt/
Preenchimento automático de morada no checkout do PrestaShop
v1.1.0 · atualizado 2026-08-23
O que faz

A versão curta.

01

Google Places para Portugal e para o mundo

Ligue a sua chave do Google Places e beneficie de cobertura mundial, incluindo Portugal continental e ilhas. Restrição por lista de países autorizados para controlar o orçamento.

02

API pública francesa gratuita para o mercado francês

Se também vende para França, o módulo usa data.geopf.fr/geocodage, a API oficial do Estado francês baseada na Base Adresse Nationale: sem chave, sem custo e com cobertura exaustiva do território francês.

03

Código postal, localidade e rua

O cliente começa a escrever a morada e a sugestão preenche a rua, o número, a localidade e o código postal de uma só vez, com uma morada normalizada.

04

PrestaShop 8 e 9

Compatível com os temas Classic e Hummingbird e com o checkout de página única ou em várias etapas. Hooks padrão, sem overrides de template, sem tabelas na base de dados.

A versão longa

Tudo o que quer saber antes de instalar.

Uma análise detalhada de como o DataFirefly Address Lookup: Preenchimento Automático de Morada no Checkout PrestaShop 8 e 9 funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.

§ 01

O problema invisível que sai caro: moradas mal escritas

Um em cada dez clientes escreve a morada com um erro, uma rua incompleta ou um código postal errado. Resultado: entregas devolvidas, custos de reexpedição, apoio ao cliente sobrecarregado e carrinhos abandonados no checkout. No PrestaShop, o formulário de morada nativo não dá qualquer ajuda: o cliente escreve às cegas. O DataFirefly Address Lookup resolve isso transformando o formulário de morada num assistente que propõe, completa e valida em tempo real.

§ 02

Em Portugal, o motor é o Google Places

Não existe hoje uma API pública gratuita de moradas em Portugal equivalente à francesa, por isso o motor recomendado para uma loja portuguesa é o Google Places. Introduza a sua chave na configuração, restrinja-a por referenciador HTTP na Google Cloud Console e o módulo passa a sugerir moradas portuguesas normalizadas, com rua, número, localidade e código postal no formato XXXX-XXX. Pode ainda limitar o Google a uma lista de países (PT, ES, FR, por exemplo) para controlar o orçamento da Google Cloud.

§ 03

A API francesa BAN, gratuita e oficial, para o mercado francês

Se também vende para França, o módulo usa por predefinição a data.geopf.fr/geocodage, a API oficial do Estado francês. É a mesma base usada pelos serviços postais e pelos sistemas de informação públicos: cobertura exaustiva do território francês, atualização contínua e moradas normalizadas. Sem chave de API, sem subscrição e sem custo de utilização. Este motor cobre apenas França e não devolve moradas portuguesas.

§ 04

O percurso do cliente

O cliente começa a preencher a morada. Com o Google Places, escreve as primeiras letras da rua e as sugestões aparecem no menu do módulo; um clique preenche os campos de uma só vez com uma morada normalizada. Com o motor francês, escreve os cinco dígitos do código postal e a localidade preenche-se sozinha (ou aparece um seletor de localidades se houver várias), e depois a rua é sugerida filtrada por esse código postal. Em ambos os casos: poucas interações, nenhuma escrita inútil.

§ 05

Integração sem atrito em todos os checkouts

O módulo liga-se ao hook padrão actionFrontControllerSetMedia e só injeta o JavaScript e o CSS nas páginas que contêm um formulário de morada: encomenda, a minha morada, os meus dados e registo. Sem overrides de templates Smarty. Sem tabelas na base de dados. Sem dependência de um tema específico: o Classic, o Hummingbird e a maioria dos temas de terceiros funcionam sem configuração.

§ 06

Robustez: compatível com checkout de página única e vários formulários

O checkout de página única do PrestaShop reapresenta o formulário de morada a cada mudança de etapa, e algumas extensões de terceiros fazem o mesmo. O módulo lida com essas reapresentações através de um MutationObserver ligado aos eventos nativos do PrestaShop: updatedAddressForm, updatedAddress, updatedDeliveryForm e changedCheckoutStep. Se estiverem dois formulários de morada visíveis em simultâneo (envio e faturação), cada um recebe o seu próprio preenchimento automático independente.

§ 07

Desempenho e privacidade: sem servidor intermédio

Todos os pedidos de sugestão partem diretamente do navegador do cliente para a API escolhida (Google ou BAN). O seu servidor PrestaShop nunca é chamado pelo módulo durante a escrita: sem carga de CPU, sem largura de banda consumida, sem latência acrescentada. Quanto ao RGPD: nenhum dado passa pela DataFirefly, nenhuma recolha do lado da DataFirefly e nenhum cookie de terceiros é colocado pelo módulo.

§ 08

Configuração em dois minutos

Instale o módulo e abra a configuração. Para Portugal: ative a opção Google Places, cole a chave e escolha a lista de países autorizados. Para França, já está funcional de origem. Defina o número mínimo de carateres antes de disparar a pesquisa, o atraso de debounce e a ativação ou não do realce dos termos correspondentes. Nenhuma linha de código a alterar.