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
chevron-right
200

Facilities are found.

application/json

StrippedFacilities

totalintegerOptional

Total number of found entities for this query

Example: 42
get
/api/facilities

Create facility

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
or
Responses
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
chevron-right
200

Facility was found & you were allowed to access it. The result is in the body.

application/json
or
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
chevron-right
200

Facility was replaced. The replaced facility is in the body.

application/json
or
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
chevron-right
200

Facility was found & you were allowed to delete it.

No content

delete
/api/facilities/{facilityId}

No content

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
chevron-right
200

Facility was found & patch-set has been applied. The patched facility is in the body.

application/json
or
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
chevron-right
200

Updated Facility in the body.

application/json

ManagedFacility

and
post
/api/facilities/{facilityId}/actions

List facility carrier connections

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. List all carrier connections configured for the given facility

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
facilityIdstringRequired
Responses
chevron-right
200

Listing returned successfully.

application/json
totalnumberRequired

Total number of carrier connections

get
/api/facilities/{facilityId}/carriers

Get facility carrier connection

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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
chevron-right
200

Carrier to facility connections was found & you were allowed to access it. The result is in the body.

application/json

FacilityCarrierConnection

carrierRefstringRequired

Reference to the carrier

createdstring · date-timeRequired

Creation timestamp

deliveryTypestring · enumOptional

Type of delivery service

Possible values:
facilityRefstringRequired

Reference to the facility

idstringRequired

Unique identifier for the facility carrier connection

keystringRequired

Configuration key for the carrier connection

lastModifiedstring · date-timeRequired

Last modification timestamp

namestringOptional

Human-readable name for the connection

statusstring · enumRequired

Status of the carrier connection

Possible values:
versionnumberRequired

Version number for optimistic locking

get
/api/facilities/{facilityId}/carriers/{carrierRef}

Create facility carrier connection

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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
post
/api/facilities/{facilityId}/carriers/{carrierRef}

Update facility carrier connection

put

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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

Responses
chevron-right
200

Modification was successful.

application/json

FacilityCarrierConnection

carrierRefstringRequired

Reference to the carrier

createdstring · date-timeRequired

Creation timestamp

deliveryTypestring · enumOptional

Type of delivery service

Possible values:
facilityRefstringRequired

Reference to the facility

idstringRequired

Unique identifier for the facility carrier connection

keystringRequired

Configuration key for the carrier connection

lastModifiedstring · date-timeRequired

Last modification timestamp

namestringOptional

Human-readable name for the connection

statusstring · enumRequired

Status of the carrier connection

Possible values:
versionnumberRequired

Version number for optimistic locking

put
/api/facilities/{facilityId}/carriers/{carrierRef}

Calculate best carriers

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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
chevron-right
200

Calculated carrier prioritization result.

application/json

CarrierPriorityResult

post
/api/facilities/{facilityId}/carriers/prioritization

List facility connections

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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
chevron-right
200

Facility connections was found & you were allowed to access it. The result is in the body.

application/json

InterFacilityConnections

totalintegerRequired

Total number of entities found for this query

Example: 42
get
/api/facilities/{facilityId}/connections

Create facility connection

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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
chevron-right
200

Creation was successful.

application/json

InterFacilityConnection

post
/api/facilities/{facilityId}/connections

Get facility connection

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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
chevron-right
200

Facility connections was found & you were allowed to access it. The result is in the body.

application/json

InterFacilityConnection

get
/api/facilities/{facilityId}/connections/{connectionId}

Update facility connection

put

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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
chevron-right
200

Modification was successful.

application/json

InterFacilityConnection

put
/api/facilities/{facilityId}/connections/{connectionId}

Delete facility connection

delete

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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
chevron-right
200

Deletion was successful

No content

delete
/api/facilities/{facilityId}/connections/{connectionId}

No content

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
chevron-right
200

The discounts were successfully retrieved. The result is in the body.

application/json
anyOptional

FacilityDiscountPaginatedResult

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

contextanyOptional

The context of the discount. This is used to determine the conditions under which the discount can be applied.

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
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
chevron-right
200

The discount was successfully retrieved. The result is in the body.

application/json

FacilityDiscount

and
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
chevron-right
200

The discount was successfully deleted. The result is in the body.

No content

delete
/api/facilities/{facilityRef}/discounts/{facilityDiscountRef}

No content

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

contextanyOptional

The context of the discount. This is used to determine the conditions under which the discount can be applied.

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
chevron-right
200

The discount was successfully updated. The result is in the body.

application/json

FacilityDiscount

and
patch
/api/facilities/{facilityRef}/discounts/{facilityDiscountRef}

List facilities (search)

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentationarrow-up-right. 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.

startAfterIdstringOptionalDeprecated

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

Responses
chevron-right
200

Your search result

application/json

FacilityPaginatedResult

totalnumberOptional

The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.

post
/api/facilities/search

Last updated