Para oferecer retirada no local no checkout em blocos do WooCommerce, confirme primeiro que a página de finalização usa o bloco Checkout. Depois, em WooCommerce > Configurações > Envio > Retirada local, habilite o recurso e cadastre pelo menos um ponto. Adicionar “Retirada local” a uma zona de envio é outra configuração: o método legado por zona, que não substitui o cadastro de pontos dos blocos. Veja a documentação oficial da retirada nos blocos.
Se você ainda precisa organizar zonas e tarifas de entrega, comece pelo guia de frete no WooCommerce. Aqui o foco é a escolha de retirar um pedido presencialmente — não resolver uma tarifa de entrega que sumiu.
Antes de começar: identifique o checkout e proteja a loja
Em WooCommerce > Configurações > Avançado, identifique a página atribuída ao checkout. Abra essa página no editor e verifique se contém o bloco Checkout ou o shortcode [woocommerce_checkout]. Nem a versão instalada nem a aparência do tema, isoladamente, provam qual fluxo a loja usa; a referência oficial do Checkout block mostra como conferir a página designada. Anote a versão do WooCommerce e compare os nomes dos controles com sua instalação: traduções e interface podem variar.
Antes de alterar métodos ou página de checkout, mantenha um backup restaurável de arquivos e banco e registre as configurações atuais. Faça as mudanças primeiro em um staging protegido, com pagamento de teste e e-mails, webhooks, estoque e outras automações reais isolados. Não restaure o banco do staging sobre a produção: você pode sobrescrever pedidos feitos depois da cópia.
Se sua loja usa shortcode, não troque o checkout ativo às pressas. Valide no staging gateways, frete, campos de endereço, extensões brasileiras e personalizações; funcionalidades do formulário clássico não necessariamente funcionam no bloco. O guia de personalização do checkout oferece contexto, mas não aplique exemplos de filtros do checkout clássico aos blocos sem verificar compatibilidade.
Retirada dos blocos ou retirada por zona?
| Retirada com pontos no checkout em blocos | Retirada legada por zona | |
|---|---|---|
| Configuração | Aba Retirada local em Configurações > Envio, para Checkout block | Método Retirada local dentro de uma zona de envio |
| Experiência | Cliente seleciona Retirada no seletor Entrega e escolhe um ponto cadastrado | Método exibido quando a zona do endereço do cliente corresponde |
| Alcance | Não é limitada pelas zonas de envio por padrão; pode ser oferecida mesmo sem endereço de entrega | Depende da zona correspondente e de sua prioridade |
| Referência de imposto por padrão | Endereço do ponto escolhido | Endereço da loja |
| Múltiplos pontos | Locais cadastrados na aba própria | O método nativo da zona não fornece o mesmo seletor de pontos |
Fontes: retirada nos blocos e método legado por zona. Legado não significa exclusivo do checkout por shortcode: um método da zona também pode aparecer no checkout em blocos. Com os dois fluxos habilitados, o comprador pode encontrar escolhas de retirada semelhantes. Decida qual atende à cobertura comercial; não ative ou desative métodos em produção sem avaliar pedidos, valores e integrações e fazer QA. Se a retirada precisar ser restrita por zona, examine o método legado e teste seu comportamento na página efetivamente usada.
A referência de endereço é o comportamento padrão do software, não uma regra fiscal para sua empresa. O status tributário de uma eventual cobrança pela retirada também é diferente da tributação dos produtos. Valide os valores, a configuração e as obrigações aplicáveis com o responsável fiscal.
Como configurar pontos de retirada no Checkout block
Faça estes passos em staging, depois de confirmar a página designada e o backup:
- Em WooCommerce > Configurações > Envio, procure a aba Retirada local (Local Pickup). Confira também se já há uma retirada legada habilitada em Zonas de envio, sem desativá-la impulsivamente.
- Marque Habilitar retirada local. Ajuste o título exibido ao cliente, se necessário. Se cobrar pela coleta, habilite adicionar um preço e configure custo e status tributário dessa cobrança conforme a operação e a orientação fiscal; não trate essa opção como controle geral dos impostos dos produtos.
- Em Locais, escolha Adicionar ponto de retirada. Informe nome, endereço completo e instruções verdadeiras (por exemplo, balcão e horário confirmado). Conclua o cadastro, repita para os demais locais que atenderão pedidos e salve as alterações. Sem ao menos um local, a retirada dos blocos não aparece no checkout.
- No editor da página de checkout designada, use a Visualização em lista para inspecionar Checkout > Campos do checkout. Os blocos internos Entrega (Delivery), Opções de envio (Shipping Options) e Método de retirada (Pickup Method) têm papéis distintos: o primeiro oferece a escolha entre envio e retirada; os outros exibem, respectivamente, as opções de entrega ou os locais de coleta. Ajuste textos somente se o controle estiver disponível e as instruções refletirem sua operação.
A documentação oficial descreve esses controles. Se a aba ou os blocos não estiverem visíveis, não invente um caminho alternativo nem remova blocos essenciais: confira a página atribuída, a versão, o carrinho e as opções calculadas de envio antes de mudar a loja.
Teste entrega, retirada e pedido completo
No staging, acrescente um produto físico que exige envio e teste o checkout atribuído como visitante. Escolha Retirada, percorra todos os pontos e confira endereço, instruções, eventual cobrança e total. Volte a Envio e compare um CEP atendido pela entrega e outro fora de sua cobertura, observando as tarifas e a escolha de retirada. O fluxo de pontos não é restrito pelas zonas por padrão; aparecer para outra região não significa que sua operação esteja preparada para atender esse cliente.
Se estiver ativo ocultar custos de envio até informar o endereço, as tarifas de entrega podem ficar ocultas até o endereço completo, embora Retirada e seus pontos possam estar disponíveis antes disso. Nesse caso, o WooCommerce não seleciona a retirada automaticamente: o cliente deve escolhê-la e selecionar um local (limitação documentada). Se o seletor Entrega não aparecer no seu cenário, verifique também se o carrinho é transportável, se existem opções de envio calculadas e se a página é realmente a designada; não conclua que basta cadastrar um ponto em qualquer carrinho.
Compare o total e os impostos calculados para cada ponto com os parâmetros da loja e com a orientação do responsável fiscal. Faça um pedido fictício apenas com pagamento de teste e integrações isoladas; confira o ponto salvo no pedido, a forma de entrega e o comportamento no celular. Se usa vários pacotes, teste também: a retirada combina visualmente os pacotes em um único local e pode ficar indisponível quando algum deles não admite coleta (limitações oficiais). Não use dados pessoais reais no teste.
Retirada não aparece ou está duplicada?
A aba “Retirada local” não existe
Confirme que está editando a página atribuída ao checkout, não uma página alternativa, e que ela contém o bloco Checkout. Verifique a versão instalada e as integrações compatíveis com blocos antes de considerar migração. Se a loja precisa continuar no shortcode ou restringir por zona, avalie a retirada legada em vez de prometer a aba de pontos nesse fluxo.
Os pontos não aparecem para o cliente
Verifique habilitação, cadastro e salvamento de ao menos um local, produto que exige envio e seleção Entrega > Retirada. Se nem o seletor aparece, confira página designada, carrinho, opções de envio calculadas e estrutura dos blocos, como orienta a referência do Checkout block. Não crie um frete fictício apenas para exibir a interface. Se faltam tarifas de entrega, não pontos de coleta, siga o diagnóstico de frete ausente no checkout.
Aparecem duas opções de retirada ou valores inesperados
Confira se Zonas de envio contém o método legado simultaneamente à aba de pontos; ambos são independentes. Determine com o responsável qual manter e teste a alteração em staging. Para valores diferentes do esperado, separe custo da retirada, preço e impostos dos produtos, ponto escolhido e configuração tributária. Não altere a regra fiscal com base apenas na aparência do checkout.
Perguntas frequentes
Preciso adicionar retirada a cada zona para oferecer pontos?
Não. A retirada própria dos blocos é habilitada na aba separada e precisa de ao menos um local cadastrado. O método por zona é outra opção e pode coexistir tecnicamente, mas exige avaliação para não confundir o cliente.
Posso dispensar CEP e endereço do cliente?
O cliente pode escolher um ponto sem informar endereço de entrega nesse fluxo. Isso não dispensa automaticamente dados de cobrança, exigências do gateway nem informações operacionais ou fiscais. Teste os campos efetivamente exigidos na sua loja.
O checkout clássico permite retirada?
Sim: o método legado pode ser adicionado à zona de envio correspondente. Ele não oferece, por si só, o mesmo seletor nativo de vários pontos da aba de retirada dos blocos.
Em resumo
Comece pelo tipo de checkout, escolha a estratégia compatível com sua política comercial e teste a jornada inteira em staging. Assim você diferencia retirada presencial de um problema no cálculo de frete e evita oferecer duas opções equivalentes sem revisar local, cobrança e impostos.



