Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
outlinetrue
indent10px
typeflat

What is Web Service Call

EFM use SOAP Web Service Calls which is a method of communicating to an application and the data it has available.

...

Making a Web Service Call

To make a call you will need to know 3 thinks

Where you are sending the information

UAT Endpoint: https://bau-uat-ws.azurewebsites.net/Data/ChainIT/DataService.svc

Production Endpoint: https://enodo-ws.azurewebsites.net/Data/ChainIT/DataService.svc

What you are planning to do

Headers:

What information you are sending

Body:

Code Block
languagexml
themeRDark
firstline1
titleSOAP Web Service Call Body Example
linenumberstrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
<!-- Requirements of each soapAction can be found http://support-ws.azurewebsites.net/Data/ChainIT/DataService.svc?xsd=xsd0 -->

				<!-- Example XSD Schema available for Login

					<xs:element name="Login">
						<xs:complexType>
							<xs:sequence>
								<xs:element minOccurs="0" name="userName" nillable="true" type="xs:string"/>
								<xs:element minOccurs="0" name="password" nillable="true" type="xs:string"/>
							</xs:sequence>
						</xs:complexType>
				</xs:element> 

				Example XSD Schema available for Login -->

<!--Below Content Dependent on soapAction Selected  -->

      <cha:Login>
         <!--Optional:-->
         <cha:userName>test@oneflo</cha:userName>
         <!--Optional:-->
         <cha:password>efm123</cha:password>
      </cha:Login>


   </soapenv:Body>
</soapenv:Envelope>

Web Service Functions/Calls

Function List

...

FunctionName

...

CancelConsignment

...

ConsignmentTrackingSearch

...

ConsignmentTrackingSearchByDistributorByAccount

...

CreateAccount

...

CreateConsolidatedBookings

...

FetchAddressByID

...

FetchBookingsByAccountAndDate

...

FetchConsignmentTracking

...

FetchConsignmentTrackingDirectAccess

...

FindLocation

...

GenerateDailyManifests

...

GenerateLabels

...

GenerateManifest

...

GetChargeQuote

...

GetChargeQuote2

...

GetChargeQuote3

...

GetChargeQuote4

...

GetChargeQuote5

...

GetLocationsByPostCode

...

GetStandardServices

...

Login

...

Logout

...

ReleaseAllConsignments

...

ReleaseSelectConsignments

...

ReleaseSingleConsignment

...

SaveAddress

...

SaveAndBookConsignment

...

SaveBookAndManifestConsignment

...

SaveConsignment

...

SavePickupRequest

...

SavepickupRequestFastTest

...

ValidateLocation

Function Explanation

CancelConsignments()

This process has implemented to allow consignments to be cancelled if a consignment has been saved with incorrect data or if the consignment is no longer required. The function requires a valid Session Key and the ConsignmentID of an un-manifested consignment. If the cancellation is successful the function will return a Boolean value.**

CreateConsolidatedBookings()

In some circumstances it may be required to auto book all consignments, particularly for return consignments. This function requires and valid Session Key and a valid DateTime for the pickup date. The function will return a Booking Notification object that will contain a ConfirmationID if successful or ResponseError message if the booking has failed.

FetchAddressByID()

Addresses are stored in the database as records with a unique ID. To increase efficiency the platform is designed to store the AddressID of an address record rather than the entire address data against a consignment record. As a result of this design decision it is a requirement that the address data be retrievable if the AddressID is known. In some scenarios the complete dataset of a consignment record will need to be known or displayed. A consignment record (returned as a consignment object) contains a receiver and sender property, where the value of these properties is an AddressID.  By calling this function and passing the AddressID the complete address data becomes available.

FetchBookingsByAccountAndDate()

It may be necessary to view all bookings requested for a specific date. This function takes a Session Key and a DateTime to filter all bookings that match. The function returns Booking Notification objects that includes summary booking details and the ConfirmationID.

GenerateDailyManifests()

This is the function that is used to generate the manifest. The function finds all released consignments applicable to the Session object and flags them for manifesting. The result is that the EDI Manifest Data process occurs and the system generates a printable pdf manifest.

GenerateLabels()

Each consignment record in the database is stored with a Connote value which is the prefix and sequence value prescribed by the carrier applicable to the consignment. The consignment is stored as a record with a unique ConsignmentID. This function is used to request a pdf byte string that represents the deconstructed label(s) for each consignment. The server side function creates the label format based on a prescribed label template. This function requires a Session object to be passed as the first parameter for security purposes. A label can be re-generated at any point in time provided the Session object is valid and the ConsignmentID is associated with the AccountID from the Session Object.

GetChargeQuote()

To retrieve a quote a list of parameters are passed for this function and a ServicePricing object is returned. This function uses the Locality and Postcode of the Sender and the Receiver coupled with a serviceList (returned from the function GetStandardServices) and the specific details such as items, weight and volume. The server side function matches the parameters against the AccountID’s rate card to determine the available services and the calculated cost.

GetStandardServices()

For quoting a consignment where the serviceList is unknown (required for GetChargeQuote function), this function returns a ServiceLookup object. The values returned in this object are the details of any service that has been configured for consigning and is based on the details of the Session object passed as a parameter. In some scenarios the quotation may not be required. This function can be used to populate an input field of available services and the service code selected as input can be passed as the Service property of the Consignment Object.

Login()

A majority of the functions listed in this document require a Session object be passed as the first parameter. This is a security principle that has been maintained across all functions that return customer sensitive data. Once a successful call has been made to the function then the Session object will contain a validated Session Key. This Key remains valid for 24 Hours and the DateTime of validity is stipulated in the Expires property.

Logout()

This functions exists to ensure that the implementation of Web Services can be controlled by the user.

ReleaseAllConsignments()

This function is required to allow for the release of all consignments. This function is a prerequisite task that must be called prior to generating the daily manifest. It takes a Session object, a Boolean value for placing bookings automatically for all consignments and a booelan value for generating the manifest.

SaveAddress()

