DeliveryBookingModel
Used to get a quote or book a delivery
Name | Description | Type | Additional information |
---|---|---|---|
Reference |
Your internal reference id for this delivery. If the reference is not provided, a new reference number will be assigned. |
string |
Max length: 50 |
DeliveryInstructions |
Instructions for the driver, for example: "Ring when you get to the street", "The nearest cross street is High St", or "Watch out for the dog!" |
string |
Max length: 2000 |
ItemsRequirePurchase |
Some merchants may need to use our payment in store service. Set this to true if you require the driver to pay for items. Please arrange with us in advance if you require this service. We recommend setting this to false unless you really need it. |
boolean |
None. |
Items |
Packages included in the delivery |
Collection of DeliveryBookingItemModel |
None. |
Capacities |
Job Capacity Name Size pair included in the delivery |
Collection of JobCapacityModel |
None. |
PickupTime |
For pre-order bookings, this specifies a specific time when delivery items should be picked up. Date should comply with ISO_8601 format, see http://en.wikipedia.org/wiki/ISO_8601#UTC for more details. If this date is not supplied, we will assume that the delivery should take place immediately, nearby drivers will be notified straight away. |
date |
None. |
PickupDetail |
Address and other details for the delivery origin. This is not required for service based merchants. |
DeliveryBookingLocationModel |
None. |
DropoffWindow |
The window of time required for the delivery to be completed. If not supplied, we will deliver as soon as possible. |
TimeFrameModel |
None. |
DropoffDetail |
Address and other details for the delivery destination |
DeliveryBookingLocationModel |
Required |
CustomerFee |
Delivery or job fee charge to the end customer. If this value is provided it will override the calculated price (based on values set in the merchant API settings ) |
decimal number |
None. |
CustomerReference |
External customer reference. Use this (for example) to match the origin of a job for your internal accounting |
string |
Max length: 50 |
CustomerId |
External customer ID. This can be used to record which customer a job was delivered to, using a customer ID in your internal systems. |
string |
Max length: 100 |
Tax |
The tax amount |
decimal number |
None. |
TaxInclusivePrice |
Specifies whether or not the price includes taxes. Set to true or false. |
boolean |
None. |
Tip |
The tax amount |
decimal number |
None. |
DriverFeePercentage |
Percentage of the CustomerFee that the driver should be paid |
decimal number |
None. |
DriverMatchCode |
A code used to notify a specific driver (see Driver/Job Match Key screen) |
string |
None. |
DeliverySequence |
Used to sequence deliveries in the order they should be completed by a particular driver. This order is reflected in the driver's app |
integer |
None. |
AutoAcceptMatchCode |
If a Driver Match Code has a single match, the job will auto accept |
boolean |
None. |
Constraints |
Job requirement constraints so only particular drivers matching the required constraints will be notified. |
Collection of JobConstraintModel |
None. |
DeliveryRouteIdentifier |
Used to distinguish deliveries from separate routes but the same delivery sequence number. This order is reflected in the driver's app and on the dispatcher map. |
string |
None. |
Webhooks |
Allows URLs to be called when various events occur in GetSwift. (see the webhooks documentation for specific event name) |
Collection of DeliveryEventWebhookModel |
None. |
Template |
Use a template |
string |
None. |
OrderPrice | decimal number |
None. |
|
Payments | Collection of OrderPaymentModel |
None. |
|
Metadata | Collection of JobMetadataModel |
None. |
|
JobCapacities | JobCapacities |
None. |