Creating an inbound

Creating an inbound

The create inbound endpoint is specifically for Fulfillment By Bol.com.

With this endpoint you can create an inbound which in turn will let us know when you’ll be sending a shipment to us with; a list of products, how much stock per product, which transporter you’ll use and if you’ll place the BSKU labels yourself or if you want to let us do the labelling.

POST /services/rest/inbounds

Input

Name Type Values Description
Reference integer [0-9] This field is optional. You can fill in your own reference id if desired. The value of this field will be available after creation
TimeSlot String You can use this endpoint to find out which values are accepted, see [delivery-window] This indicates the estimated arrival of your inbound at our warehouse
FbbTransporter String You can use this endpoint to find out which values are accepted, see [fbb-transporter] This indicates which transporter is used for this inbound, which in turn informs us which transporter we can expect at our warehouse
LabellingService Boolean True / False True indicates that you want to use our labellingservice, which means we’ll place the BSKU labels on your products when they arrive. If you don’t want to use our labellingservice use False when you’re creating your inbound.
Products > Product > EAN Integer [0-9] The EAN for the product you’ll ship to us
Products > Product > AnnouncedQuantity Integer [0-9] The amount of stock for the product you’ll ship to us

Example request

POST /services/rest/inventory

<InboundRequest xmlns="https://plazaapi.bol.com/services/xsd/v1/plazaapi.xsd">
  <Reference>FBB20170408</Reference>
  <TimeSlot>
    <Start>2017-04-08T08:00:00+02:00</Start>
    <End>2017-04-08T09:00:00+02:00</End>
  </TimeSlot>
  <FbbTransporter>
    <Code>DHL</Code>
    <Name>DHL</Name>
   </FbbTransporter>
  <LabellingService>false</LabellingService>
  <Products>
    <Product>
      <EAN>5014437972231</EAN>
      <AnnouncedQuantity>15</AnnouncedQuantity>
    </Product>
  </Products>
</InboundRequest>

Example response

Status: 201 Created

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns1:ProcessStatus xmlns:ns1="https://plazaapi.bol.com/services/xsd/v2/plazaapi.xsd">
  <ns1:id>14404965</ns1:id>
  <ns1:sellerId>123456</ns1:sellerId>
  <ns1:eventType>CREATE_INBOUND</ns1:eventType>
  <ns1:description>Create an inbound with reference FBB20170408</ns1:description>
  <ns1:status>PENDING</ns1:status>
  <ns1:createTimestamp>2017-08-14T13:44:45.000+02:00</ns1:createTimestamp>
  <ns1:Links>
    <ns1:link ns1:method="GET" ns1:href="https://plazaapi.bol.com/services/rest/process-status/v2/14404965" ns1:rel="self"/>
  </ns1:Links>
</ns1:ProcessStatus>