DELAYED PURCHASE

SendSafe has the ability to managed delay purchases. The purchase can be delayed a configurable amount of time and can be set to a configurable amount.

OPERATION

Delayed purchases are special type of subscription and use some of the subscription logic. There are two parts to a delayed purchase: (a) The trigger items and (b) The delayed purchase item. The trigger item setups up the delayed purchase. The delayed purchase is the second (or child) order that is process later.

A delayed purchase is setup as part of the purchase of a trigger item. If any item is configured to trigger a delayed purchase then in ADDITION to the purchase of this item (which can be zero cost), a delayed purchase will occur sometime later.

The delayed purchase can be for any amount from zero and up. The purchase amount can be the priceEa in the item OR it can be configured at the time that the trigger item is purchased by setting that value into OrderLineItem.ItemParameter.

A delayed purchase item can be any item in the DB including a subscription item (except FFPs). So a trigger item and initiate the delayed purchase of a subscription!

CONFIGURATION A TRIGGER ITEM

1. Create an item in the DB
2. Set the itemsext.SubscriptionType = 10001 (this is the special trigger job type)
3. Set the itemsext.SubscriptionForcedOrderSKU to the SKU of the item which will be delayed purchased.

Additionally, at the add-to-cart stage, a trigger item is setup with more information that controls the delayed purchase:

• OrderLineItemExt.NextOrderDate is set to the date when the delayed purchase job will run. This is required data. This can be done with the function: addItemToCartWithNextOrderDate().
• OrderLineItem.ItemParameter can be optionally set to an alternate price which will be charged for the delayed purchase. Set to "none" or empty/null to use the price of the item as found in the DB.

CONFIGURATION IN ROBOT

In the global storefront file storefront config file:

Activation

Delayed item activation occurs when the trigger order is processed by activateDelayedOrderSubscriptionsInOrder(). Acitivation does two things:

1. Creates an order to be completed later (the delayed purchase).
2. Queues a job (#45) in the jobqueue to be run at the time of the delayed purchase.

Rules:

• Delayed order will be for itemsext.SubscriptionForcedOrderSKU
• The order will have no shipping
• The order will have no sales tax
• The order will be for the same quantity as the tirgger job
• The order will be queued to run on the date found in the OrderLineItemExt.NextOrderDate
• If the OrderLineItemExt.NextOrderDate value is missing or less than the current date THEN the delayed job will run immediated.
• FFP Data in itemsext.SubscriptionForcedOrderSKU will be ignored.

TRIGGER ORDER JOB 20

This job will run once at the time designated by NextOrderDate. This job creates a trigger file which intiated the processing of an order which was created outside of this function.

Notes: