Orders
To understand what exactly an order is, please read the business description of our order.
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": "david.boomgaard@mail.nl"
},
"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
Last updated