Reference > Shop flow URLs > Order Management subsystem URLs > Order fulfillment URLs

AssignToSpecifiedFulfillmentCenter URL

This URL changes the assigned fulfillment center if the one specified is different from the one originally assigned, and it releases the order items. One or more releases can be created from the selected order items. (A release is a set of products in a given order that have the same ship-to address, fulfillment center, and shipping carrier.)

URL structure

http:// host/ path/

The fully qualified name of the WebSphere Commerce Server and the configuration path.

name-value pair with the & character. For a detailed description of the parameters and their values, see the list entitled Parameter values." />

Parameter values

storeId

Required: Specifies the store ID.

orderId

Required: Specifies the ID of an order with items to be released. This parameter can be repeated.

orderItemId_ i

Required: Specifies the order items to be released.

ffmcenterId_ i

Specifies IDs representing the fulfillment centers used to fulfill the order items.

fullfillmentOrderId

Specifies the ID of a pending order in the fulfillment center. This parameter is required if items are released to a fulfillment center with a fulfillment center and the user wishes to add the items to a shopping cart that the user owns.

fullfillmentOrderName

Specifies the name to be used as the order description if a new fulfillment order is to be created in the fulfillment center store for the user. This parameter is ignored if the fulfillment order ID parameter is also specified.

allocate

Required: A value of 1 specifies that the inventory will be allocated after the fulfillment center assignment is made.

release

Required: A value of 1 specifies that the order items are to be released as a result of running this command.

redirectURL

Specifies the redirection URL. The page corresponding to this URL loads when the command successfully completes execution.

outFailedOrderCountName

Specifies the output parameter name for the failedOrderCount output parameter. The default value is failedOrderCount.

outFailedOrderName

Specifies a name for the failedOrderId output parameter. The default value is failedOrderId.

This name will be appended with "_i" for grouping the i-th order with its associated failedOderItemIds and failureMessage output parameters.

outFailedOrderItemsName

Specifies a name for the failedOderItemIds output parameter. The default value is failedOrderItemIds.

This name will be appended with "_i" for associating the failed order item IDs with the failed order ID.

outFailedOrderMessageName

Specifies a name for the failureMessage output parameter. The default value is failureMessage.

This name will be appended with "_i" for associating the failure message with the failed order ID and failed order item IDs.

Output parameters

failedOrderCount

The number of orders with items that were specified to be released but failed. This output parameter is zero if there is no failure.

The IDs of the order and the order items are supplied in the failedOrderId_i and failedOrderItemIds_i output parameters. The reason for the failure is specified by the failureMessage_i output parameter.

failedOrderId_ i

The i-th order that failed (i = 1, 2, 3, and so on).

failedOderItemIds_ i

An array of order item IDs that failed to be released. This is null if all succeed or if the fulfillment center has a null EXTFFMSTORENUM attribute.

failureMessage_ i

The failure message associated with the failedOrderId_i.

Example

http://myhostname/webapp/wcs/stores/sevlet/AssignToSpecifiedFulfillmentCenter?
storeId=2066&orderId=1000&orderItemId_1=100011&orderItemId_2=100012
&orderItemId_3=100013&orderItemId_4=100014&ffmcenterId_1=1001&ffmcenterId_2=1001
&ffmcenterId_3=1001&ffmcenterId_4=206601&fulfillmentOrderId=8888&allocate=1&release=1

Behavior

• For each order specified, this command replaces the current fulfillment center ID in the order items with the specified fulfillment center ID and releases the order items. For order items destined for a fulfillment center with a non-null EXTFFMSTORENUM attribute, the command performs one of the following tasks:

  • Adds the items to a new shopping cart with the specified name if fulfillmentOrderName is non-null.

  • Adds the items to an existing shopping cart if fulfillmentOrderId is non-null.

  • Adds the items to a new shopping cart per customer order with the generated name "Shopping cart for customer order n" if fulfillmentOrderId and fulfillmentOrderName are both null.

Exception conditions

• Exceptions are thrown if required parameters are missing.

• Any other exceptions or problems encountered are communicated via the failure-output parameters.

Related concepts

Order Management subsystem

Related reference

Order Management subsystem URLs

+

Search Tips   |   Advanced Search