O Order Checker é uma integração disponível nos planos Business e Enterprise que valida a disponibilidade de itens em estoque em tempo real. Quando um atendente adiciona ou edita um produto no carrinho, a plataforma consulta sua API externa e exibe uma mensagem de erro se o item estiver indisponível.
Como ativar
Caminho: Configurações → Integrações → Outros → Order Checker
Acesse Configurações → Integrações → Outros → Order Checker.
Insira o Endpoint API.
Adicione tokens de autenticação nos campos Cabeçalho e Valor (botão "+" para múltiplos headers).
Habilite "Permite vendas mesmo se houver erros na API" ou "...erros nos itens" conforme necessário.
Clique em Salvar.
Estrutura da configuração
{
"endpoint": "https://sua-api.com/endpoint",
"headers": [{ "Authorization": "Bearer seu_token" }],
"onError": "CONTINUE"
}
onError: CONTINUE permite prosseguir mesmo com erro; FAIL bloqueia a ação.
Comportamento por código HTTP de resposta
HTTP | Payload | Comportamento |
200 | Array vazio | Permite prosseguir sem erros |
200 | Array com erros | Marca os erros; permite finalizar o pedido |
403 | Array com erros | Marca os erros e bloqueia a finalização do pedido |
Possíveis erros
Timeout da requisição (limite: 5 segundos).
Código HTTP não mapeado na resposta.
Payload em formato incorreto (não JSON).
Use a aba Log de Integração para acompanhar o status de cada requisição enviada à API externa.