Radial Integration | 2016

Working with Radial APIs > Feeds: Batch File APIs > Price Event Feed

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 Retail 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 Retail 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:

Schema

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.

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

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

 

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

 

Copyright © 2017 Radial. All rights reserved.