小红书开放平台发布文玩商品“承诺鉴定有证”接入说明

1. 接入目标 文玩类目已支持商家承诺“该商品已取得鉴定证书”。开放平台应用需要根据商家、类目维度返回的售后规则，完成以下能力接入： 查询当前商家、类目是否支持“承诺鉴定有证”，并获取实时价格阈值； 创建或更新商品时，按商品实际情况传入 certificate； 任一有效 SKU 售价严格大于价格阈值时，确保商品已承诺取得鉴定证书； 查询商品时正确回显 certificate。 “承诺鉴定有证”是商家对商品已取得鉴定证书的承诺标识。 2. 推荐调用流程 调用 common.getCategories，获取当前商家的可售类目及 supportAfterSaleList； 在目标叶子类目的 supportAfterSaleList 中查找 type=certificate 的规则； 读取规则中的 certificatePriceThreshold，结合全部有效 SKU 售价判断是否必须传 certificate=1； 调用 product.createItemAndSku 或 product.updateItemAndSku 创建、更新商品； 单独修改 SKU 售价时，调用 product.updateSkuPrice，并确保商品当前的 certificate 状态满足价格校验； 通过商品查询接口回读 certificate，确认商品状态。 类目能力会受商家灰度、类目配置等因素影响。请以当前商家实时调用 common.getCategories 的返回为准，不要跨商家复用或长期缓存规则。 3. 查询类目能力 3.1 接口说明 调用接口：common.getCategories 在返回的叶子类目（isLeaf=true）中读取 supportAfterSaleList。当列表中存在 type=certificate 的规则时，表示当前商家在该类目下支持“承诺鉴定有证”。 返回示例： { "categoryV3s": [ { "id": 100000, "name": "示例文玩叶子类目", "isLeaf": true, "supportAfterSaleList": [ { "type": "certificate", "name": "承诺鉴定有证", "mustSupport": false, "certificatePriceThreshold": 100000 } ] } ] }示例中的 certificatePriceThreshold=100000 仅用于说明字段格式，单位为分，即 1000 元。实际阈值请始终以接口实时返回为准。 3.2 规则字段说明 字段类型说明 typeString售后规则类型。“承诺鉴定有证”固定为 certificate nameString售后规则名称，当前为“承诺鉴定有证” mustSupportBoolean通用售后规则字段。鉴定证书是否必填不能只依据该字段判断，还需要结合价格阈值和 SKU 售价 certificatePriceThresholdInteger鉴定证书价格阈值，单位为分。仅 certificate 规则返回该字段 3.3 是否必须承诺的判断规则 满足以下全部条件时，商品必须传入 certificate=1： 目标叶子类目的 supportAfterSaleList 中存在 type=certificate； 商品任一有效 SKU 售价严格大于 certificatePriceThreshold。 注意： SKU 售价等于阈值时，不强制承诺； 多规格商品中，只要任一有效 SKU 售价超过阈值，整件商品就必须传 certificate=1； 如果类目规则中不存在 certificate，不要传入该字段，也不要仅依据固定金额自行判断。 4. 创建和更新商品 4.1 涉及接口 创建商品：product.createItemAndSku 更新商品：product.updateItemAndSku 4.2 请求字段 在商品请求的顶层传入 certificate: 字段类型是否必填说明 certificateInteger条件必填1：承诺该商品已取得鉴定证书；0 或不传：不承诺。当任一有效 SKU 售价严格大于类目规则返回的阈值时，必须传 1 创建商品请求片段示例： { "categoryId": 100000, "certificate": 1, "createSkuList": [ { "price": 120000 } ] }更新商品请求片段示例： { "itemId": 123456789, "certificate": 1, "updateSkuList": [ { "skuId": 987654321, "price": 120000 } ] }4.3 校验失败 当任一有效 SKU 售价严格大于阈值，但商品未传入 certificate=1 时，接口会拒绝创建或更新。 错误信息 商品规格售价大于xxx元，必须承诺该商品已取得鉴定证书。 5. 修改 SKU 售价 调用接口：product.updateSkuPrice 单独修改 SKU 售价时，系统会根据商品当前保存的 certificate 状态进行校验。如果目标售价将使任一有效 SKU 严格大于当前类目阈值，而商品尚未承诺取得鉴定证书，调价会失败。 推荐处理顺序： 先通过 product.updateItemAndSku 将商品更新为 certificate=1； 更新成功后，再调用 product.updateSkuPrice 调整 SKU 售价。 6. 商品信息回读 以下商品查询接口会返回 certificate： 接口返回字段路径 product.getDetailSkuListdata[].item.certificate product.getItemInfoitemInfo.certificate product.searchItemListitemDetailV3s[].certificate 字段含义： 返回值说明 1商家已承诺该商品已取得鉴定证书 0 或空商家未承诺该商品已取得鉴定证书 商品查询接口只返回商品自身的 certificate 状态，不返回类目价格阈值。需要阈值时，请重新调用 common.getCategories 获取当前规则。