Requirement: Order should not be picked by the schedule order agent until the appointment date arrives, if appointment date is some future date
greater than the requested ship date.

Resolving The Problem

Available Date column in the YFS_TASK_Q table could be helpful for achieving the above requirement:

For which user would have to run manageTaskQueue API after modifying the appointment date to some future date.

Sample manageTaskQueue Input XML for reference:

<TaskQueue AvailableDate="2013-04-29(future appointment date)" DataKey="20130318122521220798" TaskQKey="20130318122615220817" TransactionId="SCHEDULE.0001" DataType="OrderHeaderKey"/>

Note: Here the dates used are just for explaining the scenario, user can set these dates to any date depending on their requirement.The dates passed must be under the limit till the date supported by product -- for date limit follow the product guides.

Following are the complete steps to achieve the requirement:

1. Create a draft order with the ReqShipDate as 21-04-2013 and Product Line with the Fulfillment Method as Delivery.

2. Add the Delivery Service Line and confirm the order.

3. Create Work Order with appointment date as 21-04-2013, then after some time modify the appointment date to 29-04-2013.

4. Call manageTaskQueue API with the following Input XML:

<TaskQueue AvailableDate="2013-04-29(future appointment date)"
DataKey="20130318122521220798" TaskQKey="20130318122615220817"
TransactionId="SCHEDULE.0001" DataType="OrderHeaderKey"/>

5. Run the schedule order agent, order would not be scheduled until the appointment date arrives.