The Metapack Shipping API (SOAP) Quick Start Collection contains a brief sequence of SOAP API calls that can be run in Postman,
The calls are designed to get you up and running with the Delivery Manager Shipping API, all the way from pre-ship carrier service selection through to manifesting,
You can download Postman here for Mac, Windows or Linux. You can still use the Postman for Chrome extension, but this is deprecated, and It is therefore recommended that you download your preferred native O/S version.
You can download the collection by clicking the Run in Postman button below.
Click here to familiarise yourself with the basics of making SOAP requests in Postman. Besides this link, there are many useful YouTube tutorials.
It is also important that you go through Set up Delivery Manager before using the Collection.
If you are new to the Shipping API, you will need a Delivery Manager account with your own
Passwordwith which you can create and allocate consignments.
Passwordare entered against the
Basic Authtype under the Authorization tab in Postman. These have already been parameterised for you.
There is no need for an API key.
You will need to have logged onto your Delivery Manager account and gone through the preliminary steps required to set up your carrier services.
The collection assumes that your workflow is the default one in Delivery Manager - i.e. that you are set up to move automatically to 'Ready to manifest' (rather than 'Printed') after printing (refer to How do I Print and Manifest separately?).
The API methods used in the collection are cut down versions of those referenced in From Pre-Ship through to Manifesting, i.e.
Your collection, once downloaded, should appear as a series of
POST requests in the left hand pane, as shown below. They are numbered 1-6 and should be run in the sequence indicated, as each call is dependent on a previous one.
It is not appropriate to use the Postman Collection Runner as you will need to amend the values of particular variables between the running of requests.
Proceed as follows:
Click on the first request in the collection (findDeliveryOptionsWithBookingCode) and ensure that the Metapack Shipping API environment is selected in the top right hand corner (this will have been imported alongside your collection):
The request URL is set to the SOAP endpoint (i.e. the full path to the particular Delivery Manager service). In the above example, this is:
While REST typically uses JSON and other data formats, SOAP relies on XML, which is entered under the Body tab and must include the SOAP
Bodytags. The name of the particular API method is given at the top of the
Bodytag. The body type is set to
The values used in the request are a mixture of fixed values (e.g.
<parcelValue xsi:type="xsd:double">300</parcelValue>) and variable values (enclosed within double braces, e.g.
Overwrite the fixed values as required, e.g. enter your own values for the
For the variable values, go to the Metapack Shipping API environment in the top right hand corner of the application. Display the variables by first going to the Quick Look (eye) icon, and then clicking Edit:
You will see a list of variables representing many of the mandatory fields required to make the first two requests in the collection. Enter the values for all the variables as far down as
We have pre-filled both the
GBR, but you will need to overwrite these if you are shipping to and from other countries.
Once you have completed the
initial values, click Reset All to set all the
current values. Then click Update at the bottom of the above environment box to save your values.
Once all the values are as required, click Send to make the request.
The response will be returned under the response Body tab in XML format, where the status should be
200 OKfor a valid response, e.g.
Repeat from step 1 for the next request. You must ensure that the variables are set as required for each request. Instructions are given at the top of the request, e.g.