Update Delivery Status - Dora

Update Delivery Status

curl --request POST \
  --url https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status

const options = {method: 'POST'};

fetch('https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
"status": "success",
"data": {
"uuid": "e85616da-906c-4984-8980-069e7f3b2cd9",
"order_number": "664481112612",
"status": "Order Accepted",
"delivery_type": "intra_state",
"sender_longitude": "7.4724033",
"sender_latitude": "9.0820999",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"created_at": "2023-10-30T18:45:33.000000Z",
"customer_detail": {
  "id": "8670aeb6-8299-4f0f-8915-31c7db66a7c0",
  "customer_name": "TundeNasri",
  "customer_email": "sinoma@gmail.com",
  "customer_state_id": 304,
  "customer_phone_number": "08065302534",
  "customer_phone_code": "234",
  "customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
  "created_at": "2023-10-30T18:45:33.000000Z"
},
"delivery_detail": {
  "uuid": "dc09555f-42ac-426b-963c-7d301ea4deb3",
  "sender_name": "Ac Nice",
  "sender_phone": "08087168391",
  "sender_phonecode": "234",
  "sender_address": "T-pumpy estate, phase 20 lugbe, Abuja",
  "delivery_total_order_value": "10000.00",
  "delivery_number_of_parcels": 1,
  "delivery_unit_weight": "10.00",
  "created_at": "2023-10-30T18:45:33.000000Z",
  "updated_at": "2023-10-30T18:45:33.000000Z"
},
"items": [
  {
    "uuid": "aee2ca50-bed0-40b3-90da-534097c39f91",
    "item_description": "Freshfish",
    "item_quantity": 1,
    "item_weight": "10.00",
    "item_value": "10000.00",
    "created_at": "2023-10-30T18:45:33.000000Z"
  }
],
"organization_detail": {
  "uuid": "355c96cd-aa77-459e-9107-1223bea38f9b",
  "business_address": "Aso Housing Estate, Airport road, Abuja",
  "country_id": 161,
  "state_id": 303,
  "city": "Abuja",
  "logo": "https://usedora-bucket-dev.s3.amazonaws.com/provider-logos/mwFmcQ7ppveoNULRwL3AEyKtwoHT2KViXte8AYJA.jpg",
  "created_at": "2023-10-15T10:57:05.000000Z",
  "updated_at": "2023-10-28T16:40:21.000000Z"
}
},
"message": "Delivery status updated"
}

Update Delivery Status

curl --request POST \
  --url https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status

const options = {method: 'POST'};

fetch('https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dev.api.fleets.usedora.com/api/v1/deliveries/update_status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
"status": "success",
"data": {
"uuid": "e85616da-906c-4984-8980-069e7f3b2cd9",
"order_number": "664481112612",
"status": "Order Accepted",
"delivery_type": "intra_state",
"sender_longitude": "7.4724033",
"sender_latitude": "9.0820999",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"created_at": "2023-10-30T18:45:33.000000Z",
"customer_detail": {
  "id": "8670aeb6-8299-4f0f-8915-31c7db66a7c0",
  "customer_name": "TundeNasri",
  "customer_email": "sinoma@gmail.com",
  "customer_state_id": 304,
  "customer_phone_number": "08065302534",
  "customer_phone_code": "234",
  "customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
  "created_at": "2023-10-30T18:45:33.000000Z"
},
"delivery_detail": {
  "uuid": "dc09555f-42ac-426b-963c-7d301ea4deb3",
  "sender_name": "Ac Nice",
  "sender_phone": "08087168391",
  "sender_phonecode": "234",
  "sender_address": "T-pumpy estate, phase 20 lugbe, Abuja",
  "delivery_total_order_value": "10000.00",
  "delivery_number_of_parcels": 1,
  "delivery_unit_weight": "10.00",
  "created_at": "2023-10-30T18:45:33.000000Z",
  "updated_at": "2023-10-30T18:45:33.000000Z"
},
"items": [
  {
    "uuid": "aee2ca50-bed0-40b3-90da-534097c39f91",
    "item_description": "Freshfish",
    "item_quantity": 1,
    "item_weight": "10.00",
    "item_value": "10000.00",
    "created_at": "2023-10-30T18:45:33.000000Z"
  }
],
"organization_detail": {
  "uuid": "355c96cd-aa77-459e-9107-1223bea38f9b",
  "business_address": "Aso Housing Estate, Airport road, Abuja",
  "country_id": 161,
  "state_id": 303,
  "city": "Abuja",
  "logo": "https://usedora-bucket-dev.s3.amazonaws.com/provider-logos/mwFmcQ7ppveoNULRwL3AEyKtwoHT2KViXte8AYJA.jpg",
  "created_at": "2023-10-15T10:57:05.000000Z",
  "updated_at": "2023-10-28T16:40:21.000000Z"
}
},
"message": "Delivery status updated"
}

