Purchase Order


Goal

Distributors can use this API to receive purchase orders placed by Expert.
Confirm the order by sending a Distributor Order Confirmation.

Response Details

Name Required Type Length Description
SourceGlnCode long 13 The Global Location Number (GLN) of the sender of the message, in this case the Expert store that places the order
DestinationGlnCode long 13 The Global Location Number (GLN) of the receiver of the message, in this case the distributor that will process the order
DeliveryGlnCode long 13 The Global Location Number (GLN) of the delivery location. Not required in case of an order with OrderType ConsumerDropshipment because those orders should be delivered to the address provided in the Consumer element. It is a required field for all the other OrderType values.
PurchaseOrderId string The unique order identifier for the purchase order
Date date The date the purchase order was placed

The format is based on ISO 8601:
YYYY-MM-DD
For example: 2019-08-14
OrderType string The type of order. Valid values are:
AutomaticAllocation
The order is placed by Expert for a promotion.
ConsumerDropshipment
The order is placed on our website and will be delivered directly to the Consumer specified below.
Electronic
The order is placed by an Expert dealer through their point of sale terminal.
Phone
The order is placed by an Expert dealer by telephone.
StoreDropshipment
The order is placed on our website and will be delivered to the Expert dealer specified by the DeliveryGlnCode.
Consumer The person actually purchasing the product(s), required in case of an order with OrderType ConsumerDropshipment. Empty for all other OrderType values.
Name The consumer name, required in case of an order with OrderType ConsumerDropshipment
Title string 100
FirstName string 100
SurNamePrefix string 100
Surname string 100
Address The shipping address, required in case of an order with OrderType ConsumerDropshipment
Street string 100
HouseNumber string 7
HouseNumberSuffix string 7
PostalCode string 10
City string 100
Country string 2 The ISO 3166 Alpha-2 country code
Contact The contact information for the carrier when delivery isn't possible
Phone string 16
Email string 50
Items array The products in the purchase order
Item The product being ordered
LineId int 4 The unique identifier of the product in the purchase order
DistributorId string 25 The unique identifier the distributor assigned to the product
EanCode long 13 The European Article Number (EAN) of the product, this is also the barcode of the product
Name string 50 The commercial product description
Quantity int 4 The amount of units in the order
NetInvoicePrice decimal The net invoice price of the product including charges, excluding VAT (NFP), for a single unit
Charges decimal The charges, like disposal, battery or copyright, excluding VAT, for a single unit
ExpectedDeliveryDate date The date the product is expected to be delivered

The format is based on ISO 8601:
YYYY-MM-DD
For example: 2019-08-14
PromotionId int 6 The unique identifier of the promotion the product was purchased for

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

See Receiving Data From Expert for more information.

XML Data Format
Response

Minimal content example, containing only the required elements 
<PurchaseOrder>
  <SourceGlnCode>8713404074035</SourceGlnCode>
  <DestinationGlnCode>8711849000008</DestinationGlnCode>
  <PurchaseOrderId>550271447</PurchaseOrderId>
  <Date>2019-10-14</Date>
  <OrderType>ConsumerDropshipment</OrderType>
  <Items>
    <Item>
      <EanCode>8710103821847</EanCode>
      <Quantity>10</Quantity>
      <NetInvoicePrice>99.99</NetInvoicePrice>
    </Item>
  </Items>
</PurchaseOrder>

Extensive example 
<PurchaseOrder>
  <SourceGlnCode>8713404074035</SourceGlnCode>
  <DestinationGlnCode>8711849000008</DestinationGlnCode>
  <DeliveryGlnCode>8713404074035</DeliveryGlnCode>
  <PurchaseOrderId>550271447</PurchaseOrderId>
  <Date>2019-10-14</Date>
  <OrderType>ConsumerDropshipment</OrderType>
  <Consumer>
    <Name>
      <Title>Dhr.</Title>
      <FirstName>Jan</FirstName>
      <SurNamePrefix>de</SurNamePrefix>
      <Surname>Groot</Surname>
    </Name>
    <Address>
      <Street>Hoofdstraat</Street>
      <HouseNumber>1</HouseNumber>
      <HouseNumberSuffix>A</HouseNumberSuffix>
      <PostalCode>1234 AB</PostalCode>
      <City>Amsterdam</City>
      <Country>NL</Country>
    </Address>
    <Contact>
      <Phone>061234567</Phone>
      <Email>mail@mail.com</Email>
    </Contact>
  </Consumer>
  <Items>
    <Item>
      <LineId>1</LineId>
      <DistributorId>5428681</DistributorId>
      <EanCode>8710103821847</EanCode>
      <Name>Article Product Description</Name>
      <Quantity>10</Quantity>
      <NetInvoicePrice>99.99</NetInvoicePrice>
      <Charges>1.00</Charges>
      <ExpectedDeliveryDate>2019-10-17</ExpectedDeliveryDate>
      <PromotionId>123456</PromotionId>
    </Item>
  </Items>
