GIFT LIST SYSTEM AND GIFT ORDERING
SendSafe includes several gift giving functions. The system can split single orders into multiple recipient addresses. Multi-Address mode allows for this splitting of orders. Entry of multiple recipients can be done using special Gift List importing functions (see below) or entered one at a time by hand in the shipping address page of the checkout wizard.
The Gift List function allows your customers send out large quantities of gifts to a list of recipients. A single consolidated order is built and processed by the system.
Sections:
How Gift List works
Gift list processing job
Multi-Address mode
Gift card messages
Configuration
Gift card messages are entered either one at a time on the shipping address page OR imported from list. The gift message for each item is saved in the OrderListItem.Comment Db column. Other content may also be automatically saved in this DB column which can cause conflicts. If FFP system messages are added to this column, these messages will prevent a gift message from being saved to this column and under some circumstances these messages may be replaced by a gift message. It is advisble to never mix gift messages with FFP or other System messages.
All System comment messages are tagged with an HTML invisible code of: <!-SYSCOMMENT-> at the beginnning of the comment field and at the end of the system comment field.
There are two kinds of Order Form Addressing Modes: (a) Form Mode that allows multiple shipping addresses (b) Form Mode that allows only a single shipping address. Based on your business needs you can dynamically select one type of form or the other. If your site sells gifts or other kind of items where a single order may be sent to multiple locations then option (a) is for you. If you a typical business sending all items to one address then option (b) is for you.
The selection of a specific Order From Mode (entry mode) is done by configuring the MultiAddress Mode in the storefront Admin page (1=enabled / 0=disabled).
A good example of single address operation are the SendSafe Purchase pages. A good example of multiple address operation are Mazelle's Cheesecakes ordering pages.
Hint: Do not forget to select the appropriate Long or Short Output Mode to match your Entry Form Mode.
INFORMATION ABOUT ADDRESS ENTRY:
This shopping basket is where the customer modifies the basket AND enters the shipping addresses. The shipping address is automatically filled in for returning customers.
In all cases the customer only has to enter their address once (if they have the same shipping & billing addresses). What the customer types into this basket (the shipping address) is automatically filled into the billing address form if the use same address checkbox is checked.
A giftlist order is initiated by clicking on a [Buy Giftlist] button in product browsing pages.
Each giftlist order is saved as a specially flagged order which resolves into a single line item in a cart. The items in an order do not display seperately in the shopping cart. Gift list orders and normal order cannot mixed.
The seed orderlineitem is flagged with the keyword {GIFTLIST} in the OrderLineItem.ItemParameter column. The name of the spreadsheet file which is uploaded is temporarily stored in the ItemsParameterField i.e. {GIFTLIST}myspreadsheet.csv
Orderlineitem which are part of a gift list order are flagged in the OrderLineItem.orderFlags = GIFTLIST
Orderlineitem which are part of a gift list order have the name of the list saved in the OrderLineItem.ItemParameter column during the construction phase of an order.
An order which is a gift list container has in its Orders.status column the optional flag: GIFTORDER. All lineitems are flagged as multi-address in the OrderLineItem.OrderFlags columns
Notes:
This job is run on an order from the customer giftlist page. This job takes the list of recipients and creates orderline entires for each recipient.
| Parameter | value |
| param1 |
This is directory where the giftlist import file is located.
DEFAULT CREATED BY GIFTLIST PAGE: 12. This subdirectory is most commonly located off the /en/ directory in the uploads subdirectory i.e. /en/uploads/12.2563139 "12." is the fixed subdirectory prefix for all giftlist uploads. |
| param2 |
Is the replication directory paths WHICH are the two or more possible locations where the upload subdirectory and file may be found.
All these locations will be checked until the upload file is found. |
| param3 |
This is the UPLOAD BASE subdirectory immediately under which the param1 the upload directory can be found.
Defined by: Application("FTPIMGUploaderServerLogicalBaseDir") = "en/uploads" |
| Reserved Keyword | Action |
| Application("EnableGiftLists" ) = true | Enabled/disable giftlist mode. |
Server Replication Setup: