Web Service Call - FindLocation

Owned by Steven Reynolds (Unlicensed)
Last updated: Jul 27, 2021 by Nathan Dam (Deactivated)
2 min read

Purpose

Required/Useful to validate locations used in a Third Party System. Invalid locations used in the "SaveConsignment" call will fail if an invalid location is used. If Suburb and Postcode Validation is not performed in the source system, It is highly recommended that this call is used.

https://auspost.com.au/postcode/suburb- is used as a point of authority for existing/valid Australian suburbs and Postcodes

*This call is not required if sufficiant validation is performed in the source system/

Making a Call:

In this instance I am making a call to Find All locations in my uat environment through postman, I require my Session credentials from my previous example to continue.

*Learn how to chain this call in Creating Chained Requests

Endpoint: https://uat-thirdpartywcf.flipgroup.com.au/DataService.svc

This is not the production endpoint. The production endpoint will be provided once all requests have been validated to work correctly.

Headers: 

Body:

SOAP Web Service Call Body Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <FindLocation>
 
         <session>
            <AccountID>{{AccountID}}</AccountID>
            <DistributorID>{{DistributorID}}</DistributorID>
            <Expires>{{Expires}}</Expires>
            <Key>{{Key}}</Key>
            <UserID>{{UserID}}</UserID>
         </session>
 
         <countryCode>AU</countryCode>
         <searchValue>Hallam</searchValue>
      </FindLocation>
 
   </soapenv:Body>
</soapenv:Envelope>
SOAP Web Service Call Body Response
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <FindLocationResponse xmlns="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
            <FindLocationResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <Location>
                    <LocationID>8017</LocationID>
                    <Locality>HALLAM</Locality>
                    <State>VIC</State>
                    <Postcode>3803</Postcode>
                    <CountryCode>AU</CountryCode>
                    <SuburbStatePostcode>HALLAM VIC 3803</SuburbStatePostcode>
                </Location>
            </FindLocationResult>
        </FindLocationResponse>
    </s:Body>
</s:Envelope>

Filter by label

There are no items with the selected labels at this time.