Supplier Product Information


Goal

Suppliers use this API to notify Expert about the master data of new products

Request Details

Name Required Type Length Description
SourceGlnCode long 13 The Global Location Number (GLN) of the sender of the message
Products array The list of products to update
Product The product to update
EanCode long 13 The European Article Number (EAN) of the product, this is also the barcode of the product
Brand string 50 The brand name of the product
MainGroup string 255 A hint about the product category that helps our product managers put the product in the correct category
Description string 100 The commercial product description
TypeNumber string 100 The type description of the product as shown on the box
ImageLocation string 500 The URL of a picture of the product. Must start with either http:// or https://
Color string 100 The color of the product, only required if the product is available in multiple colors.
OrderBatchSize int The batch size the product is delivered in. Delivered quantities will always be a multiple of this number.
EprelId long The European Product Registry for Energy Labelling ID

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/SupplierProducts/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 
<SupplierProducts xmlns="https://api.expert.nl/supplierproducts/2/0">
  <SourceGlnCode>2190000000006</SourceGlnCode>
  <Products>
    <Product>
      <EanCode>8700000000001</EanCode>
      <Brand>Your Brand</Brand>
      <Description>Article Product Description</Description>
      <TypeNumber>Typenumber on product package</TypeNumber>
    </Product>
  </Products>
</SupplierProducts>

Extensive example 
<SupplierProducts xmlns="https://api.expert.nl/supplierproducts/2/0">
  <SourceGlnCode>2190000000006</SourceGlnCode>
  <Products>
    <Product>
      <EanCode>8700000000001</EanCode>
      <Brand>Your Brand</Brand>
      <MainGroup>Your Maingroup</MainGroup>
      <Description>Article Product Description</Description>
      <TypeNumber>Typenumber on product package</TypeNumber>
      <ImageLocation>http://www.someurl.com/product-photo.jpg</ImageLocation>
      <Color>Color</Color>
      <OrderBatchSize>24</OrderBatchSize>
      <EprelId>1863097</EprelId>
    </Product>
  </Products>
</SupplierProducts>
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>
    <SupplierProducts xmlns="https://api.expert.nl/supplierproducts/2/0">
      <SourceGlnCode>2190000000006</SourceGlnCode>
      <Products>
        <Product>
          <EanCode>8700000000001</EanCode>
          <Brand>Your Brand</Brand>
          <Description>Article Product Description</Description>
          <TypeNumber>Typenumber on product package</TypeNumber>
        </Product>
      </Products>
    </SupplierProducts>
  </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>
    <SupplierProducts xmlns="https://api.expert.nl/supplierproducts/2/0">
      <SourceGlnCode>2190000000006</SourceGlnCode>
      <Products>
        <Product>
          <EanCode>8700000000001</EanCode>
          <Brand>Your Brand</Brand>
          <MainGroup>Your Maingroup</MainGroup>
          <Description>Article Product Description</Description>
          <TypeNumber>Typenumber on product package</TypeNumber>
          <ImageLocation>http://www.someurl.com/product-photo.jpg</ImageLocation>
          <Color>Color</Color>
          <OrderBatchSize>24</OrderBatchSize>
          <EprelId>1863097</EprelId>
        </Product>
      </Products>
    </SupplierProducts>
  </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",
  "Products": [{ 
    "EanCode": "8700000000001",
    "Brand": "Your Brand",
    "Description": "Article Product Description",
    "TypeNumber": "Typenumber on product package"
  }]
}

Extensive example 
{
  "SourceGlnCode": "2190000000006",
  "Products": [{ 
    "EanCode": "8700000000001",
    "Brand": "Your Brand",
    "MainGroup": "Your Maingroup",
    "Description": "Article Product Description",
    "TypeNumber": "Typenumber on product package",
    "ImageLocation": "http://www.someurl.com/product-photo.jpg",
    "Color": "Color",
    "OrderBatchSize": 24,
    "EprelId": "1863097"
  }]
}
No response data. See HTTP Response Codes

Show Swagger   Open in API Playground   About Swagger