bulkUpdatePriceQuantity
<h1>bulkUpdatePriceQuantity</h1>
<p><strong>POST</strong> /bulk_update_price_quantity</p>
<p>卖方使用该呼叫来更新一个库存物品的总船到户数量，和/或更新与一个库存物品相关联的一个或多个要约的价格和/或数量。可以使用一个bulkUpdatePriceQuantity调用更新与库存项目关联的最多25个商品。每次通话只能更新一个SKU（一个产品）。</p>
<p>该getOffers调用可用于检索与SKU相关联的所有报价。卖家只需通过sku查询参数传递正确的SKU值。要更新商品，需要offerId值，并在getOffers中返回此值呼叫响应。了解哪些优惠未发布以及哪些优惠已发布也很有用。要获取此状态，请在getOffers调用响应中查找状态值。已发布状态的优惠是实时易趣物品列表，这些列表将通过成功的bulkUpdatePriceQuantity调用进行修订。如果重复发生的问题OFFERID值过柱报价的容器，或者指定提供的一个或多个与不同产品/ SKU的关联。注意：对于多变量列表，建议使用bulkUpdatePriceQuantity</p>
<pre><code>call用于更新该多变量列表中每个SKU的价格和数量信息，而不是使用createOrReplaceInventoryItem调用来更新每个SKU的价格和数量。请记住，每次通话只能更新一个SKU（一个产品变体）。</code></pre>
<p>该authorization头是该呼叫的唯一需要的HTTP标头。有关更多信息，请参阅HTTP请求标头部分。</p>
<h6>Input</h6>
<p>Resource URI (production)</p>
<pre><code>POST https://api.ebay.com/sell/inventory/v1/bulk_update_price_quantity</code></pre>
<h6>URI parameters</h6>
<p>This method has no URI parameters.</p>
<h6>HTTP request headers</h6>
<p>对eBay REST操作发出的所有请求都要求您提供授权 HTTP标头以进行身份验证授权。
此外，此方法要求您包含Content-Type标头，其值应设置为“ application / json ”。请参阅<a href="http://developer.ebay.com/devzone/rest/ebay-rest/content/rest-request-components.html#HTTP" title="HTTP请求标头">HTTP请求标头</a>- 打开其余请求组件页面以获取详细信息</p>
<h6>Request payload</h6>
<pre><code>{
"requests": [
{
"sku": "string",
"shipToLocationAvailability": {
"quantity": "integer"
},
"offers": [
{
"offerId": "string",
"availableQuantity": "integer",
"price": {
"value": "string",
"currency": "string"
}
}
]
}
]
}</code></pre>
<h6>Request fields</h6>
<table>
<thead>
<tr>
<th>Input container/field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>requests</td>
<td>array of PriceQuantity</td>
<td>卖方使用该容器来更新一个或多个库存物品（最多25个）的总“船到户”数量和/或更新一个或多个特定公开要约的价格和/或数量。发生：必需</td>
</tr>
<tr>
<td>requests.sku</td>
<td>string</td>
<td>这是卖方定义的库存项目的SKU值，其总“船到户”数量将更新。仅当卖方使用shipToLocationAvailability容器更新库存物料的总数量时，才需要此字段。如果卖方正在更新一个或多个特定要约的价格和/或数量，则改为使用一个或多个offerId值，并且不需要sku值。如果卖方想要更新一个或多个要约的价格和/或数量，并且还想要更新相应库存项目的总“船到户”数量，则与offerId值相关联的SKU值必须与相应的sku相同传入的值，否则将发生错误。最大长度：50发生：有条件的</td>
</tr>
<tr>
<td>requests.shipToLocationAvailability</td>
<td>ShipToLocationAvailability</td>
<td>如果卖方正在更新相应库存项目（在sku字段中指定）的总“出货地”数量，则需要此容器。成功的调用将更新与sku值关联的库存项目记录。发生：有条件的</td>
</tr>
<tr>
<td>requests.shipToLocationAvailability.quantity</td>
<td>integer</td>
<td>此容器用于设置可通过一个或多个已发布的商品购买的库存商品的总“发货到户”数量。此容器不是立即需要的，但必须在发布库存物品的报价之前设置“发货到户”数量。如果正在更新现有库存物料，并且库存物料记录已存在“发货至库存”数量，则应再次包含此容器，即使该值未更改，或者可用数量数据将丢失。发生：有条件的</td>
</tr>
<tr>
<td>requests.offers</td>
<td>array of OfferPriceQuantity</td>
<td>如果卖方正在更新一个或多个已发布的优惠的价格和/或数量，则需要此容器，并且成功的呼叫将实际用修改的价格和/或可用数量更新活动的eBay列表。此调用不适用于未发布的优惠。对于未发布的优惠，卖家应使用updateOffer调用来更新可用的数量和/或价格。如果卖方还使用shipToLocationAvailability容器和sku字段来更新库存物料的总“船到户”数量，则与相应offerId值相关联的SKU值必须与相应的sku相同传入的值，否则将发生错误。要更新的每个商品都需要单独的（OfferPriceQuantity）节点。发生：有条件的</td>
</tr>
<tr>
<td>requests.offers.offerId</td>
<td>string</td>
<td>此字段是商品的唯一标识符。如果要约容器用于更新与特定库存物料相关联的一个或多个要约，则需要offerId值以便用修改的价格和/或数量来识别要更新的要约。卖方可以运行getOffers调用（传递正确的SKU值作为查询参数）来检索与SKU关联的商品的offerId值。发生：有条件的</td>
</tr>
<tr>
<td>requests.offers.availableQuantity</td>
<td>integer</td>
<td>如果卖方想要修改可在报价中购买的库存项目的当前数量（由相应的offerId值标识），则使用此字段。可以使用availableQuantity字段或price容器，但不一定都是。发生：有条件的</td>
</tr>
<tr>
<td>requests.offers.price</td>
<td>Amount</td>
<td>如果卖方想要修改库存物料的当前价格，则使用此容器。此处设置的美元价值将是要约中库存项目的新价格（由相应的offerId值标识）。可以使用availableQuantity字段或price容器，但不一定都是。发生：有条件的</td>
</tr>
<tr>
<td>requests.offers.price.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>requests.offers.price.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</td>
</tr>
</tbody>
</table>
<h6>Output</h6>
<p>HTTP response headers
This call has no response headers.</p>
<h6>Response payload</h6>
<pre><code>{
"responses": [
{
"statusCode": "integer",
"sku": "string",
"offerId": "string",
"errors": [
{
"errorId": "integer",
"domain": "string",
"subdomain": "string",
"category": "string",
"message": "string",
"parameters": [
{
"value": "string",
"name": "string"
}
],
"longMessage": "string",
"inputRefIds": [
"string"
],
"outputRefIds": [
"string"
]
}
],
"warnings": [
{
"errorId": "integer",
"domain": "string",
"subdomain": "string",
"category": "string",
"message": "string",
"parameters": [
{
"value": "string",
"name": "string"
}
],
"longMessage": "string",
"inputRefIds": [
"string"
],
"outputRefIds": [
"string"
]
}
]
}
]
}</code></pre>
<h6>Response fields</h6>
<table>
<thead>
<tr>
<th>Output container/field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>responses</td>
<td>array of PriceQuantityResponse</td>
<td>此容器将返回正在更新的每个商品/库存商品的HTTP状态代码，商品ID和SKU值，以及在尝试更新这些商品/库存商品时触发任何错误或警告时的错误和/或警告容器。发生：总是</td>
</tr>
<tr>
<td>responses.statusCode</td>
<td>integer</td>
<td>此容器中返回的值将指示尝试更新商品的价格和/或数量（在相应的offerId字段中指定）或尝试更新库存的总“发货到库”数量的状态item（在相应的sku字段中指定）。要成功更新商品或库存商品记录，200将在此字段中显示值。对于不成功的尝试，400将在此字段中显示值。发生：总是</td>
</tr>
<tr>
<td>responses.sku</td>
<td>string</td>
<td>这是卖方定义的产品SKU值。无论卖方是尝试更新具有SKU值的要约还是仅尝试更新库存项目记录的总“出货地”数量，都会返回此字段。最大长度：50发生：总是</td>
</tr>
<tr>
<td>responses.offerId</td>
<td>string</td>
<td>已更新的商品的唯一标识符。在卖方仅更新库存物品记录的总“船到户”数量的情况下，不会返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors</td>
<td>array of ErrorDetailV3</td>
<td>如果有一个或多个与商品或库存商品记录更新相关的错误，则将返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.errorId</td>
<td>integer</td>
<td>唯一代码，用于标识发生的特定错误或警告。您的应用程序可以在自定义错误处理算法中使用错误代码作为标识符。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.domain</td>
<td>string</td>
<td>发生错误或警告的域的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.subdomain</td>
<td>string</td>
<td>发生错误或警告的子域的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.category</td>
<td>string</td>
<td>此字符串值表示错误类别。有三类错误：请求错误，应用程序错误和系统错误。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.message</td>
<td>string</td>
<td>导致错误或警告的条件的描述。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.parameters</td>
<td>array of ErrorParameterV3</td>
<td>各种警告和错误消息返回一个或多个变量，这些变量包含有关错误或警告的上下文信息。这通常是触发错误或警告的字段或值。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.parameters.value</td>
<td>string</td>
<td>这是为name字段中指定的元素传递的实际值。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.parameters.name</td>
<td>string</td>
<td>这是导致调用请求出现问题的输入字段的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.longMessage</td>
<td>string</td>
<td>导致错误或警告的条件的详细说明，以及有关如何解决问题的信息。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.inputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关联最密切的特定请求元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>responses.errors.outputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关系最密切的特定响应元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings</td>
<td>array of ErrorDetailV3</td>
<td>如果有一个或多个警告与商品或库存商品记录的更新相关联，则将返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.errorId</td>
<td>integer</td>
<td>唯一代码，用于标识发生的特定错误或警告。您的应用程序可以在自定义错误处理算法中使用错误代码作为标识符。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.domain</td>
<td>string</td>
<td>发生错误或警告的域的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.subdomain</td>
<td>string</td>
<td>发生错误或警告的子域的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.category</td>
<td>string</td>
<td>此字符串值表示错误类别。有三类错误：请求错误，应用程序错误和系统错误。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.message</td>
<td>string</td>
<td>导致错误或警告的条件的描述。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.parameters</td>
<td>array of ErrorParameterV3</td>
<td>各种警告和错误消息返回一个或多个变量，这些变量包含有关错误或警告的上下文信息。这通常是触发错误或警告的字段或值。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.parameters.value</td>
<td>string</td>
<td>这是为name字段中指定的元素传递的实际值。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.parameters.name</td>
<td>string</td>
<td>这是导致调用请求出现问题的输入字段的名称。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.longMessage</td>
<td>string</td>
<td>导致错误或警告的条件的详细说明，以及有关如何解决问题的信息。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.inputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关联最密切的特定请求元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>responses.warnings.outputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关系最密切的特定响应元素（如果有）。发生：有条件的</td>
</tr>
</tbody>
</table>
<p><strong>HTTP状态代码</strong>
此调用可以返回以下HTTP状态代码之一。状态代码的概述，请参阅<a href="https://developer.ebay.com/api-docs/static/rest-response-components.html#HTTP" title="HTTP状态代码">HTTP状态代码</a>在使用eBay RESTful API中。</p>
<table>
<thead>
<tr>
<th>状态码</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功</td>
</tr>
<tr>
<td>207</td>
<td>多态</td>
</tr>
<tr>
<td>400</td>
<td>错误的请求</td>
</tr>
<tr>
<td>500</td>
<td>内部服务器错误</td>
</tr>
</tbody>
</table>
<p><strong>错误代码</strong>
有关错误的更多信息以及其他常见错误的代码，请参阅<a href="https://developer.ebay.com/api-docs/static/handling-error-messages.html" title="处理错误">处理错误</a>。</p>
<table>
<thead>
<tr>
<th>状态码</th>
<th>域</th>
<th>类别</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>25001</td>
<td>API_INVENTORY</td>
<td>应用</td>
<td>发生了系统错误。{附加信息}</td>
</tr>
<tr>
<td>25709</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>{fieldName}的值无效。{附加信息}</td>
</tr>
</tbody>
</table>
<h6>示例</h6>
<p>新的API调用？请参阅拨打电话。</p>
<p>注意：这些样本中的标识符（例如订单ID或用户ID）和个人数据可能是匿名的，或者在eBay上可能不再有效。如有必要，请在您的请求中替换当前相关的eBay数据。</p>
<h6>示例1：更新价格和数量</h6>
<p>此请求将更新一个或多个SKU的总数量，以及与这些SKU关联的一个或多个要约的价格和/或数量。</p>
<h6>Input</h6>
<p>此调用将更新与两个不同SKU相关的四个单独的优惠。产品的总发货数量GP-Cam-01在shipToLocationAvailability容器中指定。与此SKU相关的两个单独报价的价格和数量将更新。请注意，货币类型为USD和GBP，表示一个优惠在eBay美国网站上，另一个优惠在eBay英国网站上。对标识为的产品进行类似的操作GP-Cam-02。
POST
<a href="https://api.ebay.com/sell/inventory/v1/bulk_update_price_quantity">https://api.ebay.com/sell/inventory/v1/bulk_update_price_quantity</a></p>
<pre><code>{
"requests": [
{
"offers": [
{
"availableQuantity": 30,
"offerId": "3455632452325",
"price": {
"currency": "USD",
"value": "299.0"
}
},
{
"availableQuantity": 20,
"offerId": "3455632452365",
"price": {
"currency": "GBP",
"value": "232.0"
}
}
],
"shipToLocationAvailability": {
"quantity": 50
},
"sku": "GP-Cam-01"
},
{
"offers": [
{
"availableQuantity": 15,
"offerId": "3455632452375",
"price": {
"currency": "USD",
"value": "249.0"
}
},
{
"availableQuantity": 10,
"offerId": "3455632452395",
"price": {
"currency": "GBP",
"value": "182.0"
}
}
],
"shipToLocationAvailability": {
"quantity": 25
},
"sku": "GP-Cam-02"
}
]
}</code></pre>
<h6>Output</h6>
<p>一个的StatusCode字段返回每个提议，表示如果该要约已成功更新。一的StatusCode的值，200表明该报价已成功更新。请注意，所有四个商品都已成功更新，并且没有任何错误或警告任何更新。</p>
<pre><code>{
"responses": [
{
"offerId": "3455632452325",
"sku": "GP-Cam-01",
"statusCode": 200
},
{
"offerId": "3455632452365",
"sku": "GP-Cam-01",
"statusCode": 200
},
{
"offerId": "3455632452375",
"sku": "GP-Cam-02",
"statusCode": 200
},
{
"offerId": "3455632452395",
"sku": "GP-Cam-02",
"statusCode": 200
}
]
}</code></pre>