findServicesInGroups

This method allows you to find out which carrier services (carrierServiceCodes) are contained within particular carrier 'service groups' (serviceGroupCodes).

This may be useful if you wish to find out why the booking codes that specify carrier 'service groups' are not returning the expected results. It also makes the returned carrierServiceCodes visible so that you can use them in booking codes.

Tip

If you need to modify your carrier 'service groups' after using this method, refer to Creating your Carrier 'Service Groups'.

Note

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

How to submit a request

Proceed as follows:

If you have not already done so, open a new project using the WSDL InformationService.xml.
Create a new request under findServicesInGroups,
Enter the authorisation for the request.
Specify the serviceGroupCodes for which carrierServiceCodes are to be returned.
Click to submit the request. You know that the information request has been successful once one or more carrierServiceCodes have been returned above a serviceGroupCode.

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:findServicesInGroups soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <serviceGroupCodes xsi:type="typ:ServiceGroupRequest"
xmlns:typ="urn:DeliveryManager/types">
            <serviceGroupCodes>
               <item>NEXT</item>
               <item>48</item>
            </serviceGroupCodes>
         </serviceGroupCodes>
      </ser:findServicesInGroups>
   </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:findServicesInGroupsResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:DeliveryManager/services">
         <findServicesInGroupsReturn soapenc:arrayType="ns2:ServiceGroupResponse[2]" xsi:type="soapenc:Array" xmlns:ns2="urn:DeliveryManager/types" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
            <findServicesInGroupsReturn xsi:type="ns2:ServiceGroupResponse">
               <carrierServiceCodes soapenc:arrayType="soapenc:string[3]" xsi:type="soapenc:Array">
                  <carrierServiceCodes xsi:type="soapenc:string">HERM48</carrierServiceCodes>
                  <carrierServiceCodes xsi:type="soapenc:string">DPD07SWAPIT2D</carrierServiceCodes>
                  <carrierServiceCodes xsi:type="soapenc:string">HERMNONSIG48</carrierServiceCodes>
               </carrierServiceCodes>
               <serviceGroupCode xsi:type="soapenc:string">48</serviceGroupCode>
            </findServicesInGroupsReturn>
            <findServicesInGroupsReturn xsi:type="ns2:ServiceGroupResponse">
               <carrierServiceCodes soapenc:arrayType="soapenc:string[2]" xsi:type="soapenc:Array">
                  <carrierServiceCodes xsi:type="soapenc:string">HERMNDG</carrierServiceCodes>
                  <carrierServiceCodes xsi:type="soapenc:string">UPSEXPEDITED</carrierServiceCodes>
               </carrierServiceCodes>
               <serviceGroupCode xsi:type="soapenc:string">NEXT</serviceGroupCode>
            </findServicesInGroupsReturn>
         </findServicesInGroupsReturn>
      </ns1:findServicesInGroupsResponse>
   </soapenv:Body>
</soapenv:Envelope>