Synchronizing events
It is possible to import resolved carrier tracking events into your host system. For this purpose you can use the synchronizeResolvedEvents API call.
For the first request you should use the ageInDays
parameter which returns all carrier events later than the value of ageInDays
.
In the API response you will also get back a syncId
which can be used in all subsequent requests instead of the ageInDays
parameter. For more information regarding the syncId
have a look here.
The following is an example for a synchronizeResolvedEvents
request:
<request>
<clientSystemId>TEST_ID</clientSystemId>
<clientIdentCode>APITEST</clientIdentCode>
<userName>API_TEST</userName>
<resultLanguageIsoCodes>en</resultLanguageIsoCodes>
<resultLanguageIsoCodes>de</resultLanguageIsoCodes>
<syncId></syncId>
<ageInDays>5</ageInDays>
<blockSize>200</blockSize>
<isStandardEventTextIncluded>true</isStandardEventTextIncluded>
<isOriginalDescriptionIncluded>true</isOriginalDescriptionIncluded>
</request>
{
"clientSystemId": "TEST_ID",
"clientIdentCode": "APITEST",
"userName": "API_TEST",
"resultLanguageIsoCodes": [
"en",
"de"
],
"ageInDays": 5,
"blockSize": 200,
"isStandardEventTextIncluded": true,
"isOriginalDescriptionIncluded": true
}
- The
blockSize
default is 200. In the API response the fieldisComplete
indicates, if there are more than 200 events - in this case it is false, otherwise it’s true. So you should check that field and if it is false immediately send another request untilisComplete = true
. - For the value for the field
clientSystemId
please contact AEB.
An event can only be synchronized 30 days after the event occurred.
AEB Standard Events
You can find an explanation of the AEB standard events here.
FAQ
Question | Answer |
---|---|
How often does CES collect event data from the carriers? | Usually every 5 minutes (in exceptional cases up to 15). That depends on the carrier. AEB endeavors to collect data as often as possible, we align ourselves with the specifications of the respective carrier. |
How to handle events where trackingObjectType = SHIPMENT? | In this case no package level tracking is possible in principle. However, the corresponding event can be used for every package of the shipment |
Updated about 1 month ago