# Place Order V3 Place Order API has two flow: 1. **Manual Flow** : The available items are passed and order can be placed. 2. **Prescription Digitization Flow** : In this flow only prescription will be provided which will be digitized at our end then, order will be placed. 3. **Order To a Particular Pharmacy (Pickup Order Only):** For Pickup orders the order can be placed to a particular chemist directly which are nearby to the user location. Refer to API `checkout_with_pharmacy` and use parameter `assign_to_chemist_id` . > In API request, You need to pass either provide **patient\_id** or **mobile & patient\_name**. To Place an order you can try with below medicines: * LTK-25 ( BEXJIx1DBa0TyZQjJB+qDw== ) * LTK-50 ( gv0GokYn9w4zFL51eouS2g== ) * LTK-AM ( vVgL6Ggy5tYhqQr1qXOAzA== ) * Rancil 10 ( kb/sYNrCj/A7lRqf7VCQOA== ) * Vicks Vapourub 25 ml ( P50Ved5KnpFmBp9XGAIVUg== ) ## [Placing Orders with Ease: A Step-by-Step Guide](https://youtu.be/1TlUVPaWolI?si=2ybv22QYp_P3w994) ## Things to know * **Price Increase After Order Place:** (very less probability to occur) * **Scenario :** While taking the payment if time difference is too large between checkout and place-order due to payment delay(from patient/user) then the `location_token` might change. This might resulting in price-increase. * **Solution-1:** Every time Before taking the payment from user refresh the location-token, then call checkout-v3 to get updated price. After that only place-order to avoid price increase. * **Solution-2:** Compare the order-total from Place-Order API Response with the payment amount taken from patient(user). If order-total is increased then cancel the order and place a new another. * **Solution-3:** Place the order in `pending` state and then take payment on **order-total** from Place-Order Response. And then call **Payment-Webhook API** to notify us. ## Place Order `POST` [`{{apiUrl}}fulfillment/orders/place_order_v3`](https://dev-api.evitalrx.in/v1/fulfillment/orders/place_order_v3) #### Request Body | Name | Type | Description | | ------------------------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | apikey\* | String | Authentication token | | location\_token\* | String | Get token from Check Serviceability V3 API | | patient\_id\* | String |

Id to uniquely identify the patient for whom the order is placed

if mobile and patient name 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}]


Provide only available items which can be know from checkout V3.


Pass "discount\_percentage" along with "medicine\_id" and quantity to apply custom discount on the item.

| | delivery\_type\* | 'pickup' \| 'delivery' |

delivery (Default): Order will be delivered.
pickup : Order will be of pick-up type.

| | 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.​

prescription\_urls is mandatory for RX medicine.(Check is\_rx\_required from checkout)

For eg.

\[""]


| | 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 | | requested\_client\_source | String | Partner Order Source | | assign\_to\_chemist\_id | String | Chemist ID from `checkout_with_pharmacy` API to assign the order to a particular chemist | {% tabs %} {% tab title="200 Order Placed successfully." %} ```json { "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" } } ] } } ``` {% endtab %} {% tab title="200: OK Order failed." %} ```json { "status_code": "0", "status_message": "Something went wrong", "datetime": "2022-12-06 18:47:41", "data": null } ``` {% endtab %} {% endtabs %}