findCarriers

This method allows you to find out which carriers are set up for the seller, both active and non-active. The relevant carrier codes are returned, together with the associated names. The codes can then be used in other calls, including createManifest.

Note

It is assumed that you have worked through Creating your first Request to a Service.

How to submit a request

Proceed as follows:

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

  2. Create a new request under findCarriers,

  3. Enter the authorisation for the request.

  4. Click Arrow.png to submit the request. You know that the information request has been successful once carrierCodes and names have been returned.

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">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:findCarriers soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
   </soapenv:Body>
</soapenv:Envelope>

For an example response, 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:findCarriersResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:DeliveryManager/services">
         <findCarriersReturn soapenc:arrayType="ns2:CodeName[4]" xsi:type="soapenc:Array" xmlns:ns2="urn:DeliveryManager/types" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
            <findCarriersReturn xsi:type="ns2:CodeName">
               <code xsi:type="soapenc:string">ROYALMAIL</code>
               <name xsi:type="soapenc:string">Royal Mail</name>
            </findCarriersReturn>
            <findCarriersReturn xsi:type="ns2:CodeName">
               <code xsi:type="soapenc:string">ROYALMAILTRKNOOBA</code>
               <name xsi:type="soapenc:string">Royal Mail Tracked non-OBA</name>
            </findCarriersReturn>
            <findCarriersReturn xsi:type="ns2:CodeName">
               <code xsi:type="soapenc:string">DHL</code>
               <name xsi:type="soapenc:string">Yodel</name>
            </findCarriersReturn>
            <findCarriersReturn xsi:type="ns2:CodeName">
               <code xsi:type="soapenc:string">YODEL</code>
               <name xsi:type="soapenc:string">Yodel B and N</name>
            </findCarriersReturn>
         </findCarriersReturn>
      </ns1:findCarriersResponse>
   </soapenv:Body>
</soapenv:Envelope>