Introduction

Let’s talk about how to get your orders set up. Whether you’re creating one order or a hundred, we’ve got you covered.

This video gives an overview of how to create orders on Burq:

Creating a Single Order

Here’s how to create an order one step at a time:

Go to the Orders Section:
Log in to your Burq Dashboard and head over to the "Orders" tab.
Click ‘Create Order’:
Hit the button to open up the order form.
Fill Out the Details:

Select a delivery time
You can choose to request a driver right away (ASAP) or you can choose to schedule delivery, with the option to select date and time for either pickup or drop off
Pickup Address
Enter a new address or choose to browse through saved addresses for Stores or Customers
Details
Provide all additional information to help the DSP make the delivery effectively. When you select a pre-saved address as the pickup address, we will pre-fill all the additional information that you had previously entered for the same address, saving you some time and effort.
Dropoff Address
Enter a new address or choose to browse through saved addresses for Customers
Customer Details
Similar to details for pickup address, provide all additional information. When you select a pre-saved address as the dropoff address, again all saved information will be pre-filled for you
Enter order details
Provide all the relevant information such as the items included in the order, their quantity and size so the DSPs can make a better judgement when sending a vehicle for delivery. Adding order value helps us in cases of refunds and you can choose to add an order number for your internal tracking and management.
Set tips
Tips are a way of ensuring top quality service from the riders as 100% of the tips go to them

Click on Next to assign Provider

Select the preferred vehicle type and the delivery preferences. Click submit to assign Provider and initiate delivery

Creating Orders in Bulk

Burq lets you import multiple orders on to the dashboard using CSV. To import, simply click on the Import using CSV button that is available in the Bulk Upload button in the Orders tab as shown below.

You can drag and drop your CSV file or click browse the file and click Import. You can download the sample CSV that we have created. It contains the format that is needed to upload the file.

How to use CSV file?

CSV file will have the following columns, some of them are required for orders to be created, you can experiment with CSV upload by creating orders in test mode.

Here's the refined table with Sample Values included on the same row but moved to a new line:

Field	Requirement	Description/Notes
External Order Reference	Required	Merchant-provided delivery identifier. Used for cross-referencing deliveries from Burq API with merchant systems.
Store ID		ID of a store created on Burq. Found under the Stores tab in Burq dashboard.
Pickup Name	Required	Name of individual or company at pickup location. Optional if store_id is provided. Otherwise required.
Pickup Phone Number	Required	Phone number of pickup location. Optional if store_id is provided. Otherwise required. Sample Value: 18045893983
Pickup Address	Required	Full address of pickup location (street, city, zipcode, country). Exclude unit number. Optional if store_id is provided.\ Sample Value: 1717 E Cary St, Richmond, VA 23223, USA
Pickup At		Timestamp for pickup in ISO8601 format (UTC). Cannot be provided with dropoff_at.\ Sample Value: 2024-06-14T09:22+07:00
Pickup Unit Number		Unit number of pickup location. Optional if store_id is provided.
Pickup Notes		Instructions for drivers when picking up items.
Dropoff Name	Required	Name of individual or company receiving the delivery.
Dropoff Phone Number	Required	Phone number of dropoff location. Sample Value: 18045893983
Dropoff Address	Required	Full address of dropoff location (street, city, zipcode, country). Exclude unit number.\ Sample Value: 13th St, Brooklyn, NY 11215, USA
Dropoff At	Required	Timestamp for delivery in ISO8601 format (UTC). Cannot be provided with pickup_at.\ Sample Value: 2024-06-14T09:22+07:00
Dropoff Unit Number		Unit number of dropoff location.
Dropoff Notes		Instructions for drivers when dropping off items.
Vehicle		Preferred vehicle type (Car, SUV, Truck). May not affect all providers.
Order Value		Total value of all items in the delivery in cents.
Tip Amount		Tips for the driver. Forwarded to delivery providers in cents.
Item Name	Required	List of items to be delivered.
Item Quantity		Quantity of items listed.
Item Size		Size of the item (Small, Medium, Large).
Contactless Delivery		Indicates if delivery is contactless. Cannot be true if signature is required.
Request Signature		Indicates if signature is required at dropoff. Cannot be true if contactless delivery is enabled.
Test Mode		Indicates if delivery is created in test mode.
Auto Initiate		Automatically assigns providers based on Order Workflow preferences. Configurable in the Workflow tab.

Adding multiple items:
To list down multiple items in a single order, simply add External order ID number in the following row and just add item details as shown in the image below.

View history:
By clicking on the View history button, merchants can view the the status of their uploaded file and check how many orders have been created and how many have failed.

Incase of there are orders that have failed to upload, merchants can click on the View error details to see the exact row that failed to upload along with the reason of failure.