JSON API – PUT Update Amazon Listings

Overview

Using the API without files, you can send a list of up to 1000 items to update listing configurations.

---

Endpoint

Method

PUT

URL

<Post-authentication Base URL>/external/{accountId}/v2/listings

---

Path Parameters

Parameter	Type	Required	Description
accountId	integer	Yes	Account id as Int

---

Headers

Authorization: Bearer <access token>

user-name: "myScript"

user-name is optional and used for logging purposes.

---

Request Body

The body must contain an array of listing objects.

Maximum items per request: 1000

---

Mandatory Identification Parameters

Parameter	Type	Required	Description
sku	String	Yes	SKU (Seller id)
asin	String	Yes	ASIN (Product id)
fulfillmentChannel	String	Yes	Fulfillment Method (FBA/FBM)

---

Inventory Configurations

Parameter	Type	Optional	Description
cost	Double	Yes	Inventory Product cost. No more than 2 decimal digits
shippingCost	Double	Yes	Est. Fulfillment Cost - for FBM only. No more than 2 decimal digits
additionalInventoryCosts	Double	Yes	No more than 2 decimal digits
inventoryComment	String	Yes
vendorName	String	Yes	Vendor Name
vendorPartNumber	String	Yes	Vendor Part Number
brand	String	Yes	Brand
leadTime	Double	Yes	Lead Time (in days)
unitsInPack	Integer	Yes	Units in Pack
minQuantityForOrder	Integer	Yes	Minimum Quantity for Order
parentSKU	String	Yes
daysOfCoverage	Integer	Yes	Days of Coverage
isReplenishable	boolean	Yes	Replenishable ON/OFF
warehouseInventory	Integer	Yes	Warehouse Inventory Quantity

---

Listings Configurations

Parameter	Type	Optional
repricerActivated	boolean	Yes
floorPrice	Double	Yes
ceilingPrice	Double	Yes
floorMarkupPercent	Double	Yes
ceilingMarkupPercent	Double	Yes
repricingMethod	String	Yes
repricingStrategy	String	Yes
repricingMethodValue	Details below	Yes
itemOnSaleRepricingMethod	String	Yes
itemOnSaleRepricingStrategy	String	Yes
itemOnSaleRepricingMethodValue	Details below	Yes
itemOnSaleStartDate	Long	Yes
itemOnSaleEndDate	Long	Yes
saleListedPrice	Double	Yes
onSale	boolean	Yes
mapPrice	Double	Yes
mapPriceActivated	boolean	Yes
neverBreakMapPrice	boolean	Yes
mapPriceEnforcement	boolean	Yes
enforceCompetitivePrice	boolean	Yes
cohort	String	Yes
vat	Double	Yes
markup	Double	Yes
additionalSellingCosts	Double	Yes
isAdditionalSellingCostByPercent	boolean	Yes
listingComment	Double	Yes
isBusinessPriceEnabled	boolean	Yes
businessPriceByPercent	boolean	Yes
b2bPriceDiffValue	double	Yes
b2bPriceDiffType	string	Yes
businessPrice	Set<BusinessPrice>	Yes
b2bFloorPrice	Double	Yes
isAutoSwitchBB	boolean	Yes
bbSuppressionBehavior	string	Yes
outOfStockBehavior	string	Yes
outOfStockPriceIncreasePercentage	double	Yes
backOrderConfig	string	Yes
pushToCeilingNoCompetition	boolean	Yes

---

repricingMethod

Acceptable values:

BB
PSP
RBV
FIXED

---

repricingStrategy

Options for repricingStrategy = BB

INC_MARGIN
INC_UNIT_SALES
MAX_UNIT_SALES
WIN_BB_HIGHEST_PRICE

Options for repricingStrategy = PSP

INC_MARGIN
INC_UNIT_SALES
MAX_UNIT_SALES

Options for repricingMethod = RBV

VELOCITY
LIQUIDATION

Options for repricingMethod = FIXED

NA

---

repricingMethodValue

repricingMethod = BB / PSP → N/A

