This method allows you to add 'Ready to Manifest' consignments to a post-dated manifest, and clear the consignments from the current transactional flow.
You might want to do this because you have a large number of orders to go out on a particular day in the future, but you want to leave sufficient time to pack and process them beforehand.
You can filter the consignments by carrier, warehouse and transaction type, and, optionally, manifest group.
The manifest is then sent to the carrier automatically.
Note
It is assumed that you have worked through Creating your first Request to a Service, and that, if required, you have already used addConsignmentsToGroup to assign a manifest group to the consignments.
How to submit a request
Proceed as follows:
-
If you have not already done so, open a new project using the WSDL
ManifestService.xml
. -
Create a new request under
createManifestForFutureDespatch
, -
Enter the authorisation for the request.
-
Specify the following to filter the consignments that are 'Ready to manifest':
-
The carrier code (refer to findCarriers) (mandatory).
-
The warehouse code (refer to Configuring your Default Warehouse) (mandatory).
-
The transaction type (mandatory).
-
The manifest group (refer to Scanning Consignments to a Trailer and addConsignmentsToGroup) (optional).
Note
If you not using manifest groups, and are simply using the default
manifestGroupCode
, then you should remove this optional field from the API call.
-
-
Specify the future
despatchDate
(mandatory). -
Set
specificDateOnly
totrue
if only those consignments that are due to be despatched on the specifieddespatchDate
are to be added to the manifest. Otherwise, set it tofalse
. -
Click to submit the request.
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="urn:DeliveryManager/services">
<soapenv:Header/>
<soapenv:Body>
<ser:createManifestForFutureDespatch soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<carrierCode xsi:type="soapenc:string" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">HERMESPOS</carrierCode>
<warehouseCode xsi:type="soapenc:string" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">READING1</warehouseCode>
<transactionType xsi:type="soapenc:string" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">DELIVERY</transactionType>
<manifestGroupCode xsi:type="soapenc:string" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">TRUCK10</manifestGroupCode>
<despatchDate xsi:type="xsd:dateTime">2020-07-27T05:31:00.000Z</despatchDate>
<specificDateOnly xsi:type="xsd:boolean">false</specificDateOnly>
</ser:createManifestForFutureDespatch>
</soapenv:Body>
</soapenv:Envelope>
As shown below, if the input is valid, a manifest number is returned and the newly created manifest is emailed to the carrier.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<ns1:createManifestForFutureDespatchResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:DeliveryManager/services">
<createManifestForFutureDespatchReturn soapenc:arrayType="soapenc:string[1]" xsi:type="soapenc:Array" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
<createManifestForFutureDespatchReturn xsi:type="soapenc:string">DMM1W29ZV</createManifestForFutureDespatchReturn>
</createManifestForFutureDespatchReturn>
</ns1:createManifestForFutureDespatchResponse>
</soapenv:Body>
</soapenv:Envelope>
If you wish to confirm the creation of the manifest, then check the Historic Manifests (refer to findManifests, Generating a Delivery Manifest and Generating a bulk Delivery Manifest).