Fulfillment Orders

Fulfillment orders are based on using Bosta's warehouses to store and manage your inventory and ship conveniently to your customers. Once you store your products in Bosta's Warehouse, you should be able to see those products from your account dashboard. To know more about your fulfillment products and serials, you can check this article Fulfillment Products.

How to create a Fulfillment Order

Create single deliver order

You can use the following endpoint, but you have to make two main changes

POST

https://app.bosta.co/api/v2

/deliveries

More Info

1. Change order type to FXF_SEND.
   
2. Add fulfillmentInfo object in the payload.
   
   

Create Multiple deliver orders

You can use the following endpoint to create more than one order using the same API Call.

POST

https://app.bosta.co/api/v2

/fulfillment/deliveries/bulky

The payload will be an array of orders as the following:

Note

• If multiple deliveries in the input array share the same customer phone number, they will be merged into one order with all items combined so a single order will be created per customer.

Create single CRP order

You can use the following endpoint, but you have to make three main changes

POST

https://app.bosta.co/api/v2

/deliveries

More Info

1. Change order type to CUSTOMER_RETURN_PICKUP.
   
2. Add fulfillmentInfo object in the payload.
   
3. Add originalFulfillmentTrackingNumber.

Note

• originalFulfillmentTrackingNumber represent the original fulfillment delivery tracking number that the CRP will be created based on it.
• Items in fulfillmentInfo should be only subset or all of the items that belong to the original fulfillment delivery.

Your Shipment Status

If you want to track your shipment status via Webhook, you have to follow the steps mentioned in this article Get Shipment Status via Webhook .
Your shipment could face one of the three following flows:

Successful Flow

Events arrange	State Name	State Code
1	Pickup requested	10
2	Fulfilled	25
3	Received at warehouse	24
4	In transit between Hubs*	30
5	Received at warehouse	24
6	Picked up	41
7	Delivered	45

Exception & Successful Flow

Events arrange	State Name	State Code
1	Pickup requested	10
2	Fulfilled	25
3	Received at warehouse	24
4	In transit between Hubs*	30
5	Received at warehouse	24
6	Picked up	41
7	Exception	47
8	Received at warehouse	24
9	Picked up	41
10	Delivered	45

Unsuccessful Flow

Events arrange	State Name	State Code
1	Pickup requested	10
2	Fulfilled	25
3	Received at warehouse	24
4	In transit between Hubs*	30
5	Received at warehouse	24
6	Picked up	41
7	Exception	47
8	Received at warehouse	24
9	Type of the order will be changed from FXF_SEND to RTO	-
10	In transit between Hubs	30
11	Received at warehouse	24
12	Returned to stock	60

Note

If the distance between the pickup address and the drop-off address is small enough the order won't go to the in transit between hubs state.