Routing Plans (DOMS)

Endpoints to get information out of the brain of our Distributed Order Management System (DOMS).

List reroute descriptions

get

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation.

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

all entities after given Id

sizeintegerOptional

number of entities to show

Default: 25
Responses
200

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

application/json

RerouteDescriptions

hasNextPagebooleanRequired

True if there are more results after the current page

totalintegerRequired

Total number of found entities for this query

get
/api/reroutedescriptions

Create reroute description

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation.

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

AbstractReasonForCreation

reasonstringRequired

Text explaining the reason for a supported action.

Example: Rerouted because of an issue in the Facility.
Responses
post
/api/reroutedescriptions

Trigger reroute

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation.

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

RerouteRoutingPlan

allReroutablebooleanOptional

if set to true every reroutable routing plan is rerouted. overrules every other identifier

orderRefsstring[] · max: 10Optional
routingPlanIdsstring[] · max: 10Optional
tenantOrderIdsstring[] · max: 10Optional
Responses
200

Rerouting was successfully triggered

No content

post
/api/routing/commands/reroute

No content

List routing plans

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

Reference to the order you want to get the corresponding routing plan.

Responses
200

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

application/json

RoutingPlans

totalintegerOptional

Total number of found entities for this query

Example: 42
get
/api/routingplans

Get routing plan

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

ID of the routing plan want to get

Responses
200

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

application/json

RoutingPlan

createdstring · date-timeRequired

The date this entity was created at the platform. This value is generated by the service.

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeRequired

The date this entity was modified last. This value is generated by the service.

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
anonymizedbooleanOptional

Indicates if gdpr related data was anonymized

Example: false
childRoutingPlanRefstringOptional
consolidatedStatusstring · enumRequired

This status consolidates many of the RoutingPlanStatus and offers a more detailes explanation of what happened to the routing plan.

Possible values:
facilityBlackListstring[]Optional

Contains a list of facilities to ignore when rerouting happens.

facilityRefstringOptional

The id of the facility reference. The given ID has to be present in the system.

Example: Esb20gpHBL94X5NdMp3C
fallbackRoutingAfterTimeInSecondsnumberOptional

In case this routing plan has an active fallback facility configuration, this is the time in seconds after which the fallback routing will be attempted.

finalizeRunnumberRequired

The iteration through the finalizer process

Example: 5
firstRoutingAttemptstring · date-timeOptional

The date of the first routing attempt.

Example: 2020-02-03T08:45:50.525Z
idstringRequired
orderDatestring · date-timeRequired

The date this order was created at the supplying system.

Example: 2020-02-03T08:45:50.525Z
orderRefstringRequired

The id of the order that lead to the creation of this pickjob. Can be empty / not present when the pickjob was created without having an order.

Example: LGMl2DuvPnfPoSHhYFOm
parentRoutingPlanRefstringOptional
pickJobRefstringOptional

The id of the pickjob that has been created from the routing plan.

Example: Esb20gpHBL94X5NdMp3C
predecessorRerouteRoutingPlanRefsstring[]Required

Refs of the predecessor routing plans, in the case of a reroute.

prioritynumberRequired

priority of return plan

processIdstringRequired

Id of the global process related to this entity. For example used for starting the GDPR process and others.

provisioningTimestring · date-timeOptional

The point in time by which the order is supposed to be provisioned.

Example: 2020-02-03T08:45:50.525Z
reRoutedFacilityRefstringOptional

The id of the facility the order was rerouted from.

Example: 1DEYZgmfAcXRVYv6KEka36
reRoutedPickJobRefstringOptional

The id of the original pickjob that was rerouted.

Example: Eghhj20878dhbd989NdMp3C
reRoutedRoutingPlanRefstringOptional

The id of the original routingplan that was rerouted.

Example: Eghhj20878dhbd989NdMp3C
reRouteReasonstring · enumOptional

RerouteReason

Possible values:
routingRunnumberRequired

The iteration through the routing process

runIdstringOptional

ID of the routing run this plan was created in

runTypestring · enumOptional

The rule type of a decision log entry

Possible values:
splitCountnumberOptional

The number of order splits that happened before this routingplan was created

Default: 0Example: 5
statusstring · enumRequired

A routing plan line initially has the status INITIAL. Final state is ROUTED

Possible values:
successorRerouteRoutingPlanRefsstring[]Required

Refs of the succeeding routing plans, in the case of a reroute.

targetTimeBaseDatestring · date-timeOptional

This date is used as base/start to calculate the target time date.

Example: 2020-02-03T08:45:50.525Z
tenantOrderIdstringOptional

The id of the order in the tenant system that lead to the creation of this routingplan.

workflowInformationone ofRequired
or
get
/api/routingplans/{routingplanId}

Update routing plan

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

ID of routing plan you want to patch

Body

RoutingPlanPatchActions

versioninteger · int64Required

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

Example: 42
Responses
200

