Como enviar atualizações de status das entregas solicitadas
Webhook fornecido pela Saipos para que o parceiro de entrega possa enviar as atualizações de status das entregas solicitadas
O schema utilizado pela saipos segue todas as especificações da documentação do OD
https://abrasel-nacional.github.io/docs/#tag/logisticTracking/operation/newLogisticEvent
URL Base:
Para recebimento dos webhooks, deve seguir a URL base de acordo com "Dados necessários"
URL Base: https://logistics-api.saipos.com/delivery-tracking/tracking-event-webhook
DeliveryID não encontrado na Saipos
O campo deliveryId é utilizado para determinar se o pedido (orderId) teve uma solicitação de delivery concluída com sucesso pela Saipos. Caso não seja encontrado na Saipos o vínculo entre deliveryId e orderId o webhook irá retornar o seguinte erro:
400: deliveryId [deliveryId] with orderId [orderId] not found!
Eventos disponíveis
Os eventos disponíveis na API de Logística são:
| Evento | Tradução |
|---|---|
| PENDING | Pendente |
| ACCEPTED | Aceito |
| REJECTED | Rejeitado |
| PICKUP_ONGOING | Retirada em andamento |
| ARRIVED_AT_MERCHANT | Aguardando no estabelecimento |
| READY_FOR_PICKUP | Pronto para retirada |
| READY_FOR_PICKUP_NOTIFIED | Parceiro notificado - Pedido pronto para coleta (Evento enviando juntamente com o envio do evento de READY_FOR_PICKUP) |
| READY_FOR_PICKUP_ATTEMPTED | Tentativa de notificação - Entregador pode coletar normalmente (Quando ocorre erro no envio do evento de READY_FOR_PICKUP) |
| ORDER_PICKED | Pedido retirado |
| DELIVERY_ONGOING | Entrega em andamento |
| ARRIVED_AT_CUSTOMER | No local de entrega |
| ORDER_DELIVERED | Pedido entregue |
| RETURNING_TO_MERCHANT | Retornando ao estabelecimento |
| RETURNED_TO_MERCHANT | De volta ao estabelecimento |
| DELIVERY_FINISHED | Entrega finalizada |
| CANCELLED | Cancelado |