Wednesday, April 25th, 2012
The following post replaces a post made on April 24 about the April 2012 release, in order to provide greater clarity about these updates. We appreciate you taking the time to read information about these updates.
Early this morning (April 25, 2012), the updates noted below will be released for Yahoo! Merchant Solutions and Yahoo! Store accounts. Please be advised that the updates noted for Order and Checkout API responses, Order Manager, order export information, order email information, and order format information affect only a small group of store owners who are participating in a closed beta release for a new Promotions Center feature, and that these updates are being made to support this feature. These updates do not affect merchants who are not part of this closed beta and who have not received notice about Promotions Center.
For merchants who are participating in the Promotions Center beta, links to download sample order export changes for CSV, XML, and plain text export formats, a sample updated Yahoo! Order format script, and sample updated Order API XSD and Checkout API XSD files are below. If you are participating in this beta, please note that the changes will not take effect until Promotions Center is enabled for your store.
Updates for all stores
Item options using quotation marks (Catalog Manager and catalog.xml)
Catalog Manager and catalog.xml fixes are being made for an issue encountered when using a quotation mark (") in an item option. The catalog.xml will now display only one option for "OptionValue" when a quotation mark is used, and the quotation mark will no longer be stripped. Catalog Manager will now also correctly display item options using a quotation mark.
Updates to objinfo.xml
Previously, non-orderable items that did not have a value entered for either the "Caption" or "Message" attribute were not added to your store’s objinfo.xml file. Now, only non-orderable items that do not have a value for either "Caption" or "Message," and that do not have an object property of "item," "section," or other default item or section type as configured by you in your Store Editor, will be excluded from your store’s objinfo.xml file.
Order API and Checkout API XSD updates
If you are referencing the Order API XSD and/or the Checkout API XSD, these have been updated to include promotions elements for the Promotions Center closed beta. Please note that Order API responses and Checkout API responses are not affected for your store, unless you are participating in the Promotions Center beta.
Updates for merchants participating in the Promotions Center beta
Order Manager updates
New fields for store promotion discounts will be added to your full order and invoice format printed order information, and to order email information for readable, Adobe PDF, and XML format emails. In addition, a new "Promotion Discount" column heading will be added to your order export information for Microsoft Excel, Microsoft Access, and generic CSV export formats; a new "<Promotions>" element will be added to the XML export format; and a new "Promo Discount" line will be added to plain text export format. New information has not been added to the M.O.M., QuickBooks, PC Charge, or UPS WorldShip® export formats.
- Sample updated CSV order export format
- Sample updated XML order export format
- Sample updated plain text order export format
Yahoo! Order format and XML order format updates
If you are using the Yahoo! Order format for real-time order posts or real-time tax and shipping calculation, please be advised that the Yahoo! Order format will be updated with the new fields listed below. Download an updated sample Yahoo! Order format script.
New fields added to the Yahoo! Order format: Promo-Count, Promo-Id-N*, Promo-Type-N*, Promo-Discount-N*, and Promo-Message-N*
* "N" in all instances represents a numeric character, such as Promo-Id-1, Promo-Type-2, Promo-Discount-1, Promo-Message-2.
A description for each field is below:
Promo-Count—number of promotions applied (e.g. 3)
Promo-Id-N—promotion ID (e.g. 2)
Promo-Name-N—name of promotion (e.g. promo-40%)
Promo-Type-N—type of promotion (e.g. percentage)
Promo-Discount-N—discount applied with this promotion (e.g. 5.00)
Promo-Message-N—promotion message (e.g. 40% off)
If you are using the XML order format for real-time order posts or real-time tax and shipping calculation, please be advised that a new "<Promotions>" element will be added to this format. (Please see the sample XML order export format.)
Order API and Checkout API response updates:
Order API responses will now include a new "<Promotions>" element under "<OrderTotals>," while Checkout API responses will now include new "<PromotionsDiscount>," "<AppliedPromotions>," and "<QualifiablePromotions>" elements. Updated API documentation will be available in online help prior to the Promotions Center beta being enabled for your store, which is when these changes will take effect.
Thank you for your attention to these updates.