bulkCreateOrReplaceInventoryItem

<h1>bulkCreateOrReplaceInventoryItem</h1> <p><strong>POST</strong> /bulk_create_or_replace_inventory_item</p> <pre><code>注意：请注意，使用Inventory API创建的任何eBay列表都无法使用Trading API调用进行修订或重新发布。</code></pre> <p>此调用可用于创建和/或更新最多25个新的库存项目记录。卖家是否想要从一开始就创建完整的库存项目记录，或者卖家只能通过初始 bulkCreateOrReplaceInventoryItem调用提供一些信息，然后进行一个或多个额外的 bulkCreateOrReplaceInventoryItem调用以完成库存的所有必填字段。项目记录并准备发布。首次创建库存物料记录时，仅需要SKU值。</p> <p>在更新现有库存物料记录的情况下，bulkCreateOrReplaceInventoryItem调用将完全替换现有库存项目记录，因此无论其值是否更改，在该更新操作中都需要当前为库存项目记录定义的所有字段。因此，在更换/更新库存项目记录时，建议卖方运行“获取”调用以检索库存项目记录的完整详细信息，并在尝试更新记录之前查看其所有当前值/设置。对作为一个或多个有效eBay列表的一部分的库存项目记录所做的任何更改，成功的调用将自动更新这些活动列表。</p> <p>使用bulkCreateOrReplaceInventoryItem调用设置的关键信息包括：</p> <ul> <li>卖方定义的产品SKU值。每个卖家产品（包括商品库存组中的产品）必须具有自己的SKU值。</li> <li>项目的条件 </li> <li>产品详细信息，包括任何产品标识符，例如UPC，ISBN，EAN或品牌/制造商部件号对，产品描述，产品标题，产品/项目方面以及图像链接。易趣将使用任何提供的易趣产品ID（ePID）或GTIN（UPC，ISBN或EAN），并尝试将这些标识符与易趣目录中的产品相匹配，如果找到产品匹配，则清单的产品详细信息项目将自动填充。</li> <li>可供购买的库存物料的数量</li> <li>包装重量和尺寸，如果卖家提供计算的运输选项，则需要包装。如果卖家提供统一运费服务，但需要收取重量附加费，也需要包裹重量。</li> </ul> <p>除了authorization所有eBay REST API调用所需的标头之外，bulkCreateOrReplaceInventoryItem调用还需要Content-Language标头，该标头设置将在请求有效负载的字段值中使用的自然语言。对于美国英语，此标头中传递的代码值应为en-US。要查看其他受支持的Content-Language值，并阅读有关eBay REST API调用的所有支持的HTTP标头的更多信息，请参阅使用eBay RESTful API文档中的HTTP请求标头主题。</p> <p>对于那些更喜欢创建或更新单个库存物料记录的人，可以使用createOrReplaceInventoryItem方法。</p> <h6>Input</h6> <p><strong>Resource URI (production)</strong></p> <pre><code>POST https://api.ebay.com/sell/inventory/v1/bulk_create_or_replace_inventory_item</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>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">{ "requests": [ { "availability": { "pickupAtLocationAvailability": [ { "availabilityType": "AvailabilityTypeEnum : [IN_STOCK,OUT_OF_STOCK,SHIP_TO_STORE]", "fulfillmentTime": { "unit": "TimeDurationUnitEnum : [YEAR,MONTH,DAY,HOUR,CALENDAR_DAY,BUSINESS_DAY,MINUTE,SECOND,MILLISECOND]", "value": "integer" }, "merchantLocationKey": "string", "quantity": "integer" } ], "shipToLocationAvailability": { "quantity": "integer" } }, "condition": "ConditionEnum : [NEW,LIKE_NEW,NEW_OTHER,NEW_WITH_DEFECTS,MANUFACTURER_REFURBISHED,SELLER_REFURBISHED,USED_EXCELLENT,USED_VERY_GOOD,USED_GOOD,USED_ACCEPTABLE,FOR_PARTS_OR_NOT_WORKING]", "conditionDescription": "string", "packageWeightAndSize": { "dimensions": { "height": "number", "length": "number", "unit": "LengthUnitOfMeasureEnum : [INCH,FEET,CENTIMETER,METER]", "width": "number" }, "packageType": "PackageTypeEnum : [LETTER,BULKY_GOODS,CARAVAN,CARS,EUROPALLET,EXPANDABLE_TOUGH_BAGS,EXTRA_LARGE_PACK,FURNITURE,INDUSTRY_VEHICLES,LARGE_CANADA_POSTBOX,LARGE_CANADA_POST_BUBBLE_MAILER,LARGE_ENVELOPE,MAILING_BOX,MEDIUM_CANADA_POST_BOX,MEDIUM_CANADA_POST_BUBBLE_MAILER,MOTORBIKES,ONE_WAY_PALLET,PACKAGE_THICK_ENVELOPE,PADDED_BAGS,PARCEL_OR_PADDED_ENVELOPE,ROLL,SMALL_CANADA_POST_BOX,SMALL_CANADA_POST_BUBBLE_MAILER,TOUGH_BAGS,UPS_LETTER,USPS_FLAT_RATE_ENVELOPE,USPS_LARGE_PACK,VERY_LARGE_PACK,WINE_PAK]", "weight": { "unit": "WeightUnitOfMeasureEnum : [POUND,KILOGRAM,OUNCE,GRAM]", "value": "number" } }, "product": { "aspects": [ "string" ], "brand": "string", "description": "string", "imageUrls": [ "string" ], "mpn": "string", "subtitle": "string", "title": "string", "isbn": [ "string" ], "upc": [ "string" ], "ean": [ "string" ], "epid": "string" }, "sku": "string", "locale": "LocaleEnum : [en_US,en_CA,fr_CA,en_GB,en_AU,en_IN,de_AT,fr_BE,fr_FR,de_DE,it_IT,nl_BE,nl_NL,es_ES,de_CH,fi_FI,zh_HK,hu_HU,en_PH,pl_PL,pt_PT,ru_RU,en_SG,en_IE,en_MY]" } ] }</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 InventoryItemWithSkuLocale</td> <td>正在创建或更新的每个库存项目的详细信息将在此容器下传递。使用一个bulkCreateOrReplaceInventoryItem调用最多可以创建和/或更新25个库存项目记录。发生：必需</td> </tr> <tr> <td>availability</td> <td>Availability</td> <td>此容器用于指定可供购买的库存物料的数量。在卖方准备与SKU一起发布要约之前，此容器是可选的，此时它是必需的。如果正在更新库存项目并且该库存项目的可用性数据已存在，则还必须传递可用性数据。由于库存项目在要约中发布之前必须具有指定数量，因此该容器始终在针对已发布要约的SKU的“获取”调用中返回。如果SKU不是已发布商品的一部分，则仅在为库存商品设置时才会返回此容器。发生：有条件的</td> </tr> <tr> <td>availability.pickupAtLocationAvailability</td> <td>array of PickupAtLocationAvailability</td> <td>该容器由一个或多个商家的实体店位置组成，其中库存项目可用于店内提货订单。商家的位置，可用数量和履行时间（订单发生后物品准备好接收的时间）都在此容器中。店内提货仅适用于在美国，英国，德国和澳大利亚网站销售的大型商家。出现：可选</td> </tr> <tr> <td>availability.pickupAtLocationAvailability.availabilityType</td> <td>AvailabilityTypeEnum</td> <td>此字段中的枚举值指示由pickupAtLocationAvailability.merchantLocationKey字段指定的商家实体店中的库存项目的可用性状态。如果使用了pickupAtLocationAvailability容器，则此字段是必需的，并且始终使用pickupAtLocationAvailability容器返回。有关使用每个枚举值的方式/ 时间的详细信息，请参阅AvailabilityTypeEnum。发生：有条件的</td> </tr> <tr> <td>availability.pickupAtLocationAvailability.fulfillmentTime</td> <td>TimeDuration</td> <td>此容器用于指示在订单发生后买方可以立即获取店内提货订单。如果使用了pickupAtLocationAvailability容器，则此容器是必需的，并且始终使用pickupAtLocationAvailability容器返回。发生：有条件的</td> </tr> <tr> <td>availability.pickupAtLocationAvailability.fulfillmentTime.unit</td> <td>TimeDurationUnitEnum</td> <td>此枚举值指示用于指定履行时间的时间单位，例如HOUR。发生：有条件的</td> </tr> <tr> <td>availability.pickupAtLocationAvailability.fulfillmentTime.value</td> <td>integer</td> <td>此字段中的整数值以及单位字段中的时间单位将指示买家在店内提货购买后多久可以在指定的商店位置领取商品。如果此字段4的值为，且单位字段的值为HOUR，则店内提货订单的履行时间为四小时，这意味着买方将能够在商店提取物品四小时交易发生后。发生：有条件的</td> </tr> <tr> <td>availability.pickupAtLocationAvailability.merchantLocationKey</td> <td>string</td> <td>店内提货库存项目当前所在的商家商店的唯一标识符，或库存将被发送到的商店。如果商家的商店当前正在等待库存，那么availabilityType值应该是SHIP_TO_STORE。如果使用了pickupAtLocationAvailability容器，则此字段是必需的，并且始终使用pickupAtLocationAvailability容器返回。最大长度：36发生：有条件的</td> </tr> <tr> <td>availability.pickupAtLocationAvailability.quantity</td> <td>integer</td> <td>此整数值表示在merchantLocationKey值标识的商店中可用于店内代答的库存项目数量。除非库存商品缺货，否则数量值应为大于的整数值0。如果使用了pickupAtLocationAvailability容器，则此字段是必需的，并且始终使用pickupAtLocationAvailability容器返回。发生：有条件的</td> </tr> <tr> <td>availability.shipToLocationAvailability</td> <td>ShipToLocationAvailability</td> <td>此容器指定可在一个或多个eBay市场上购买的库存物料的数量。出现：可选</td> </tr> <tr> <td>availability.shipToLocationAvailability.quantity</td> <td>integer</td> <td>此容器用于设置可通过一个或多个已发布的商品购买的库存商品的总“发货到户”数量。此容器不是立即需要的，但必须在发布库存物品的报价之前设置“发货到户”数量。如果正在更新现有库存物料，并且库存物料记录已存在“发货至库存”数量，则应再次包含此容器，即使该值未更改，或者可用数量数据将丢失。发生：有条件的</td> </tr> <tr> <td>condition</td> <td>ConditionEnum</td> <td>此枚举值表示项目的条件。支持的项目条件值将因易趣网站和类别而异。要查看特定eBay类别支持的项条件值，请使用Metadata API的getItemConditionPolicies调用，将类别ID作为查询参数传递。可以在getItemConditionPolicies Call Reference页面上找到正确的语法。支持的项目条件将在getItemConditionPolicies响应的itemConditions容器下返回。该itemConditions容器将包括conditionId和conditionDescription值。该conditionId值必须与ConditionEnum类型中定义的枚举值匹配。有关映射信息，请参阅此类型文档，因为必须在条件字段中指定此类型中的一个值。在卖方准备与SKU发布要约之前，此字段是可选的，此时它将成为必需。由于必须在要约中发布之前指定库存项目的条件，因此该字段始终在作为已发布要约的一部分的SKU的“获取”调用中返回。如果SKU不是已发布商品的一部分，则仅在为库存商品设置时才会返回此容器。发生：有条件的</td> </tr> <tr> <td>conditionDescription</td> <td>string</td> <td>该字符串字段用于卖方更清楚地描述使用库存项目的条件，或对库存物料，其条件值不NEW，LIKE_NEW，NEW_OTHER，或NEW_WITH_DEFECTS。该conditionDescription场适用于所有类别的易趣。如果conditionDescription字段与其中一个新条件（前一段中提到）中的项目一起使用，eBay将忽略此字段（如果包含），eBay将向用户返回警告消息。此字段仅用于进一步阐明所用项目的状况。它不应用于品牌，促销，运输，退货，付款或与使用过的商品的状态无关的其他信息。确保条件值，条件描述，列表描述和项目图片不会相互矛盾。此字段并不总是必需的，但如果正在更新库存项目并且该库存项目已存在条件描述，则需要此字段。如果为使用过的库存项目提供了条件描述，则会在getInventoryItem和getInventoryItems调用中返回此字段。最大长度：1000。出现：可选</td> </tr> <tr> <td>packageWeightAndSize</td> <td>PackageWeightAndSize</td> <td>如果卖方为库存物品提供一个或多个计算的运输选项，或者卖方提供统一运费但包含基于物品重量的运费附加费，则使用此容器。此容器用于指定运输包装的尺寸和重量。此容器并不总是必需的，但如果正在更新库存项目并且该库存项目已存在装运包数据，则需要此容器。如果为库存项目指定了包类型，包装重量和/或包装尺寸，则在getInventoryItem和getInventoryItems调用中返回此容器。有关计算出货的详细信息，请参阅计算出货帮助页面。发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.dimensions</td> <td>Dimension</td> <td>此容器用于指示将用于运送库存物料的装运包的长度，宽度和高度。使用计算出货时，需要运输包装的尺寸。如果为库存物料设置了包装尺寸，则将返回此容器。发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.dimensions.height</td> <td>number</td> <td>运输包装的实际高度（在单位字段中指定的测量单位）。如果指定了包维，则需要维度容器的所有字段。如果运输包装的长度为21.5英寸，宽度为15.0英寸，高度为12.0英寸，则尺寸容器的外观如下："dimensions": {"length": 21.5,"width": 15.0,"height": 12.0,"unit": "INCH"} 发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.dimensions.length</td> <td>number</td> <td>运输包装的实际长度（在单位字段中指定的测量单位）。如果指定了包维，则需要维度容器的所有字段。如果运输包装的长度为21.5英寸，宽度为15.0英寸，高度为12.0英寸，则尺寸容器的外观如下："dimensions": {"length": 21.5,"width": 15.0,"height": 12.0,"unit": "INCH"} 发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.dimensions.unit</td> <td>LengthUnitOfMeasureEnum</td> <td>用于指定运输包装尺寸的计量单位。如果指定了包维，则需要维度容器的所有字段。如果使用英语测量系统，则尺寸单位的适用值为FEET和INCH。如果使用公制测量系统，则重量单位的适用值为METER和CENTIMETER。公制系统被美国以外的大多数国家使用。发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.dimensions.width</td> <td>number</td> <td>运输包装的实际宽度（在单位字段中指定的测量单位）。如果指定了包维，则需要维度容器的所有字段。如果运输包装的长度为21.5英寸，宽度为15.0英寸，高度为12.0英寸，则尺寸容器的外观如下："dimensions": {"length": 21.5,"width": 15.0,"height": 12.0,"unit": "INCH"} 发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.packageType</td> <td>PackageTypeEnum</td> <td>此枚举值指示用于运送库存物料的装运包的类型。可以在PackageTypeEnum类型中找到此字段支持的值。如果为库存项目设置了包类型，则将返回此字段。发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.weight</td> <td>Weight</td> <td>此容器用于指定将用于运送库存物料的装运包的重量。如果使用计算运费，或者使用固定运费，但需要重量附加费，则需要运输包裹的重量。如果为库存料品设置了包装重量，则会返回此栏位。发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.weight.unit</td> <td>WeightUnitOfMeasureEnum</td> <td>用于指定运输包装重量的计量单位。两个单元和值，如果字段是必需的重量，使用的容器。如果使用英制测量系统，则重量单位的适用值为POUND和OUNCE。如果使用公制测量系统，则重量单位的适用值为KILOGRAM和GRAM。公制系统被美国以外的大多数国家使用。发生：有条件的</td> </tr> <tr> <td>packageWeightAndSize.weight.value</td> <td>number</td> <td>运输包装的实际重量（在单位字段中指定的测量单位）。两个单元和值，如果字段是必需的重量，使用的容器。如果运输包装重20.5盎司，则容器看起来如下：“重量”：{ “值”：20.5，“单位”：“OUNCE” }发生：有条件的</td> </tr> <tr> <td>product</td> <td>Product</td> <td>此容器用于定义产品详细信息，例如产品标题，产品描述，产品标识符（eBay产品ID，GTIN或品牌/ MPN对），产品方面/项目细节和产品图像。请注意，可以使用易趣产品ID（ePID）或全球贸易项目编号（GTIN）值来尝试在易趣目录中查找匹配的产品。如果找到产品匹配，则库存项目记录将自动获取与eBay目录产品相关的所有产品详细信息。注意：对于美国，英国，CA（英语）和AU网站，eBay开始要求某些eBay类别中的某些产品与eBay目录产品相关联。有关此要求的详细信息，请参阅中的基于产品的购物体验手册主题销售集成指南。为了找到eBay目录产品匹配，ePID值始终优先于其他产品标识符，因为一个GTIN值可能与多个eBay目录产品相关联，如果找到多个产品，产品详细信息将不被Inventory Item对象选中。许多易趣类别不要求列表与易趣目录产品相关联，但需要至少一个产品标识符（GTIN或品牌/ MPN对）。要发现易趣类别需要或支持的产品标识符，请使用Trading API中的 GetCategoryFeatures调用。在呼叫请求中，包括四个 FeatureID字段并将这些字段中的值设置为EANEnabled，ISBNEnabled，UPCEnabled和BrandMPNIdentifierEnabled。在呼叫响应中，在“ 类别”节点下查找这些相同的字段名称。在EANEnabled，ISBNEnabled，UPCEnabled字段中返回的值将是Enabled（支持GTIN类型但不是必需的），Required（必须为库存项目提供GTIN类型），或者Disabled（类别不支持GTIN类型）。该BrandMPNIdentifierEnabled是一个布尔字段和true值表示，卖方必须提供品牌和MPN值。理想情况下，如果卖方需要/支持GTIN类型或品牌/ MPN对，则应为库存项目提供这些产品标识符。在某些情况下，可能需要产品标识符类型，但不知道/适用于产品。如果是这种情况，卖方仍必须在库存项目记录中包含相应的字段，但是传入默认文本字符串。此文本字符串可能因站点而异，因此卖家应使用Trading API 的GeteBayDetails调用来获取此字符串值。在GeteBayDetails调用中，卖方应包含一个DetailName字段，其值设置为ProductDetails。在通话响应中，卖家可以看到默认的字符串值ProductDetails.ProductIdentifierUnavailableText字段。如果产品ID未知或不适用，卖方将在一个或多个产品标识符字段（ean，isbn，upc或mpn）中使用此值。此容器最初不是必需的，但在库存项目可以作为要约发布之前和/或如果正在更新库存项目并且该库存项目的产品数据已存在之前，则需要此容器。始终为getInventoryItem，bulkGetInventoryItem和getInventoryItems中的已发布商品返回此容器调用，因为必须为已发布的商品定义商品数据，但对于未发布的库存商品，只有在为库存商品定义了商品详细信息时才会返回此容器。发生：有条件的</td> </tr> <tr> <td>product.aspects</td> <td>array of string</td> <td>这是一组特定于项目的对，提供有关产品的更多信息，并可能使买家更容易找到。要查看特定易趣类别的必需/推荐产品方面/项目细节名称（和相应值），卖家可以使用交易API 的GetCategorySpecifics调用。或者，卖家可以在同一类别的eBay.com上查看类似的商品，以了解其他卖家正在使用的产品方面/商品细节。卖家还必须指定一个eBay的产品ID（EPID）或可选地，通过在相应的领域全球贸易项目代码（GTIN）的期权产品容器试图在易趣目录中找到产品匹配。如果根据ePID或GTIN值找到匹配项，则为新建/更新的库存项目将自动获取为eBay目录产品定义的产品方面。下面是手动输入项目细节时使用的正确JSON语法的示例："aspects": {"Brand": ["GoPro"],"Storage Type": ["Removable"]}请注意，将成为库存项目组和多变量列表一部分的库存项目应具有为库存项目组定义的相同属性。如果为库存物料定义了一个或多个物料特定对，则将返回此容器。Aspect Name的最大长度：40 Aspect值的最大长度：50;发生：有条件的</td> </tr> <tr> <td>product.brand</td> <td>string</td> <td>该产品的品牌。该字段通常与mpn字段配对，以通过制造部件号识别特定产品。如果易趣类别需要制造商部件号（MPN）值，则有条件地需要此字段。如果eBay能够在提供eBay产品ID（ePID）或GTIN值（UPC，ISBN或EAN）时在eBay目录中找到产品匹配，则该eBay目录产品的所有产品详细信息均由库存项目选取如果createOrUpdateInventoryItem调用成功，则记录（包括品牌）。如果为库存物料定义，则返回此字段。如果品牌通过createOrReplaceInventoryItem中的aspects数组作为项特定名称 - 值对传入打电话，这个价值也被品牌领域所吸引。最大长度：65;发生：有条件的</td> </tr> <tr> <td>product.description</td> <td>string</td> <td>产品说明。可以使用createOrReplaceInventoryItem调用添加或修改现有库存项的描述。如果卖方指定了易趣产品ID（ePID）或全球贸易项目编号（GTIN），并且易趣能够在易趣目录中找到匹配的产品，则会自动填充库存项目的描述。请注意，此字段是可选的，但建议使用。如果在创建和发布单变体商品时省略了listingDescription字段，则将使用此字段中的文本。如果库存项目的product.description字段和商品的listingDescription字段都不存在，则publishOffer电话会失败。如果库存项目将是库存项目组/多变量列表的一部分，则该字段应该用于指定相应的产品变体如何不同（例如，这是衬衫的绿色，超大版本）。但是，对于库存项目组，库存项目组的说明字段中的文本将成为实际eBay列表的列表描述，而不是此字段中的文本。支持基本HTML标记，包括以下标记：<code><b><strong><br><ol><ul><li></code>表标签包括<code><table>，<tr>，<td>，<th>，<thead>，<tfoot>，<tbody>，<caption>，<colgroup>和<col></code>卖家不能在其列表说明中使用任何有效内容。活动内容包括通过JavaScript，Flash，插件或表单操作的动画或视频。如果为库存物料定义，则返回此字段。如果在创建/修改库存项目并且在易趣目录中找到产品匹配时传入了其中一种GTIN类型（例如UPC），则产品描述是从目录产品中获取的详细信息之一。最大长度：4000;发生：有条件的</td> </tr> <tr> <td>product.imageUrls</td> <td>array of string</td> <td>用于产品图像的一个或多个链接的数组。URL必须使用“HTTPS”协议。图像可以由卖家自行托管，或者卖家可以使用Trading API 的UploadSiteHostedPictures调用将图像上传到eBay图片服务器。如果成功，UploadSiteHostedPictures调用的响应将包含eBay图片服务器上图像的完整URL。这是将通过imageUrls数组传递的URL 。在发布商品之前，库存商品必须至少存在一个图像。大多数eBay网站免费支持多达12张图片，eBay Motors列表最多可支持24张图片。如果卖家指定了易趣产品ID（ePID）或全球贸易项目编号（GTIN），并且易趣能够在易趣目录中找到匹配的产品，则可以自动为库存项目填充产品库存图像的链接。对于作为已发布报价的一部分的库存项目，将始终返回此容器，因为已发布的报价始终至少包含一张图片，但只有在为不属于已发布报价的库存项目定义的情况下才会返回此容器。发生：有条件的</td> </tr> <tr> <td>product.mpn</td> <td>string</td> <td>产品的制造商部件号（MPN）。该字段与品牌字段配对以识别产品。一些易趣类别需要MPN值。Trading API 的GetCategorySpecifics调用可用于查看类别是否需要MPN。如果卖方指定了eBay产品ID（ePID）或全球贸易项目编号（GTIN），并且eBay能够在eBay目录中找到匹配的产品，则可以自动为库存项目填充产品的MPN值。如果为库存物料定义，则返回此字段。如果MPN作为特定于项目的名称 - 值对通过createOrReplaceInventoryItem调用中的aspects数组传递，则该值也由mpn拾取领域。最大长度：65;发生：有条件的</td> </tr> <tr> <td>product.subtitle</td> <td>string</td> <td>字幕是可选的列表功能，允许卖家提供有关产品的更多信息，可能包括可能有助于搜索结果的关键字。如果使用字幕，将向卖家收取额外的上市费用。有关在美国网站上使用列表字幕的详细信息，请参阅向列表帮助页面添加字幕。可以使用createOrReplaceInventoryItem调用添加，修改或删除现有库存项目的副标题。请注意，对于将成为库存项目组一部分的每个库存项目，应使用相同的字幕文本，并最终成为多变体列表中的一个产品变体。仅当为库存项目设置时，才会返回此字段。最大长度：55;出现：可选</td> </tr> <tr> <td>product.title</td> <td>string</td> <td>可以使用createOrReplaceInventoryItem调用添加或修改库存项目的标题。虽然不是立即需要，但在发布库存项目的报价之前将需要标题。如果卖方指定了易趣产品ID（ePID）或全球贸易项目编号（GTIN），并且易趣能够在易趣目录中找到匹配的产品，则会自动填充库存项目的标题。如果库存项目将成为单一变更要约的一部分，并且该列表不是基于产品的列表，则此字段中的文本将成为已发布要约的实际列表标题。但是，如果库存项目将成为多变量要约的一部分，则标题中的文本相反，库存物品组实体的字段实际上将成为已发布商品的商品标题，尽管仍可以为库存商品提供商品名称，它实际上将成为变体的标题。对于作为已发布要约的一部分的库存项，将始终返回此字段，因为已发布的要约将始终具有列表标题，但仅当为不属于已公布要约的库存项目定义时，才会返回此字段。最大长度：80;发生：有条件的</td> </tr> <tr> <td>product.isbn</td> <td>array of string</td> <td>产品的国际标准书号（ISBN）值。虽然在尝试在易趣目录中查找产品匹配时首选ePID值，但此字段也可用于尝试在易趣目录中查找产品匹配。如果在易趣目录中找到产品匹配，则库存项目会自动填充可用的产品详细信息，例如标题，产品描述，产品方面（包括指定的ISBN值）以及指向任何库存图像的链接。目录产品。如果为库存物料定义，则返回此字段。如果ISBN通过createOrReplaceInventoryItem调用中的aspects数组作为项特定名称 - 值对传入，则isbn也会获取此值领域。出现：可选</td> </tr> <tr> <td>product.upc</td> <td>array of string</td> <td>产品的通用产品代码（UPC）值。虽然在尝试在易趣目录中查找产品匹配时首选ePID值，但此字段也可用于尝试在易趣目录中查找产品匹配。如果在易趣目录中找到产品匹配，则库存项目会自动填充可用的产品详细信息，例如标题，产品描述，产品方面（包括指定的UPC值）以及指向任何库存图像的链接。目录产品。如果为库存物料定义，则返回此字段。如果通过createOrReplaceInventoryItem调用中的aspects数组将UPC作为项特定的名称 - 值对传入，则upc字段也会拾取此值。出现：可选</td> </tr> <tr> <td>product.ean</td> <td>array of string</td> <td>产品的欧洲产品编号/国际产品编号（EAN）。虽然在尝试在易趣目录中查找产品匹配时首选ePID值，但此字段也可用于尝试在易趣目录中查找产品匹配。如果在易趣目录中找到产品匹配，则库存项目会自动填充可用的产品详细信息，例如标题，产品描述，产品方面（包括指定的EAN值）以及指向任何库存图像的链接。目录产品。如果为库存物料定义，则返回此字段。如果通过createOrReplaceInventoryItem调用中的aspects数组将EAN作为项特定的名称 - 值对传入，则该值也会被ean拾取领域。出现：可选</td> </tr> <tr> <td>product.epid</td> <td>string</td> <td>产品的易趣产品标识符（ePID）。此字段可用于直接识别易趣目录产品。根据其指定的ePID值，易趣将在易趣目录中搜索产品，如果找到匹配项，库存项目将自动填充可用的产品详细信息，例如产品标题，产品描述，产品方面和链接目录产品存在的任何库存图像。如果为库存物料定义，则返回此字段。注意：对于美国，英国，CA（英语）和AU网站，eBay开始要求某些eBay类别中的某些产品与eBay目录产品相关联。有关此要求的详细信息，请参阅中的基于产品的购物体验手册主题销售集成指南。为了找到eBay目录产品匹配，ePID值始终优先于其他产品标识符，因为一个GTIN值可能与多个eBay目录产品相关联，如果找到多个产品，产品详细信息将不被Inventory Item对象选中。出现：可选</td> </tr> <tr> <td>sku</td> <td>string</td> <td>卖方定义的库存物料的库存单位（SKU）。卖方应为其销售的每种产品提供唯一的SKU值。发生：有条件的</td> </tr> <tr> <td>locale</td> <td>LocaleEnum</td> <td>该字段仅供将来使用。发生：有条件的</td> </tr> </tbody> </table> <p><strong>Output</strong></p> <h6>HTTP response headers</h6> <p>This call has no response headers.</p> <h6>Response payload</h6> <pre><code class="language-json">{ "responses": [ { "statusCode": "integer", "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" ] } ], "sku": "string", "locale": "LocaleEnum : [en_US,en_CA,fr_CA,en_GB,en_AU,en_IN,de_AT,fr_BE,fr_FR,de_DE,it_IT,nl_BE,nl_NL,es_ES,de_CH,fi_FI,zh_HK,hu_HU,en_PH,pl_PL,pt_PT,ru_RU,en_SG,en_IE,en_MY]" } ] }</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.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> <tr> <td>responses.sku</td> <td>string</td> <td>卖方定义的库存物料的库存单位（SKU）。卖方应为其销售的每种产品提供唯一的SKU值。发生：总是</td> </tr> <tr> <td>responses.locale</td> <td>LocaleEnum</td> <td>该字段仅供将来使用。发生：有条件的</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>25002</td> <td>API_INVENTORY</td> <td>请求</td> <td>发生了用户错误。{附加信息}</td> </tr> <tr> <td>25003</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存商品相关联的易趣物品列表或未发布的商品具有无效价格。{附加信息}</td> </tr> <tr> <td>25004</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品列表或未发布的要约具有无效数量。{附加信息}</td> </tr> <tr> <td>25005</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品列表或未发布的商品具有无效的类别ID。{附加信息}</td> </tr> <tr> <td>25006</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品列表或未发布的商品具有无效的列表选项。{附加信息}</td> </tr> <tr> <td>25007</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品清单或未发布的物品在相关的配送政策中包含无效数据。{附加信息}</td> </tr> <tr> <td>25008</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品列表或未发布的要约在相关的付款政策中包含无效数据。{附加信息}</td> </tr> <tr> <td>25009</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品列表或未发布的物品在相关的退货政策中包含无效数据。{附加信息}</td> </tr> <tr> <td>25011</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品列表或未发布的要约具有无效的税务信息。{附加信息}</td> </tr> <tr> <td>25012</td> <td>API_INVENTORY</td> <td>请求</td> <td>库存位置无效。{附加信息}</td> </tr> <tr> <td>25013</td> <td>API_INVENTORY</td> <td>请求</td> <td>库存物料组中的数据无效。{附加信息}</td> </tr> <tr> <td>25014</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品列表或未发布的商品具有无效图片。{附加信息}</td> </tr> <tr> <td>25015</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目相关联的易趣物品列表或未发布的商品具有无效的图片URL。{附加信息}</td> </tr> <tr> <td>25016</td> <td>API_INVENTORY</td> <td>请求</td> <td>{fieldName}值无效。{附加信息}</td> </tr> <tr> <td>25017</td> <td>API_INVENTORY</td> <td>请求</td> <td>{fieldName}丢失了。{附加信息}</td> </tr> <tr> <td>25018</td> <td>API_INVENTORY</td> <td>请求</td> <td>帐户信息不完整。{附加信息}</td> </tr> <tr> <td>25019</td> <td>API_INVENTORY</td> <td>请求</td> <td>无法修改上市。{附加信息}</td> </tr> <tr> <td>25020</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存商品相关联的易趣物品列表或未发布的商品具有无效的运送包裹详细信息。{附加信息}</td> </tr> <tr> <td>25021</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目相关联的易趣物品列表或未发布的物品具有无效物品条件信息。{附加信息}</td> </tr> <tr> <td>25022</td> <td>API_INVENTORY</td> <td>请求</td> <td>无效的属性。{}字段名</td> </tr> <tr> <td>25023</td> <td>API_INVENTORY</td> <td>请求</td> <td>无效的兼容性信息。{附加信息}</td> </tr> <tr> <td>25025</td> <td>API_INVENTORY</td> <td>应用</td> <td>不允许同时访问同一库存或库存物料组对象。请稍后再试。</td> </tr> <tr> <td>25026</td> <td>API_INVENTORY</td> <td>请求</td> <td>超出销售限额。{附加信息}</td> </tr> <tr> <td>25501</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目相关联的易趣物品列表或未发布的商品具有无效图片。{附加信息}</td> </tr> <tr> <td>25502</td> <td>API_INVENTORY</td> <td>请求</td> <td>无效的属性信息。{附加信息}</td> </tr> <tr> <td>25503</td> <td>API_INVENTORY</td> <td>请求</td> <td>与库存项目关联的易趣物品列表或未发布的商品具有无效的产品信息。{附加信息}</td> </tr> <tr> <td>25601</td> <td>API_INVENTORY</td> <td>请求</td> <td>{fieldName}是无效的属性。</td> </tr> <tr> <td>25604</td> <td>API_INVENTORY</td> <td>请求</td> <td>输入错误。{附加信息}</td> </tr> <tr> <td>25701</td> <td>API_INVENTORY</td> <td>请求</td> <td>在系统中找不到一个或多个提供的SKU。</td> </tr> <tr> <td>25702</td> <td>API_INVENTORY</td> <td>请求</td> <td>无法找到{skuValue}或系统中无法使用。</td> </tr> <tr> <td>25707</td> <td>API_INVENTORY</td> <td>请求</td> <td>这是SKU的无效值。SKU只能使用字母数字字符，其长度不得超过50个字符。</td> </tr> <tr> <td>25708</td> <td>API_INVENTORY</td> <td>请求</td> <td>无效的SKU。</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>此优惠不可用：{additionalInfo}。</td> </tr> <tr> <td>25715</td> <td>API_INVENTORY</td> <td>请求</td> <td>运输包装的尺寸和/或重量的值无效。</td> </tr> <tr> <td>25727</td> <td>API_INVENTORY</td> <td>请求</td> <td>请求中的InventoryItem数量不能超过{additionalInfo}。</td> </tr> <tr> <td>25728</td> <td>API_INVENTORY</td> <td>请求</td> <td>InventoryItems在请求中应该是唯一的。</td> </tr> <tr> <td>25733</td> <td>API_INVENTORY</td> <td>请求</td> <td>请求中的所有InventoryItem都需要有效的SKU和区域设置信息。</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>此示例将创建两个库存项目。</p> <h6>Input</h6> <p>此调用会创建两个库存项目。必须为每个库存项目提供卖方定义的SKU值。为这些库存项目提供的其他详细信息包括列表标题，列表描述，项目条件，产品方面，项目图像的URL和可用数量。 <strong>POST</strong> <a href="https://api.ebay.com/sell/inventory/v1/bulk_create_or_replace_inventory_item">https://api.ebay.com/sell/inventory/v1/bulk_create_or_replace_inventory_item</a></p> <pre><code>{ "requests": [ { "sku": "BT_AllEars", "locale": "en_US", "product": { "title": "Boston Terriers Collector Plate &quot;All Ears by Dan Hatala - The Danbury Mint", "aspects": { "Country/Region of Manufacture": [ "United States" ] }, "description": "All Ears by Dan Hatala. A limited edition from the collection entitled 'Boston Terriers'. Presented by The Danbury Mint.", "imageUrls": [ "https://i.ebayimg.com/00/s/OTk5WDc0OQ==/z/54IAAOSw3thbW20V/$_12.JPG?set_id=880000500F" ] }, "condition": "USED_EXCELLENT", "conditionDescription": "Mint condition. Kept in styrofoam case. Never displayed.", "availability": { "shipToLocationAvailability": { "quantity": 2 } } }, { "sku": "JPavelski_SJS25th", "locale": "en_US", "product": { "title": "JOE PAVELSKI 2015-16 BOBBLEHEAD NHL SAN JOSE SHARKS 25TH ANNIVERSARY", "aspects": { "Team": [ "San Jose Sharks" ], "Player": [ "Joe Pavelski" ], "Pre & Post Season": [ "Regular Season" ], "Product": [ "Bobblehead" ], "Country/Region of Manufacture": [ "China" ], "Brand": [ "Success Promotions" ], "UPC": [ "Does not apply" ] }, "description": "Joe Pavelski bobble head from 2015-16 season, the 25th season of the San Jose Sharks. New in box.", "imageUrls": [ "https://i.ebayimg.com/00/s/MTYwMFgxMjAw/z/lXoAAOSwZb5bT4W6/$_57.JPG?set_id=8800005007" ] }, "condition": "NEW", "availability": { "shipToLocationAvailability": { "quantity": 1 } } } ] }</code></pre> <h6>Output</h6> <p>如果成功检索到库存物料记录，则会为SKU返回statusCode值200。对于每个SKU，将返回当前为库存项目记录定义的所有详细信息。</p> <pre><code class="language-json">{ "responses": [ { "statusCode": 201, "sku": "BT_AllEars", "locale": "en_US", "warnings": [], "errors": [] }, { "statusCode": 201, "sku": "JPavelski_SJS25th", "locale": "en_US", "warnings": [], "errors": [] } ] }</code></pre>

eBay文档翻译

bulkCreateOrReplaceInventoryItem

页面列表