Processe um pedido - Onbeef Connect API

O fluxo combina polling de eventos, consulta do pedido e mudanças de estado.

Consulte os eventos

Chame GET /v1/events:polling com seu token:

Sandbox

curl --request GET \
  --url https://api.dev.connect.onbeefapp.com.br/v1/events:polling \
  --header 'Authorization: Bearer <access_token>'

Cada evento informa eventId, eventType e orderId.

Consulte o pedido

Use o orderId em GET /v1/orders/{orderId}. Valide itens, valores, cliente, pagamento e entrega antes de continuar.

Confirme os eventos processados

Envie os eventos para POST /v1/events/acknowledgment. Você pode confirmar vários eventos no mesmo array.

Um evento não confirmado pode aparecer novamente no próximo polling.

Aceite o pedido

Chame POST /v1/orders/{orderId}/confirm. Informe os campos exigidos pela referência do endpoint.

Informe que o pedido está pronto

Chame POST /v1/orders/{orderId}/readyForPickup quando o preparo terminar.

Despache o pedido

Chame POST /v1/orders/{orderId}/dispatch quando o entregador retirar o pedido.

Conclua a entrega

Valide o código de entrega quando necessário. Depois, chame POST /v1/orders/{orderId}/delivered.

Cancelamentos

Inicie o cancelamento de um pedido.

Aceite uma solicitação recebida.

Negue a solicitação e mantenha o pedido ativo.

⌘I