A property required for creating a Consignment object is the Sender and Receiver AddressID. The platform has been designed in such a way that each address record is given a unique identifier and this identifier is stored against the consignment record. To maximise the efficiency of the platform, when a new consignment is to be created a request can be made to save a new address and if a record exists in the database that matches the unique combination of the address line, state, suburb and postcode then the existing identifier is returned. If there is no match a new record is created with the data parameters and the newly created identifier is returned.

SaveConsignment()

Once a Consignment object has been created containing the required parameters, including a validated SenderID, ReceiverID and ConsignmentItem object, this function can be called. Taking Consignment Object and Session object as input this function will generate a consignment record and the unique ConsignmentID is returned.

ValidateLocation()

A property of the Address object is the LocationID. This LocationID can be found by passing the State, Locality and Postcode of a location. If the combination of these properties exists, the matched LocationID is returned.

Function Definition (Table Format)

CancelConsignment




   </soapenv:Body>
</soapenv:Envelope>

Web Service Functions/Calls

Function Definition (Table Format)

CancelConsignment

This process has implemented to allow consignments to be cancelled if a consignment has been saved with incorrect data or if the consignment is no longer required. The function requires a valid Session Key and the ConsignmentID of an un-manifested consignment. If the cancellation is successful the function will return a Boolean value.**

Element

Type

Optional / Mandatory

Length

Comments

session

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

consignmentID

Long

M

20

This is the unique identification number applied to the consignment. Note** This number is different to the Consignment Note sequence.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:ConsignmentTrackingSearchByDistributorByAccount>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
         <!--Optional:-->
         <cha:connoteReference>?</cha:connoteReference>
         <!--Optional:-->
         <cha:consignmentDate>?</cha:consignmentDate>
         <!--Optional:-->
         <cha:distributorId>?</cha:distributorId>
         <!--Optional:-->
         <cha:accountId>?</cha:accountId>
      </cha:ConsignmentTrackingSearchByDistributorByAccount>
    </soapenv:Body>
</soapenv:Envelope>

CreateConsolidatedBooking

</soapenv:Body>
</soapenv:Envelope>

CreateConsolidatedBooking

In some circumstances it may be required to auto book all consignments, particularly for return consignments. This function requires and valid Session Key and a valid DateTime for the pickup date. The function will return a Booking Notification object that will contain a ConfirmationID if successful or ResponseError message if the booking has failed.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

pickupDate

string

M

10

Formatted as “YYYY-MM-DD”.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:CreateConsolidatedBookings>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
         <!--Optional:-->
         <cha:pickupDate>?</cha:pickupDate>
      </cha:CreateConsolidatedBookings>
   </soapenv:Body>
</soapenv:Envelope>

FetchAddressByID

Addresses are stored in the database as records with a unique ID. To increase efficiency the platform is designed to store the AddressID of an address record rather than the entire address data against a consignment record. As a result of this design decision it is a requirement that the address data be retrievable if the AddressID is known. In some scenarios the complete dataset of a consignment record will need to be known or displayed. A consignment record (returned as a consignment object) contains a receiver and sender property, where the value of these properties is an AddressID.  By calling this function and passing the AddressID the complete address data becomes available.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

AddressID

Int

M

10

AddressID object is returned object when calling the SaveAddress function

...

FetchBookingsByAccountAndDate

It may be necessary to view all bookings requested for a specific date. This function takes a Session Key and a DateTime to filter all bookings that match. The function returns Booking Notification objects that includes summary booking details and the ConfirmationID.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

pickupDate

string

M

10

Formatted as “YYYY-MM-DD”.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:FindLocation>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
         <!--Optional:-->
         <cha:countryCode>?</cha:countryCode>
         <!--Optional:-->
         <cha:searchValue>?</cha:searchValue>
      </cha:FindLocation>
   </soapenv:Body>
</soapenv:Envelope>

...

FindLocation>
   </soapenv:Body>
</soapenv:Envelope>

GenerateDailyManifest

This is the function that is used to generate the manifest. The function finds all released consignments applicable to the Session object and flags them for manifesting. The result is that the EDI Manifest Data process occurs and the system generates a printable pdf manifest.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:GenerateDailyManifests>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
      </cha:GenerateDailyManifests>
   </soapenv:Body>
</soapenv:Envelope>

GenerateLabels

Each consignment record in the database is stored with a Connote value which is the prefix and sequence value prescribed by the carrier applicable to the consignment. The consignment is stored as a record with a unique ConsignmentID. This function is used to request a pdf byte string that represents the deconstructed label(s) for each consignment. The server side function creates the label format based on a prescribed label template. This function requires a Session object to be passed as the first parameter for security purposes. A label can be re-generated at any point in time provided the Session object is valid and the ConsignmentID is associated with the AccountID from the Session Object.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

ConsignmentID

Long

M

20

This is the unique identification number applied to the consignment. Note** This number is different to the Consignment Note sequence.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:GenerateManifest>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
         <!--Optional:-->
         <cha:manifestID>?</cha:manifestID>
      </cha:GenerateManifest>
   </soapenv:Body>
</soapenv:Envelope>

...

:Envelope>

GetChargeQuote3

To retrieve a quote a list of parameters are passed for this function and a ServicePricing object is returned. This function uses the Locality and Postcode of the Sender and the Receiver coupled with a serviceList (returned from the function GetStandardServices) and the specific details such as items, weight and volume. The server side function matches the parameters against the AccountID’s rate card to determine the available services and the calculated cost.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

shipperID

Int

M

10

This value represents your assigned account id and can be found as a property in your Session object.

effectiveDate

String

M

10

Formatted as “YYYY-MM-DD”.

senderLocation

String

M

10

Description of the suburb name, should be validated by using FindLocation to ensure correct spelling.

senderPostcode

String

M

4

Postcode matching the senderLocation. Should be validated by using the FindLocation method to ensure validity.

senderCountryCode

String

M

5

CountryCode matching the senderLocation. Should be validated by using the FindLocation method to ensure validity.

senderIsResidential

Bool

O

1

Flags for whether the address is residential. Used to pre-empt residential pick up fees.

receiverAddress1

