Skip to main content
Use a aba Cancelar pedido para enviar uma solicitação de cancelamento ao FIRE para um pedido que já está no sistema. Isso é útil quando você precisa limpar pedidos de teste, simular fluxos de cancelamento ou verificar se o FIRE realiza corretamente a transição de um pedido para o estado cancelado. Aba Cancelar pedido — campo de ID do pedido, motivo e histórico de cancelamentos
O cancelamento é irreversível. Uma vez que um pedido é cancelado no FIRE, ele não pode ser restaurado. A operação só é bem-sucedida para pedidos que estão em um estado cancelável — normalmente received ou processing. Pedidos que já estão com status completed, cancelled ou dispatched retornarão um erro.

​
Antes de começar

Certifique-se de que o contexto operacional está definido na barra lateral: ambiente, conta, país, fornecedor e loja devem estar todos selecionados. As solicitações de cancelamento são enviadas para o ambiente do FIRE que você tem ativo.

​
Como cancelar um pedido

1

Abra a aba Cancelar pedido

Clique em Cancelar pedido na navegação superior. A aba exibe um único campo de busca e uma área de ação de cancelamento.
2

Informe o identificador do pedido

Digite o External Order ID (o ID que seu sistema atribuiu quando o pedido foi criado) ou o Order Code (o código alfanumérico curto visível na lista de pedidos do FIRE) no campo de busca.
Se você injetou o pedido pelo Pedido individual ou pelo Batch, o External Order ID é exibido no cartão de resposta e no log de resultados no painel direito.
3

Verifique o pedido (opcional)

Clique em Buscar para localizar o pedido no FIRE antes de cancelar. O FUEL exibirá o status atual do pedido, o canal e o horário de criação para que você confirme que está com o pedido correto. Esta etapa é opcional — você pode prosseguir para o cancelamento sem realizar a busca primeiro.
4

Cancele o pedido

Clique em Cancelar pedido. Um diálogo de confirmação aparece solicitando que você confirme a ação. Revise o identificador do pedido exibido no diálogo e clique em Confirmar para prosseguir.
5

Revise a resposta

Após a conclusão da solicitação, o FUEL exibe a resposta bruta do FIRE:
  • Sucesso — O FIRE retorna o objeto do pedido atualizado com o status cancelled. O cartão de resposta é destacado em verde.
  • Erro — O FIRE retorna um código de erro e uma mensagem. As causas mais comuns são pedido não encontrado, identificador inválido ou pedido em um estado não cancelável.

​
Referência de resposta

Sucesso (200)

O FIRE aceitou o cancelamento. O corpo da resposta contém o objeto completo do pedido com "status": "cancelled" e um timestamp cancelledAt.

Erro (4xx / 5xx)

O FIRE rejeitou o cancelamento. Verifique o campo message no corpo da resposta. Mensagens comuns incluem Order not found, Order already cancelled e Order cannot be cancelled in current state.

​
Observações

O FUEL chama o endpoint de cancelamento do FIRE em POST /v1/orders/:id/cancel. O :id utilizado é o ID interno do pedido no FIRE, resolvido a partir do External Order ID ou Order Code informado. Se a busca falhar, o FUEL exibirá um erro de “não encontrado” antes de tentar o cancelamento.
Se você precisar cancelar muitos pedidos de uma só vez, considere usar um script diretamente contra a API do FIRE — a aba Cancelar pedido foi projetada para cancelamentos individuais e pontuais durante testes e depuração.