openapi: 3.0.1
info:
title: Walmart Promotion Management
description: Sellers can set regular or promotional prices for their items. Setting the Promotional prices is an option to create unique pricing for events such as clearance sales or to call out a comparison price
servers:
- url: https://marketplace.walmartapis.com
description: Production URL
- url: https://sandbox.walmartapis.com
description: Sandbox URL
security:
- basicScheme: []
paths:
"/v3/price":
put:
tags:
- Promotions
summary: Walmart Update a Promotional Price
description: |-
Updates the promotional price.
Sellers can update or delete an existing promotional price as well as set up a new promotional price.
To set a new promotional price or update an existing one, set the XML pricing attribute processMode to UPSERT.
To delete a promotional price, set the XML pricing attribute processMode to DELETE.
To delete all promotions for a SKU, set replaceAll to an empty payload.
operationId: updatePromotionalPrices
parameters:
- name: promo
in: query
description: The promotional price. Set to 'true' in order to retrieve promotional prices
required: true
schema:
type: boolean
default: true
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- in: header
name: WM_CONSUMER.CHANNEL.TYPE
description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding
required: false
schema:
type: string
- in: header
name: WM_QOS.CORRELATION_ID
description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID
required: true
schema:
type: string
example: b3261d2d-028a-4ef7-8602-633c23200af6
- in: header
name: WM_SVC.NAME
description: Walmart Service Name
required: true
schema:
type: string
example: Walmart Service Name
requestBody:
description: The request body consists of a Feed file attached to the request.
content:
application/json:
schema:
required:
- pricing
- sku
type: object
properties:
offerId:
type: string
description: This is applicable only for promotions
sku:
type: string
replaceAll:
type: string
description: This is applicable only for promotions
enum:
- 'true'
- 'false'
pricing:
type: array
items:
required:
- currentPrice
- currentPriceType
type: object
properties:
effectiveDate:
type: string
description: This is applicable only for promotions
format: date-time
expirationDate:
type: string
description: This is applicable only for promotions
format: date-time
promoId:
type: string
description: This is applicable only for promotions
processMode:
type: string
description: This is applicable only for promotions
enum:
- UPSERT
- DELETE
currentPriceType:
type: string
description: This is applicable only for both promotions and price
enum:
- BASE
- REDUCED
- CLEARANCE
currentPrice:
type: object
properties:
currency:
type: string
enum:
- USD
- CAD
amount:
type: number
format: double
comparisonPriceType:
type: string
description: This is applicable only for promotions
enum:
- BASE
comparisonPrice:
type: object
properties:
currency:
type: string
enum:
- USD
- CAD
amount:
type: number
format: double
description: This is applicable only for promotions
priceDisplayCodes:
type: string
description: Represent promo placement. This is applicable only for promotions
enum:
- CART
- CHECKOUT
definitions:
type: object
examples:
Promotional Pricing Update JSON:
value:
sku: 97964_KFTest
pricing:
- currentPrice:
currency: USD
amount: 4
currentPriceType: REDUCED
comparisonPriceType: BASE
comparisonPrice:
currency: USD
amount: 4
priceDisplayCodes: CART
effectiveDate: '2019-11-03T09:49:57.943Z'
expirationDate: '2019-12-03T09:49:57.943Z'
processMode: UPSERT
required: true
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
errors:
type: array
xml:
name: error
items:
required:
- code
type: object
properties:
code:
type: string
field:
type: string
description:
type: string
info:
type: string
severity:
type: string
enum:
- INFO
- WARN
- ERROR
category:
type: string
enum:
- APPLICATION
- SYSTEM
- REQUEST
- DATA
causes:
type: array
xml:
wrapped: true
items:
type: object
properties:
code:
type: string
field:
type: string
type:
type: string
description:
type: string
xml:
name: Cause
errorIdentifiers:
type: object
additionalProperties:
type: object
component:
type: string
type:
type: string
serviceName:
type: string
gatewayErrorCategory:
type: string
enum:
- INTERNAL_DATA_ERROR
- EXTERNAL_DATA_ERROR
- SYSTEM_ERROR
xml:
name: GatewayError
statusCode:
type: integer
format: int32
mart:
type: string
description: 'Marketplace name. Example: Walmart-US'
xml:
namespace: http://walmart.com/
sku:
type: string
description: An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item.
xml:
namespace: http://walmart.com/
message:
type: string
description: A message of acknowledgement for a price update
xml:
namespace: http://walmart.com/
xml:
name: ItemPriceResponse
namespace: http://walmart.com/
example:
ItemPriceResponse:
mart: WALMART_US
message: Thank you. Your price has been updated. Please allow up to five minutes for this change to be reflected on the site.
sku: 97964_KFTest
application/xml:
schema:
type: object
properties:
errors:
type: array
xml:
name: error
items:
required:
- code
type: object
properties:
code:
type: string
field:
type: string
description:
type: string
info:
type: string
severity:
type: string
enum:
- INFO
- WARN
- ERROR
category:
type: string
enum:
- APPLICATION
- SYSTEM
- REQUEST
- DATA
causes:
type: array
xml:
wrapped: true
items:
type: object
properties:
code:
type: string
field:
type: string
type:
type: string
description:
type: string
xml:
name: Cause
errorIdentifiers:
type: object
additionalProperties:
type: object
component:
type: string
type:
type: string
serviceName:
type: string
gatewayErrorCategory:
type: string
enum:
- INTERNAL_DATA_ERROR
- EXTERNAL_DATA_ERROR
- SYSTEM_ERROR
xml:
name: GatewayError
statusCode:
type: integer
format: int32
mart:
type: string
description: 'Marketplace name. Example: Walmart-US'
xml:
namespace: http://walmart.com/
sku:
type: string
description: An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item.
xml:
namespace: http://walmart.com/
message:
type: string
description: A message of acknowledgement for a price update
xml:
namespace: http://walmart.com/
xml:
name: ItemPriceResponse
namespace: http://walmart.com/
example: |
WALMART_US
97964_KFTest
Thank you. Your price has been updated. Please allow up to five minutes for this change to be reflected on the site.
"/v3/feeds":
post:
tags:
- Promotions
summary: Walmart Updates Bulk Promotional Prices
description: Updates or creates promotional prices for multiple specified SKUs
operationId: updateBulkPromotionalPrice
parameters:
- name: feedType
in: query
description: Feed Type
required: true
schema:
type: string
default: promo
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- in: header
name: WM_CONSUMER.CHANNEL.TYPE
description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding
required: false
schema:
type: string
- in: header
name: WM_QOS.CORRELATION_ID
description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID
required: true
schema:
type: string
example: b3261d2d-028a-4ef7-8602-633c23200af6
- in: header
name: WM_SVC.NAME
description: Walmart Service Name
required: true
schema:
type: string
example: Walmart Service Name
requestBody:
description: 'The request body consists of a Feed file attached to the request. '
content:
multipart/form-data:
schema:
required:
- file
type: object
properties:
file:
type: string
description: Feed file to upload
format: binary
required: true
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
feedId:
type: string
description: A unique ID, returned from the Bulk Upload API, used for tracking the Feed File.
example:
feedId: 609B1E4C0B3E48989690263DEAC85C63@AVUBAQA
application/xml:
schema:
type: object
properties:
feedId:
type: string
description: A unique ID, returned from the Bulk Upload API, used for tracking the Feed File.
example: |-
55DE8A53B09F41BBBF261C1AB5FB2BC8@AVMBAgA
"/v3/promo/sku/{sku}":
get:
tags:
- Promotions
summary: Walmart Promotional Prices
description: " Retrieves a list of promotional prices for a single SKU."
operationId: getPromotionalPrices
parameters:
- name: sku
in: path
description: 'An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item. This will be used by the seller in the XSD file to refer to each item. Special characters in the sku needing encoding are: '':'', ''/'', ''?'', ''#'', ''['', '']'', ''@'', ''!'', ''$'', ''&'', "''", ''('', '')'', ''*'', ''+'', '','', '';'', ''='', as well as ''%'' itself. Other characters don''t need to be encoded.'
required: true
schema:
type: string
- in: header
name: WM_SEC.ACCESS_TOKEN
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
- in: header
name: WM_CONSUMER.CHANNEL.TYPE
description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding
required: false
schema:
type: string
- in: header
name: WM_QOS.CORRELATION_ID
description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID
required: true
schema:
type: string
example: b3261d2d-028a-4ef7-8602-633c23200af6
- in: header
name: WM_SVC.NAME
description: Walmart Service Name
required: true
schema:
type: string
example: Walmart Service Name
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: object
properties:
payload:
required:
- itemIdentifier
- pricingList
type: object
properties:
itemIdentifier:
type: object
properties:
sku:
type: string
offerId:
type: string
itemId:
type: string
wpid:
type: string
productType:
type: string
pricingList:
required:
- pricing
type: object
properties:
replaceAll:
type: boolean
xml:
attribute: true
pricing:
type: array
items:
required:
- currentPrice
- currentPriceType
type: object
properties:
currentPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
currentPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
comparisonPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
comparisonPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
savingsAmount:
type: number
savingsPercent:
type: number
priceDisplayCodes:
type: object
properties:
isClearance:
type: boolean
hidePriceForSOI:
type: object
submapType:
type: object
isRollback:
type: boolean
isReducedPrice:
type: boolean
isEligibleForAssociateDiscount:
type: object
isStrikethrough:
type: boolean
pickupDiscount:
type: object
properties:
isPickUpDiscountEligible:
type: boolean
xml:
attribute: true
pickupDiscountAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
effectiveDate:
type: integer
format: int64
xml:
attribute: true
expirationDate:
type: integer
format: int64
xml:
attribute: true
processMode:
type: string
xml:
attribute: true
enum:
- UPSERT
- DELETE
pid:
type: string
maxSalesRetailPrice:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minAdvtPrice:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
rebate:
required:
- rebateAmt
type: object
properties:
rebateAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
infoUrl:
type: string
xml:
attribute: true
rebateType:
type: string
xml:
attribute: true
enum:
- AMOUNT
- PRODUCT
startDate:
type: string
format: date-time
xml:
attribute: true
endDate:
type: string
format: date-time
xml:
attribute: true
additionalAttributes:
required:
- additionalAttribute
type: object
properties:
additionalAttribute:
type: array
items:
required:
- name
- value
type: object
properties:
name:
type: string
value:
type: string
xml:
name: Price
header:
type: object
properties:
headerAttributes:
type: object
status:
type: string
example:
status: OK
payload:
itemIdentifier:
sku: 97964_KFTest
pricingList:
pricing:
- currentPrice:
value:
currency: USD
amount: 4
currentPriceType: REDUCED
comparisonPrice:
value:
currency: USD
amount: 4
comparisonPriceType: BASE
savingsAmount: 0
savingsPercent: 0
priceDisplayCodes:
isRollback: false
isStrikethrough: true
isReducedPrice: true
isClearance: false
effectiveDate: 1572774597943
expirationDate: 1575366597943
promoId: ce9dfbce-4043-442c-8cb9-77d39d0f727f
replaceAll: false
application/xml:
schema:
type: object
properties:
payload:
required:
- itemIdentifier
- pricingList
type: object
properties:
itemIdentifier:
type: object
properties:
sku:
type: string
offerId:
type: string
itemId:
type: string
wpid:
type: string
productType:
type: string
pricingList:
required:
- pricing
type: object
properties:
replaceAll:
type: boolean
xml:
attribute: true
pricing:
type: array
items:
required:
- currentPrice
- currentPriceType
type: object
properties:
currentPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
currentPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
comparisonPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
comparisonPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
savingsAmount:
type: number
savingsPercent:
type: number
priceDisplayCodes:
type: object
properties:
isClearance:
type: boolean
hidePriceForSOI:
type: object
submapType:
type: object
isRollback:
type: boolean
isReducedPrice:
type: boolean
isEligibleForAssociateDiscount:
type: object
isStrikethrough:
type: boolean
pickupDiscount:
type: object
properties:
isPickUpDiscountEligible:
type: boolean
xml:
attribute: true
pickupDiscountAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
effectiveDate:
type: integer
format: int64
xml:
attribute: true
expirationDate:
type: integer
format: int64
xml:
attribute: true
processMode:
type: string
xml:
attribute: true
enum:
- UPSERT
- DELETE
pid:
type: string
maxSalesRetailPrice:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minAdvtPrice:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
rebate:
required:
- rebateAmt
type: object
properties:
rebateAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
infoUrl:
type: string
xml:
attribute: true
rebateType:
type: string
xml:
attribute: true
enum:
- AMOUNT
- PRODUCT
startDate:
type: string
format: date-time
xml:
attribute: true
endDate:
type: string
format: date-time
xml:
attribute: true
additionalAttributes:
required:
- additionalAttribute
type: object
properties:
additionalAttribute:
type: array
items:
required:
- name
- value
type: object
properties:
name:
type: string
value:
type: string
xml:
name: Price
header:
type: object
properties:
headerAttributes:
type: object
status:
type: string
example: |-
OK
97964_KFTest
REDUCED
BASE
0.00
0.00
components:
schemas:
Cause:
type: object
properties:
code:
type: string
field:
type: string
type:
type: string
description:
type: string
xml:
name: Cause
GatewayError:
required:
- code
type: object
properties:
code:
type: string
field:
type: string
description:
type: string
info:
type: string
severity:
type: string
enum:
- INFO
- WARN
- ERROR
category:
type: string
enum:
- APPLICATION
- SYSTEM
- REQUEST
- DATA
causes:
type: array
xml:
wrapped: true
items:
type: object
properties:
code:
type: string
field:
type: string
type:
type: string
description:
type: string
xml:
name: Cause
errorIdentifiers:
type: object
additionalProperties:
type: object
component:
type: string
type:
type: string
serviceName:
type: string
gatewayErrorCategory:
type: string
enum:
- INTERNAL_DATA_ERROR
- EXTERNAL_DATA_ERROR
- SYSTEM_ERROR
xml:
name: GatewayError
ItemPriceResponse:
type: object
properties:
errors:
type: array
xml:
name: error
items:
required:
- code
type: object
properties:
code:
type: string
field:
type: string
description:
type: string
info:
type: string
severity:
type: string
enum:
- INFO
- WARN
- ERROR
category:
type: string
enum:
- APPLICATION
- SYSTEM
- REQUEST
- DATA
causes:
type: array
xml:
wrapped: true
items:
type: object
properties:
code:
type: string
field:
type: string
type:
type: string
description:
type: string
xml:
name: Cause
errorIdentifiers:
type: object
additionalProperties:
type: object
component:
type: string
type:
type: string
serviceName:
type: string
gatewayErrorCategory:
type: string
enum:
- INTERNAL_DATA_ERROR
- EXTERNAL_DATA_ERROR
- SYSTEM_ERROR
xml:
name: GatewayError
statusCode:
type: integer
format: int32
mart:
type: string
description: 'Marketplace name. Example: Walmart-US'
xml:
namespace: http://walmart.com/
sku:
type: string
description: An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item.
xml:
namespace: http://walmart.com/
message:
type: string
description: A message of acknowledgement for a price update
xml:
namespace: http://walmart.com/
xml:
name: ItemPriceResponse
namespace: http://walmart.com/
ComparisonPrice:
type: object
properties:
currency:
type: string
enum:
- USD
- CAD
amount:
type: number
format: double
description: This is applicable only for promotions
CurrentPrice:
type: object
properties:
currency:
type: string
enum:
- USD
- CAD
amount:
type: number
format: double
Price:
required:
- pricing
- sku
type: object
properties:
offerId:
type: string
description: This is applicable only for promotions
sku:
type: string
replaceAll:
type: string
description: This is applicable only for promotions
enum:
- 'true'
- 'false'
pricing:
type: array
items:
required:
- currentPrice
- currentPriceType
type: object
properties:
effectiveDate:
type: string
description: This is applicable only for promotions
format: date-time
expirationDate:
type: string
description: This is applicable only for promotions
format: date-time
promoId:
type: string
description: This is applicable only for promotions
processMode:
type: string
description: This is applicable only for promotions
enum:
- UPSERT
- DELETE
currentPriceType:
type: string
description: This is applicable only for both promotions and price
enum:
- BASE
- REDUCED
- CLEARANCE
currentPrice:
type: object
properties:
currency:
type: string
enum:
- USD
- CAD
amount:
type: number
format: double
comparisonPriceType:
type: string
description: This is applicable only for promotions
enum:
- BASE
comparisonPrice:
type: object
properties:
currency:
type: string
enum:
- USD
- CAD
amount:
type: number
format: double
description: This is applicable only for promotions
priceDisplayCodes:
type: string
description: Represent promo placement. This is applicable only for promotions
enum:
- CART
- CHECKOUT
definitions:
type: object
Pricing:
required:
- currentPrice
- currentPriceType
type: object
properties:
effectiveDate:
type: string
description: This is applicable only for promotions
format: date-time
expirationDate:
type: string
description: This is applicable only for promotions
format: date-time
promoId:
type: string
description: This is applicable only for promotions
processMode:
type: string
description: This is applicable only for promotions
enum:
- UPSERT
- DELETE
currentPriceType:
type: string
description: This is applicable only for both promotions and price
enum:
- BASE
- REDUCED
- CLEARANCE
currentPrice:
type: object
properties:
currency:
type: string
enum:
- USD
- CAD
amount:
type: number
format: double
comparisonPriceType:
type: string
description: This is applicable only for promotions
enum:
- BASE
comparisonPrice:
type: object
properties:
currency:
type: string
enum:
- USD
- CAD
amount:
type: number
format: double
description: This is applicable only for promotions
priceDisplayCodes:
type: string
description: Represent promo placement. This is applicable only for promotions
enum:
- CART
- CHECKOUT
FeedId:
type: object
properties:
feedId:
type: string
description: A unique ID, returned from the Bulk Upload API, used for tracking the Feed File.
AdditionalAttribute:
required:
- name
- value
type: object
properties:
name:
type: string
value:
type: string
AdditionalAttributes:
required:
- additionalAttribute
type: object
properties:
additionalAttribute:
type: array
items:
required:
- name
- value
type: object
properties:
name:
type: string
value:
type: string
Header:
type: object
properties:
headerAttributes:
type: object
ItemIdentifierType:
type: object
properties:
sku:
type: string
offerId:
type: string
itemId:
type: string
wpid:
type: string
productType:
type: string
ItemPriceType:
required:
- itemIdentifier
- pricingList
type: object
properties:
itemIdentifier:
type: object
properties:
sku:
type: string
offerId:
type: string
itemId:
type: string
wpid:
type: string
productType:
type: string
pricingList:
required:
- pricing
type: object
properties:
replaceAll:
type: boolean
xml:
attribute: true
pricing:
type: array
items:
required:
- currentPrice
- currentPriceType
type: object
properties:
currentPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
currentPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
comparisonPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
comparisonPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
savingsAmount:
type: number
savingsPercent:
type: number
priceDisplayCodes:
type: object
properties:
isClearance:
type: boolean
hidePriceForSOI:
type: object
submapType:
type: object
isRollback:
type: boolean
isReducedPrice:
type: boolean
isEligibleForAssociateDiscount:
type: object
isStrikethrough:
type: boolean
pickupDiscount:
type: object
properties:
isPickUpDiscountEligible:
type: boolean
xml:
attribute: true
pickupDiscountAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
effectiveDate:
type: integer
format: int64
xml:
attribute: true
expirationDate:
type: integer
format: int64
xml:
attribute: true
processMode:
type: string
xml:
attribute: true
enum:
- UPSERT
- DELETE
pid:
type: string
maxSalesRetailPrice:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minAdvtPrice:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
rebate:
required:
- rebateAmt
type: object
properties:
rebateAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
infoUrl:
type: string
xml:
attribute: true
rebateType:
type: string
xml:
attribute: true
enum:
- AMOUNT
- PRODUCT
startDate:
type: string
format: date-time
xml:
attribute: true
endDate:
type: string
format: date-time
xml:
attribute: true
additionalAttributes:
required:
- additionalAttribute
type: object
properties:
additionalAttribute:
type: array
items:
required:
- name
- value
type: object
properties:
name:
type: string
value:
type: string
xml:
name: Price
MoneyType:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
PickupDiscount:
type: object
properties:
isPickUpDiscountEligible:
type: boolean
xml:
attribute: true
pickupDiscountAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
PriceDisplayCodes:
type: object
properties:
isClearance:
type: boolean
hidePriceForSOI:
type: object
submapType:
type: object
isRollback:
type: boolean
isReducedPrice:
type: boolean
isEligibleForAssociateDiscount:
type: object
isStrikethrough:
type: boolean
PricingListType:
required:
- pricing
type: object
properties:
replaceAll:
type: boolean
xml:
attribute: true
pricing:
type: array
items:
required:
- currentPrice
- currentPriceType
type: object
properties:
currentPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
currentPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
comparisonPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
comparisonPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
savingsAmount:
type: number
savingsPercent:
type: number
priceDisplayCodes:
type: object
properties:
isClearance:
type: boolean
hidePriceForSOI:
type: object
submapType:
type: object
isRollback:
type: boolean
isReducedPrice:
type: boolean
isEligibleForAssociateDiscount:
type: object
isStrikethrough:
type: boolean
pickupDiscount:
type: object
properties:
isPickUpDiscountEligible:
type: boolean
xml:
attribute: true
pickupDiscountAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
effectiveDate:
type: integer
format: int64
xml:
attribute: true
expirationDate:
type: integer
format: int64
xml:
attribute: true
processMode:
type: string
xml:
attribute: true
enum:
- UPSERT
- DELETE
pid:
type: string
PricingType:
required:
- currentPrice
- currentPriceType
type: object
properties:
currentPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
currentPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
comparisonPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
comparisonPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
savingsAmount:
type: number
savingsPercent:
type: number
priceDisplayCodes:
type: object
properties:
isClearance:
type: boolean
hidePriceForSOI:
type: object
submapType:
type: object
isRollback:
type: boolean
isReducedPrice:
type: boolean
isEligibleForAssociateDiscount:
type: object
isStrikethrough:
type: boolean
pickupDiscount:
type: object
properties:
isPickUpDiscountEligible:
type: boolean
xml:
attribute: true
pickupDiscountAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
effectiveDate:
type: integer
format: int64
xml:
attribute: true
expirationDate:
type: integer
format: int64
xml:
attribute: true
processMode:
type: string
xml:
attribute: true
enum:
- UPSERT
- DELETE
pid:
type: string
PromotionalPriceResponse:
type: object
properties:
payload:
required:
- itemIdentifier
- pricingList
type: object
properties:
itemIdentifier:
type: object
properties:
sku:
type: string
offerId:
type: string
itemId:
type: string
wpid:
type: string
productType:
type: string
pricingList:
required:
- pricing
type: object
properties:
replaceAll:
type: boolean
xml:
attribute: true
pricing:
type: array
items:
required:
- currentPrice
- currentPriceType
type: object
properties:
currentPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
currentPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
comparisonPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
comparisonPriceType:
type: string
enum:
- BASE
- REDUCED
- SAVINGS_AMT
- SAVINGS_PCT
- ROLLBACK
- CLEARANCE
- LIST_PRICE
savingsAmount:
type: number
savingsPercent:
type: number
priceDisplayCodes:
type: object
properties:
isClearance:
type: boolean
hidePriceForSOI:
type: object
submapType:
type: object
isRollback:
type: boolean
isReducedPrice:
type: boolean
isEligibleForAssociateDiscount:
type: object
isStrikethrough:
type: boolean
pickupDiscount:
type: object
properties:
isPickUpDiscountEligible:
type: boolean
xml:
attribute: true
pickupDiscountAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
effectiveDate:
type: integer
format: int64
xml:
attribute: true
expirationDate:
type: integer
format: int64
xml:
attribute: true
processMode:
type: string
xml:
attribute: true
enum:
- UPSERT
- DELETE
pid:
type: string
maxSalesRetailPrice:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minAdvtPrice:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
rebate:
required:
- rebateAmt
type: object
properties:
rebateAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
infoUrl:
type: string
xml:
attribute: true
rebateType:
type: string
xml:
attribute: true
enum:
- AMOUNT
- PRODUCT
startDate:
type: string
format: date-time
xml:
attribute: true
endDate:
type: string
format: date-time
xml:
attribute: true
additionalAttributes:
required:
- additionalAttribute
type: object
properties:
additionalAttribute:
type: array
items:
required:
- name
- value
type: object
properties:
name:
type: string
value:
type: string
xml:
name: Price
header:
type: object
properties:
headerAttributes:
type: object
status:
type: string
PromotionsPrice:
type: object
properties:
value:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
uomType:
type: string
minValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
perUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
minUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
maxUnitValue:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
Rebate:
required:
- rebateAmt
type: object
properties:
rebateAmt:
type: object
properties:
value:
type: string
currency:
type: string
xml:
attribute: true
amount:
type: number
xml:
attribute: true
infoUrl:
type: string
xml:
attribute: true
rebateType:
type: string
xml:
attribute: true
enum:
- AMOUNT
- PRODUCT
startDate:
type: string
format: date-time
xml:
attribute: true
endDate:
type: string
format: date-time
xml:
attribute: true
parameters:
authorization:
name: Authorization
in: header
description: Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.
required: true
schema:
type: string
example: Basic YzcyOTFjNmItNzI5MC00....
accessToken:
name: WM_SEC.ACCESS_TOKEN
in: header
description: The access token retrieved in the Token API call
required: true
schema:
type: string
example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
channelType:
name: WM_CONSUMER.CHANNEL.TYPE
in: header
description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding
required: false
schema:
type: string
correlationId:
name: WM_QOS.CORRELATION_ID
in: header
description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID
required: true
schema:
type: string
example: b3261d2d-028a-4ef7-8602-633c23200af6
svcName:
name: WM_SVC.NAME
in: header
description: Walmart Service Name
required: true
schema:
type: string
example: Walmart Service Name
accept:
name: Accept
in: header
description: 'Only supported Media Type : application/json'
required: true
schema:
type: string
example: application/json
content-type:
name: Content-Type
in: header
description: 'Only supported Media Type : application/json'
required: true
schema:
type: string
example: application/json
tags:
- name: Promotions