Distributor Track & Trace


Goal

Distributors can use this API to send a track & trace URL to Expert.

Request Details

Name Required Type Length Description
SourceGlnCode long 13 The Global Location Number (GLN) of the sender of the message
DestinationGlnCode long 13 The Global Location Number (GLN) of the Expert store that placed the order
OrderNumber string The Expert order number
DeliveryDate dateTime The expected delivery date & time of the order

The format is based on ISO 8601:
YYYY-MM-DDThh:mm:ss
For example: 2019-08-14T15:30:00
Url string The URL where the customer can see the track & trace information about the order

Supported Data Formats

See the Implementation Guide on the Get Started page for details about the different data formats we support.

XML SOAP JSON

Examples

Pick the data format that best fits your needs.
Include your authorization token in the "Authorization" HTTP header and POST the data to: 
https://api.expert.nl/DistributorTrackAndTrace/1/0

HTTP Response Codes
Code Description
200 The message was sent successfully
400 Your data does not conform to the specification. See the status description for the exact issue.
401 You are not authorized to send this message. See the status description for the exact issue.
500 An error occured while processing the message. See the status description for the exact issue.
XML Data Format
Request

Minimal content example, containing only the required elements 
<DistributorTrackAndTrace xmlns="https://api.expert.nl/distributortrackandtrace/1/0">
  <SourceGlnCode>2190000000006</SourceGlnCode>
  <DestinationGlnCode>2190000007101</DestinationGlnCode>
  <OrderNumber>E-123456789</OrderNumber>
  <DeliveryDate>2019-03-25T15:30:00</DeliveryDate>
  <Url>http://url.com</Url>
</DistributorTrackAndTrace>

Extensive example 
<DistributorTrackAndTrace xmlns="https://api.expert.nl/distributortrackandtrace/1/0">
  <SourceGlnCode>2190000000006</SourceGlnCode>
  <DestinationGlnCode>2190000007101</DestinationGlnCode>
  <OrderNumber>E-123456789</OrderNumber>
  <DeliveryDate>2019-03-25T15:30:00</DeliveryDate>
  <Url>http://url.com</Url>
</DistributorTrackAndTrace>
No response data. See HTTP Response Codes

Show XSD   Open in API Playground

SOAP Data Format
Request

Minimal content example, containing only the required elements 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
      <Authorization>Test:YourApiToken=</Authorization>
  </soap:Header>
  <soap:Body>
    <DistributorTrackAndTrace xmlns="https://api.expert.nl/distributortrackandtrace/1/0">
      <SourceGlnCode>2190000000006</SourceGlnCode>
      <DestinationGlnCode>2190000007101</DestinationGlnCode>
      <OrderNumber>E-123456789</OrderNumber>
      <DeliveryDate>2019-03-25T15:30:00</DeliveryDate>
      <Url>http://url.com</Url>
    </DistributorTrackAndTrace>
  </soap:Body>
</soap:Envelope>

Extensive example 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
      <Authorization>Test:YourApiToken=</Authorization>
  </soap:Header>
  <soap:Body>
    <DistributorTrackAndTrace xmlns="https://api.expert.nl/distributortrackandtrace/1/0">
      <SourceGlnCode>2190000000006</SourceGlnCode>
      <DestinationGlnCode>2190000007101</DestinationGlnCode>
      <OrderNumber>E-123456789</OrderNumber>
      <DeliveryDate>2019-03-25T15:30:00</DeliveryDate>
      <Url>http://url.com</Url>
    </DistributorTrackAndTrace>
  </soap:Body>
</soap:Envelope>
Note: you can send your authorization token in the SOAP Header as shown here or you can send it as an HTTP Header. Whatever is easier.

No response data. See HTTP Response Codes

Show WSDL   Open in API Playground

JSON Data Format
Request

Minimal content example, containing only the required elements 
{
  "SourceGlnCode": "2190000000006",
  "DestinationGlnCode": "2190000007101",
  "OrderNumber": "E-123456789",
  "DeliveryDate": "2019-03-25T15:30:00",
  "Url": "http://url.com"
}

Extensive example 
{
  "SourceGlnCode": "2190000000006",
  "DestinationGlnCode": "2190000007101",
  "OrderNumber": "E-123456789",
  "DeliveryDate": "2019-03-25T15:30:00",
  "Url": "http://url.com"
}
No response data. See HTTP Response Codes

Show Swagger   Open in API Playground   About Swagger