Pular para o conteúdo

Introdução

A RaptorX é uma plataforma de entregas para restaurantes e lojas, feita com entregadores de moto. Se o seu sistema recebe pedidos de uma loja, você pode solicitar a entrega à RaptorX por API e acompanhar cada etapa até a entrega ao cliente.

A integração segue o padrão de logística Open Delivery. Nesta documentação você encontra apenas o que a RaptorX implementa.

Seu sistema chama a RaptorX

Obter token, criar a entrega, marcar o pedido como pronto, consultar o status e cancelar.

A RaptorX chama o seu webhook

A cada mudança de status (aceita, retirada, a caminho, entregue, cancelada) a RaptorX envia um POST para a URL de webhook que você cadastrou.

1. Seu sistema para RaptorX: POST /oauth/token. 2. RaptorX para Seu sistema: access_token (1 hora). 3. Seu sistema para RaptorX: POST /logistics/delivery. 4. RaptorX para Seu sistema: 202 deliveryId. 5. RaptorX para Seu sistema: Webhook PENDING. 6. Seu sistema para RaptorX: POST /logistics/readyForPickup/{deliveryId}. 7. RaptorX para Seu sistema: Webhook ACCEPTED, PICKUP_ONGOING. 8. RaptorX para Seu sistema: Webhook ORDER_PICKED, DELIVERY_ONGOING. 9. RaptorX para Seu sistema: Webhook ARRIVED_AT_CUSTOMER. 10. RaptorX para Seu sistema: Webhook ORDER_DELIVERED, DELIVERY_FINISHEDSeu sistemaRaptorXPOST /oauth/tokenaccess_token (1 hora)POST /logistics/delivery202 deliveryIdWebhook PENDINGPOST /logistics/readyForPickup/{deliveryId}Webhook ACCEPTED, PICKUP_ONGOINGWebhook ORDER_PICKED, DELIVERY_ONGOINGWebhook ARRIVED_AT_CUSTOMERWebhook ORDER_DELIVERED, DELIVERY_FINISHED
Operação Para que serve
Token Autenticar com client_id e client_secret
Criar entrega Solicitar a entrega de um pedido (idempotente por orderId)
Pedido pronto Liberar a entrega para despacho
Consultar entrega Ver o status atual
Cancelar entrega Cancelar, quando permitido
Disponibilidade Retorna sempre available: true; não calcula preço nem cobertura