createPaperworkForParcel

This method creates the label and customs documents for a particular parcel within an allocated consignment. The documents are created in a Base64-encoded format.

Note

It is assumed that you have worked through Creating your first Request to a Service and are familiar with the Properties needed to Call or Create a Consignment and Printing Properties.

How to submit a request

Proceed as follows:

  1. If you have not already done so, open a new project using the WSDL ConsignmentService.xml.

  2. Create a new request under createPaperworkForParcel.

  3. Enter the authorisation for the request.

  4. Specify the code of the existing consignment containing the parcel for which paperwork is to be generated.

  5. Specify the parcel for which paperwork is to be generated, by giving its parcelNumber (e.g. '1' or '2', etc.).

  6. Enter the parameters for document generation.

  7. Click Arrow.png to submit the request.

Example 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" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:createPaperworkForParcel soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <consignmentCode xsi:type="soapenc:string">DMC4BY1V4HMR</consignmentCode>
         <parcelNumber xsi:type="xsd:int">2</parcelNumber>
         <parameters xmlns:tns="http://schemas.xmlsoap.org/soap/envelope/">
            <Property>
               <propertyName>type</propertyName>
               <propertyValue>all</propertyValue>
            </Property>
            <Property>
               <propertyName>format</propertyName>
               <propertyValue>pdf</propertyValue>
            </Property>
            <Property>
               <propertyName>dimension</propertyName>
               <propertyValue>6x4</propertyValue>
            </Property>
         </parameters>
      </ser:createPaperworkForParcel>
   </soapenv:Body>
</soapenv:Envelope>

For an example response and how to process the information, see below.

Example Response

<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:createPaperworkForParcelResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:DeliveryManager/services">
         <createPaperworkForParcelReturn xsi:type="ns2:Paperwork" xmlns:ns2="urn:DeliveryManager/types">
            <documents xsi:type="soapenc:base64Binary" xsi:nil="true" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"/>
            <labels xsi:type="soapenc:base64Binary" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">JVBERi0xLjQ.....c4MAolJUVPRgo=</labels>
        </createPaperworkForParcelReturn>
      </ns1:createPaperworkForParcelResponse>
   </soapenv:Body>
</soapenv:Envelope>

Decode and Print the Labels and Customs Documents

The results are generated in up to two strings at the bottom of the response: a labels string containing the label(s) for each parcel, and a documents string containing the customs documents.

In the example response, the Base64-encoded strings have been truncated for aesthetic purposes.

To generate the labels or documents from the string, you need to copy and load the string into a Base64 decoder. For more information about this, refer to Store the Paperwork and Print Later.