📝 Summary

This endpoint allows updating the status of a specific delivery. The status can reflect various stages of the delivery process, such as pending, in transit, completed, or failed. This is typically used when there is a change in the delivery’s current state, helping to track its progress.

Requests

Example

Show child attributes

delivery_uuid: "{{delivery_uuid}}"
status: in_transit
pickup_otp: "097857"
dropoff_otp: "098798"
note: Reason for cancellation

Params

Show child attributes

Description:

Name	Location	Type	Required	Description
`body`	body	object	no	none
`delivery_uuid`	body	string	yes	none
`status`	body	string	yes	accepted	in_transit	delivered	cancelled
`pickup_otp`	body	string	no	required if status is in_transit
`dropoff_otp`	body	string	no	required if status is delivered
`note`	body	string	no	Reason for cancellation

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline
422	Bad Request	none	Inline

{
"status": "success",
"data": {
"uuid": "e85616da-906c-4984-8980-069e7f3b2cd9",
"order_number": "664481112612",
"status": "Order Accepted",
"delivery_type": "intra_state",
"sender_longitude": "7.4724033",
"sender_latitude": "9.0820999",
"customer_longitude": "7.4974495",
"customer_latitude": "9.0339358",
"created_at": "2023-10-30T18:45:33.000000Z",
"customer_detail": {
  "id": "8670aeb6-8299-4f0f-8915-31c7db66a7c0",
  "customer_name": "TundeNasri",
  "customer_email": "sinoma@gmail.com",
  "customer_state_id": 304,
  "customer_phone_number": "08065302534",
  "customer_phone_code": "234",
  "customer_address": "12 Ahmadu Bello way, Central Business District, Abuja",
  "created_at": "2023-10-30T18:45:33.000000Z"
},
"delivery_detail": {
  "uuid": "dc09555f-42ac-426b-963c-7d301ea4deb3",
  "sender_name": "Ac Nice",
  "sender_phone": "08087168391",
  "sender_phonecode": "234",
  "sender_address": "T-pumpy estate, phase 20 lugbe, Abuja",
  "delivery_total_order_value": "10000.00",
  "delivery_number_of_parcels": 1,
  "delivery_unit_weight": "10.00",
  "created_at": "2023-10-30T18:45:33.000000Z",
  "updated_at": "2023-10-30T18:45:33.000000Z"
},
"items": [
  {
    "uuid": "aee2ca50-bed0-40b3-90da-534097c39f91",
    "item_description": "Freshfish",
    "item_quantity": 1,
    "item_weight": "10.00",
    "item_value": "10000.00",
    "created_at": "2023-10-30T18:45:33.000000Z"
  }
],
"organization_detail": {
  "uuid": "355c96cd-aa77-459e-9107-1223bea38f9b",
  "business_address": "Aso Housing Estate, Airport road, Abuja",
  "country_id": 161,
  "state_id": 303,
  "city": "Abuja",
  "logo": "https://usedora-bucket-dev.s3.amazonaws.com/provider-logos/mwFmcQ7ppveoNULRwL3AEyKtwoHT2KViXte8AYJA.jpg",
  "created_at": "2023-10-15T10:57:05.000000Z",
  "updated_at": "2023-10-28T16:40:21.000000Z"
}
},
"message": "Delivery status updated"
}