Overview
The Price Event feed transmits permanent price changes, temporary price changes, and promotional event pricing. Pricing is maintained at the item (SKU) level.
This feed is optional. For integrations with external webstores, an item's price is managed by the external webstore and is transmitted to Radial Order Management with order information when the item is sold to a shopper.
The Price Event feed is required if use any marketplace integrations through Radial Order Management, such as a third-party marketing affiliate. In this scenario, an item's initial MSRP and initial selling price are loaded with the Item Master feed, and price change events are loaded in the Price Event feed.
An item price error report is available and is generated upon SKU load failure (email to distribution list provided by the client).
Notes:
- Default Character Encoding: Unicode: UTF-8
- Recipient Acknowledgment Required: Yes
- Exchange Frequency: Client Specific
- Production Mailbox Location: Client Specific
- Test Mailbox Location: Client Specific
- Filename Format: <ClientId>_<CatalogID>_<StoreId>_Price_<YYYYMMDDHHMISS>.xml
- The filename combined with the mailbox determines the destination of the pricing updates.
Schemas
Type definitions and other details: CommonTypes.xsd
Price Event schema: PriceEventV11.xsd
Examples
The following example shows a permanent price change for one item.
In the following example, elements with special meaning for this item type are noted in before the element.
Copy
<?xml version="1.0" encoding="UTF-8"?>
<Prices>
<MessageHeader>
<Standard>GSI</Standard>
<HeaderVersion>NGP1.1.0</HeaderVersion>
<VersionReleaseNumber>NGP1.1.0</VersionReleaseNumber>
<SourceData>
<SourceId>TMSNA</SourceId>
<SourceType>CLIENT</SourceType>
</SourceData>
<DestinationData>
<DestinationId>GSI</DestinationId>
<DestinationType>PH</DestinationType>
</DestinationData>
<EventType>Pricing</EventType>
<MessageData>
<MessageId>000508965005783</MessageId>
<CorrelationId>000508965005783</CorrelationId>
</MessageData>
<CreateDateAndTime>2014-11-10T18:37:39-05:00</CreateDateAndTime>
</MessageHeader>
<PricePerItem gsi_store_id="TMSUS" gsi_client_id="TMSNA" catalog_id="21">
<ClientItemId>5143473</ClientItemId>
<Event>
<EventNumber/>
<EventDescription/>
<Price>21.99</Price>
<MSRP>21.99</MSRP>
<AlternatePrice1>65.00</AlternatePrice1>
/*For a permanent price change, include a StartDate value, but do not include
the EndDate element.*/
<StartDate>2014-11-11T00:00:00-05:00</StartDate>
</Event>
</PricePerItem>
</Prices>
The following example shows a temporary price change for one item.
In the following example, elements with special meaning for this item type are noted in before the element.
Copy
<?xml version="1.0" encoding="UTF-8"?>
<Prices>
<MessageHeader>
<Standard>GSI</Standard>
<HeaderVersion>NGP1.1.0</HeaderVersion>
<VersionReleaseNumber>NGP1.1.0</VersionReleaseNumber>
<SourceData>
<SourceId>TMSNA</SourceId>
<SourceType>CLIENT</SourceType>
</SourceData>
<DestinationData>
<DestinationId>GSI</DestinationId>
<DestinationType>PH</DestinationType>
</DestinationData>
<EventType>Pricing</EventType>
<MessageData>
<MessageId>000508965005783</MessageId>
<CorrelationId>000508965005783</CorrelationId>
</MessageData>
<CreateDateAndTime>2014-11-10T18:37:39-05:00</CreateDateAndTime>
</MessageHeader>
<PricePerItem gsi_store_id="TMSUS" gsi_client_id="TMSNA" catalog_id="21">
<ClientItemId>5066966</ClientItemId>
<Event>
<EventNumber>31812</EventNumber>
<EventDescription>Sales Pricing Event</EventDescription>
<Price>17.99</Price>
<MSRP>19.99</MSRP>
<AlternatePrice1>65.00</AlternatePrice1>
/*For a temporary price change, use StartDate and EndDate to define the time
period when the price is in effect.*/
<StartDate>2014-11-09T00:00:00-05:00</StartDate>
<EndDate>2014-11-10T23:59:59-05:00</EndDate>
</Event>
</PricePerItem>
</Prices>
Data Keys
| GSI |
Radial
|
| PH |
Radial middleware |
| Country – ISO 3166-1 |
2 Letter Country Standard |
| Currency – ISO 4217 |
Currency Standard |
| Time – ISO 8601 |
Date Time Standard |
Permanent Price Change