When:

repricingMethod = RBV
repricingStrategy = VELOCITY

Velocity target → Integer

When:

repricingMethod = RBV
repricingStrategy = LIQUIDATION

Velocity target → Date (format yyyy-MM-dd)

When:

repricingMethod = FIXED

Double

---

itemOnSaleRepricingMethod

Acceptable values

BB
PSP
RBV
FIXED

---

itemOnSaleRepricingStrategy

Options for repricingStrategy = BB

INC_MARGIN
INC_UNIT_SALES
MAX_UNIT_SALES

Options for repricingStrategy = PSP

INC_MARGIN
INC_UNIT_SALES
MAX_UNIT_SALES

Options for repricingMethod = RBV

VELOCITY
LIQUIDATION

Options for repricingMethod = FIXED

NA

---

Attention

itemOnSaleRepricingMethod MUST be the same as non sale repricingMethod, or FIXED.

If the non-sale repricingMethod is FIXED then there will be no sale.

Example:

IF repricingMethod = BB

THEN itemOnSaleRepricingStrategy = INC_MARGIN / INC_UNIT_SALES / MAX_UNIT_SALES

If PSP OnSaleRepricingStrategy is enabled under a BB item,
no sale element will be sent to Amazon.

---

itemOnSaleRepricingMethodValue

repricingMethod = BB / PSP → N/A

When:

repricingMethod = RBV
repricingStrategy = VELOCITY

Velocity target → Integer

When:

repricingMethod = RBV
repricingStrategy = LIQUIDATION

Velocity target → Date (format yyyy-MM-dd)

When:

repricingMethod = FIXED

Double

---

Followed ASIN configuration

Relevant when:

repricingMethod = PSP
AND repricingStrategy = FOLLOW_ASIN

Parameter	Type	Optional	Description
followedAsin	String	Yes	ASIN value to be followed
followedAsinPriceDiff	Double	Yes	Diff amount from the relevant competitor offer of the followed ASIN
followedAsinInPercent	Boolean	Yes	Diff from followed ASIN by percent or absolute value

---

Relevant only if repricingMethod = BB

Parameter	Type	Optional	Description
isLimitPriceIncrease	Boolean	Yes	Enable/disable price increase limit
limitPriceIncrease	Double	Yes	Amount of price increase limitation
limitPriceIncreaseByPercent	Boolean	Yes	Price increase limitation by percent or absolute value
avoidBeingFirstBelowBB	Boolean	Yes	Enable/Disable restriction of being the first offering price below BB price
avoidPriceErosion	Boolean	Yes	Enable/Disable price erosion validation
avoidPriceErosionValue	Double	Yes	Amount of price decrease to limit
avoidPriceErosionInPercent	Boolean	Yes	The limited amount in percent or absolute

---

Relevant to FBA state is in Excess/Low inventory

Parameter	Type	Optional	Description
fbaExcessInventoryStateType	String	Yes	State reached / Trending towards
fbaExcessInventoryStrategy	String	Yes	Ignore excess / accelerate sales
fbaLowStockInventoryStateType	String	Yes	State reached / Trending towards
fbaLowStockInventoryStateStrategy	String	Yes	Ignore / Set price to Ceiling / Slow down sales / Liquidate inventory
fbaLowStockBBPercent	Double	Yes	Set price to be at least x% above BB Price
fbaSaleLowStockBBPercent	Double	Yes	Set price to be at least y% above last sale price

---

businessPrice Object

Example:

[
{
"quantity": 3,
"salePercentage": 1.0
},
{
"quantity": 10,
"salePercentage": 2.0
}
]

Object containing up to 5 quantity discount tiers.

---

Example Request

PUT /external/{accountId}/v2/listings

Body

[
{
"sku": "FPSE0012345",
"asin": "B08YFK1ABC",
"fulfillmentChannel": "FBA",
"cost": 141.93,
"unitsInPack": 1
}
]

---

Example Response

{
"successMessage": "UPDATE_PRODUCT_CONFIGURATION_SUCCESS"
}