Skip to main content
A API usa códigos HTTP convencionais:
CódigoSignificado
200Sucesso
401Token ausente, inválido ou revogado
403Loja inativa ou suspensa
404Recurso não encontrado (ou pertence a outra loja)
422Erro de validação ou transição de status inválida
429Limite de requisições excedido

​
Formato dos erros de validação

Erros de validação seguem o formato: 
{
  "message": "O campo preco é obrigatório.",
  "errors": {
    "preco": ["O campo preco é obrigatório."]
  }
}

​
Como tratar cada erro

Verifique se o header Authorization: Bearer SEU_TOKEN está presente e se o token não foi revogado. Gere um novo token no painel de integrações se necessário.
O recurso não existe ou pertence a outra loja. Confirme se os UUIDs usados foram obtidos com o mesmo token.
Leia message e errors para saber qual campo falhou. Em ações de pedido, confira se o item está no status esperado para a transição (veja o fluxo de pedidos).
Aguarde antes de tentar novamente e implemente backoff exponencial. Reduza o volume de chamadas com delta sync e webhooks.