createOrReplaceProductCompatibility

<h1>createOrReplaceProductCompatibility</h1> <p><strong>PUT</strong> /inventory_item/{sku}/product_compatibility</p> <pre><code>注意：请注意，使用Inventory API创建的任何eBay列表都无法使用Trading API调用进行修订或重新发布。</code></pre> <p>此调用将创建新的库存物料记录或替换现有库存物料记录。卖家是否想要从一开始就创建完整的库存项目记录，或者卖家只能通过初始 createOrReplaceInventoryItem调用提供一些信息，然后进行一个或多个额外的 createOrReplaceInventoryItem调用以完成库存的所有必填字段。项目记录并准备发布。首次创建库存物料记录时，只需要调用路径中的SKU值。</p> <p>在替换现有库存物料记录的情况下，createOrReplaceInventoryItem调用将完全替换现有库存项目记录，因此在该更新操作中，无论其值是否更改，当前为库存项目记录定义的所有字段都是必需的。因此，在更换/更新库存物料记录时，建议卖方运行getInventoryItem调用以检索完整库存物料记录，并在尝试更新记录之前查看其所有当前值/设置。如果对作为一个或多个有效eBay列表的一部分的库存项目进行了更改，则成功通话将自动更新这些eBay列表。</p> <p>使用createOrReplaceInventoryItem调用设置的关键信息包括：</p> <ul> <li>卖方定义的产品SKU值。每个卖家产品（包括商品库存组中的产品）必须具有自己的SKU值。此SKU值在调用URI的末尾传入</li> <li>项目的条件</li> <li>产品详细信息，包括任何产品标识符，例如UPC，ISBN，EAN或品牌/制造商部件号对，产品描述，产品标题，产品/项目方面以及图像链接。易趣将使用任何提供的易趣产品ID（ePID）或GTIN（UPC，ISBN或EAN），并尝试将这些标识符与易趣目录中的产品相匹配，如果找到产品匹配，则清单的产品详细信息项目将自动填充。</li> <li>可供购买的库存物料的数量</li> <li>包装重量和尺寸，如果卖家提供计算的运输选项，则需要包装。如果卖家提供统一运费服务，但需要收取重量附加费，也需要包裹重量。</li> </ul> <p>除了authorization所有eBay REST API调用所需的标头之外，createOrReplaceInventoryItem调用还需要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个）创建或更新大量库存项目记录的人，可以使用bulkCreateOrReplaceInventoryItem方法。</p> <h6>Input</h6> <p>Resource URI (production) <strong>PUT</strong> <a href="https://api.ebay.com/sell/inventory/v1/inventory_item/{sku}/product_compatibility">https://api.ebay.com/sell/inventory/v1/inventory_item/{sku}/product_compatibility</a></p> <h6>URI parameters</h6> <table> <thead> <tr> <th>参数</th> <th>类型</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>sku</td> <td><a href="https://developer.ebay.com/api-docs/static/simple-types.html" title="string">string</a></td> <td>无论卖方是创建新库存项目还是更新现有库存项目，都需要卖方定义的库存项目SKU值。此SKU值在调用URI的末尾传入。SKU值在卖家库存中必须是唯一的。最大长度：50。发生：必需</td> </tr> </tbody> </table> <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">{ "compatibleProducts": [ { "productFamilyProperties": { "make": "string", "model": "string", "year": "string", "trim": "string", "engine": "string" }, "productIdentifier": { "epid": "string", "gtin": "string", "ktype": "string" }, "notes": "string" } ], "sku": "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>compatibleProducts</td> <td>array of CompatibleProduct</td> <td>该容器由一系列机动车辆（制造商，型号，年份，装饰，发动机）组成，这些机动车辆与sku值指定的机动车辆部件或附件兼容。发生：必需</td> </tr> <tr> <td>compatibleProducts.productFamilyProperties</td> <td>ProductFamilyProperties</td> <td>指定的机动车辆部件或附件兼容。这些机动车辆通过诸如品牌，型号，年份，装饰和发动机类型等属性来识别。无论是产品识别或productFamilyProperties容器（或两者）可用于指定与所述库存项目兼容的一个或多个机动车辆。需要单独的productFamilyProperties来指定每个兼容的机动车辆。通常，需要机动车的品牌，型号和年份（有时可选择内饰和发动机），但这取决于零件或附件以及车辆类别。注：该ProductIdentifier类型供将来使用，因此productFamilyProperties容器是目前指定兼容机动车辆的唯一方法。发生：必需</td> </tr> <tr> <td>compatibleProducts.productFamilyProperties.make</td> <td>string</td> <td>该字段表示车辆的品牌（例如Toyota）。发生：必需</td> </tr> <tr> <td>compatibleProducts.productFamilyProperties.model</td> <td>string</td> <td>该字段表示车辆的型号（例如Camry）。发生：必需</td> </tr> <tr> <td>compatibleProducts.productFamilyProperties.year</td> <td>string</td> <td>该字段表示车辆的年份（例如2016）。发生：必需</td> </tr> <tr> <td>compatibleProducts.productFamilyProperties.trim</td> <td>string</td> <td>该字段表示车辆的纵倾（例如2-door Coupe）。该字段是有条件的，但如果已知/适用，则应提供。发生：有条件的</td> </tr> <tr> <td>compatibleProducts.productFamilyProperties.engine</td> <td>string</td> <td>该字段表示发动机的规格，包括其尺寸，块类型和燃料类型。一个例子是2.7L V6 gas DOHC naturally aspirated。该字段是有条件的，但如果已知/适用，则应提供。发生：有条件的</td> </tr> <tr> <td>compatibleProducts.productIdentifier</td> <td>ProductIdentifier</td> <td>此容器用于createOrReplaceProductCompatibility调用，以识别与库存项目兼容的机动车辆。如果在eBay目录中找到机动车辆，则将自动为车辆填充机动车辆属性（productFamilyProperties中的属性）。此容器不适用于getProductCompatibility调用。无论是产品识别或productFamilyProperties容器（或两者）可用于指定与所述库存项目兼容的一个或多个机动车辆。如果是productIdentifier使用容器时，在该容器中传递的产品标识符必须与易趣目录中的车辆匹配，以便将该车辆添加到兼容的车辆列表中。注：该产品识别类型以供将来使用，所以productFamilyProperties容器是目前指定一个兼容的机动车辆的唯一途径。一旦此类型可供使用，它将仅用于识别易趣目录中的机动车辆。但是，将来可能会将产品兼容性功能扩展到其他（非车辆）产品。发生：有条件的</td> </tr> <tr> <td>compatibleProducts.productIdentifier.epid</td> <td>string</td> <td>如果卖方已经知道与要添加到兼容产品列表的机动车辆相关联的eBay目录产品ID（ePID），则可以使用该字段。如果在eBay产品目录中找到此eBay目录产品ID，则将自动获取该机动车辆的机动车辆属性（例如制造商，型号，年份，发动机和装饰）。注意：此字段和productIdentifier类型仅供将来使用。出现：可选</td> </tr> <tr> <td>compatibleProducts.productIdentifier.gtin</td> <td>string</td> <td>如果卖方知道要添加到兼容产品列表的机动车辆的全球贸易项目编号，则可以使用该字段。如果在易趣产品目录中找到此GTIN值，则机动车辆属性（例如制造商，型号，年份，发动机和装饰将自动获取该机动车辆。注意：此字段和productIdentifier类型供将来使用只要。出现：可选</td> </tr> <tr> <td>compatibleProducts.productIdentifier.ktype</td> <td>string</td> <td>如果卖方知道要添加到兼容产品列表的机动车辆的K型号，则可以使用该字段。如果在eBay产品目录中找到此K类型值，则将自动获取该机动车辆的机动车辆属性（例如制造商，型号，年份，发动机和纵倾）。只有DE，UK和AU站点支持使用K类型号。注意：此字段和productIdentifier类型仅供将来使用。出现：可选</td> </tr> <tr> <td>compatibleProducts.notes</td> <td>string</td> <td>卖方可选择使用该字段输入与指定的零件兼容性有关的任何注释。卖方可以使用此字段指定零件在车辆上的位置或其他适用信息。只有卖方指定才会返回此字段。最大长度：500发生：有条件的</td> </tr> <tr> <td>sku</td> <td>string</td> <td>这是与兼容车辆相关联的库存项目的卖方定义的SKU值。此字段不适用于createOrReplaceProductCompatibility 调用，但始终使用getProductCompatibility调用返回该字段。对于createOrReplaceProductCompatibility 调用，库存项的SKU值实际上是作为调用URI的一部分传入的，而不是在请求有效负载中传入的。发生：NA</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" ] } ] }</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> </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>201</td> <td>创建</td> </tr> <tr> <td>204</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>25702</td> <td>API_INVENTORY</td> <td>请求</td> <td>无法找到{skuValue}或系统中无法使用。</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值作为调用URI的一部分传递。两个兼容车辆的属性在请求有效载荷中传递。 <strong>PUT</strong> <a href="https://api.ebay.com/sell/inventory/v1/inventory_item/Al-8730/product_compatibility">https://api.ebay.com/sell/inventory/v1/inventory_item/Al-8730/product_compatibility</a></p> <pre><code class="language-json">{ "compatibleProducts": [ { "productFamilyProperties": { "make": "Subaru", "model": "DL", "year": "1982", "trim": "Base Wagon 4-Door", "engine": "1.8L 1781CC H4 GAS SOHC Naturally Aspirated" }, "notes": "Equivalent to AC Delco Alternator" }, { "productFamilyProperties": { "make": "Subaru", "model": "GL", "year": "1983", "trim": "Base Wagon 4-Door", "engine": "1.8L 1781CC H4 GAS OHV Turbocharged" }, "notes": "Equivalent to AC Delco Alternator" }, { "productFamilyProperties": { "make": "Subaru", "model": "DL", "year": "1985", "trim": "Base Wagon 4-Door", "engine": "1.8L 1781CC H4 GAS SOHC Naturally Aspirated" }, "notes": "Equivalent to AC Delco Alternator" }, { "productFamilyProperties": { "make": "Subaru", "model": "GL", "year": "1986", "trim": "Base Wagon 4-Door", "engine": "1.8L 1781CC H4 GAS OHV Naturally Aspirated" }, "notes": "Equivalent to AC Delco Alternator" } ] }</code></pre> <h6>Output</h6> <p>除非有任何错误或警告，否则此响应没有输出有效负载。成功的呼叫包含HTTP状态代码200。</p>