Distributor Product Price Information


Goal

Distributors can use this API to notify Expert about price changes.

Request Details

Name Required Type Length Description
SourceGlnCode long 13 The Global Location Number (GLN) of the sender of the message
ProductPrices array The list of product prices to update
ProductPrice The product price to update
EanCode long 13 The European Article Number (EAN) of the product, this is also the barcode of the product
DistributorId string 25 The unique identifier the distributor assigned to the product
StartDate date The start date of the price. This date cannot be in the past. No date means the price starts now.

The format is based on ISO 8601:
YYYY-MM-DD
For example: 2019-08-14
NetPurchasePrice decimal The net purchase price.
NetCopyrightCharge decimal The net copyright charge.
NetBatteryCharge decimal The net battery charge.
NetRecyclingCharge decimal The net recycling charge.
GrossRecommendedSalesPrice decimal The gross recommended sales price.

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/DistributorProductPrices/2/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 
<DistributorProductPrices xmlns="https://api.expert.nl/distributorproductprices/2/0">
  <SourceGlnCode>2190000000006</SourceGlnCode>
  <ProductPrices>
    <ProductPrice>
      <EanCode>8700000000001</EanCode>
      <NetPurchasePrice>12.29</NetPurchasePrice>
    </ProductPrice>
  </ProductPrices>
</DistributorProductPrices>

Extensive example 
<DistributorProductPrices xmlns="https://api.expert.nl/distributorproductprices/2/0">
  <SourceGlnCode>2190000000006</SourceGlnCode>
  <ProductPrices>
    <ProductPrice>
      <EanCode>8700000000001</EanCode>
      <DistributorId>106B983</DistributorId>
      <StartDate>2018-10-31</StartDate>
      <NetPurchasePrice>12.29</NetPurchasePrice>
      <NetCopyrightCharge>1.80</NetCopyrightCharge>
      <NetBatteryCharge>0.04</NetBatteryCharge>
      <NetRecyclingCharge>0.16</NetRecyclingCharge>
      <GrossRecommendedSalesPrice>29.95</GrossRecommendedSalesPrice>
    </ProductPrice>
  </ProductPrices>
</DistributorProductPrices>
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>
    <DistributorProductPrices xmlns="https://api.expert.nl/distributorproductprices/2/0">
      <SourceGlnCode>2190000000006</SourceGlnCode>
      <ProductPrices>
        <ProductPrice>
          <EanCode>8700000000001</EanCode>
          <NetPurchasePrice>12.29</NetPurchasePrice>
        </ProductPrice>
      </ProductPrices>
    </DistributorProductPrices>
  </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>
    <DistributorProductPrices xmlns="https://api.expert.nl/distributorproductprices/2/0">
      <SourceGlnCode>2190000000006</SourceGlnCode>
      <ProductPrices>
        <ProductPrice>
          <EanCode>8700000000001</EanCode>
          <DistributorId>106B983</DistributorId>
          <StartDate>2018-10-31</StartDate>
          <NetPurchasePrice>12.29</NetPurchasePrice>
          <NetCopyrightCharge>1.80</NetCopyrightCharge>
          <NetBatteryCharge>0.04</NetBatteryCharge>
          <NetRecyclingCharge>0.16</NetRecyclingCharge>
          <GrossRecommendedSalesPrice>29.95</GrossRecommendedSalesPrice>
        </ProductPrice>
      </ProductPrices>
    </DistributorProductPrices>
  </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",
  "ProductPrices": [{ 
    "EanCode": "8700000000001",
    "NetPurchasePrice": 12.29
  }]
}

Extensive example 
{
  "SourceGlnCode": "2190000000006",
  "ProductPrices": [{ 
    "EanCode": "8700000000001",
    "DistributorId": "106B983",
    "StartDate": "2018-10-31",
    "NetPurchasePrice": 12.29,
    "NetCopyrightCharge": 1.80,
    "NetBatteryCharge": 0.04,
    "NetRecyclingCharge": 0.16,
    "GrossRecommendedSalesPrice": 29.95
  }]
}
No response data. See HTTP Response Codes

Show Swagger   Open in API Playground   About Swagger