createOffer
<h1>createOffer</h1>
<p><strong>POST</strong> /offer</p>
<p>此调用为特定eBay市场上的特定库存项目创建报价。卖家是否想要从一开始就创建完整的报价（包含所有必要的详细信息），或卖家只能通过初始createOffer调用提供一些信息，然后进行一个或多个后续updateOffer调用以完成提供并准备发布报价。首次创建商品时，请求有效负载中需要以下字段： sku，marketplaceId和（listing）格式。</p>
<p>下面突出显示要约发布之前需要的其他信息。可以使用createOffer设置这些设置，或者可以使用后续的updateOffer调用设置它们：</p>
<ul>
<li>库存位置</li>
<li>报价</li>
<li>可用数量</li>
<li>易趣上市类别</li>
<li>参考列出政策配置文件以设置付款，退货和履行价值/设置</li>
</ul>
<p>如果调用成功，则在响应中返回唯一的offerId值。许多其他与报价相关的呼叫将需要此值。请注意，此调用仅提供发布要约。卖方必须运行publishOffer调用才能将要约转换为有效的易趣列表。</p>
<p>除了authorization所有eBay REST API调用所需的标头之外，createOffer调用还需要Content-Language标头，该标头设置将在请求有效负载的字段值中使用的自然语言。对于美国英语，此标头中传递的代码值应为en-US。要查看其他受支持的Content-Language值，并阅读有关eBay REST API调用的所有支持的HTTP标头的更多信息，请参阅使用eBay RESTful API文档中的<a href="https://developer.ebay.com/api-docs/static/rest-request-components.html#HTTP" title="HTTP请求标头">HTTP请求标头</a>主题。</p>
<p>对于那些喜欢通过一次调用创建多个商品（一次最多25个）的人，可以使用bulkCreateOffer方法。</p>
<h6>Input</h6>
<h6>Resource URI (production)</h6>
<p>POST <a href="https://api.ebay.com/sell/inventory/v1/offer">https://api.ebay.com/sell/inventory/v1/offer</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>
<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>流创建的访问令牌，使用以下列表中的一个范围：</p>
<p><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">{
"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",
"sku": "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]",
"format": "FormatTypeEnum : [FIXED_PRICE]"
}</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>availableQuantity</td>
<td>integer</td>
<td>此整数值设置在marketplaceId字段中指定的eBay站点上购物的买家可以购买的库存项目数量（由sku值指定）。必须将数量设置为或更多才能使库存项目可购买，但如果已在库存项目记录中设置了库存项目的一般数量，则即使对于已发布的要约，也不一定需要此字段。1发生：有条件的</td>
</tr>
<tr>
<td>categoryId</td>
<td>string</td>
<td>库存项目将在其下列出的易趣类别的唯一标识符。创建要约时不会立即要求此字段，但在发布要约之前将需要此字段。卖方可以使用Taxonomy API 的getCategorySuggestions方法或Trading API 的GetSuggestedCategories调用来检索建议的类别ID值。卖家传递一个类似“ iPhone 6 ” 的查询字符串，并在响应中返回建议类别的类别ID值。发生：有条件的</td>
</tr>
<tr>
<td>listingDescription</td>
<td>string</td>
<td>易趣上市的描述。除非定义了库存项目记录中的product.description字段，否则在发布单变量要约之前有条件地需要此字段，在该情况下，该特定字段中的文本将成为列表描述。类似地，除非定义了库存项目组记录中的描述字段，否则在发布多变量要约之前还有条件地要求该字段，在这种情况下，该特定字段中的文本将成为列表描述。但是，如果提供此字段，则此字段中的文本将覆盖为库存项目或库存项目组提供的任何描述。列表说明中支持HTML标记标记，但请记住，这些标记标记会转到此字段的最大字符限制。最大长度：500000;发生：有条件的</td>
</tr>
<tr>
<td>listingPolicies</td>
<td>ListingPolicies</td>
<td>此容器用于设置将用于构建列表的列表策略。此容器包含与eBay列表相关联的付款，退货和履行列表政策的标识符。首次创建要约时，最初不需要此容器，但在要约发布之前将需要此容器。在通过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>sku</td>
<td>string</td>
<td>这是将在易趣网站上列出的产品（由marketplaceId字段中指定）的卖方定义的SKU值。每个sku / marketplaceId / 格式组合可能只存在一个要约（未发布或已发布状态）。这是必填栏。最大长度：50发生：必需</td>
</tr>
<tr>
<td>marketplaceId</td>
<td>MarketplaceEnum</td>
<td>此枚举值是eBay网站的唯一标识符，可供该报价使用。请参阅MarketplaceEnum以获取支持的枚举值列表。这是必填栏。发生：必需</td>
</tr>
<tr>
<td>format</td>
<td>FormatTypeEnum</td>
<td>此枚举值表示商品的列表格式。目前，此字段唯一受支持的值是FIXED_PRICE，因为Inventory API目前仅支持固定价格列表。发生：必需</td>
</tr>
</tbody>
</table>
<h6>Output</h6>
<h6>HTTP response headers</h6>
<p>有关详细信息，请参阅<a href="https://developer.ebay.com/devzone/rest/ebay-rest/content/rest-response-components.html#HTTP2" title="HTTP响应头">HTTP响应头</a></p>
<table>
<thead>
<tr>
<th>Header</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Language</td>
<td>此响应标头设置将在响应有效负载的字段值中提供的自然语言。</td>
</tr>
</tbody>
</table>
<h6>Response payload</h6>
<pre><code class="language-json">{
"warnings": [
{
"errorId": "integer",
"domain": "string",
"subdomain": "string",
"category": "string",
"message": "string",
"parameters": [
{
"value": "string",
"name": "string"
}
],
"longMessage": "string",
"inputRefIds": [
"string"
],
"outputRefIds": [
"string"
]
}
],
"offerId": "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>warnings</td>
<td>array of ErrorDetailV3</td>
<td>如果在进行Inventory API调用时触发了一个或多个警告或错误，则此容器将在调用响应有效内容中返回。此容器将包含有关错误或警告的详细信息。发生：有条件的</td>
</tr>
<tr>
<td>warnings.errorId</td>
<td>integer</td>
<td>唯一代码，用于标识发生的特定错误或警告。您的应用程序可以在自定义错误处理算法中使用错误代码作为标识符。发生：有条件的</td>
</tr>
<tr>
<td>warnings.domain</td>
<td>string</td>
<td>发生错误或警告的域的名称。发生：有条件的</td>
</tr>
<tr>
<td>warnings.subdomain</td>
<td>string</td>
<td>发生错误或警告的子域的名称。发生：有条件的</td>
</tr>
<tr>
<td>warnings.category</td>
<td>string</td>
<td>此字符串值表示错误类别。有三类错误：请求错误，应用程序错误和系统错误。发生：有条件的</td>
</tr>
<tr>
<td>warnings.message</td>
<td>string</td>
<td>导致错误或警告的条件的描述。发生：有条件的</td>
</tr>
<tr>
<td>warnings.parameters</td>
<td>array of ErrorParameterV3</td>
<td>各种警告和错误消息返回一个或多个变量，这些变量包含有关错误或警告的上下文信息。这通常是触发错误或警告的字段或值。发生：有条件的</td>
</tr>
<tr>
<td>warnings.parameters.value</td>
<td>string</td>
<td>这是为name字段中指定的元素传递的实际值。发生：有条件的</td>
</tr>
<tr>
<td>warnings.parameters.name</td>
<td>string</td>
<td>这是导致调用请求出现问题的输入字段的名称。发生：有条件的</td>
</tr>
<tr>
<td>warnings.longMessage</td>
<td>string</td>
<td>导致错误或警告的条件的详细说明，以及有关如何解决问题的信息。发生：有条件的</td>
</tr>
<tr>
<td>warnings.inputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关联最密切的特定请求元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>warnings.outputRefIds</td>
<td>array of string</td>
<td>一个或多个引用ID的数组，用于标识与错误或警告关系最密切的特定响应元素（如果有）。发生：有条件的</td>
</tr>
<tr>
<td>offerId</td>
<td>string</td>
<td>通过createOffer调用创建的商品的唯一标识符，或者仅使用updateOffer调用更新的商品的唯一标识符。如果createOffer调用无法创建商品，则不会返回。许多与报价相关的呼叫都需要此标识符。发生：有条件的</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>201</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>25702</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>无法找到{skuValue}或系统中无法使用。</td>
</tr>
<tr>
<td>25709</td>
<td>API_INVENTORY</td>
<td>请求</td>
<td>{fieldName}的值无效</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>
<h6>Input</h6>
<p>此调用不需要查询或URI路径参数。 </p>
<p>将为sku字段中指定的库存项目创建商品。该库存商品的总数量将在eBay美国网站上出售。此优惠的促销价为272.17美元。卖方已将单个购买者可以购买的商品数量限制为两个。 </p>
<p>将用于易趣列表的履行，付款和退货列表政策在listingPolicies容器下指定。卖家可以在“我的易趣”的“业务政策”部分中创建和编辑列表政策，也可以通过卖家帐户API中的列表政策调用来创建和编辑。</p>
<p><strong>POST</strong>
<a href="https://api.ebay.com/sell/inventory/v1/offer">https://api.ebay.com/sell/inventory/v1/offer</a></p>
<pre><code class="language-json">{
"sku": "3455632452345",
"marketplaceId": "EBAY_US",
"format": "FIXED_PRICE",
"availableQuantity": 75,
"categoryId": "30120",
"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": "272.17"
}
},
"quantityLimitPerBuyer": 2
}</code></pre>
<h6>Output</h6>
<p>成功创建商品后，eBay会创建一个唯一的offerId值，并在通话响应中返回。</p>
<pre><code class="language-json">{
"offerId": "36445435465"
}</code></pre>