getListingFees
<p><strong>POST</strong> /offer/get_listing_fees</p>
<p>此调用用于检索最多250个未发布的优惠的预期上市费用。在offers容器下传递一个或多个offerId值的数组。在响应有效载荷中，所有列出的费用都按照eBay市场分组，并且不显示每个要约的列表费用。将为卖家销售与指定优惠相关的产品的每个eBay市场返回一个收费容器。如果卖方通过将发生错误offerIds代表已公布的计划书，因此，这个调用应该在卖方通过publishOffer的发布offer之前进行。</p>
<h5>Input</h5>
<h6>Resource URI (production)</h6>
<p><strong>POST</strong> <a href="https://api.ebay.com/sell/inventory/v1/offer/get_listing_fees">https://api.ebay.com/sell/inventory/v1/offer/get_listing_fees</a></p>
<h6>URI parameters</h6>
<p>This method has no URI parameters.</p>
<h5>HTTP请求标头</h5>
<p>对eBay REST操作发出的所有请求都要求您提供授权 HTTP标头以进行身份验证授权。
此方法具有下面列出的其他请求标头要求。请参阅<a href="http://developer.ebay.com/devzone/rest/ebay-rest/content/rest-request-components.html#HTTP" title="HTTP请求标头">HTTP请求标头</a>- 打开其余请求组件页面以获取详细信息</p>
<h6>OAuth范围</h6>
<p>此请求需要使用<a href="https://developer.ebay.com/api-docs/static/oauth-authorization-code-grant.html" title="授权代码授权">授权代码授权</a>流创建的访问令牌，使用以下列表中的一个范围：
<a href="https://api.ebay.com/oauth/api_scope/sell.inventory.readonly">https://api.ebay.com/oauth/api_scope/sell.inventory.readonly</a>
<a href="https://api.ebay.com/oauth/api_scope/sell.inventory">https://api.ebay.com/oauth/api_scope/sell.inventory</a></p>
<p>有关详细信息，请参阅<a href="https://developer.ebay.com/api-docs/static/oauth-tokens.html" title="OAuth访问令牌">OAuth访问令牌</a>。</p>
<h6>Request payload</h6>
<pre><code class="language-json">{
"offers": [
{
"offerId": "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>offers</td>
<td>array of OfferKeyWithId</td>
<td>此容器用于标识将检索预期列表费用的一个或多个（最多250个）未发布的商品。用户将一个或多个offerId值（最多250个）传递到此容器，以标识未发布的要约，以便检索预期的列表费用。此调用仅适用于未发布状态的商品。呼叫响应为每个eBay市场提供总费用金额，并且不会在个别要约级别提供费用信息。发生：必需</td>
</tr>
<tr>
<td>offers.offerId</td>
<td>string</td>
<td>未检索报价的唯一标识符，将检索预期的列表费用。一到250个OFFERID值可以到传递报价容器一个getListingFees调用。如果传递了表示已发布商品的offerId值，则会发生错误。发生：必需</td>
</tr>
</tbody>
</table>
<h5>Output</h5>
<h6>HTTP response headers</h6>
<p>This call has no response headers.</p>
<h6>Response payload</h6>
<pre><code class="language-json">{
"feeSummaries": [
{
"warnings": [
{
"errorId": "integer",
"domain": "string",
"subdomain": "string",
"category": "string",
"message": "string",
"parameters": [
{
"value": "string",
"name": "string"
}
],
"longMessage": "string",
"inputRefIds": [
"string"
],
"outputRefIds": [
"string"
]
}
],
"marketplaceId": "MarketplaceEnum : [EBAY_US,EBAY_MOTORS,EBAY_CA,EBAY_GB,EBAY_AU,EBAY_AT,EBAY_BE_FR,EBAY_FR,EBAY_DE,EBAY_IT,EBAY_BE_NL,EBAY_NL,EBAY_ES,EBAY_CH,EBAY_TW,EBAY_CZ,EBAY_DK,EBAY_FI,EBAY_GR,EBAY_HK,EBAY_HU,EBAY_IN,EBAY_ID,EBAY_IE,EBAY_IL,EBAY_MY,EBAY_NZ,EBAY_NO,EBAY_PH,EBAY_PL,EBAY_PT,EBAY_PR,EBAY_RU,EBAY_SG,EBAY_ZA,EBAY_SE,EBAY_TH,EBAY_VN,EBAY_CN,EBAY_PE,EBAY_CA_FR,EBAY_JP]",
"fees": [
{
"feeType": "string",
"amount": {
"value": "string",
"currency": "string"
},
"promotionalDiscount": {
"value": "string",
"currency": "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>feeSummaries</td>
<td>array of FeeSummary</td>
<td>此容器包含一个或多个上市费用的数组，卖方可以为期望在呼叫请求中指定的未发布的商品支付这些费用。许多费用类型即使在它们的情况下也会被退回0.0。发生：总是</td>
</tr>
<tr>
<td>feeSummaries.warnings</td>
<td>array of ErrorDetailV3</td>
<td>在进行调用时，此容器将包含一系列错误和/或警告，并发生错误和/或警告。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.errorId</td>
<td>integer</td>
<td>唯一代码，用于标识发生的特定错误或警告。您的应用程序可以在自定义错误处理算法中使用错误代码作为标识符。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.domain</td>
<td>string</td>
<td>发生错误或警告的域的名称。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.subdomain</td>
<td>string</td>
<td>发生错误或警告的子域的名称。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.category</td>
<td>string</td>
<td>此字符串值表示错误类别。有三类错误：请求错误，应用程序错误和系统错误。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.message</td>
<td>string</td>
<td>导致错误或警告的条件的描述。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.parameters</td>
<td>array of ErrorParameterV3</td>
<td>各种警告和错误消息返回一个或多个变量，这些变量包含有关错误或警告的上下文信息。这通常是触发错误或警告的字段或值。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.parameters.value</td>
<td>string</td>
<td>这是为name字段中指定的元素传递的实际值。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.parameters.name</td>
<td>string</td>
<td>这是导致调用请求出现问题的输入字段的名称。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.longMessage</td>
<td>string</td>
<td>导致错误或警告的条件的详细说明，以及有关如何解决问题的信息。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.inputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关联最密切的特定请求元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.warnings.outputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关系最密切的特定响应元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.marketplaceId</td>
<td>MarketplaceEnum</td>
<td>这是eBay网站的唯一标识符，适用于此优惠的上市费用。发生：总是</td>
</tr>
<tr>
<td>feeSummaries.fees</td>
<td>array of Fee</td>
<td>此容器是一系列上市费用，可以预期应用于指定的eBay市场上的报价（marketplaceId值）。许多费用类型即使在它们的情况下也会被退回0.0。有关上市费用的更多信息，请参阅标准销售费帮助页面。发生：总是</td>
</tr>
<tr>
<td>feeSummaries.fees.feeType</td>
<td>string</td>
<td>该字段中返回的值表示如果在marketplaceId字段中指定的市场上发布一个或多个未发布的要约（在呼叫请求中指定要约），则卖方可能产生的列表费用的类型。适用的上市费通常包括诸如InsertionFee或之类的东西SubtitleFee，但许多费用类型将被退回，即使它们是0.0。有关上市费用的更多信息，请参阅标准销售费帮助页面。发生：总是</td>
</tr>
<tr>
<td>feeSummaries.fees.amount</td>
<td>Amount</td>
<td>此容器中的此美元值是feeType字段中指定的上市费用类型的实际美元值。发生：总是</td>
</tr>
<tr>
<td>feeSummaries.fees.amount.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.fees.amount.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.fees.promotionalDiscount</td>
<td>Amount</td>
<td>此容器中的美元值表示对feeType字段中指定的上市费用类型应用的任何eBay促销折扣。如果没有对该费用适用折扣，则该容器仍然被退回，但其价值为0.0。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.fees.promotionalDiscount.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>feeSummaries.fees.promotionalDiscount.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</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>400</td>
<td>错误的请求</td>
</tr>
<tr>
<td>404</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>25009</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>与库存项目关联的易趣物品列表或未发布的物品在相关的退货政策中包含无效数据。{附加信息}</td>
</tr>
</tbody>
</table>
<h6>示例</h6>
<p>新的API调用？请参阅<a href="https://developer.ebay.com/api-docs/static/make-a-call.html" title="拨打电话">拨打电话</a>。</p>
<p>注意：这些样本中的标识符（例如订单ID或用户ID）和个人数据可能是匿名的，或者在eBay上可能不再有效。如有必要，请在您的请求中替换当前相关的eBay数据。</p>
<h6>示例1：检索预期的上市费用</h6>
<p>此调用检索每个eBay市场的预期上市费用，用于请求有效负载中指定的未发布的商品。</p>
<h6>Input</h6>
<p>两个OFFERID值下传递报价容器。这些未发布的优惠的预期上市费用将在回复中返回。</p>
<p><strong>POST</strong>
<a href="https://api.ebay.com/sell/inventory/v1/offer/get_listing_fees">https://api.ebay.com/sell/inventory/v1/offer/get_listing_fees</a></p>
<pre><code class="language-json">{
"offers": [
{
"offerId": "36445435465"
},
{
"offerId": "36445435466"
}
]
}</code></pre>
<h6>Output</h6>
<p>从输出中可以看出，其中一个优惠将发布到eBay美国网站，另一个将发布到eBay英国网站。卖家可以期望对这两个优惠都有插入费和字幕费。</p>
<pre><code class="language-json">{
"feeSummaries": [
{
"fees": [
{
"amount": {
"currency": "USD",
"value": "0.3"
},
"feeType": "InsertionFee"
},
{
"amount": {
"currency": "USD",
"value": "0.5"
},
"feeType": "SubtitleFee"
}
],
"marketplaceId": "EBAY_US"
},
{
"fees": [
{
"amount": {
"currency": "GBP",
"value": "0.23"
},
"feeType": "InsertionFee"
},
{
"amount": {
"currency": "GBP",
"value": "0.39"
},
"feeType": "SubtitleFee"
}
],
"marketplaceId": "EBAY_UK"
}
]
}</code></pre>