coupang
PUT/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/prices/{price}v1

更改单品价格

# 01

简介

API支持的买家用户地区:韩国,台湾 用于 变更单品级别的销售价格。 “ 销 售 申请 ” 批准通 过 后 ,已生成 属性I D ( vendoritemId )的情况下 可使用此功能。 当forceSalePriceUpdate=true 的情况下 更改价格时,更改比率没有限制。

# 02

详细内容

API支持的买家用户地区:韩国,台湾
用于变更单品级别的销售价格。申请批准通,已生成属性IDvendoritemId)的情况下可使用此功能。
当forceSalePriceUpdate=true的情况下更改价格时,更改比率没有限制。 

Path

PUT

/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/prices/{price}

Example Endpoint

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/3572784698/prices/49000?forceSalePriceUpdate=true

Request Parameters

Path Segment Parameter

Name Required Type Description
vendorItemId O Number

属性ID 

品固有的号码 

price O Number 

价格 

10为单输入(无法以1为单输入 

Query String Parameter

Name Required Type Description
forceSalePriceUpdate   Boolean

是否有价格更改的比率限制  

false(默认值) or true (更改比率无限制) 

为避免输入错误,会以之前的价格为基准限制更改范围。 

添加forceSalePriceUpdate=true时,可进行价格更改 

apMinSalePrice   Number 自动定价最低售价。必须小于 path 中的 {price}
apActive   Boolean 是否启用自动定价(true/false)

Request Example

not require body

Response Message

Name Type Description
code Result code
SUCCESS/ERROR
message String
结果信息

Response Example

{
  "code": "SUCCESS",
  "message": "Completed price change.",
  "data": null
}

Error Spec

HTTP status code (Error type) Error message Solution
400 (确认请求参数)  가격변경에 실패했습니다. [옵션ID[3572***698] : 판매가 변경이 불가능합니다. 변경전 판매가의 최대 50% 인하/최대 100%인상까지 변경가능합니다.]

认输入的price值是否在价格更改范围内。 

添加forceSalePriceUpdate=true即可输入无范围限制的价格。  

 

400 (Check request parameter)  가격변경에 실패했습니다. [옵션ID[5133***569] : 삭제된 상품은 변경이 불가능합니다.] 确认属性ID (vendorItemId)是否被删除。 
400 (Check request parameter) 자동생성옵션의 가격을 직접 수정할 수 없습니다. 기준 판매자옵션 가격으로 자동생성옵션 가격도 변경할 수 있습니다. 如果您要调整卖方单体商品的价格(这是创建自动生成选项的基础),则自动生成单体的价格也相应的也会被调整并以数量的倍数反映。 如果您已经直接修改了自动生成的单体价格,则无法将其调整为卖方单体商品的价格,则必须在WING中直接更改。
400 (Check request parameter)  가격변경에 실패했습니다. [옵션ID[4685***739]: 가격은 최소 10원 단위로 입력가능합니다. (1원단위 입력 불가)] 确认输入的价格(price)是否正确。价格最少以10韩元为单位输入(无法以1韩元为单位输入) 
400 (Check request parameter)   유효하지 않은 ID입니다. 确认输入的属性ID(vendorItemId)  值是否正确 
400 Bad Request apMinSalePrice must be less than price 请将 apMinSalePrice 设为低于 path 中的 {price}
400 Bad Request apMinSalePrice and apActive must be provided together 请同时传递 apMinSalePrice 与 apActive

URL API Name

UPDATE_PRODUCT_PRICE_BY_ITEM