Shopware Checkout & Pagamento

Preenchimento Automático de Moradas Shopware 6: multifornecedor BAN e Google Places

Os seus clientes escrevem 3 letras e a extensão preenche a morada completa

At a glance
  • Preenchimento automático de morada no checkout, na conta de cliente e no registo
  • 2 fornecedores incluídos: BAN (gratuito, França) e Google Places (mundial)
  • Arquitetura extensível: acrescente Mapbox, HERE ou Loqate através de uma interface PHP
  • Chave da API Google mantida do lado do servidor, nunca exposta ao navegador
  • Compatível com Shopware 6.6 e 6.7, configuração por sales channel
Shopware 6.6 Shopware 6.7 BAN gratuito Google Places Compatível com o RGPD
  • Reembolso em 30 dias
  • 12 meses de atualizações
  • Suporte em 24h
www.datafirefly.com/pt/
Preenchimento automático de morada no checkout Shopware 6 via BAN e Google Places
v1.0.0 · atualizado 2026-07-01
O que faz

A versão curta.

01

Menos erros de entrega

As moradas selecionadas vêm diretamente da BAN ou da Google: rua, código postal, localidade e país ficam normalizados. Acabam as encomendas devolvidas por morada inválida.

02

Checkout mais rápido

O cliente escreve três caracteres, escolhe a sugestão e todos os campos se preenchem: rua, complemento, código postal, localidade, país. A taxa de abandono no checkout desce por mecânica própria.

03

Dois fornecedores, zero compromissos

A BAN (api-adresse.data.gouv.fr) é gratuita e cobre toda a França, incluindo o ultramar. O Google Places (New) cobre o mundo inteiro, Portugal incluído. Alterna entre um e outro num clique na configuração.

04

Arquitetura aberta

Uma interface AutocompleteProviderInterface e uma tag Symfony bastam para ligar qualquer API de moradas: Mapbox, HERE, Loqate, o seu repositório interno. A extensão encaminha automaticamente cada sugestão para o fornecedor de origem.

05

Segurança e sobriedade

Todos os pedidos passam pelo seu servidor Shopware: a chave da Google nunca aparece no navegador. Uma cache de servidor opcional (5 min) reduz a facturação da Google e a latência.

A versão longa

Tudo o que quer saber antes de instalar.

Uma análise detalhada de como o Preenchimento Automático de Moradas Shopware 6: multifornecedor BAN e Google Places funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.

§ 01

Porque é que o preenchimento automático de moradas muda as suas conversões

O formulário de morada é a etapa mais fastidiosa do checkout: seis campos, erros de escrita, códigos postais errados. Cada atrito custa vendas e cada morada inválida custa uma encomenda devolvida. Esta extensão substitui a introdução manual por uma pesquisa instantânea: o cliente escreve o início da morada, aparece uma lista de sugestões, e um clique preenche todos os campos. Os dados vêm de um repositório oficial (BAN) ou da Google, pelo que estão normalizados e são entregáveis.

§ 02

BAN ou Google Places: escolha consoante o seu mercado

Se vende em França, a Base Adresse Nationale é imbatível: gratuita, sem chave de API, mantida pelo Estado, cobre a metrópole e o ultramar com precisão ao número de porta. Se vende em Portugal ou noutros mercados internacionais, o Google Places (New) assume, com cobertura mundial. A extensão usa os endpoints modernos da API Places v1 e mantém a sua chave do lado do servidor: nunca passa pelo navegador, o que simplifica a segurança do seu projeto Google Cloud.

§ 03

Uma arquitetura pensada para integradores

A extensão expõe uma interface AutocompleteProviderInterface e recolhe os fornecedores através da tag Symfony df_address_autocomplete.provider. Acrescentar Mapbox, HERE, Loqate ou um repositório interno de moradas resume-se a uma classe PHP e a três linhas de services.xml. Cada sugestão transporta o prefixo do seu fornecedor, pelo que o encaminhamento das chamadas de detalhe é automático mesmo que mude de fornecedor a meio da sessão.

§ 04

Instalação em cinco minutos

Carregue o ZIP, ative a extensão, compile o storefront e escolha o fornecedor na configuração. Todo o resto, ativação por página, restrição de país, antirressalto, cache, define-se a partir da administração do Shopware, com âmbito por sales channel se gerir várias lojas.