String

O

30


receiverAddress2

String

O

30


receiverLocation

String

M

10

Description of the suburb name, should be validated by using FindLocation to ensure correct spelling.

receiverPstcode

String

M

4

Postcode matching the receiverLocation. Should be validated by using the FindLocation method to ensure validity.

receiverCountryCode

String

M

5

CountryCode matching the receiverLocation. Should be validated by using the FindLocation method to ensure validity.

receiverIsResidential

Bool

O

1

Flags for whether the address is residential. Used to pre-empt residential delivery fees.

Items

Short

M

5

Represents the total number of shipping items.

Weight

Float

M


Sum of shipping items weight in kilograms.

Volume

Float

M


Sum of shipping items cubic metres. M3

Time

Float

O


Estimated Travel Time. Recommended not to be used as inaccuracies in time calculation greatly vary quote results.

Distance

Float

O


Estimated Distance between sender and receiver locations. Recommended not to be used as inaccuracies in route taken greatly vary quote results.

serviceList

String

O


Concatenated string of active services for the current Session. Found by called GetStandardServices function.

containsDGs

String

M


Flags whether shipping items contain dangerous goods. Required for compliance and dangerous goods handling fee calculations.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:GetChargeQuote3>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
         <!--Optional:-->
         <cha:shipperID>?</cha:shipperID>
         <!--Optional:-->
         <cha:effectiveDate>?</cha:effectiveDate>
         <!--Optional:-->
         <cha:senderLocation>?</cha:senderLocation>
         <!--Optional:-->
         <cha:senderPostcode>?</cha:senderPostcode>
         <!--Optional:-->
         <cha:senderCountryCode>?</cha:senderCountryCode>
         <!--Optional:-->
         <cha:senderIsResidential>?</cha:senderIsResidential>
         <!--Optional:-->
         <cha:receiverAddress1>?</cha:receiverAddress1>
         <!--Optional:-->
         <cha:receiverAddress2>?</cha:receiverAddress2>
         <!--Optional:-->
         <cha:receiverLocation>?</cha:receiverLocation>
         <!--Optional:-->
         <cha:receiverPostcode>?</cha:receiverPostcode>
         <!--Optional:-->
         <cha:receiverCountryCode>?</cha:receiverCountryCode>
         <!--Optional:-->
         <cha:receiverIsResidential>?</cha:receiverIsResidential>
         <!--Optional:-->
         <cha:items>?</cha:items>
         <!--Optional:-->
         <cha:weight>?</cha:weight>
         <!--Optional:-->
         <cha:volume>?</cha:volume>
         <!--Optional:-->
         <cha:time>?</cha:time>
         <!--Optional:-->
         <cha:distance>?</cha:distance>
         <!--Optional:-->
         <cha:serviceList>?</cha:serviceList>
         <!--Optional:-->
         <cha:containsDGs>?</cha:containsDGs>
      </cha:GetChargeQuote3>
   </soapenv:Body>
</soapenv:Envelope>

GetChargeQuote5

To retrieve a quote a list of parameters are passed for this function and a ServicePricing object is returned. This function uses the Locality and Postcode of the Sender and the Receiver coupled with a serviceList (returned from the function GetStandardServices) and the specific details such as items, weight and volume. The server side function matches the parameters against the AccountID’s rate card to determine the available services and the calculated cost.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

shipperID

Int

M

10

This value represents your assigned account id and can be found as a property in your Session object.

effectiveDate

String

M

10

Formatted as “YYYY-MM-DD”.

senderLocation

String

M

10

Description of the suburb name, should be validated by using FindLocation to ensure correct spelling.

senderPostcode

String

M

4

Postcode matching the senderLocation. Should be validated by using the FindLocation method to ensure validity.

senderCountryCode

String

M

5

CountryCode matching the senderLocation. Should be validated by using the FindLocation method to ensure validity.

senderIsResidential

Bool

O

1

Flags for whether the address is residential. Used to pre-empt residential pick up fees.

receiverAddress1

String

O

30


receiverAddress2

String

O

30


receiverLocation

String

M

10

Description of the suburb name, should be validated by using FindLocation to ensure correct spelling.

receiverPostcode

String

M

4

Postcode matching the receiverLocation. Should be validated by using the FindLocation method to ensure validity.

receiverCountryCode

String

M

5

CountryCode matching the receiverLocation. Should be validated by using the FindLocation method to ensure validity.

receiverIsResidential

Bool

O

1

Flags for whether the address is residential. Used to pre-empt residential delivery fees.

Items

Short

M

5

Represents the total number of shipping items.

Weight

Float

M


Sum of shipping items weight in kilograms.

Volume

Float

M


Sum of shipping items cubic metres. M3

Time

Float

O


Estimated Travel Time. Recommended not to be used as inaccuracies in time calculation greatly vary quote results.

Distance

Float

O


Estimated Distance between sender and receiver locations. Recommended not to be used as inaccuracies in route taken greatly vary quote results.

serviceList

String

O


Concatenated string of active services for the current Session. Found by called GetStandardServices function.

userID

Int

M


Current user ID. Can be found from the id property of the Session object.

itemsList

ConsignmentItem

M


This is an array of ConsignmentItem objects that are being quoted. Allows for greater clarity of quoting. E.g Shipping Item Dimensions.

containsDGs

String

M


Flags whether shipping items contain dangerous goods. Required for compliance and dangerous goods handling fee calculations.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:GetStandardServices>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
      </cha:GetStandardServices>
   </soapenv:Body>
</soapenv:Envelope>

Login

A majority of the functions listed in this document require a Session object be passed as the first parameter. This is a security principle that has been maintained across all functions that return customer sensitive data. Once a successful call has been made to the function then the Session object will contain a validated Session Key. This Key remains valid for 24 Hours and the DateTime of validity is stipulated in the Expires property.

Element

Type

Optional / Mandatory

Length

Comments

userName

String

M

30


password

String

M

30


...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:Login>
         <!--Optional:-->
         <cha:userName>?</cha:userName>
         <!--Optional:-->
         <cha:password>?</cha:password>
      </cha:Login>
   </soapenv:Body>
