Thursday, October 4th, 2012
Earlier this morning, notice of upcoming changes being made to support a new shipping promotions feature for Promotions Center was emailed to Yahoo! Merchant Solutions and Yahoo! Store customers. The changes being made to support the new feature will take effect beginning October 16, 2012. (More information about the new shipping promotions feature will be announced at the time of its release.)
While most stores should not be affected by these changes, we’re providing this notice in case you have systems or hard-coded third-party integrations in place that could be impacted. If you missed the email notice, please review the changes listed below and contact your developer if you believe that your store may be affected when the new fields are added.
Order Export Updates
Two new column headings, "Promotion ID" and "Promotion Type," will be added to order export information for Microsoft Excel, Microsoft Access, and generic CSV export formats. The new column headings apply to all order exports for these formats, even when a promotion has not been applied to an order; however, values will only be present in the columns when a promotion is applied to an order. When multiple promotions are applied to an order, the values in these columns will be separated by commas.
Please note that no changes are being made to the M.O.M., QuickBooks, PC Charge, or UPS WorldShip® export formats.
XML Order Format and Yahoo! Order Format Updates
The XML order format for real-time order posts and real-time tax and shipping calculation will include a new "SHIPPING" value in the "Type" field when a shipping promotion is applied. The Yahoo! Order format will also include the "SHIPPING" value in the "Promo-Type" field. If you use a third-party shipping system for calculating shipping charges, you may still create shipping promotions in Promotions Center. The shipping promotion will be applied after the third-party system returns the shipping charge.
Order API Updates
The "Type" field in the "Promotions" element will include a new "SHIPPING" value when a shipping promotion is applied to an order. In addition, the Get Order API response will contain a new "GiftMessage" field for gift messages specified by a shopper (shown only when a shopper has selected the gift wrap option during checkout), as well as a new "PaymentType" field to indicate the payment type used by the customer to place their order.
If you have any questions about these changes, please contact us. We look forward to bringing you the new shipping promotions feature, and can’t wait to tell you more about it!