Create multiple deliveries
POST/standard/deliveries
This endpoint is meant to be used for creating multiple deliveries at once in our Platform to then be processed and dispatched by a fleet.
Request
Header Parameters
Default value: Bearer <token>
Default value: application/json
- application/json
Body
array
- Array [
- ]
If a good is considered hazardous and needs special treatment then we advise to set this as true
City for the dropoff - destination city
Comments while dropping off the package/s - i.e. please enter the red gateway and turn left
Company name in case is a B2B delivery or parcel needs to be dropped at the customer's workplace
Receiver's firstname who is addressed the package/s to
Receiver's lastname who is addressed the package/s to
Receiver's email who is addressed the package/s to. This field can be used by SiG or the Fleet to provide certain notifications to the receiver
Receiver's phone who is addressed the package/s to. Be aware that this field can be used by SiG or the Fleet to provide certain notifications via SMS or WhatsApp
Receiver's streetname where the package/s will be dropped off
Receiver's streetnumber where the package/s will be dropped off
Receiver's postalcode where the package/s will be dropped off
If the agreement allows this service, this field will indicate what's the safeplace designated by the customer
If the agreement allows this service, this field will indicate what's the neighbour's name designated by the customer
Quantity of parcels within this delivery. By default is 1
This field represents the Delivery ID from the Sender's side which usually represents the Order Id of the purchase. This ID will be used for the driver to recognize the package and the destination
Flag for testing while implementing, this will prevent to be sent to the real fleet and remain in the Sandbox. It's only meant to be used for integration purposes
If the volume of the parcel is known from the Sender's side, it is recommended to be provided. It is expected to be in cm³
Field to host the weight of the delivery when is known. The standard units are kg
Type of delivery service. Keep in mind every service has a different price and different terms
Field to use in order to group a sequence of deliveries that shall be combined
Responses
- 200
- 400
- 500
OK
- application/json
- Schema
- Example (from schema)
- example-200
Schema
Possible values: non-empty
{
"status": "string"
}
{
"status": "ok"
}
Bad Request
- application/json
- Schema
- Example (from schema)
- example-400
Schema
Possible values: non-empty
{
"error": true,
"message": "string"
}
{
"error": true,
"message": "missing the following fields: dropoff_firstname, dropoff_lastname"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
- example-500
Schema
Possible values: non-empty
{
"error": true,
"message": "string"
}
{
"error": true,
"message": "Internal error, please contact support@sendit.green"
}