Buscar na documentação
ctrl+4K
Módulos
Authentication
Merchant
Catalog
Order
Events
Logistics
Shipping
Review
Financial
Soluções

Erros e troubleshooting

Melhores práticas

Reintente inteligentemente: Aplique backoff exponencial (1s, 2s, 4s) até máximo de 10 minutos.Use idempotencyKey: Inclua em cabeçalhos para reintentar com segurança sem duplicar requisições.Monitore ativamente: Rastreie taxa de erros, latência e tempos de resposta.Processe independentemente: Trate cada pedido isoladamente; implemente fila manual para falhas.Registre estruturadamente: Capture:
  • Payload de requisição/resposta
  • Status HTTP, código e mensagem de erro
  • ID de requisição, timestamp UTC
  • Usuário/operador afetado

Erro 404: Pedido não encontrado

Pedido não existe ou não está disponível ainda.

Causas

  • orderId inválido ou formato incorreto
  • Pedido ainda não sincronizado (evento PLACED chega antes dos detalhes)
  • Pedido arquivado (+ 7 dias)

Resolução

  1. Valide orderId como UUID válido
  2. Implemente backoff exponencial (máx 10 minutos) após evento PLACED
  3. Não consulte pedidos com mais de 7 dias
  4. Respeite rate limits
Melhor prática: Armazene orderId e timestamp para rastreamento.

Erro 901: Pedido não enviado ao PDV

Pedido não chegou ao sistema POS.

Causas

  • Sistema POS/integrador offline ou indisponível
  • Timeout de rede ou falha de conexão
  • Fila travada ou webhook inalcançável

Resolução

  1. Verifique logs do sistema para orderId e requestId
  2. Restaure conectividade e valide saúde de webhook
  3. Revise métricas de desempenho no Portal do Parceiro
  4. Contate suporte com logs se persistir
Prevenção: Monitore saúde do sistema, filas e latência de webhook. Mantenha fallback de aceitação manual.

Erro 902: Pedido não confirmado

Pedido não foi confirmado em 8 minutos.

Causas

  • Confirmação automática desabilitada
  • Operador manual não confirmou a tempo
  • Regras de negócio bloquearam (inventário, horários, itens indisponíveis)

Resolução

  1. Revise janela de SLA e display do POS
  2. Habilite confirmação automática onde apropriado
  3. Valide catálogo, inventário e horários atualizados
  4. Capacite equipe sobre prazo de confirmação
  5. Monitore taxa de confirmação no Portal do Parceiro
Prevenção: Configure alertas para pedidos pendentes. Mantenha dados sincronizados e treine operadores.

Suporte

Se erros persistirem, recopile e envie para suporte:
  • Logs: Últimas 24 horas com timestamps em UTC
  • Erro: Código, frequência e contexto
  • IDs: orderId e requestId afetados
  • Ambiente: Produção, staging ou sandbox
  • Histórico: Passos de troubleshooting já realizados
Esta página foi útil?
Avalie sua experiência no novo Developer portal:
Nesta página
Erros e troubleshooting
Melhores práticas
Erro 404: Pedido não encontrado
Causas
Resolução
Erro 901: Pedido não enviado ao PDV
Causas
Resolução
Erro 902: Pedido não confirmado
Causas
Resolução
Suporte
Conteúdo lido0%