</soapenv:Envelope>

Logout

This functions exists to ensure that the implementation of Web Services can be controlled by the user.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:Logout>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>64796</cha:UserID>
         </cha:session>
      </cha:Logout>
     </soapenv:Body>
</soapenv:Envelope>

...

</soapenv:Body>
</soapenv:Envelope>

ReleaseAllConsignments

This function is required to allow for the release of all consignments. This function is a prerequisite task that must be called prior to generating the daily manifest. It takes a Session object, a Boolean value for placing bookings automatically for all consignments and a booelan value for generating the manifest.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

releaseDate

String

M


Formatted as “YYYY-MM-DD”.

generateBookingRequests

Bool

O


Creates a booking for all Consignments. Not recommended for use.

generateManifests

Bool

O


Creates ManifestID for all consignments. Not recommended. Use specific Release Consignment functions.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:ReleaseSingleConsignment>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
         <!--Optional:-->
         <cha:consignmentID>?</cha:consignmentID>
         <!--Optional:-->
         <cha:releaseDate>?</cha:releaseDate>
         <!--Optional:-->
         <cha:generateBookingRequest>?</cha:generateBookingRequest>
         <!--Optional:-->
         <cha:generateManifests>?</cha:generateManifests>
      </cha:ReleaseSingleConsignment>
   </soapenv:Body>
</soapenv:Envelope>

SaveAddress

A property required for creating a Consignment object is the Sender and Receiver AddressID. The platform has been designed in such a way that each address record is given a unique identifier and this identifier is stored against the consignment record. To maximise the efficiency of the platform, when a new consignment is to be created a request can be made to save a new address and if a record exists in the database that matches the unique combination of the address line, state, suburb and postcode then the existing identifier is returned. If there is no match a new record is created with the data parameters and the newly created identifier is returned.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

address

Address

M


