Erros na loja virtual: o que quebra e como eu conserto
A maioria das falhas de loja não é defeito. É configuração pela metade que só aparece com cliente de verdade na tela.
Um domingo de manhã, mensagem no celular: a loja está fora do ar. Larguei o café, abri o notebook, testei tudo. A loja estava perfeitamente no ar. O que não funcionava era o checkout para o endereço daquela pessoa específica, num bairro que ninguém tinha cadastrado. Quase todos os erros na loja virtual que eu vi até hoje são assim: parecem pane e são configuração pela metade.
Frete que não calcula, meio de pagamento que falha, produto publicado sem foto, bairro sem cobertura. Cada um tem causa determinável e correção objetiva. Nenhum deles é misterioso depois que você sabe onde olhar.
Organizei os casos por sintoma, porque é assim que o problema chega até você: alguém conta o que apareceu na tela, nunca a causa. Se a loja ainda está em implantação, o caminho preventivo é o checklist de lançamento.
Erros na loja virtual ligados a entrega
| Sintoma | Causa provável | Correção |
|---|---|---|
| Checkout não avança na entrega | Região sem forma de envio ou faixa | Cadastrar a regra e definir fallback |
| Frete zerado sem motivo | Regra de isenção mal delimitada | Rever piso de valor e cobertura |
| Taxa alta demais em bairro perto | Faixa cadastrada no grupo errado | Reagrupar por tempo de deslocamento |
| Prazo prometido e não cumprido | Área maior que a capacidade real | Reduzir cobertura ou ajustar prazo |
O primeiro caso é o mais caro de todos, porque o cliente não recebe explicação nenhuma. Só uma tela que não conclui. Definir fallback resolve a maior parte deles, como está em taxa de entrega por bairro.
Erros ligados a pagamento
- Meio ligado na loja sem credencial válida cadastrada no Hub.
- Credencial de ambiente de teste rodando em produção.
- Operador escolhido no catálogo sem driver implementado.
- Expectativa de estorno num provedor cujo driver não suporta.
- Token de proteção da API interna ausente em ambiente exposto.
Erros de catálogo e vitrine
Produto que não aparece na navegação quase sempre está sem categoria pública. Categoria vazia costuma significar produto ainda não publicado. Disponibilidade estranha vem de variação cadastrada como produto independente, dividindo o saldo entre registros. Três sintomas, três verificações rápidas.
Imagem enviada por engano você corrige pela remoção de imagens na administração da loja, sem refazer cadastro. Quando o problema é persistente, a raiz está no cadastro, tema de estoque e preço sincronizados.
Erros específicos do Modo Delivery
- Scripts manuais de banco não aplicados antes de habilitar o recurso.
- Host não configurado, impedindo a identificação correta do tenant.
- Origem de catálogo trocada com o canal já rodando, gerando divergência.
- Pedido mínimo ativo e não comunicado antes da finalização.
- Sincronização com a Central de Pedidos nunca testada sob volume.
O Modo Delivery e os tokens de cliente exigem `database/loja_modo_delivery.sql` e `database/loja_cliente_tokens.sql`, além das configurações reais de host, frete e pagamento. Recurso ligado sem essa base produz falha que parece aleatória, e falha aleatória consome dia inteiro de gente boa.
Erros de conta e acesso
Recuperação de senha que não chega e sessão se comportando de forma estranha costumam apontar para a ausência do script de tokens de cliente. Antes de investigar caso a caso, confirme que a base foi aplicada no ambiente. Os detalhes estão em conta do cliente.
Outro caso recorrente é a pessoa tentar se cadastrar de novo porque não lembra que já tem conta. Isso não é falha do sistema, mas gera registro duplicado e embaralha o histórico. Uma frase clara mostrando o caminho de recuperação resolve quase todas essas ocorrências.
Como investigar sem se perder
- Reproduza o sintomaRefaça o caminho exato descrito, como cliente novo, no mesmo tipo de endereço e com o mesmo meio de pagamento.
- Isole a etapaDescubra se a falha está em catálogo, entrega, pagamento ou conta antes de abrir qualquer configuração.
- Confira a configuração daquela etapaFormas de envio, meios habilitados, credenciais e ambiente, conforme o caso.
- Verifique os pré-requisitos de baseScripts manuais aplicados, host configurado e token de API definido em ambiente exposto.
- Registre o que você mudouAnote a correção, para a mesma falha não voltar em outra unidade ou em outro ambiente.
Investigar nessa ordem poupa tempo porque tira a tentação de mexer em cinco configurações ao mesmo tempo. Quando muita coisa muda junto, ninguém descobre o que resolveu, e o problema volta sem explicação. Já fiz assim, na pressa, e paguei duas vezes pelo mesmo erro.
Próximo passo
Corrija primeiro o que trava venda, depois o que degrada experiência. Previna reincidência com o checklist de lançamento e organize a entrega em rotina diária do delivery. Falha fiscal do pedido pertence ao módulo fiscal.