getOffer
<h1>getOffer</h1>
<p><strong>GET</strong> /offer/{offerId}</p>
<p>此调用检索特定的已发布或未发布的商品。商品（offerId）的唯一标识符在调用URI的末尾传递。
该authorization头是该呼叫的唯一需要的HTTP标头。有关更多信息，请参阅HTTP请求标头部分。</p>
<h6>Input</h6>
<h6>Resource URI (production)</h6>
<p><strong>GET</strong> <a href="https://api.ebay.com/sell/inventory/v1/offer/{offerId">https://api.ebay.com/sell/inventory/v1/offer/{offerId</a>}</p>
<h6>URI parameters</h6>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>offerId</td>
<td>string</td>
<td>要检索的商品的唯一标识符。发生：必需</td>
</tr>
</tbody>
</table>
<h6>HTTP request headers</h6>
<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>
<table>
<thead>
<tr>
<th>Header</th>
<th>Type</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Language</td>
<td><a href="https://developer.ebay.com/api-docs/static/simple-types.html" title="string">string</a></td>
<td>此请求标头设置将在请求有效负载的字段值中提供的自然语言。发生：必需</td>
</tr>
</tbody>
</table>
<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>
<p>This call has no payload.</p>
<h6>Request fields</h6>
<p>This call has no field definitions.</p>
<h6>Output</h6>
<h6>HTTP response headers</h6>
<p>This call has no response headers.</p>
<h6>Response payload</h6>
<pre><code class="language-json">{
"availableQuantity": "integer",
"categoryId": "string",
"listingDescription": "string",
"listingPolicies": {
"paymentPolicyId": "string",
"returnPolicyId": "string",
"shippingCostOverrides": [
{
"surcharge": {
"value": "string",
"currency": "string"
},
"additionalShippingCost": {
"value": "string",
"currency": "string"
},
"priority": "integer",
"shippingCost": {
"value": "string",
"currency": "string"
},
"shippingServiceType": "ShippingServiceTypeEnum : [DOMESTIC,INTERNATIONAL]"
}
],
"fulfillmentPolicyId": "string",
"ebayPlusIfEligible": "boolean"
},
"merchantLocationKey": "string",
"pricingSummary": {
"minimumAdvertisedPrice": {
"value": "string",
"currency": "string"
},
"pricingVisibility": "MinimumAdvertisedPriceHandlingEnum : [NONE,PRE_CHECKOUT,DURING_CHECKOUT]",
"originallySoldForRetailPriceOn": "SoldOnEnum : [ON_EBAY,OFF_EBAY,ON_AND_OFF_EBAY]",
"originalRetailPrice": {
"value": "string",
"currency": "string"
},
"price": {
"value": "string",
"currency": "string"
}
},
"quantityLimitPerBuyer": "integer",
"tax": {
"applyTax": "boolean",
"thirdPartyTaxCategory": "string",
"vatPercentage": "number"
},
"storeCategoryNames": [
"string"
],
"lotSize": "integer",
"format": "FormatTypeEnum : [FIXED_PRICE]",
"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]",
"sku": "string",
"offerId": "string",
"listing": {
"listingId": "string",
"listingStatus": "ListingStatusEnum : [ACTIVE,OUT_OF_STOCK,INACTIVE,ENDED,EBAY_ENDED,NOT_LISTED]",
"soldQuantity": "integer"
},
"status": "OfferStatusEnum : [UNPUBLISHED,PUBLISHED]"
}</code></pre>
<h6>Response fields</h6>
<table>
<thead>
<tr>
<th>Input container/field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>availableQuantity</td>
<td>integer</td>
<td>此整数值表示在marketplaceId字段中指定的eBay站点上购物的买家可以购买的库存项目数量（由sku值指定）。对于尚未设置可用数量的未发布商品，availableQuantity值设置为0。发生：总是</td>
</tr>
<tr>
<td>categoryId</td>
<td>string</td>
<td>列出库存项目的主要易趣类别的唯一标识符。对于已发布的商品，始终会返回此字段，但仅在为未发布的商品设置时才会返回。发生：有条件的</td>
</tr>
<tr>
<td>listingDescription</td>
<td>string</td>
<td>eBay列表的描述是未发布或已发布的优惠的一部分。对于已发布的商品，始终会返回此字段，但仅在为未发布的商品设置时才会返回。最大长度：500000发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies</td>
<td>ListingPolicies</td>
<td>此容器指示应用于商品的商家信息策略。此容器包含将与列表关联的付款，退货和履行列表政策。在通过Inventory API创建实时易趣列表之前，卖家必须选择加入商业政策。卖家可以通过“我的易趣”或使用帐户API的optInToProgram电话选择加入商业政策。同样，可以在“我的易趣”中创建/管理付款，退货和履行列表政策，也可以使用帐户API的列表政策调用。对于尚未指定列表策略的未发布商品，此容器将返回为空。发生：总是</td>
</tr>
<tr>
<td>listingPolicies.paymentPolicyId</td>
<td>string</td>
<td>此唯一标识符表示一旦要约发布并转换为易趣列表时将使用的付款列表政策。此付款列表政策将为易趣物品列表设置所有与付款相关的设置。优惠不是立即需要上市政策，但在发布优惠之前是必需的。卖方应在将付款清单政策分配给优惠之前查看付款清单政策，因为以下情况必须符合付款清单政策才能与优惠兼容：该marketplaceId值应反映在报价被公布该immediatePay字段值必须设置为true因为库存API只提供支持立即付款唯一指定的付款方式应为“PayPal”，因为即时付款需要“PayPal”可以在“我的易趣”或帐户API中创建和管理列表策略。要获取与特定eBay Marketplace上的卖家帐户相关联的所有付款政策的列表，请使用Account API的getPaymentPolicies调用。帐户API中还调用按策略ID或策略名称检索付款策略。如果为商品设置，则会在getOffer和getOffers调用中返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.returnPolicyId</td>
<td>string</td>
<td>此唯一标识符表示一旦要约发布并转换为eBay列表时将使用的退货列表政策。此退货清单政策将为易趣物品清单设置所有退货政策设置。优惠不是立即需要上市政策，但在发布优惠之前是必需的。卖方应在将报价分配给报价之前查看退货清单政策，以确保其与库存项目和报价设置兼容。可以在“我的易趣”或帐户API中创建和管理列表策略。要获取与特定eBay Marketplace上的卖家帐户关联的所有退货政策的列表，请使用Account API的getReturnPolicies调用。还有电话帐户API，用于按策略ID或策略名称检索退货策略。如果为商品设置，则会在getOffer和getOffers调用中返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides</td>
<td>array of ShippingCostOverride</td>
<td>如果卖方希望覆盖履行列表政策中定义的一个或多个国内或国际航运服务选项的运费或附加费，则使用此容器。为了覆盖特定国内或国际运输服务选项的成本，卖方必须知道履行列表政策中该运输服务的优先级/顺序。航运服务选项的名称可以在发现shippingOptions.shippingServices.shippingServiceCode履行政策的领域，而航运服务选项的优先级/顺序在发现shippingOptions.shippingServices.sortOrderId领域。通过使用getFulfillmentPolicies或搜索该履行策略，可以检索这两个值Account API的getFulfillmentPolicyByName调用。该shippingCostOverrides.priority值应符合shippingOptions.shippingServices.sortOrderId以覆盖该航运服务选项的运输成本。卖方还必须确保shippingServiceType值设置为DOMESTIC覆盖国内送货服务选项，或INTERNATIONAL覆盖国际送货服务选项。每个运输服务选项都需要单独的ShippingCostOverrides节点，其成本被覆盖。shippingCostOverrides的所有已定义字段即使运费和附加费值没有变化，也应包括容器。该shippingCostOverrides容器在返回getOffer和getOffers如果被应用到实现政策的一种或多种运输成本覆盖的呼叫。出现：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.surcharge</td>
<td>Amount</td>
<td>传入此字段的美元值将覆盖当前为适用的送货服务选项设置的运费附加费。要覆盖的配送策略中的送货服务选项由shippingServiceType和优先级值控制。如果使用updateOffer调用，并且为要更新的商品定义了此字段，则必须再次提供此字段，即使其值未更改。如果已定义，则在getOffer和getOffers调用中返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.surcharge.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.surcharge.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.additionalShippingCost</td>
<td>Amount</td>
<td>传入此字段的美元值将覆盖当前为适用的送货服务选项设置的额外运费。“额外运费”是使用相应的运输服务将每个额外的相同产品运送给买方的成本。要覆盖的配送策略中的送货服务选项由shippingServiceType和优先级值控制。如果使用updateOffer调用，并且为要更新的商品定义了此字段，则必须再次提供此字段，即使其值未更改。如果已定义，则在getOffer和getOffers调用中返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.additionalShippingCost.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.additionalShippingCost.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.priority</td>
<td>integer</td>
<td>输入此字段的整数值以及shippingServiceType值设置将根据更新的运费修改履行政策中的哪个国内或国际运输服务选项。具体来说，shippingCostOverrides.shippingServiceType一个值createOffer或updateOffer调用必须匹配shippingOptions.optionType在履行上市策略值，以及shippingCostOverrides.priority一个值createOffer或updateOffer调用必须匹配shippingOptions.shippingServices.sortOrderId在履约价值上市政策。在覆盖送货服务选项的运输成本时始终需要此字段，并且将始终为其成本被覆盖的每个送货服务选项返回。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.shippingCost</td>
<td>Amount</td>
<td>传入此字段的美元值将覆盖当前为适用的送货服务选项设置的运费。此值将是使用相应的送货服务将一件商品运送给买家的成本。要覆盖的配送策略中的送货服务选项由shippingServiceType和优先级值控制。如果使用updateOffer调用，并且为要更新的商品定义了此字段，则必须再次提供此字段，即使其值未更改。如果已定义，则在getOffer和getOffers调用中返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.shippingCost.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.shippingCost.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.shippingCostOverrides.shippingServiceType</td>
<td>ShippingServiceTypeEnum</td>
<td>此枚举值指示优先级字段中指定的送货服务是国内还是国际送货服务选项。要在履行列表政策中覆盖特定国内运输服务的运费，应将此字段设置为DOMESTIC，并覆盖每个国际运输服务的运费，此字段应设置为INTERNATIONAL。此值以及优先级值设置将根据更新的运输成本修改的履行政策中的国内或国际运输服务选项。具体来说，createOffer或updateOffer调用中的shippingCostOverrides.shippingServiceType值必须与在配送清单策略中的shippingOptions.optionType值，以及createOffer或updateOffer调用中的shippingCostOverrides.priority值必须与配送清单策略中的shippingOptions.shippingServices.sortOrderId值匹配。在覆盖送货服务选项的运输成本时始终需要此字段，并且将始终为其成本被覆盖的每个送货服务选项返回。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.fulfillmentPolicyId</td>
<td>string</td>
<td>此唯一标识符表示一旦要约发布并转换为eBay列表时将使用的履行列表政策。此履行列表政策将设置eBay列表的所有与履行相关的设置。优惠不是立即需要上市政策，但在发布优惠之前是必需的。卖方应在将配送列表政策分配给要约之前检查配送列表政策，以确保其与库存项目和要约设置兼容。卖方还可能希望查看履行政策中的送货服务费用，并且卖方可能决定通过使用shippingCostOverrides容器来覆盖一个或多个送货服务选项的运费。可以在“我的易趣”或帐户API中创建和管理列表策略。要获取与特定eBay Marketplace上的卖家帐户关联的所有退货政策的列表，请使用Account API的getFulfillmentPolicies调用。Account API中还调用按策略ID或策略名称检索履行策略。如果为商品设置，则会在getOffer和getOffers调用中返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies.ebayPlusIfEligible</td>
<td>boolean</td>
<td>此字段包含在要约中，并设置为true如果最高评级卖家选择加入eBay Plus计划。通过eBay Plus计划，合格的卖家必须承诺在第二天交付商品，并且买家必须拥有eBay Plus订阅才有资格获得此计划的优惠，这些优惠是免费的，次日送达，以及作为免费回报。目前，该计划仅适用于德国和澳大利亚的网站。如果为商品设置，则会在getOffer和getOffers调用中返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>merchantLocationKey</td>
<td>string</td>
<td>商家库存位置的唯一标识符（商品中的库存商品所在的位置）。一个merchantLocationKey，当商户创建一个使用库存位置已确定值createInventoryLocation电话。要获取有关库存位置的更多信息，可以使用getInventoryLocation调用。首次创建要约时，此字段最初不需要，但在要约发布之前将成为必填字段。最大长度：36发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary</td>
<td>PricingSummary</td>
<td>此容器显示产品报价的上市价格，如果适用，还显示最小广告价格和删除线价格功能的设置。最低广告价格功能仅适用于美国站点。Strikethrough定价适用于美国，eBay Motors，英国，德国，加拿大（英语和法语），法国，意大利和西班牙站点。首次创建要约时，最初不需要此容器，但在要约发布之前，将要求提供要约的价格。发生：总是</td>
</tr>
<tr>
<td>pricingSummary.minimumAdvertisedPrice</td>
<td>Amount</td>
<td>如果要约中将使用最低广告价格（MAP）功能，则需要此容器。最低广告价格（MAP）是供应商（或制造商（OEM））与零售商（卖方）之间达成的协议，规定允许广告的最低价格。卖家只能通过使用其他折扣提供低于此价格的价格。MAP功能仅适用于符合条件的美国卖家。如果卖家和/或列表不符合MAP功能的条件，则会忽略此字段。如果为要约设置，则将返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.minimumAdvertisedPrice.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.minimumAdvertisedPrice.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.pricingVisibility</td>
<td>MinimumAdvertisedPriceHandlingEnum</td>
<td>如果要约中将使用最低广告价格（MAP）功能，则需要此字段。此字段仅适用于符合条件的美国卖家使用最低广告价格（MAP）功能且已指定minimumAdvertisedPrice的情况。此字段中设置的值将确定在通过从“查看项目”页面访问的弹出窗口结帐之前是否向潜在买方显示MAP价格，或者如果在买方之后的结帐流程之前未显示MAP价格已经承诺购买该物品。要在结帐前显示MAP价格，卖家会将此值设置为PRE_CHECKOUT。要在买方已承诺购买商品后显示MAP价格，卖家会将此值设置为DURING_CHECKOUT。如果卖家和/或商家信息不符合MAP功能的条件，则会忽略此字段。如果为要约设置，将返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.originallySoldForRetailPriceOn</td>
<td>SoldOnEnum</td>
<td>如果要约中将使用删除线定价（STP）功能，则需要此字段。此字段表示产品在eBay网站上的originalRetailPrice字段中以此价格出售，或由第三方零售商以该价格出售。当使用createOffer或updateOffer调用时，卖家将传递一个值，ON_EBAY表示该产品是在eBay网站上为originalRetailPrice出售的，或者卖家将传递一个值，OFF_EBAY表示该产品是为originalRetailPrice出售的通过第三方零售商。这个字段和originalRetailPrice字段仅适用于卖家和列表有资格使用删除线定价功能的功能，该功能仅限于美国（核心站点和汽车），英国，德国，加拿大（英语和法语版本），法国，意大利和西班牙网站。如果为要约设置，将返回此字段。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.originalRetailPrice</td>
<td>Amount</td>
<td>如果要约中将使用删除线定价（STP）功能，则需要此容器。传入此字段的美元值表示制造商（OEM）设定的原始零售价格。易趣不保留或验证卖方提供的价值。此字段中的美元值应始终大于价格容器中的美元值。此字段和originalSoldForRetailPriceOn字段仅适用于卖家和列表有资格使用删除线定价功能，此功能仅限于美国（核心站点和汽车），英国，德国，加拿大（英语和法语版本），法国，意大利和西班牙的网站。比较originalRetailPrice和价格中的美元价值字段来确定买方的节省金额。对于营销影响，此原始零售价格将具有删除线。如果为要约设置，则将返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.originalRetailPrice.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.originalRetailPrice.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.price</td>
<td>Amount</td>
<td>这是该产品的上市价格。在发布商品之前必须指定商品价格，但可以在没有价格的情况下创建商品。对于已发布的商品，将始终返回此容器，但对于未发布的商品，只有在为商品设置时才会返回此容器。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.price.value</td>
<td>string</td>
<td>以货币字段中指定的货币表示的美元值的字符串表示形式。无论是价值和货币领域都需要/表达价格时总是返回。发生：有条件的</td>
</tr>
<tr>
<td>pricingSummary.price.currency</td>
<td>string</td>
<td>一个三位数字符串值，表示正在使用的货币类型。无论是价值和货币领域都需要/表达价格时总是返回。请参阅CurrencyCodeEnum类型以获取完整的货币列表及其对应的三位数字符串值。发生：有条件的</td>
</tr>
<tr>
<td>quantityLimitPerBuyer</td>
<td>integer</td>
<td>如果卖方希望对每个卖家的购买数量设置限制，则此字段仅适用并设置。如果卖方为要约设置了此字段，则每个不同的买方可以购买最多但不超过为该字段指定的数量。因此，如果该字段的价值是5，每个买方可以购买一到五个这些产品，并且购买可以在一次多次购买或多次交易中进行。如果买方试图购买这些产品中的一种或多种，并且累计数量将使买方超出数量限制，则该买方将被阻止该购买。出现：有条件的</td>
</tr>
<tr>
<td>tax</td>
<td>Tax</td>
<td>只有在销售税表，增值税（VAT）税率或税务例外类别代码将应用于要约时，此容器才适用并使用。只有商业卖家可以在其商品详情中申请增值税。这是可能的applyTax字段将包含的值true，但买家的购买将不涉及营业税。必须在卖方的销售税表中为买方的州/税收管辖区设置销售税率，以便该买方需要缴纳销售税。可以在“我的易趣”的“付款首选项”部分添加/修改不同司法辖区的销售税率，或者卖家可以使用帐户API的销售税调用。请参阅使用税表 帮助页面，了解有关设置和使用销售税表的更多信息。出现：有条件的</td>
</tr>
<tr>
<td>tax.applyTax</td>
<td>boolean</td>
<td>true如果卖方想要参考其帐户级别的销售税表来计算订单的销售税，则将包括此字段并设置为该字段。可以在“我的易趣”的“付款首选项”中手动创建和管理卖家的销售税表。此销售税表包含卖方所在国家/地区的所有税收管辖区域（美国各州和地区），卖方可以为这些税收管辖区域设置销售税率。Trading API具有SetTaxTable调用以添加/修改一个或多个税收管辖区的销售税率，以及GetTaxTable调用将检索所有税收管辖区和相关数据，例如销售税率（如果已定义）和布尔字段表明销售税是否适用于运费和手续费。Account API具有getSalesTaxTable调用以检索具有已定义销售税率的所有税收管辖区，用于检索特定税收辖区的销售税率的getSalesTaxTableEntry调用，用于设置/修改特定税收的销售税率的createSalesTaxTableEntry调用辖区和deleteSalesTaxTableEntry调用，以从特定税收辖区中删除销售税率。请注意，卖方可以启用销售税表，但如果未为买方的州/税收管辖区指定销售税率，则不会对该订单应用销售税。如果使用thirdPartyTaxCategory值，则还必须使用applyTax字段并将其设置为true如果为要约设置，将返回此字段。有关设置和使用销售税表的详细信息，请参阅使用税表帮助页面。发生：有条件的</td>
</tr>
<tr>
<td>tax.thirdPartyTaxCategory</td>
<td>string</td>
<td>税收例外类别代码。如果使用此字段，销售税也将适用于服务/费用，而不仅仅是商品价格。这仅供已选择销售税计算供应商计算的销售税的卖家使用。如果您有兴趣成为eBay的税务计算供应商合作伙伴，请联系developer-relations@ebay.com。该字段的一个受支持的值是WASTE_RECYCLING_FEE。如果使用此字段，则还必须使用applyTaxtrue字段并将其设置为如果为商品设置，则将返回此字段。出现：有条件的</td>
</tr>
<tr>
<td>tax.vatPercentage</td>
<td>number</td>
<td>此值是项目的增值税（VAT）费率（如果有）。如果指定增值税百分比，则项目的增值税信息将显示在商品的“查看项目”页面上。此外，卖家可以选择打印包含商品的净价，增值税百分比，增值税金额和总价的发票。由于增值税税率因项目和用户所在国家/地区而异，因此卖方有责任输入正确的增值税税率; 它不是由eBay计算的。要使用增值税，卖家必须是在eBay注册了增值税ID的商家卖家，并且必须在启用增值税的网站上列出该商品。最大适用长度为6个字符，包括小数（例如12.345）。比例是小数点后3位。（如果您通过12.3456，eBay可能会将该值向上舍入为12.346）。如果为要约设置，将返回此字段。出现：有条件的</td>
</tr>
<tr>
<td>storeCategoryNames</td>
<td>array of string</td>
<td>如果卖家想要将库存物品放入卖家为其易趣店铺设置的一个或两个易趣店铺类别中，则使用此容器。传递给此容器的字符串值将是eBay商店类别的完整路径，如下所示："storeCategoryNames": ["/Fashion/Men/Shirts", "/Fashion/Men/Accessories" ], 出现：有条件的</td>
</tr>
<tr>
<td>lotSize</td>
<td>integer</td>
<td>此字段仅适用于列表是批次列表的情况。很多列表是具有多个相同产品数量的列表。一个例子是一组四个相同的汽车轮胎。传递到此字段的整数值是通过批次列表销售的相同商品的数量。发生：有条件的</td>
</tr>
<tr>
<td>format</td>
<td>FormatTypeEnum</td>
<td>此枚举值表示商品的列表格式。目前，此字段唯一受支持的值是FIXED_PRICE，因为Inventory API目前仅支持固定价格列表。发生：总是</td>
</tr>
<tr>
<td>marketplaceId</td>
<td>MarketplaceEnum</td>
<td>此枚举值是eBay网站的唯一标识符，可供该报价使用。请参阅MarketplaceEnum以获取支持的枚举值列表。这是必填栏。发生：总是</td>
</tr>
<tr>
<td>sku</td>
<td>string</td>
<td>这是将在易趣网站上列出的产品（由marketplaceId字段中指定）的卖方定义的SKU值。每个sku / marketplaceId / 格式组合可能只存在一个要约（未发布或已发布状态）。这是必填栏。最大长度：50发生：总是</td>
</tr>
<tr>
<td>offerId</td>
<td></td>
<td>string</td>
<td>offer的唯一标识符。此标识符用于许多与商品相关的调用，并且还在bulkUpdatePriceQuantity调用中使用。发生：总是</td>
</tr>
<tr>
<td>listing</td>
<td></td>
<td>ListingDetails</td>
<td>对于已发布的商品，此容器始终在getOffer和getOffers调用中返回，并包含与商品关联的易趣商家信息ID，商家信息状态以及通过商家信息销售的数量。该上市容器不会返回在所有的未公开报价。发生：有条件的</td>
</tr>
<tr>
<td>listing.listingId</td>
<td>string</td>
<td>与已发布的商品相关联的易趣商家信息的唯一标识符。发生：有条件的</td>
</tr>
<tr>
<td>listing.listingStatus</td>
<td>ListingStatusEnum</td>
<td>此字段中返回的枚举值指示与已发布商品关联的商品的状态。发生：有条件的</td>
</tr>
<tr>
<td>listing.soldQuantity</td>
<td>integer</td>
<td>此整数值表示已发布商品的销售产品数量。发生：有条件的</td>
</tr>
<tr>
<td>status</td>
<td>OfferStatusEnum</td>
<td>此字段中的枚举值指定商品的状态 - PUBLISHED或者UNPUBLISHED。发生：总是</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>25709</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>{fieldName}的值无效</td>
</tr>
<tr>
<td>25713</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>
<p>示例1：检索库存物料的提供</p>
<p>此调用将检索与卖方的帐户关联的库存项目的特定提供。</p>
<h6>Input</h6>
<p>该OFFERID路径参数是必需的，以指定现有以检索。</p>
<p><strong>GET</strong>
<a href="https://api.ebay.com/sell/inventory/v1/offer/36445435465">https://api.ebay.com/sell/inventory/v1/offer/36445435465</a></p>
<h6>Output</h6>
<p>检索到的优惠处于已发布状态，并且有一个与此优惠相关联的有效eBay列表。项目ID，状态和该列表售出数量显示在列表容器。仍有70个可供购买的数量。 </p>
<p>用于创建eBay列表的履行，付款和退货列表政策在listingPolicies容器下指定。</p>
<pre><code class="language-json">{
"offerId": "36445435465"
"sku": "3455632452345",
"marketplaceId": "EBAY_US",
"format": "FIXED_PRICE",
"availableQuantity": 70,
"categoryId": "30120",
"listing":
{
"listingId": "223412345678",
"listingStatus": "ACTIVE",
"soldQuantity": 5
},
"listingDescription": "Lumia phone with a stunning 5.7 inch Quad HD display and a powerful octa-core processor.",
"listingPolicies":
{
"fulfillmentPolicyId": "37967346010",
"paymentPolicyId": "37967344010",
"returnPolicyId": "37967343010",
},
"pricingSummary":
{
"price":
{
"currency": "USD",
"value": "260.00"
},
},
"quantityLimitPerBuyer": 2,
"status" : "PUBLISHED"
}</code></pre>