Fully constructed Address object.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:SaveBookAndManifestConsignment>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
         <!--Optional:-->
         <cha:consignment>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:CloseAt>?</cha:CloseAt>
            <!--Optional:-->
            <cha:ConsignmentDate>?</cha:ConsignmentDate>
            <!--Optional:-->
            <cha:ConsignmentID>?</cha:ConsignmentID>
            <!--Optional:-->
            <cha:ConsignmentItems>
               <!--Zero or more repetitions:-->
               <cha:ConsignmentItem>
                  <!--Optional:-->
                  <cha:Barcode>?</cha:Barcode>
                  <!--Optional:-->
                  <cha:ConsignmentID>?</cha:ConsignmentID>
                  <!--Optional:-->
                  <cha:ConsignmentProduct>
                     <!--Optional:-->
                     <cha:AccountID>?</cha:AccountID>
                     <!--Optional:-->
                     <cha:Code>?</cha:Code>
                     <!--Optional:-->
                     <cha:DangerousGoods>
                        <!--Optional:-->
                        <cha:AggrigateQuantity>?</cha:AggrigateQuantity>
                        <!--Optional:-->
                        <cha:ConsignmentID>?</cha:ConsignmentID>
                        <!--Optional:-->
                        <cha:DangerousGoodsID>?</cha:DangerousGoodsID>
                        <!--Optional:-->
                        <cha:DgClass>?</cha:DgClass>
                        <!--Optional:-->
                        <cha:Exception>
                           <!--Optional:-->
                           <cha:Message>?</cha:Message>
                           <!--Optional:-->
                           <cha:ModuleName>?</cha:ModuleName>
                           <!--Optional:-->
                           <cha:ProcedureName>?</cha:ProcedureName>
                        </cha:Exception>
                        <!--Optional:-->
                        <cha:Group>?</cha:Group>
                        <!--Optional:-->
                        <cha:ID>?</cha:ID>
                        <!--Optional:-->
                        <cha:ItemNo>?</cha:ItemNo>
                        <!--Optional:-->
                        <cha:LiquidVolume>?</cha:LiquidVolume>
                        <!--Optional:-->
                        <cha:Liquidweight>?</cha:Liquidweight>
                        <!--Optional:-->
                        <cha:Name>?</cha:Name>
                        <!--Optional:-->
                        <cha:PSN>?</cha:PSN>
                        <!--Optional:-->
                        <cha:Quantity>?</cha:Quantity>
                        <!--Optional:-->
                        <cha:Recepticle>?</cha:Recepticle>
                        <!--Optional:-->
                        <cha:SubRisk>?</cha:SubRisk>
                        <!--Optional:-->
                        <cha:UnCode>?</cha:UnCode>
                        <!--Optional:-->
                        <cha:Units>?</cha:Units>
                        <!--Optional:-->
                        <cha:Volume>?</cha:Volume>
                        <!--Optional:-->
                        <cha:Weight>?</cha:Weight>
                     </cha:DangerousGoods>
                     <!--Optional:-->
                     <cha:DangerousGoodsID>?</cha:DangerousGoodsID>
                     <!--Optional:-->
                     <cha:Error>
                        <!--Optional:-->
                        <cha:Message>?</cha:Message>
                        <!--Optional:-->
                        <cha:ModuleName>?</cha:ModuleName>
                        <!--Optional:-->
                        <cha:ProcedureName>?</cha:ProcedureName>
                     </cha:Error>
                     <!--Optional:-->
                     <cha:Height>?</cha:Height>
                     <!--Optional:-->
                     <cha:IsActive>?</cha:IsActive>
                     <!--Optional:-->
                     <cha:Length>?</cha:Length>
                     <!--Optional:-->
                     <cha:Name>?</cha:Name>
                     <!--Optional:-->
                     <cha:ProductID>?</cha:ProductID>
                     <!--Optional:-->
                     <cha:Volume>?</cha:Volume>
                     <!--Optional:-->
                     <cha:Weight>?</cha:Weight>
                     <!--Optional:-->
                     <cha:Width>?</cha:Width>
                  </cha:ConsignmentProduct>
                  <!--Optional:-->
                  <cha:Description>?</cha:Description>
                  <!--Optional:-->
                  <cha:ExchangeReturnable>?</cha:ExchangeReturnable>
                  <!--Optional:-->
                  <cha:Height>?</cha:Height>
                  <!--Optional:-->
                  <cha:ItemNo>?</cha:ItemNo>
                  <!--Optional:-->
                  <cha:ItemType>?</cha:ItemType>
                  <!--Optional:-->
                  <cha:Length>?</cha:Length>
                  <!--Optional:-->
                  <cha:ModifiedBy>?</cha:ModifiedBy>
                  <!--Optional:-->
                  <cha:NoItems>?</cha:NoItems>
                  <!--Optional:-->
                  <cha:ProductID>?</cha:ProductID>
                  <!--Optional:-->
                  <cha:Reference>?</cha:Reference>
                  <!--Optional:-->
                  <cha:Returnable>?</cha:Returnable>
                  <!--Optional:-->
                  <cha:Volume>?</cha:Volume>
                  <!--Optional:-->
                  <cha:Weight>?</cha:Weight>
                  <!--Optional:-->
                  <cha:Width>?</cha:Width>
               </cha:ConsignmentItem>
            </cha:ConsignmentItems>
            <!--Optional:-->
            <cha:ConsignmentNote>?</cha:ConsignmentNote>
            <!--Optional:-->
            <cha:ConsignmentType>?</cha:ConsignmentType>
            <!--Optional:-->
            <cha:ConsolidatedSus>
               <!--Zero or more repetitions:-->
               <cha:ConsolidateConsignment>
                  <!--Optional:-->
                  <cha:Height>?</cha:Height>
                  <!--Optional:-->
                  <cha:ItemType>?</cha:ItemType>
                  <!--Optional:-->
                  <cha:Items>?</cha:Items>
                  <!--Optional:-->
                  <cha:Length>?</cha:Length>
                  <!--Optional:-->
                  <cha:Volume>?</cha:Volume>
                  <!--Optional:-->
                  <cha:Weight>?</cha:Weight>
                  <!--Optional:-->
                  <cha:Width>?</cha:Width>
               </cha:ConsolidateConsignment>
            </cha:ConsolidatedSus>
            <!--Optional:-->
            <cha:ContainingConsignment>?</cha:ContainingConsignment>
            <!--Optional:-->
            <cha:DeliveryInstructions>?</cha:DeliveryInstructions>
            <!--Optional:-->
            <cha:Description>?</cha:Description>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:DownloadID>?</cha:DownloadID>
            <!--Optional:-->
            <cha:Exception>
               <!--Optional:-->
               <cha:Message>?</cha:Message>
               <!--Optional:-->
               <cha:ModuleName>?</cha:ModuleName>
               <!--Optional:-->
               <cha:ProcedureName>?</cha:ProcedureName>
            </cha:Exception>
            <!--Optional:-->
            <cha:Ext>
               <!--Optional:-->
               <cha:ConsignmentID>?</cha:ConsignmentID>
               <!--Optional:-->
               <cha:CostCenter>?</cha:CostCenter>
               <!--Optional:-->
               <cha:ThirdPartyAccount>?</cha:ThirdPartyAccount>
               <!--Optional:-->
               <cha:UserField1>?</cha:UserField1>
               <!--Optional:-->
               <cha:UserField2>?</cha:UserField2>
               <!--Optional:-->
               <cha:UserField3>?</cha:UserField3>
               <!--Optional:-->
               <cha:UserField4>?</cha:UserField4>
               <!--Optional:-->
               <cha:UserField5>?</cha:UserField5>
            </cha:Ext>
            <!--Optional:-->
            <cha:ExtraInfo>?</cha:ExtraInfo>
            <!--Optional:-->
            <cha:Hours>?</cha:Hours>
            <!--Optional:-->
            <cha:ModifiedBy>?</cha:ModifiedBy>
            <!--Optional:-->
            <cha:NoItems>?</cha:NoItems>
            <!--Optional:-->
            <cha:OnForwarder>?</cha:OnForwarder>
            <!--Optional:-->
            <cha:PickupInstructions>?</cha:PickupInstructions>
            <!--Optional:-->
            <cha:ReadyAt>?</cha:ReadyAt>
            <!--Optional:-->
            <cha:Receiver>
               <!--Optional:-->
               <cha:AccountID>?</cha:AccountID>
               <!--Optional:-->
               <cha:AddressID>?</cha:AddressID>
               <!--Optional:-->
               <cha:AddressLocation>
                  <!--Optional:-->
                  <cha:LocationID>?</cha:LocationID>
                  <!--Optional:-->
                  <cha:Locality>?</cha:Locality>
                  <!--Optional:-->
                  <cha:State>?</cha:State>
                  <!--Optional:-->
                  <cha:Postcode>?</cha:Postcode>
                  <!--Optional:-->
                  <cha:CountryCode>?</cha:CountryCode>
                  <!--Optional:-->
                  <cha:SuburbStatePostcode>?</cha:SuburbStatePostcode>
               </cha:AddressLocation>
               <!--Optional:-->
               <cha:ContactName>?</cha:ContactName>
               <!--Optional:-->
               <cha:Email>?</cha:Email>
               <!--Optional:-->
               <cha:Exception>
                  <!--Optional:-->
                  <cha:Message>?</cha:Message>
                  <!--Optional:-->
                  <cha:ModuleName>?</cha:ModuleName>
                  <!--Optional:-->
                  <cha:ProcedureName>?</cha:ProcedureName>
               </cha:Exception>
               <!--Optional:-->
               <cha:Fax>?</cha:Fax>
               <!--Optional:-->
               <cha:Line1>?</cha:Line1>
               <!--Optional:-->
               <cha:Line2>?</cha:Line2>
               <!--Optional:-->
               <cha:Line3>?</cha:Line3>
               <!--Optional:-->
               <cha:LocationDetails>
                  <!--Optional:-->
                  <cha:LocationID>?</cha:LocationID>
                  <!--Optional:-->
                  <cha:Locality>?</cha:Locality>
                  <!--Optional:-->
                  <cha:State>?</cha:State>
                  <!--Optional:-->
                  <cha:Postcode>?</cha:Postcode>
                  <!--Optional:-->
                  <cha:CountryCode>?</cha:CountryCode>
                  <!--Optional:-->
                  <cha:SuburbStatePostcode>?</cha:SuburbStatePostcode>
               </cha:LocationDetails>
               <!--Optional:-->
               <cha:LocationID>?</cha:LocationID>
               <!--Optional:-->
               <cha:ModifiedBy>?</cha:ModifiedBy>
               <!--Optional:-->
               <cha:Name>?</cha:Name>
               <!--Optional:-->
               <cha:Phone>?</cha:Phone>
               <!--Optional:-->
               <cha:State>?</cha:State>
               <!--Optional:-->
               <cha:Suburb>?</cha:Suburb>
            </cha:Receiver>
            <!--Optional:-->
            <cha:Reference>?</cha:Reference>
            <!--Optional:-->
            <cha:References>
               <!--Zero or more repetitions:-->
               <cha:Reference>
                  <!--Optional:-->
                  <cha:ConsignmentReference>?</cha:ConsignmentReference>
                  <!--Optional:-->
                  <cha:RemoveReference>?</cha:RemoveReference>
               </cha:Reference>
            </cha:References>
            <!--Optional:-->
            <cha:Released>?</cha:Released>
            <!--Optional:-->
            <cha:Sender>
               <!--Optional:-->
               <cha:AccountID>?</cha:AccountID>
               <!--Optional:-->
               <cha:AddressID>?</cha:AddressID>
               <!--Optional:-->
               <cha:AddressLocation>
                  <!--Optional:-->
                  <cha:LocationID>?</cha:LocationID>
                  <!--Optional:-->
                  <cha:Locality>?</cha:Locality>
                  <!--Optional:-->
                  <cha:State>?</cha:State>
                  <!--Optional:-->
                  <cha:Postcode>?</cha:Postcode>
                  <!--Optional:-->
                  <cha:CountryCode>?</cha:CountryCode>
                  <!--Optional:-->
                  <cha:SuburbStatePostcode>?</cha:SuburbStatePostcode>
               </cha:AddressLocation>
               <!--Optional:-->
               <cha:ContactName>?</cha:ContactName>
               <!--Optional:-->
               <cha:Email>?</cha:Email>
               <!--Optional:-->
               <cha:Exception>
                  <!--Optional:-->
                  <cha:Message>?</cha:Message>
                  <!--Optional:-->
                  <cha:ModuleName>?</cha:ModuleName>
                  <!--Optional:-->
                  <cha:ProcedureName>?</cha:ProcedureName>
               </cha:Exception>
               <!--Optional:-->
               <cha:Fax>?</cha:Fax>
               <!--Optional:-->
               <cha:Line1>?</cha:Line1>
               <!--Optional:-->
               <cha:Line2>?</cha:Line2>
               <!--Optional:-->
               <cha:Line3>?</cha:Line3>
               <!--Optional:-->
               <cha:LocationDetails>
                  <!--Optional:-->
                  <cha:LocationID>?</cha:LocationID>
                  <!--Optional:-->
                  <cha:Locality>?</cha:Locality>
                  <!--Optional:-->
                  <cha:State>?</cha:State>
                  <!--Optional:-->
                  <cha:Postcode>?</cha:Postcode>
                  <!--Optional:-->
                  <cha:CountryCode>?</cha:CountryCode>
                  <!--Optional:-->
                  <cha:SuburbStatePostcode>?</cha:SuburbStatePostcode>
               </cha:LocationDetails>
               <!--Optional:-->
               <cha:LocationID>?</cha:LocationID>
               <!--Optional:-->
               <cha:ModifiedBy>?</cha:ModifiedBy>
               <!--Optional:-->
               <cha:Name>?</cha:Name>
               <!--Optional:-->
               <cha:Phone>?</cha:Phone>
               <!--Optional:-->
               <cha:State>?</cha:State>
               <!--Optional:-->
               <cha:Suburb>?</cha:Suburb>
            </cha:Sender>
            <!--Optional:-->
            <cha:Service>?</cha:Service>
            <!--Optional:-->
            <cha:SessionID>?</cha:SessionID>
            <!--Optional:-->
            <cha:SpecialInstructions>?</cha:SpecialInstructions>
            <!--Optional:-->
            <cha:Volume>?</cha:Volume>
            <!--Optional:-->
            <cha:Weight>?</cha:Weight>
         </cha:consignment>
      </cha:SaveBookAndManifestConsignment>
   </soapenv:Body>
