Sinaliza ao Wake OMS que um pedido não será atendido pela loja/seller responsável — por ruptura de estoque, produto avariado ou outro motivo. Executa exatamente o mesmo processo que o botão de recusa da tela de pedidos: o pedido avança para o próximo status configurado e, quando esse status é Aguardando Change Seller, o OMS inicia automaticamente as tentativas de reatribuição, sem exigir nova chamada da sua integração.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
motivosRecusaProdutoé por linha do pedido, não por quantidade.Não existe campo de quantidade neste contrato: um elemento cobre a linha inteira, independentemente de quantas unidades ela tem. Se um pedido tem uma linha com 3 unidades, um único elemento recusa as 3.
Em quais status o pedido pode ser recusado
A recusa só é aceita quando o pedido está em um dos status abaixo. Em qualquer outro, a API retorna 400 informando o status atual.
| ID | Status | Observação |
|---|---|---|
| 1 | Pendente | Pedido aguardando aceite da loja. |
| 2 | Aceito | Loja já aceitou, mas ainda não iniciou a separação. |
| 3 | Aguardando Faturamento Loja | Separação concluída, aguardando faturamento. |
| 17 | Em Separação | Separação em andamento — cenário típico de ruptura identificada na coleta. |
Pedidos já cancelados, faturados, expedidos ou entregues não podem ser recusados.
Para onde o pedido vai depois da recusa
O status seguinte é definido pela configuração, nesta ordem de precedência:
- Campo Próx. Status Recusa da forma de envio do pedido;
- Se esse campo estiver vazio, o parâmetro
PROXIMO_STATUS_RECUSA_SELLERda conta.
Valores possíveis:
| Status resultante | ID | O que acontece |
|---|---|---|
| Aguardando Change Seller | 9 | O OMS enfileira automaticamente a tentativa de reatribuição do pedido a outra loja. É a configuração necessária para o fluxo de Change Seller. |
| Aguardando Change Seller Manual | 10 | O pedido fica retido aguardando reatribuição manual por um operador, sem tentativa automática. |
| Aguardando Cancelamento Seller | 14 | O pedido segue para cancelamento junto à plataforma de e-commerce. |
| Aguardando Cancelamento Marketplace | 16 | O pedido entra em espera antes do cancelamento final no marketplace. |
Com o status 9, o OMS executa as tentativas de Change Seller automático por conta própria — sua integração não precisa fazer nova chamada nem consultar em loop. Se todas as tentativas se esgotarem sem loja disponível, o OMS aplica a ação de contingência configurada na conta (parâmetro ACAO_CHANGE_SELLER), que pode ser encaminhar para reatribuição manual, remover os itens ou cancelar o pedido.
Motivos de recusa e efeito no estoque
Cada motivo cadastrado no OMS carrega um tipo de ajuste de estoque, exposto no campo abateEstoque da consulta de motivos:
abateEstoque | Efeito |
|---|---|
0 | Não altera o estoque do item. |
1 | Zera o estoque do item na loja recusante. |
2 | Aplica o ajuste de estoque vinculado ao motivo (campo ajuste). |
Atenção à nomenclatura dos camposEste endpoint utiliza
contaepedido. Outros endpoints públicos de pedidos (separacao-concluida,cancelar,dados-faturamento) utilizamcontaOmsepedidoOms. Atente-se à diferença ao reaproveitar código entre integrações.
{
"conta": "loja01",
"pedido": "PED-000456",
"motivosRecusaProduto": [
{
"codigoProduto": "SKU-1001",
"sequencial": 1,
"idMotivo": 2
},
{
"codigoProduto": "SKU-1002",
"sequencial": 2,
"idMotivo": 3
}
]
}