Planning API (1.4.1)

Download OpenAPI specification:Download

URL: https://servicedesk.conundra.eu

The planning API provides information about plannings and their lifecycle.

You can find out more in our developer portal.

Changelog

Add Location header when creating a new location workload levelling set

Health

Validate connection and accessibility of the API.

Returns a single `pong` string

The ping-endpoint can be used for validating a connection with the application. It will authenticate the caller and returns a pong response when everything is set-up correctly.

SecurityclientCredentials

Responses

200

Everything set-up correctly

401

Authentication required

get/ping

Response samples

text/plain

pong

Plannings

Endpoints used for retrieving information about plannings and its releases.

Get a cursor paged list of plannings

Returns a cursor paged list of plannings. Results are sorted by created_at in descending order. You can find out more about how to use cursors in our developer portal.

SecurityclientCredentials

Request

query Parameters

released_since	string <date-time> When provided, only plannings which have been released since (exclusive) the given date will be returned. Example: released_since=2021-01-01T10:15:30Z
cursor	string Cursor of the page to retrieve.
limit	integer <int32> [ 1 .. 1000 ] Default: 100 The maximum amount of plannings that should be returned in the response Example: limit=100

Responses

200

400

Bad request

401

Authentication required

get/plannings

Response samples

application/json

{"plannings": [{"id": "86b54c9d-21d7-4b37-af3d-25f03886153b",
"created_at": "2024-11-30T08:15:00Z",
"released_at": "2024-11-30T10:00:00Z",
"name": "Operational Planning",
"labels": ["operational",
"DEMO",
"label-xyz"
]
}
],
"cursor": {"self": "c2VsZl9fcGFnZQ",
"prev": "cHJldmlvdXNfX3BhZ2U",
"next": "bmV4dF9fcGFnZQ"
}
}

Retrieve a released planning using a given planning id

Retrieves detailed information on the given released planning.

Note that information about releases are only stored for 2 weeks after the release was made. If you try to retrieve a release which is older than 2 weeks, you will get a 404 Not Found response.

SecurityclientCredentials

Request

path Parameters

required

string

The unique identifier of a planning

Responses

200

401

Authentication required

404

Not found

get/plannings/{id}/releases/latest

Response samples

application/json

{"release_metadata": {"planning_id": "86b54c9d-21d7-4b37-af3d-25f03886153b",
"released_at": "2024-11-30T10:00:00Z"
},
"routes": [{"id": "d2c6013e-9194-46ac-a44c-855abf1176ca",
"resource_combination": {"id": "5a4e8c43-80c0-4d5b-8f7e-32ec94f25d79",
"employee": {"business_id": "EMP-18",
"name": "Patrick Simmons",
"custom_data": {"shop_manager": "John Smith"
}
},
"transport_resources": [{"business_id": "TR-14",
"license_plate": "2-QBD-124",
"custom_data": {"shop_manager": "John Smith"
}
}
]
},
"start": {"location": {"business_id": "LOC_001",
"name": "Conundra (Oosterzele)",
"type": "CUSTOMER",
"geo_point": {"latitude": 50.9514048,
"longitude": 3.8067878
},
"address": {"address_line": "Voordries 41b",
"city": "Oosterzele",
"zip_code": "9860",
"country_code": "BE"
}
},
"timings": {"arrival_at": "2024-12-01T10:30:00Z",
"service_time": "PT45M",
"departure_at": "2024-12-01T11:15:00Z"
}
},
"end": {"location": {"business_id": "LOC_001",
"name": "Conundra (Oosterzele)",
"type": "CUSTOMER",
"geo_point": {"latitude": 50.9514048,
"longitude": 3.8067878
},
"address": {"address_line": "Voordries 41b",
"city": "Oosterzele",
"zip_code": "9860",
"country_code": "BE"
}
},
"timings": {"arrival_at": "2024-12-01T10:30:00Z",
"service_time": "PT45M",
"departure_at": "2024-12-01T11:15:00Z"
}
},
"breaks": [{"at": "2024-12-01T11:15:30Z",
"duration": "PT45M"
}
],
"trips": [{"stops": [{"location": {"business_id": "LOC_001",
"name": "Conundra (Oosterzele)",
"type": "CUSTOMER",
"geo_point": {"latitude": 50.9514048,
"longitude": 3.8067878
},
"address": {"address_line": "Voordries 41b",
"city": "Oosterzele",
"zip_code": "9860",
"country_code": "BE"
}
},
"deliveries": [{"order": {"business_id": "O_554",
"description": "Order 554",
"capacities": [{"type": "weight",
"value": 20.02
}
],
"custom_data": {"shop_manager": "John Smith"
}
},
"timings": {"arrival_at": "2024-12-01T10:30:00Z",
"earliest_arrival_at": "2024-12-01T10:00:00Z",
"latest_arrival_at": "2024-12-01T12:00:00Z",
"service_time": "PT15M",
"wait_time": "PT30M",
"departure_at": "2024-12-01T11:15:00Z"
}
}
],
"pickups": [{"order": {"business_id": "O_554",
"description": "Order 554",
"capacities": [{"type": "weight",
"value": 20.02
}
],
"custom_data": {"shop_manager": "John Smith"
}
},
"timings": {"arrival_at": "2024-12-01T10:30:00Z",
"earliest_arrival_at": "2024-12-01T10:00:00Z",
"latest_arrival_at": "2024-12-01T12:00:00Z",
"service_time": "PT15M",
"wait_time": "PT30M",
"departure_at": "2024-12-01T11:15:00Z"
}
}
],
"timings": {"arrival_at": "2024-12-01T10:30:00Z",
"service_time": "PT15M",
"wait_time": "PT30M",
"departure_at": "2024-12-01T11:15:00Z"
}
}
]
}
]
}
]
}

