Place Order V3

To place order with items and its quantity.

Placing Orders with Ease: A Step-by-Step Guide

Place Order

POST {{apiUrl}}fulfillment/orders/place_order_v3

Request Body

Name	Type	Description
apikey*	String	Authentication token
location_token*	String	Get token fro Check Serviceability V3 API
patient_id*	String	Id to uniquely identify the patient for whom the order is placed if mobile is provided, then patient_id is optional.
items*	String	Stringified Array of items with quantity (in strip) and medicine_id. i.e. [{"medicine_id":"Eli4pMFfzobV63G67jtjZw==","quantity": 2}]
delivery_type*	String	Order Delivery type can be pickup or delivery
address*	String	Address of Patient for delivery. required if delivery_type is delivery
address_line2	String	Address Line 2 for long address
city*	String	City of Patient for delivery
state*	String	State of Patient for delivery
zipcode*	String	Zip code of Patient for delivery
latitude*	Number	Latitude of the patient to search in nearby pharmacies.
longitude*	Number	Longitude of the patient to search in the nearby pharmacies.
mobile	String	Patient's mobile no is optional if patient_id is provided, required otherwise.
patient_name	String	Patient's name is optional if patient_id is provided, required otherwise.
prescription_urls	String	Stringified Array of prescription URLs.​ items param is optional, if prescription_urls param is passed.​ For eg. ["https://www.klippa.com/wp-content/uploads/2020/12/medical-prescription-ocr.png","https://as2.ftcdn.net/v2/jpg/00/56/61/71/500_F_56617167_ZGbrr3mHPUmLoksQmpuY7SPA8ihTI5Dh.jpg"]
full_address	String	Required If lat-long is not provided. This address is used to get the lat-long to find the nearest pharmacy store. Only zipcode can also by passed in this param like { "full_address": "560008" }
requestId	String	Partner order id

200 Order Placed successfully.

{
    "status_code": "1",
    "status_message": "Order placed successfully",
    "datetime": "2025-03-13 17:52:30",
    "version": "1.1.51",
    "data": {
        "order_id": "F7VH/hoYLmOIBrCiHyccng==",
        "order_number": "OOM87BK5Y7",
        "total_amount": 119,
        "total": 149,
        "split_orders": [
            {
                "order_id": "7xS09/uGsj9fglWVxIw97Q==",
                "order_number": "O2M87BK68H",
                "chemist_details": {
                    "chemist_id": "GJmQXzl+VAVkke3efyTrcw==",
                    "pharmacy_name": "Demo Pharmacy",
                    "full_address": "Evital Rx 4d Square Mall, Ahmedabad, Gujarat, India, 380005",
                    "latitude": "23.1025849",
                    "longitude": "72.5953601",
                    "zipcode": "380005"
                }
            }
        ]
    }
}

200: OK Order failed.

{
    "status_code": "0",
    "status_message": "Something went wrong",
    "datetime": "2022-12-06 18:47:41",
    "data": null
}