Toda solicitação de cancelamento leva:
reason— texto livre;code— motivo (enum abaixo);mode—AUTOouMANUAL.

POST /v1/orders/{orderId}/requestCancellation responde 202, que significa só "pedido recebido para análise". O pedido só está cancelado quando chegar o evento CANCELLED. Dependendo do momento, a Keeta pode consultar o cliente antes de aceitar.
code | Significado | Uso típico |
|---|---|---|
SYSTEMIC_ISSUES | Problemas sistêmicos | Falha de PDV/integração |
DUPLICATE_APPLICATION | Pedido duplicado | Cliente fez o mesmo pedido duas vezes |
UNAVAILABLE_ITEM | Item indisponível | Acabou o produto; informe em outOfStockItems |
RESTAURANT_WITHOUT_DELIVERY_PERSON | Restaurante sem entregador | Entrega própria sem motoboy disponível |
OUTDATED_MENU | Cardápio desatualizado | Desativa os itens listados em invalidItems |
ORDER_OUTSIDE_THE_DELIVERY_AREA | Fora da área de entrega | Endereço fora do raio |
BLOCKED_CUSTOMER | Cliente bloqueado | Histórico de fraude/problemas |
OUTSIDE_DELIVERY_HOURS | Fora do horário de entrega | Pedido chegou após o fechamento |
INTERNAL_DIFFICULTIES_OF_THE_RESTAURANT | Dificuldades internas | Falta de energia, cozinha parada |
RISK_AREA | Área de risco | Endereço em área considerada insegura |
DELIVERY_PROBLEM | Problema na entrega | Falha logística |
Códigos antigos (legado, ainda aceitos): INSUFFICIENT_DISHES, SUSPENSION_OF_BUSINESS, INSUFFICIENT_MANPOWER, OTHERS. Atenção: o metadata do evento CANCELLED ainda pode trazer esses valores antigos — trate os dois conjuntos ao ler eventos.
Cancelamentos iniciados pela Keeta:
CONSUMER_CANCELLATION_REQUESTED— o cliente pediu (pode não estar habilitado para todo merchant ou só valer antes da confirmação).OTHER_CANCELLATION_REASON— o sistema cancelou (ex.: sem aceite no prazo, nenhum entregador aceitou, entregador reportou loja fechada).
Em ambos os casos o Software Service recebe o evento e deve atualizar o pedido.
- O cliente pede reembolso total ou parcial no app → a Keeta envia
USER_REFUND_REQUESTcom itens e valores nometadata. - O merchant responde: aceita → POST /v1/orders/{orderId}/acceptRefund → evento
REFUNDED; recusa → POST /v1/orders/{orderId}/rejectRefund → eventoREFUND_FAILED.
- O merchant não consegue iniciar reembolso pela API.
- Responder pela API ou pelo Merchant Portal dá o mesmo resultado; vale a primeira resposta recebida. Disputas podem ser conduzidas pelo chat (Instant Messenger) do Merchant Portal.

Exemplo de metadata de USER_REFUND_REQUEST (adaptado para o Brasil; valores em centavos):
{
"money": 3790,
"opTime": 1760380200000,
"shopId": "159416882",
"status": 5002,
"currency": "BRL",
"isAppeal": 0,
"partRefund": 1,
"applyOpType": 10,
"applyReason": "Item errado",
"orderViewId": 783441058793308,
"handleOpType": 20,
"handleReason": "Merchant concordou com o reembolso",
"refundProducts": [
{
"id": 12053105,
"name": "Pastel de carne",
"count": 1,
"price": 1490,
"skuId": 8949938,
"spuId": 9897081,
"groups": [],
"currency": "BRL",
"nameI18n": {
"pt-BR": "Pastel de carne",
"default": "Pastel de carne"
},
"priceStr": "R$ 14,90",
"refundType": 1,
"originPrice": 1490,
"refundCount": 1,
"refundPrice": 0,
"orderProductId": 359379560,
"skuOpenItemCode": "PDV-2001",
"spuOpenItemCode": "PDV-2000"
}
],
"afterSaleOrderId": 783440453161676
}O
metadataé uma string JSON dentro do evento — faça o parse. Os códigosstatus,applyOpTypeehandleOpTypenão têm tabela oficial publicada; trate-os como informativos.
| Cliente | Merchant | Atendimento Keeta | Sistema | |
|---|---|---|---|---|
| Cancelamento | Em full service, só antes de o merchant confirmar, sem precisar de aprovação | Pode cancelar até 48 h após a conclusão, pelo seu sistema ou pelo Order Management da Keeta (neste caso, a Keeta notifica via API) | Pode cancelar até 30 dias após a conclusão; o evento é enviado ao Software Service | Cancela pedido não aceito em 5 min; a loja é fechada temporariamente |
| Reembolso | Gera evento e exige aprovação do merchant; o merchant pode tratar disputas pelo Merchant Portal | Não pode iniciar reembolso pela API | Igual à coluna do cliente | — |
Ou seja: a Keeta pode enviar cancelamento ou reembolso a qualquer momento. Decida se o seu sistema acompanha o status da Keeta ou descarta essas notificações em certos estados (ex.: depois de concluído). Se isso gerar divergência de conciliação, o merchant deve acionar o time comercial (BD) da Keeta.