Implementing Gift Wrap and Gift Messages

Overview

Radial supports both gift wrap and gift messages. Gift messages can be printed on the pack slip or on a separate card.

Gift messaging is typically at the shipment level; however, you could specify the message at the item level to have a card on every wrapped item. Gift wrap is typically at the item level but depending on the nature of the product, you can specify it at the shipment level. For example, if you sell small, related items, you could put all of the items into one gift box in a single shipment.

Note: The decisions on whether to specify gift messaging and gift wrap at the shipment or item level are operations/WMS decisions. The decision to use line-level or shipment- level gifting is made in conjunction with Radial’s engineering and operations teams, and is reflected in your placement of the Gifting tags in the Create Order XML.

If are not using the standard Radial APIs, consult your Radial representative to see how you should specify gift wrap or messaging.

Create Order and Item Master Tags

The Create Order API includes a gifting tag that you can place at the item level or the ShipGroup level. It looks the same in either location but should reflect the decisions about item or shipment level that you made with Radial’s engineering and operations teams.

The following example specifies free gift wrap and a gift message.

Copy this code sample.

Gifting tag specifying gift message

<Gifting>
    <Gift>
        <ItemId>80-44554</ItemId>
        <Pricing>
            <Amount>0.00</Amount>
            <TaxData>
                <TaxClass>89999</TaxClass>
            </TaxData>
            <UnitPrice>0.00</UnitPrice>
        </Pricing>
        <Message>
            <To>Bentley</To>
            <From>Max</From>
            <Message>Happy Hanukkah!</Message>
        </Message>
    </Gift>
</Gifting>

The ItemId tag specifies the gift wrap SKU, prefixed with the client's catalog id (80 in the preceding example). The Pricing tag and its children specify the amount to be charged for the gift wrapping service, while the Message tag and its children specify the message.

Notes:

  • The gift wrap SKU must be entered through an Item Master. If your system does not have gift wrap SKUs, Radial can create the gift wrap SKU(s) as part of the launch and specify that you will use it in the ID field. In the ItemType is a child of BaseAttributes. It is normally set to MERCH, but you should set the ItemType of a gift wrap SKU to GIFTWRAP.

  • If you place the Gifting tag inside the OrderItemTag, place it between EstimatedDeliveryDate and ReservationId tags.

  • If you place the Gifting tag inside the ShipGroup tag, place it after the OrderItems tag.

  • Set the order-level attribute isGift to Y (/OrderCreateRequest/Order/CustomAttributes/).

    Copy this code sample. 
    <Attribute>
        <Key>IsGift</Key>
        <Value>Y</Value>
    </Attribute>