Location Workload Levelling

Endpoints used for managing location workload levelling sets.

List the existing location workload levelling sets

Retrieves detailed information on all location workload levelling sets, limited to at most 100 items.

SecurityclientCredentials

Request

query Parameters

cursor	string Cursor of the page to retrieve.
limit	integer <int32> [ 1 .. 100 ] Default: 100 The maximum amount of `location workload levelling set`s that should be returned in the response Example: limit=100

Responses

200

401

Authentication required

get/settings/location-workload-levelling-sets

Response samples

application/json

{"data": [{"business_id": "86b54c9d-21d7-4b37-af3d-25f03886153b",
"name": "Weekday",
"settings": [{"location_business_ids": ["LOC_001",
"LOC_002"
],
"loading_zones": [{"cost": 10
}
],
"minimum_buffer_duration": "PT30M"
}
],
"etag": "W/\"1\""
}
],
"cursor": {"self": "c2VsZl9fcGFnZQ",
"prev": "cHJldmlvdXNfX3BhZ2U",
"next": "bmV4dF9fcGFnZQ"
}
}

Get location workload levelling set

Retrieves detailed information on the given location workload levelling set.

SecurityclientCredentials

Request

path Parameters

business_id

required

string^[a-zA-Z0-9.~\-_]+$

The unique identifier of an entity

Responses

200

401

Authentication required

404

Not found

get/settings/location-workload-levelling-sets/{business_id}

Response samples

application/json

{"business_id": "86b54c9d-21d7-4b37-af3d-25f03886153b",
"name": "Weekday",
"settings": [{"location_business_ids": ["LOC_001",
"LOC_002"
],
"loading_zones": [{"cost": 10
}
],
"minimum_buffer_duration": "PT30M"
}
]
}

Upsert location workload levelling set

Create or update a location workload levelling set. A unique ID (business_id) is required to identify the location workload levelling set. Calling this endpoint with an existing business_id will update the location workload levelling set.

SecurityclientCredentials

Request

path Parameters

business_id

required

string^[a-zA-Z0-9.~\-_]+$

The unique identifier of an entity

header Parameters

If-Match

string

Weak Etag used for optimistic locking.

Example: W/"24"

Request Body schema: application/json
required

business_id	string [ 1 .. 250 ] characters ^[a-zA-Z0-9.~\-_]+$ The identifier for this location workload levelling set
name	string The name of the location workload levelling set
	Array of objects (LocationWorkloadLevellingSetting)

Responses

201

location workload levelling set created successful

204

location workload levelling set updated successful

400

Bad request

401

Authentication required

404

Not found

409

Conflict

412

This status is returned when an entity is updated with an outdated version in the If-Match header.

put/settings/location-workload-levelling-sets/{business_id}

Request samples

Payload

application/json

{"business_id": "86b54c9d-21d7-4b37-af3d-25f03886153b",
"name": "Weekday",
"settings": [{"location_business_ids": ["LOC_001",
"LOC_002"
],
"loading_zones": [{"cost": 10
}
],
"minimum_buffer_duration": "PT30M"
}
]
}

Response samples

application/problem+json

{"type": "https://developer.conundra.eu/developer-portal/problem/#constraint-violation",
"title": "Bad Request",
"status": 400,
"detail": "Bad request. See violations for more details.",
"violations": [{"field": "limit",
"message": "Limit must be strictly positive."
}
]
}

Delete location workload levelling set

Delete a location workload levelling set by it's business_id.

SecurityclientCredentials

Request

path Parameters

business_id

required

string^[a-zA-Z0-9.~\-_]+$

The unique identifier of an entity

header Parameters

If-Match

string

Weak Etag used for optimistic locking.

Example: W/"24"

Responses

204

Delete successful

400

Bad request

401

Authentication required

404

Not found

412

This status is returned when an entity is updated with an outdated version in the If-Match header.

delete/settings/location-workload-levelling-sets/{business_id}

Response samples

application/problem+json

