How to: Create Orders

5 min

for information about prerequisites, see integrate with docid\ lgpwxpxeuqvfmdy eddbd create orders to create an order, call the following endpoint and post /orders/ specify the required docid\ i2nt8t7mn9jrmau8p1mkx in the request body the request body is specified in json format and shows how to create a new order sample request { "dropdetails" { "contact" "string", "location" "string" }, "ordersummary" { "invoicenumber" "string", "orderdescription" "string", "totalweight" { "value" 9999999, "additionalprop1" {} }, "totalvolume" { "value" 9999999, "additionalprop1" {} }, "totalitems" 0, "totalordercost" { "cost" 0, "currencycode" "string", "minorunit" 0 }, "totalinvoice" { "value" 1000000000000, "currencycode" "string", "minorunit" 3 } }, "clientdetails" { "clientname" "string", "clientid" "string", "clientorderid" "string" }, "mps" { "groupid" "string", "groupsize" 0, "isenabled" true, "ispartial" true }, "ewaybillattributes" { "is valid ewaybill" true, "ewaybills" \[ "string" ] }, "producttype" "string", "planningmode" "string", "modeoftransport" "string", "speedoftransport" "string", "shipmentflow" "string", "pickupdetails" { "contact" "string", "location" "string", "pickupslot" { "from" 0, "to" 0 }, "servicetime" 43200, "instruction" "string" }, "paymentinformation" { "paymenttype" "string", "paymentoption" "string" }, "deliverydetails" { "promiseddeliverydate" "string", "deliveryslot" { "from" 0, "to" 0 }, "servicetime" 43200, "instruction" "string" }, "actions" { "qcvalidation" { "isrequired" true, "requiredat" "pickup" }, "qcvalidationchecklist" {}, "kycverification" { "isrequired" true, "requiredat" "pickup" }, "otpverification" { "isrequired" true, "requiredat" "pickup" }, "signaturecollection" { "isrequired" true, "requiredat" "pickup" } }, "notificationdetails" { "notificationtype" "pickup", "notificationmode" "sms" }, "returndetails" { "contact" "string", "location" "string", "returnslot" { "from" 0, "to" 0 }, "servicetime" 43200 }, "priority" 3, "maxattempts" 3, "teamid" "string", "seqno" 20000, "routetag" "string", "vehiclemodel" "string", "readytoprocess" true, "containers" \[ { "containertype" "shipment", "scannableid" "string", "trackingdetails" { "operator" "string", "trackingid" "string", "isprimary" true }, "attributes" { "dimensions" { "weight" 0, "volume" 0, "additionalprop1" {} }, "additionalprop1" {} } } ], "callback" { "url" "https //delhivery requestcatcher com/", "meta" {} } } sample response { "error" { "code" "string", "description" "string", "additionalinfo" {} }, "request" { "uri" "string", "method" "post", "querystring" "string", "body" {} }, "data" { "id" "string" } } note while creating an order, users can provide location details either as a string (which could be a facility id if they have facilities created) or as an object with more detailed information, including addressline1, addressline2, city, state, etc this applies to pickup, drop off, and return locations the sample request above is the example of a location when passed as string now, let's see the sample request when the location is passed as an object sample request