For the complete documentation index, see llms.txt. This page is also available as Markdown.

Facilities (Core)

Facilities represent various locations that form part of the fulfillment network.

List facilities

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startAfterIdstringOptional

all entities after given Id

statusstring[]Optional

Reference to the status you want to get the corresponding facilities

sizeintegerOptional

number of facilities to show

Default: 25
tenantFacilityIdstringOptional

query facilities with the given tenantFacilityId

orderBystring · enumOptional

Attribute to order a facility list

Possible values:
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
get/api/facilities

Create facility

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
or
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
post/api/facilities

Get facility

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to get. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
get/api/facilities/{facilityId}

Update facility

put
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to replace. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Body
or
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
put/api/facilities/{facilityId}

Delete facility

delete
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to delete. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Query parameters
forceDeletionbooleanOptional

cascading deletion without pre condition check

Default: false
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
delete/api/facilities/{facilityId}

Update facility

patch
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to patch. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Body
or
or
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
patch/api/facilities/{facilityId}

Call facility action

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

Reference to the facility you want to call the action for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Body

FacilityActionsParameter

or
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
post/api/facilities/{facilityId}/actions

List facility carrier connections

get

List all carrier connections configured for the given facility

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
get/api/facilities/{facilityId}/carriers

Get facility carrier connection

get

Get the details for a carrier related to the facility with the given ID

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired
carrierRefstringRequired
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
get/api/facilities/{facilityId}/carriers/{carrierRef}

Create facility carrier connection

post

Create a connection of a configured carrier to the facility with given ID

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired
carrierRefstringRequired
Body

FacilityCarrierConnectionForCreation

namestringOptional

Human-readable name for the connection

statusstring · enumOptional

Status of the carrier connection

Possible values:
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
post/api/facilities/{facilityId}/carriers/{carrierRef}

Update facility carrier connection

put

Connect a configured carrier to the facility with given ID

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired
carrierRefstringRequired
Body

FacilityCarrierConnectionForModification

namestringOptional

Human-readable name for the connection

statusstring · enumOptional

Status of the carrier connection

Possible values:
versionnumberRequired

Version number for optimistic locking

Example: 1
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
put/api/facilities/{facilityId}/carriers/{carrierRef}

Calculate best carriers

post

Calculate prioritized list of recommended carriers for the given facility and input parameters

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired
Body

CarrierPriorityCalculationRequest

Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
post/api/facilities/{facilityId}/carriers/prioritization

List facility connections

get

Get the details for all connections related to the facility with the given ID.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to get connections

Query parameters
targetFacilityRefstringOptional

The targetFacilityRef of the connection

startAfterIdstringOptional

all entities

sizeintegerOptional

number of entities to show

Default: 25
localestringOptional

Provide the localized names and descriptions for the parcel label classifications. If not provided the default locale is used., for example de_DE.

Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
get/api/facilities/{facilityId}/connections

Create facility connection

post

Create a connections for a supplier facility with given ID.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to create a connection for

Body
or
or
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
post/api/facilities/{facilityId}/connections

Get facility connection

get

Get the details for a facility connection related to the facility with the given ID.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to get connections

connectionIdstringRequired

The ID that describes the connection of this facility to the its connections

Query parameters
localestringOptional

Provide the localized names and descriptions for the parcel label classifications. If not provided the default locale is used., for example de_DE.

Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
get/api/facilities/{facilityId}/connections/{connectionId}

Update facility connection

put

Update the given connection for a facility

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to get

connectionIdstringRequired

The referenced connection ID

Query parameters
localestringOptional

Provide the localized names and descriptions for the parcel label classifications. If not provided the default locale is used., for example de_DE.

Body
or
or
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
put/api/facilities/{facilityId}/connections/{connectionId}

Delete facility connection

delete

Delete the connection for facility with the given ID

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired

ID of facility you want to delete a connection

connectionIdstringRequired

The ID of the connection you want to delete

Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
delete/api/facilities/{facilityId}/connections/{connectionId}

List facility discounts

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityRefstringRequired

ID of the facility you want to get the discounts for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Query parameters
startAfterIdstringOptional

all entities after given Id

sizeintegerOptional

number of facilities to show

Default: 25
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
get/api/facilities/{facilityRef}/discounts

Create facility discount

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityRefstringRequired

ID of the facility you want to add the discount to. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Body

FacilityDiscountForCreation

discountone ofRequired
or
priorityintegerRequired

The priority of the discount. Discounts with the lowest priority value are applied first. Value must be greater than 0 and smaller than 1000.

Example: 1
typestring · enumRequired

Determines the price type this discount can be applied to.

Possible values:
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
post/api/facilities/{facilityRef}/discounts

Get facility discount

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityRefstringRequired

ID of the facility you want to get the discount for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

facilityDiscountRefstringRequired

ID of the discount you want to get

Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
get/api/facilities/{facilityRef}/discounts/{facilityDiscountRef}

Delete facility discount

delete
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityRefstringRequired

ID of the facility you want to delete the discount from. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

facilityDiscountRefstringRequired

ID of the discount you want to delete

Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
delete/api/facilities/{facilityRef}/discounts/{facilityDiscountRef}

Update facility discount

patch
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityRefstringRequired

ID of the facility you want to update the discount for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

facilityDiscountRefstringRequired

ID of the discount you want to update

Body

FacilityDiscountForUpdate

discountone ofOptional
or
priorityintegerOptional

The priority of the discount. Discounts with the lowest priority value are applied first. Must be greater than 0 and smaller than 1000.

Example: 1
typestring · enumOptional

Determines the price type this discount can be applied to.

Possible values:
versioninteger · int64Required

The version of the document to be used in optimistic locking mechanisms.

Example: 42
Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
patch/api/facilities/{facilityRef}/discounts/{facilityDiscountRef}

List facilities (search)

post

This part of the API is in Beta status. For details, see the API release lifecycle documentation. Search for Facility

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

FacilitySearchPayload

afterstringOptional

The cursor to start after for forward pagination. The value is provided in the pageInfo.endCursor field of the response. Cannot be used with before or last.

beforestringOptional

The cursor to start before for backward pagination. The value is provided in the pageInfo.startCursor field of the response. Cannot be used with after or size (first).

lastnumber · min: 1 · max: 250Optional

Number of items to return for backward pagination. Cannot be used with 'size' (first). Default: 20.

sizenumber · min: 1 · max: 250Optional

Number of items to return for forward pagination. Cannot be used with 'last'. Default: 20.

Example: 10
startAfterIdstringOptionalDeprecated

The ID to start after. Deprecated, use after with the value provided in pageInfo.endCursor instead.

Responses
401

Your user is not allowed to operate against this API instance

application/json

ApiError

descriptionstringOptionalExample: Missing attributes were name, address, items
requestVersioninteger · int64Optional

The version provided within an invalid request.

Example: 41
summarystringRequiredExample: One or more mandatory attributes were not provided.
versioninteger · int64OptionalExample: 42
post/api/facilities/search

Last updated