{"type": "https://developer.conundra.eu/developer-portal/problem/#constraint-violation",
"title": "Bad Request",
"status": 400,
"detail": "Bad request. See violations for more details.",
"violations": [{"field": "limit",
"message": "Limit must be strictly positive."
}
]
}

Order-Order Restrictions

Endpoints used for managing order-order restriction sets.

List the existing order-order restriction sets

Retrieves detailed information on all order-order restriction sets, limited to at most 100 items.

SecurityclientCredentials

Request

query Parameters

cursor	string Cursor of the page to retrieve.
limit	integer <int32> [ 1 .. 100 ] Default: 100 The maximum amount of `order-order restriction set`s that should be returned in the response Example: limit=100

Responses

200

401

Authentication required

get/settings/order-order-restriction-sets

Response samples

application/json

{"data": [{"business_id": "a-business-id",
"name": "Ambient goods not with chilled goods",
"etag": "W/\"1\""
}
],
"cursor": {"self": "c2VsZl9fcGFnZQ",
"prev": "cHJldmlvdXNfX3BhZ2U",
"next": "bmV4dF9fcGFnZQ"
}
}

Get order-order restriction set

Retrieves detailed information on the given order-order restriction set.

SecurityclientCredentials

Request

path Parameters

business_id

required

string^[a-zA-Z0-9.~\-_]+$

The unique identifier of an entity

Responses

200

401

Authentication required

404

Not found

get/settings/order-order-restriction-sets/{business_id}

Response samples

application/json

{"business_id": "a-business-id",
"name": "Ambient goods not with chilled goods",
"restrictions": [{"order_label_1": "ambient",
"type": "NOT_TOGETHER_IN_VEHICLE_WITH",
"order_label_2": "chilled",
"vehicle_label": "cooler truck"
}
]
}

Upsert order-order restriction set

Create or update an order-order restriction set. A unique ID (business_id) is required to identify the order-order restriction set. Calling this endpoint with an existing business_id will update the order-order restriction set.

SecurityclientCredentials

Request

path Parameters

business_id

required

string^[a-zA-Z0-9.~\-_]+$

The unique identifier of an entity

header Parameters

If-Match

string

Weak Etag used for optimistic locking.

Example: W/"24"

Request Body schema: application/json
required

name required	string [ 1 .. 250 ] characters The name of the order-order restriction set
required	Array of objects (OrderOrderRestriction) non-empty List of order-order restrictions in this set

Responses

201

order-order restriction set created successful

204

order-order restriction set updated successful

400

Bad request

401

Authentication required

404

Not found

409

Conflict

412

This status is returned when an entity is updated with an outdated version in the If-Match header.

put/settings/order-order-restriction-sets/{business_id}

Request samples

Payload

application/json

{"name": "Ambient goods not with chilled goods",
"restrictions": [{"order_label_1": "ambient",
"type": "NOT_TOGETHER_IN_VEHICLE_WITH",
"order_label_2": "chilled",
"vehicle_label": "cooler truck"
}
]
}

Response samples

application/problem+json

{"type": "https://developer.conundra.eu/developer-portal/problem/#constraint-violation",
"title": "Bad Request",
"status": 400,
"detail": "Bad request. See violations for more details.",
"violations": [{"field": "limit",
"message": "Limit must be strictly positive."
}
]
}

Delete order-order restriction set

Delete an order-order restriction set by it's business_id.

SecurityclientCredentials

Request

path Parameters

business_id

required

string^[a-zA-Z0-9.~\-_]+$

The unique identifier of an entity

header Parameters

If-Match

string

Weak Etag used for optimistic locking.

Example: W/"24"

Responses

204

Delete successful

400

Bad request

401

Authentication required

404

Not found

412

This status is returned when an entity is updated with an outdated version in the If-Match header.

428

This status is returned when the If-Match header is missing.

delete/settings/order-order-restriction-sets/{business_id}

Response samples

application/problem+json

{"type": "https://developer.conundra.eu/developer-portal/problem/#constraint-violation",
"title": "Bad Request",
"status": 400,
"detail": "Bad request. See violations for more details.",
"violations": [{"field": "limit",
"message": "Limit must be strictly positive."
}
]
}

Planning API (1.4.1)

Changelog

Health

Returns a single `pong` string

Plannings

Get a cursor paged list of plannings

query Parameters

Retrieve a released planning using a given planning id

path Parameters

Location Workload Levelling

List the existing location workload levelling sets

query Parameters

Get location workload levelling set

path Parameters

Upsert location workload levelling set

path Parameters

header Parameters

Request Body schema: application/jsonrequired

Delete location workload levelling set

path Parameters

header Parameters

Order-Order Restrictions

List the existing order-order restriction sets

query Parameters

Get order-order restriction set

path Parameters

Upsert order-order restriction set

path Parameters

header Parameters

Request Body schema: application/jsonrequired

Delete order-order restriction set

path Parameters

header Parameters

Request Body schema: application/json
required

Request Body schema: application/json
required