Pedidos e status
Erro no pedido
Atualizado em pela Equipe editorial do PanelCompare
Por que “erro no pedido” importa para quem compra?
O comportamento do HTTP é a peculiaridade de maior consequência da especificação. Os erros devolvem status 200 com um corpo como um campo error dizendo “Incorrect request”, então os códigos de resposta não trazem informação nenhuma e toda integração precisa ler o corpo (verificado em justanotherpanel.com/api, pesquisa de mercado do PanelCompare, 6 de setembro de 2026). Um script que confia em res.ok vai relatar tranquilamente cem pedidos recusados como feitos. Um painel grande ainda responde a uma chave inválida com HTTP 401 e um corpo de erro em JSON, então um 4xx também precisa ser lido, e não tratado como “aqui não tem API”.
Para quem compra à mão, os erros são mais restritos e quase sempre autoinfligidos: um link no formato errado para o serviço, uma quantidade abaixo do mínimo ou acima do máximo, saldo insuficiente ou um item que o painel desativou desde a última vez que o catálogo foi carregado. Vale prestar atenção a este último, porque um preço de vitrine que fica indisponível no momento em que o saldo é carregado é uma isca e troca, não uma queda do serviço.
Como “erro no pedido” aparece numa tabela de preços?
Os erros não aparecem no catálogo; aparecem no envio. Os campos min, max e type do catálogo determinam a maioria deles, e por isso ler essas três colunas antes de pedir evita a maior parte das recusas.
Num pedido em massa, o lote inteiro costuma ser validado e ter o preço calculado antes da confirmação, então uma linha malformada é pega cedo; mas um lote que passa na validação é enviado como uma única ação, e a janela de cancelamento vale então para tudo de uma vez.
Acha que esta definição está errada?
A terminologia deste mercado é definida pelos painéis que a usam, e ela muda. Se um painel usa “erro no pedido” com um sentido diferente do que está escrito aqui, envie para nós o serviço listado, e vamos corrigir a definição ou registrar a variante. O processo está na página Quem somos.