Synchronizing shipments

A further possibility for requesting shipments from a calling system is given with syncShipments.

This method is similar to the getShipments method, but with a difference that it returns the shipping orders that have changed since the last syncShipments call.

To use syncShipments, you need to provide either a syncID or fill in the ageInDays parameter.

The following is an example for the syncShipments request using the parameter ageInDays:

<request>
   <clientSystemId>SOAPUI</clientSystemId>
   <clientIdentCode>ADMIN</clientIdentCode>
   <userName>ADMIN</userName>
   <resultLanguageIsoCodes>DE</resultLanguageIsoCodes>
   <syncId></syncId>
   <ageInDays>2</ageInDays>
   <includeDocuments>false</includeDocuments>
</request>

Understanding the parameter syncID

There is a limit of 100 shipments per syncShipment call. As long as the number of shipments in the answer equals 100, there are still more shipments to synchronize. This limit is built in so that a single call does not request an indefinite number of shipments and thus paralyze the system.

If the number returned equals 100, then further syncShipment calls could follow directly with the last syncId transmitted until less than 100 shipments are synced back.

• The value for the next syncShipment call is transferred in the response to the syncShipment call in the field syncId.
• Initially you can start the syncShipment call with syncId = 0 or 1.
• With syncID = -1 you can query shipping orders that do not have a completed status.