</PurchaseOrder>
Show XSD  

SOAP Data Format
Response

Minimal content example, containing only the required elements 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PurchaseOrder xmlns="https://api.expert.nl/purchaseorder/1/0">
      <SourceGlnCode>8713404074035</SourceGlnCode>
      <DestinationGlnCode>8711849000008</DestinationGlnCode>
      <PurchaseOrderId>550271447</PurchaseOrderId>
      <Date>2019-10-14</Date>
      <OrderType>ConsumerDropshipment</OrderType>
      <Items>
        <Item>
          <EanCode>8710103821847</EanCode>
          <Quantity>10</Quantity>
          <NetInvoicePrice>99.99</NetInvoicePrice>
        </Item>
      </Items>
    </PurchaseOrder>
  </soap:Body>
</soap:Envelope>

Extensive example 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PurchaseOrder xmlns="https://api.expert.nl/purchaseorder/1/0">
      <SourceGlnCode>8713404074035</SourceGlnCode>
      <DestinationGlnCode>8711849000008</DestinationGlnCode>
      <DeliveryGlnCode>8713404074035</DeliveryGlnCode>
      <PurchaseOrderId>550271447</PurchaseOrderId>
      <Date>2019-10-14</Date>
      <OrderType>ConsumerDropshipment</OrderType>
      <Consumer>
        <Name>
          <Title>Dhr.</Title>
          <FirstName>Jan</FirstName>
          <SurNamePrefix>de</SurNamePrefix>
          <Surname>Groot</Surname>
        </Name>
        <Address>
          <Street>Hoofdstraat</Street>
          <HouseNumber>1</HouseNumber>
          <HouseNumberSuffix>A</HouseNumberSuffix>
          <PostalCode>1234 AB</PostalCode>
          <City>Amsterdam</City>
          <Country>NL</Country>
        </Address>
        <Contact>
          <Phone>061234567</Phone>
          <Email>mail@mail.com</Email>
        </Contact>
      </Consumer>
      <Items>
        <Item>
          <LineId>1</LineId>
          <DistributorId>5428681</DistributorId>
          <EanCode>8710103821847</EanCode>
          <Name>Article Product Description</Name>
          <Quantity>10</Quantity>
          <NetInvoicePrice>99.99</NetInvoicePrice>
          <Charges>1.00</Charges>
          <ExpectedDeliveryDate>2019-10-17</ExpectedDeliveryDate>
          <PromotionId>123456</PromotionId>
        </Item>
      </Items>
    </PurchaseOrder>
  </soap:Body>
</soap:Envelope>


JSON Data Format
Response

Minimal content example, containing only the required elements 
{
  "SourceGlnCode": "8713404074035",
  "DestinationGlnCode": "8711849000008",
  "PurchaseOrderId": "550271447",
  "Date": "2019-10-14",
  "OrderType": "ConsumerDropshipment",
  "Items": [{ 
    "EanCode": "8710103821847",
    "Quantity": 10,
    "NetInvoicePrice": 99.99
  }]
}

Extensive example 
{
  "SourceGlnCode": "8713404074035",
  "DestinationGlnCode": "8711849000008",
  "DeliveryGlnCode": "8713404074035",
  "PurchaseOrderId": "550271447",
  "Date": "2019-10-14",
  "OrderType": "ConsumerDropshipment",
  "Consumer": { 
    "Name": { 
      "Title": "Dhr.",
      "FirstName": "Jan",
      "SurNamePrefix": "de",
      "Surname": "Groot"
    },
    "Address": { 
      "Street": "Hoofdstraat",
      "HouseNumber": "1",
      "HouseNumberSuffix": "A",
      "PostalCode": "1234 AB",
      "City": "Amsterdam",
      "Country": "NL"
    },
    "Contact": { 
      "Phone": "061234567",
      "Email": "mail@mail.com"
    }
  },
  "Items": [{ 
    "LineId": 1,
    "DistributorId": "5428681",
    "EanCode": "8710103821847",
    "Name": "Article Product Description",
    "Quantity": 10,
    "NetInvoicePrice": 99.99,
    "Charges": 1.00,
    "ExpectedDeliveryDate": "2019-10-17",
    "PromotionId": 123456
  }]
}