Routing plan was found & patch-set has been applied. The patched entity is in the body.

application/json

RoutingPlan

createdstring · date-timeRequired

The date this entity was created at the platform. This value is generated by the service.

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeRequired

The date this entity was modified last. This value is generated by the service.

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
anonymizedbooleanOptional

Indicates if gdpr related data was anonymized

Example: false
childRoutingPlanRefstringOptional
consolidatedStatusstring · enumRequired

This status consolidates many of the RoutingPlanStatus and offers a more detailes explanation of what happened to the routing plan.

Possible values:
facilityBlackListstring[]Optional

Contains a list of facilities to ignore when rerouting happens.

facilityRefstringOptional

The id of the facility reference. The given ID has to be present in the system.

Example: Esb20gpHBL94X5NdMp3C
fallbackRoutingAfterTimeInSecondsnumberOptional

In case this routing plan has an active fallback facility configuration, this is the time in seconds after which the fallback routing will be attempted.

finalizeRunnumberRequired

The iteration through the finalizer process

Example: 5
firstRoutingAttemptstring · date-timeOptional

The date of the first routing attempt.

Example: 2020-02-03T08:45:50.525Z
idstringRequired
orderDatestring · date-timeRequired

The date this order was created at the supplying system.

Example: 2020-02-03T08:45:50.525Z
orderRefstringRequired

The id of the order that lead to the creation of this pickjob. Can be empty / not present when the pickjob was created without having an order.

Example: LGMl2DuvPnfPoSHhYFOm
parentRoutingPlanRefstringOptional
pickJobRefstringOptional

The id of the pickjob that has been created from the routing plan.

Example: Esb20gpHBL94X5NdMp3C
predecessorRerouteRoutingPlanRefsstring[]Required

Refs of the predecessor routing plans, in the case of a reroute.

prioritynumberRequired

priority of return plan

processIdstringRequired

Id of the global process related to this entity. For example used for starting the GDPR process and others.

provisioningTimestring · date-timeOptional

The point in time by which the order is supposed to be provisioned.

Example: 2020-02-03T08:45:50.525Z
reRoutedFacilityRefstringOptional

The id of the facility the order was rerouted from.

Example: 1DEYZgmfAcXRVYv6KEka36
reRoutedPickJobRefstringOptional

The id of the original pickjob that was rerouted.

Example: Eghhj20878dhbd989NdMp3C
reRoutedRoutingPlanRefstringOptional

The id of the original routingplan that was rerouted.

Example: Eghhj20878dhbd989NdMp3C
reRouteReasonstring · enumOptional

RerouteReason

Possible values:
routingRunnumberRequired

The iteration through the routing process

runIdstringOptional

ID of the routing run this plan was created in

runTypestring · enumOptional

The rule type of a decision log entry

Possible values:
splitCountnumberOptional

The number of order splits that happened before this routingplan was created

Default: 0Example: 5
statusstring · enumRequired

A routing plan line initially has the status INITIAL. Final state is ROUTED

Possible values:
successorRerouteRoutingPlanRefsstring[]Required

Refs of the succeeding routing plans, in the case of a reroute.

targetTimeBaseDatestring · date-timeOptional

This date is used as base/start to calculate the target time date.

Example: 2020-02-03T08:45:50.525Z
tenantOrderIdstringOptional

The id of the order in the tenant system that lead to the creation of this routingplan.

workflowInformationone ofRequired
or
patch
/api/routingplans/{routingplanId}

List routing plan decision log

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

ID of the routing plan you want to get it's decision log

routingRunintegerRequired

ID of the decision log you want to get

Responses
200

Decision log was found.

application/json

DecisionLog

createdstring · date-timeRequired

The date this entity was created at the platform. This value is generated by the service.

Example: 2020-02-03T08:45:51.525Z
lastModifiedstring · date-timeRequired

The date this entity was modified last. This value is generated by the service.

Example: 2020-02-03T09:45:51.525Z
versioninteger · int64Required

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

Example: 42
idstringRequired
latestPickingStartHintsobjectOptional

This part of the API is in Alpha status. For details please check the api-release-life-cycle documentation.

In case no LPS could be calculated for this facility, the possible causes will be listed in this array. This property is an alpha property and still under development

routingPlanRefstringRequired
routingRunnumberRequired
get
/api/routingplans/{routingplanId}/decisionlogs/{routingRun}

List routing plans (search)

post

This part of the API is in Alpha status. For details please check the api-release-life-cycle documentation. Search for RoutingPlan

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

RoutingPlanSearchPayload

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
200

Your search result

application/json

RoutingPlanPaginatedResult

totalnumberOptional

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

post
/api/routingplans/search

List routing plans graphs

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

Reference to the process you want to get the corresponding routing plans graph.

Responses
200

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

application/json

A graph representation of the routing plans. The nodes are the routing plans and the edges are the rerouting reasons.

get
/api/routingplansgraph

Last updated