Um autocomplete de moradas para todas as lojas dos seus clientes

Para agências e freelancers que fazem lojas online em WooCommerce, PrestaShop, Shopify ou à medida: o cliente escolhe a rua numa lista e o código postal exato (CP7) preenche-se pelo número de porta, pronto para a etiqueta de envio. Grátis, sem chave de API, sem contrato — o mesmo plugin ou script em todos os projetos.

O que já está pronto

Tudo o que está abaixo é público e pode ser usado hoje, sem falar connosco primeiro.

• Plugin para WooCommerce. Instala-se a partir do ZIP descarregado deste site; está em revisão no diretório wordpress.org. Checkout em blocos e clássico, só aparece quando o país é Portugal, nada para configurar. Descarregar e instalar.
• Módulo para PrestaShop. Também em ZIP, para instalar pelo gestor de módulos; liga o widget ao formulário de morada no checkout e na área de cliente, só quando o país é Portugal. Descarregar e instalar.
• Widget de duas linhas. Para qualquer formulário onde possa incluir um script: carregar o widget.js e ligá-lo ao campo da morada; preenche código postal, localidade, concelho e distrito. Funciona com HTML simples, React e Vue. Widget.
• API REST e OpenAPI. Para integrações no servidor, lojas headless e aplicações: /suggest, /resolve, /cp e POST /batch para listas, com exemplos em curl, JavaScript, PHP, Python e C#. Início rápido · openapi.json.
• Guias por plataforma, com veredictos honestos. Shopify (no checkout só com uma app e só no Shopify Plus; nas páginas do tema, em qualquer plano), Magento (sim, com trabalho de programador), Wix (o checkout não aceita scripts; só em formulários próprios), Jumpseller (Checkout Classic sim, Checkout Standard não), Shopkit (sim, a partir de Aparência › Avançado). Cada guia diz o que é possível em cada plano ou versão e o que ainda não foi verificado numa loja real.
• Servidor MCP para agentes de IA. Se a sua equipa usa Claude, Cursor ou outro agente, ele lê a documentação e liga o Moradas ao checkout sozinho; o mesmo servidor dá-lhe as moradas e os códigos postais como ferramentas. Documentação.
• Página de estado. Estado atual do serviço, atualizações dos dados e registo de todas as alterações da API, do widget e dos plugins — para saber o que mudou antes de o cliente perguntar. Estado e alterações.

Como propor ao cliente

Três argumentos que o lojista entende sem ver código:

• Menos erros de entrega. Uma gralha na rua ou no código postal manda o estafeta para a morada errada: a encomenda volta, o cliente fica insatisfeito e a entrega paga-se duas vezes. Com a morada escolhida numa lista, o código postal vai certo para a etiqueta.
• Checkout mais rápido. Escrever uma morada completa à mão — rua, número de porta, código postal de 7 dígitos — é onde muitos checkouts param. Aqui o cliente escreve o início da rua, escolhe, e o resto preenche-se sozinho.
• O código postal certo pelo número de porta. Em Portugal uma rua pode ter vários códigos postais, por troços e pela paridade dos números. O Moradas escolhe o CP7 pelo número de porta; quando não é possível, mostra os troços para escolher.

Se o cliente quiser ver antes de decidir: a demo na página inicial usa o mesmo serviço que o plugin e o widget.

Garantias e limites

O que pode prometer ao cliente em nosso nome — nem mais, nem menos:

• Contrato estável (v1). Os campos nunca são renomeados nem removidos, apenas acrescentados. Alterações incompatíveis só sairiam como /v2 separado e ficariam registadas na página de estado. Uma loja integrada hoje não parte com uma atualização nossa.
• Limites de utilização. Cerca de 50 pedidos por 10 segundos por IP; /cp tem um limite próprio, mais folgado. Acima disso, 429 com Retry-After. Para um checkout é mais do que suficiente; o widget já trata do 429 sozinho, e os exemplos da documentação também.
• Sem SLA. O Moradas é gratuito e está em beta: fazemos o melhor para o manter disponível — a disponibilidade é verificada periodicamente a partir do exterior e qualquer falha avisa-nos — mas não há garantia de disponibilidade nem compensações. Se o serviço não responder, o checkout continua a funcionar como um formulário normal.
• Privacidade. Sem cookies, sem contas. O texto que o cliente escreve é processado apenas para responder ao pedido: não é guardado nem associado a uma pessoa; guardamos só contagens agregadas de utilização. A loja pode remeter para a nossa página de privacidade na sua própria política.
• Beta. O serviço continua a evoluir; cada alteração visível para quem integra fica registada, com data, na página de estado.

Para quem faz várias lojas

O Moradas foi pensado para ser repetido. Não há chaves de API, contas nem contratos por cliente: o mesmo plugin, módulo ou script serve em todos os projetos, e uma loja nova fica pronta no tempo de instalar um plugin.

Não precisamos de saber quem são os seus clientes nem quantas lojas tem. Se um dia quiser que uma loja deixe de usar o serviço, basta desativar o plugin ou remover o script — não fica nada do nosso lado para cancelar.

O que muda no serviço fica registado, com data, na página de estado — é o sítio para consultar quando um cliente pergunta o que mudou. Para integrações no servidor, a documentação diz como tratar o 429 e as falhas.

Fale connosco

Perguntas frequentes

É mesmo grátis para as lojas dos meus clientes?

Sim — grátis, incluindo uso comercial, sem limite de lojas e sem chave de API. A única condição é o limite de utilização por IP descrito acima.

Precisa de registo?

Não. Não há contas, chaves nem contratos: instala-se o plugin ou cola-se o script e funciona. Também não precisa de nos avisar de cada loja nova — embora gostemos de saber.

E se o serviço falhar?

O checkout continua a funcionar como um formulário normal: o widget — e, por isso, o plugin e o módulo — avisa na lista que o serviço está temporariamente indisponível, e todos os campos continuam editáveis. Na API, trate o 429 e as falhas como com qualquer serviço externo; os exemplos da documentação já o fazem. O estado atual está na página de estado.

O que acontece quando o plugin sair no wordpress.org?

As lojas que instalaram o plugin a partir do ZIP continuam a funcionar — o ficheiro em revisão é o mesmo. Enquanto não estiver no diretório, o WordPress não avisa de novas versões: para atualizar, carrega-se o ZIP novo da mesma forma. Depois de aceite, as atualizações deverão passar a aparecer no painel como para qualquer outro plugin, e a página de estado dirá quando.