If you wish to create a placeholder for a future consignment, you can create a Pending Consignment. Unlike creating a consignment, you don't need to provide the full data to create a pending one. However, the more info you provide, the easier it is to convert the pending consignment into a consignment.
This article will outline the properties and steps required to create a pending consignment in MachShip.
Create Pending Consignment Request Parameters
All these details must be provided to the /apiv2/pendingConsignments/createPendingConsignment for MachShip to return your valid despatch options. Please refer to our API documentation for further technical documentation regarding creating consignments.
Despatch DateTime (optional)
MachShip allows you to specify the despatch date and time of the consignment. Please refer to our Working with Despatch Dates when Routing and Creating Consignments documentation for further information on specifying the Despatch DateTime.
Pickup and Delivery Locations
Please refer to our Working with Locations when Routing and Creating Consignments documentation for details on how to specify locations when generating a routing request.
Only Address 1 field for both Pickup and Delivery Locations is required.
Special Instructions (optional)
Special Instructions allow you to specify any special instructions that need to be passed on to the carrier regarding the delivery location. This could include instructions such as 'leave at front door'.
Please refer to our Working with Items when Routing and Creating Consignments documentation for details on how to specify items when generating a routing request.
Company ID (optional)
Company ID can be used if you wish to get routes for a specific company in MachShip. This is useful if you have multiple companies in MachShip and need to get routing and pricing for different companies. If no company ID is provided, the company that your user is assigned to will be used to return routes. Please refer to /apiv2/companies for company documentation.
Carrier ID (optional)
Carrier ID tells MachShip which carrier should be used for this consignment. This should be taken from the selected route using the carrier.id property.
Carrier Account ID (optional)
Carrier Account ID tells MachShip which account should be used for this consignment. This should be taken from the selected route using the carrierAccount.id property.
Company Carrier Account ID (optional)
Company Carrier Account ID tells MachShip which carrier should be used for this consignment. This should be taken from the selected route using the companyCarrierAccountId property.
Carrier Service ID (optional)
Carrier ID tells MachShip which carrier should be used for this consignment. This should be taken from the selected route using the carrierService.id property.
Customer References (optional)
You can provide 2 customer references when creating a consignment. These could be a Purchase Order number, an internal reference to your system, etc. These can be provided using the following properties.
Question IDs (optional)
Question IDs allow you to pass in answers to questions that allow MachShip to further restrict routes. This should not be specified unless advised to do so by the MachShip support team.
Create Pending Consignment Request Example
A basic request
A request with many fields provided
"fromName": "My Warehouse",
"fromContact": "Bob Jones",
"toName": "Customers House",
"toContact": "Stacy Smith",
"specialInstructions": "leave at front door"
Create Pending Consignment Response
If a pending consignment is created successfully, MachShip will return an object with a subset of the properties relating to the consignment including:
- ID: This is the unique identifier that you should reference for all other API calls relating to this pending consignment. For future API calls, it is recommended that this ID is stored within your system.
- consignmentNumber: This is the ID with a PC prefix. This is the human-friendly ID that is used in MachShip's UI and is also the main reference that is sent through to the carrier.
"errorMessage":"Pending Consignment Created Successfully"