Orders

To understand what exactly an order is, please read the business description of our order.

More Facilities-API information can be found here: REST API documentation - Orders

Create an order

Orders with the same tenantOrderId are only allowed if the previous orders are not in the status OPEN, LOCKED, or PROMISED. Cancel the previous orders first.

To create a new order at fulfillmenttools, call the following POST endpoint:

POST https://{YOUR_TENANT_NAME}.api.fulfillmenttools.com/api/orders

{
  "consumer": {
    "addresses": [
      {
        "salutation": "Meneer",
        "firstName": "David",
        "lastName": "van den Boomgaard",
        "street": "Rombout Hogerbeetsstraat",
        "houseNumber": "96",
        "postalCode": "1052 XM",
        "province": "Noord-Holland",
        "city": "Amsterdam",
        "country": "NL"
      }
    ],
    "email": "[email protected]"
  },
  "tenantOrderId": "R456728546",
  "orderDate": "2024-01-19T08:45:50.525Z",
  "orderLineItems": [
    {
      "article": {
        "tenantArticleId": "TSHIRT-W-2468",
        "title": "Basic T-Shirt White"
      },
      "quantity": 10
    },
    {
      "article": {
        "tenantArticleId": "JEANS-B-2605",
        "title": "Washed Slim Fit Jeans"
      },
      "quantity": 3
    },
    {
      "article": {
        "tenantArticleId": "SNEAK-W-4891",
        "title": "White Sneakers"
      },
      "quantity": 1
    }
  ],
  "deliveryPreferences": {
    "shipping": {
      "serviceLevel": "DELIVERY"
    }
  }
}

If the request was successful, it returns an HTTP 200 OK response with a body that contains some new values:

id: Every order has a unique generated ID for identification

version: Version as part of our optimistic locking mechanism

orderLineItems[].id: Each order line item has its ID

status: Every order has a status, newly posted orders always have the status OPEN

processId: A process is an entity containing every entity involved in the whole fulfilling process

created: Time at which the order was created in the platform

lastModified: Time the order was most recently modified