Price Event Feed

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

API Structure

Price Event element table: PriceEvent.xsd.html

Examples

ClosedPermanent Price Change

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 /*comments*/ before the element.

Copy this code sample. 

<?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>

ClosedTemporary Price Change

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 /*comments*/ before the element.

Copy this code sample. 

<?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

Source/Destination Type Description
GSI Radial
PH Radial middleware

 

ISO Standard Definition
Country – ISO 3166-1 2 Letter Country Standard
Currency – ISO 4217 Currency Standard
Time – ISO 8601 Date Time Standard