</soapenv:Envelope>

SaveConsignment

Once a Consignment object has been created containing the required parameters, including a validated SenderID, ReceiverID and ConsignmentItem object, this function can be called. Taking Consignment Object and Session object as input this function will generate a consignment record and the unique ConsignmentID is returned.

Element

Type

Optional / Mandatory

Length

Comments

ValidSession

Session

M


Session object created using the Login method or by hard-coding the properties of a session object (See Request an API Key)

Consignment

Consignment

M


Fully constructed Consignment object.

...

Code Block
languagexml
themeRDark
firstline1
titleWeb Service Call Body
linenumberstrue
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
   <soapenv:Header/>
   <soapenv:Body>
      <cha:SavePickupRequest>
         <!--Optional:-->
         <cha:session>
            <!--Optional:-->
            <cha:AccountID>?</cha:AccountID>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:Expires>?</cha:Expires>
            <!--Optional:-->
            <cha:Key>?</cha:Key>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:session>
         <!--Optional:-->
         <cha:pickupRequest>
            <!--Optional:-->
            <cha:ActualItems>?</cha:ActualItems>
            <!--Optional:-->
            <cha:ActualPalletSpaces>?</cha:ActualPalletSpaces>
            <!--Optional:-->
            <cha:ActualVolume>?</cha:ActualVolume>
            <!--Optional:-->
            <cha:ActualWeight>?</cha:ActualWeight>
            <!--Optional:-->
            <cha:Cancelled>?</cha:Cancelled>
            <!--Optional:-->
            <cha:CancelledBy>?</cha:CancelledBy>
            <!--Optional:-->
            <cha:CarrierID>?</cha:CarrierID>
            <!--Optional:-->
            <cha:CloseAt>?</cha:CloseAt>
            <!--Optional:-->
            <cha:ConfirmationId>?</cha:ConfirmationId>
            <!--Optional:-->
            <cha:DetailItems>
               <!--Zero or more repetitions:-->
               <cha:PickupRequestDetail>
                  <!--Optional:-->
                  <cha:ConsignmentID>?</cha:ConsignmentID>
                  <!--Optional:-->
                  <cha:ConsignmentNote>?</cha:ConsignmentNote>
                  <!--Optional:-->
                  <cha:Items>?</cha:Items>
                  <!--Optional:-->
                  <cha:PickupRequestID>?</cha:PickupRequestID>
                  <!--Optional:-->
                  <cha:Volume>?</cha:Volume>
                  <!--Optional:-->
                  <cha:Weight>?</cha:Weight>
               </cha:PickupRequestDetail>
            </cha:DetailItems>
            <!--Optional:-->
            <cha:DetailedSUs>
               <!--Zero or more repetitions:-->
               <cha:Sus>
                  <!--Optional:-->
                  <cha:Barcode>?</cha:Barcode>
                  <!--Optional:-->
                  <cha:Height>?</cha:Height>
                  <!--Optional:-->
                  <cha:ItemNo>?</cha:ItemNo>
                  <!--Optional:-->
                  <cha:ItemType>?</cha:ItemType>
                  <!--Optional:-->
                  <cha:Length>?</cha:Length>
                  <!--Optional:-->
                  <cha:ReceiverAddress>
                     <!--Optional:-->
                     <cha:AccountID>?</cha:AccountID>
                     <!--Optional:-->
                     <cha:AddressID>?</cha:AddressID>
                     <!--Optional:-->
                     <cha:AddressLocation>
                        <!--Optional:-->
                        <cha:LocationID>?</cha:LocationID>
                        <!--Optional:-->
                        <cha:Locality>?</cha:Locality>
                        <!--Optional:-->
                        <cha:State>?</cha:State>
                        <!--Optional:-->
                        <cha:Postcode>?</cha:Postcode>
                        <!--Optional:-->
                        <cha:CountryCode>?</cha:CountryCode>
                        <!--Optional:-->
                        <cha:SuburbStatePostcode>?</cha:SuburbStatePostcode>
                     </cha:AddressLocation>
                     <!--Optional:-->
                     <cha:ContactName>?</cha:ContactName>
                     <!--Optional:-->
                     <cha:Email>?</cha:Email>
                     <!--Optional:-->
                     <cha:Exception>
                        <!--Optional:-->
                        <cha:Message>?</cha:Message>
                        <!--Optional:-->
                        <cha:ModuleName>?</cha:ModuleName>
                        <!--Optional:-->
                        <cha:ProcedureName>?</cha:ProcedureName>
                     </cha:Exception>
                     <!--Optional:-->
                     <cha:Fax>?</cha:Fax>
                     <!--Optional:-->
                     <cha:Line1>?</cha:Line1>
                     <!--Optional:-->
                     <cha:Line2>?</cha:Line2>
                     <!--Optional:-->
                     <cha:Line3>?</cha:Line3>
                     <!--Optional:-->
                     <cha:LocationDetails>
                        <!--Optional:-->
                        <cha:LocationID>?</cha:LocationID>
                        <!--Optional:-->
                        <cha:Locality>?</cha:Locality>
                        <!--Optional:-->
                        <cha:State>?</cha:State>
                        <!--Optional:-->
                        <cha:Postcode>?</cha:Postcode>
                        <!--Optional:-->
                        <cha:CountryCode>?</cha:CountryCode>
                        <!--Optional:-->
                        <cha:SuburbStatePostcode>?</cha:SuburbStatePostcode>
                     </cha:LocationDetails>
                     <!--Optional:-->
                     <cha:LocationID>?</cha:LocationID>
                     <!--Optional:-->
                     <cha:ModifiedBy>?</cha:ModifiedBy>
                     <!--Optional:-->
                     <cha:Name>?</cha:Name>
                     <!--Optional:-->
                     <cha:Phone>?</cha:Phone>
                     <!--Optional:-->
                     <cha:State>?</cha:State>
                     <!--Optional:-->
                     <cha:Suburb>?</cha:Suburb>
                  </cha:ReceiverAddress>
                  <!--Optional:-->
                  <cha:Reference>?</cha:Reference>
                  <!--Optional:-->
                  <cha:Volume>?</cha:Volume>
                  <!--Optional:-->
                  <cha:Weight>?</cha:Weight>
                  <!--Optional:-->
                  <cha:Width>?</cha:Width>
               </cha:Sus>
            </cha:DetailedSUs>
            <!--Optional:-->
            <cha:DistributorID>?</cha:DistributorID>
            <!--Optional:-->
            <cha:EdiFormat>?</cha:EdiFormat>
            <!--Optional:-->
            <cha:EstimatedItems>?</cha:EstimatedItems>
            <!--Optional:-->
            <cha:EstimatedPalletSpaces>?</cha:EstimatedPalletSpaces>
            <!--Optional:-->
            <cha:EstimatedVolume>?</cha:EstimatedVolume>
            <!--Optional:-->
            <cha:EstimatedWeight>?</cha:EstimatedWeight>
            <!--Optional:-->
            <cha:Exception>
               <!--Optional:-->
               <cha:Message>?</cha:Message>
               <!--Optional:-->
               <cha:ModuleName>?</cha:ModuleName>
               <!--Optional:-->
               <cha:ProcedureName>?</cha:ProcedureName>
            </cha:Exception>
            <!--Optional:-->
            <cha:FileName>?</cha:FileName>
            <!--Optional:-->
            <cha:Instructions>?</cha:Instructions>
            <!--Optional:-->
            <cha:PickupDate>?</cha:PickupDate>
            <!--Optional:-->
            <cha:PickupRequestID>?</cha:PickupRequestID>
            <!--Optional:-->
            <cha:ReadyAt>?</cha:ReadyAt>
            <!--Optional:-->
            <cha:Reference>?</cha:Reference>
            <!--Optional:-->
            <cha:Response>?</cha:Response>
            <!--Optional:-->
            <cha:SalesForceException>?</cha:SalesForceException>
            <!--Optional:-->
            <cha:SalesForceId>?</cha:SalesForceId>
            <!--Optional:-->
            <cha:Sender>
               <!--Optional:-->
               <cha:AccountID>?</cha:AccountID>
               <!--Optional:-->
               <cha:AddressID>?</cha:AddressID>
               <!--Optional:-->
               <cha:AddressLocation>
                  <!--Optional:-->
                  <cha:LocationID>?</cha:LocationID>
                  <!--Optional:-->
                  <cha:Locality>?</cha:Locality>
                  <!--Optional:-->
                  <cha:State>?</cha:State>
                  <!--Optional:-->
                  <cha:Postcode>?</cha:Postcode>
                  <!--Optional:-->
                  <cha:CountryCode>?</cha:CountryCode>
                  <!--Optional:-->
                  <cha:SuburbStatePostcode>?</cha:SuburbStatePostcode>
               </cha:AddressLocation>
               <!--Optional:-->
               <cha:ContactName>?</cha:ContactName>
               <!--Optional:-->
               <cha:Email>?</cha:Email>
               <!--Optional:-->
               <cha:Exception>
                  <!--Optional:-->
                  <cha:Message>?</cha:Message>
                  <!--Optional:-->
                  <cha:ModuleName>?</cha:ModuleName>
                  <!--Optional:-->
                  <cha:ProcedureName>?</cha:ProcedureName>
               </cha:Exception>
               <!--Optional:-->
               <cha:Fax>?</cha:Fax>
               <!--Optional:-->
               <cha:Line1>?</cha:Line1>
               <!--Optional:-->
               <cha:Line2>?</cha:Line2>
               <!--Optional:-->
               <cha:Line3>?</cha:Line3>
               <!--Optional:-->
               <cha:LocationDetails>
                  <!--Optional:-->
                  <cha:LocationID>?</cha:LocationID>
                  <!--Optional:-->
                  <cha:Locality>?</cha:Locality>
                  <!--Optional:-->
                  <cha:State>?</cha:State>
                  <!--Optional:-->
                  <cha:Postcode>?</cha:Postcode>
                  <!--Optional:-->
                  <cha:CountryCode>?</cha:CountryCode>
                  <!--Optional:-->
                  <cha:SuburbStatePostcode>?</cha:SuburbStatePostcode>
               </cha:LocationDetails>
               <!--Optional:-->
               <cha:LocationID>?</cha:LocationID>
               <!--Optional:-->
               <cha:ModifiedBy>?</cha:ModifiedBy>
               <!--Optional:-->
               <cha:Name>?</cha:Name>
               <!--Optional:-->
               <cha:Phone>?</cha:Phone>
               <!--Optional:-->
               <cha:State>?</cha:State>
               <!--Optional:-->
               <cha:Suburb>?</cha:Suburb>
            </cha:Sender>
            <!--Optional:-->
            <cha:SenderID>?</cha:SenderID>
            <!--Optional:-->
            <cha:ShipperID>?</cha:ShipperID>
            <!--Optional:-->
            <cha:SummaryItems>
               <!--Zero or more repetitions:-->
               <cha:PickupRequestSummary>
                  <!--Optional:-->
                  <cha:CarrierID>?</cha:CarrierID>
                  <!--Optional:-->
                  <cha:CarrierServiceCode>?</cha:CarrierServiceCode>
                  <!--Optional:-->
                  <cha:CartonCount>?</cha:CartonCount>
                  <!--Optional:-->
                  <cha:CartonWeight>?</cha:CartonWeight>
                  <!--Optional:-->
                  <cha:OtherCount>?</cha:OtherCount>
                  <!--Optional:-->
                  <cha:OtherWeight>?</cha:OtherWeight>
                  <!--Optional:-->
                  <cha:PalletCount>?</cha:PalletCount>
                  <!--Optional:-->
                  <cha:PalletWeight>?</cha:PalletWeight>
                  <!--Optional:-->
                  <cha:PickupRequestID>?</cha:PickupRequestID>
                  <!--Optional:-->
                  <cha:PickupRequestSummaryID>?</cha:PickupRequestSummaryID>
                  <!--Optional:-->
                  <cha:SalesForceException>?</cha:SalesForceException>
                  <!--Optional:-->
                  <cha:SalesForceId>?</cha:SalesForceId>
                  <!--Optional:-->
                  <cha:ServiceCode>?</cha:ServiceCode>
                  <!--Optional:-->
                  <cha:SuType>?</cha:SuType>
                  <!--Optional:-->
                  <cha:TotalItems>?</cha:TotalItems>
                  <!--Optional:-->
                  <cha:TotalWeight>?</cha:TotalWeight>
               </cha:PickupRequestSummary>
            </cha:SummaryItems>
            <!--Optional:-->
            <cha:TransferMethod>?</cha:TransferMethod>
            <!--Optional:-->
            <cha:TransferSettingsID>?</cha:TransferSettingsID>
            <!--Optional:-->
            <cha:Transferred>?</cha:Transferred>
            <!--Optional:-->
            <cha:TransmitErrorMessage>?</cha:TransmitErrorMessage>
            <!--Optional:-->
            <cha:UserID>?</cha:UserID>
         </cha:pickupRequest>
      </cha:SavePickupRequest>
   </soapenv:Body>
</soapenv:Envelope>

ValidateLocation

A property of the Address object is the LocationID. This LocationID can be found by passing the State, Locality and Postcode of a location. If the combination of these properties exists, the matched LocationID is returned.

Element

Type

Optional / Mandatory

Length

Comments

Location

Location

M


Fully constructed Location object.

...