同步商品（延保险）

注意

本页适用于 OpenAPI 自主接入，或平台能力声明明确要求补充此能力的场景。使用平台集成方案时，请先确认该方案的 OpenAPI 依赖和职责边界。

接口名：/go/packageOpenApiWeb/OpenApiV2/SyncPlatformProduct

商品同步。入参 items 与 fileUrl 至少传一个；同时传入时，服务端优先使用 items 并忽略 fileUrl。出参 data 只有 requestId。

完整字段说明见 API 接口文档 · SyncPlatformProduct。

注意：

• 使用 fileUrl 时，CSV 每一行等同于一个 Item；复杂字段（数组/结构体）用 JSON。
• 变体名称 JSON 键是 Name（PascalCase）。
• variants 选填。不传或传空数组时，服务端使用商品同级的 variantId、skuId、Name、price 合成一个单变体。

请求示例

包含变体示例

{
    "items": [
        {
            "platformItemId": "B01N1SE4E9",
            "itemState": 1,
            "itemName": "Sample Product",
            "currency": "USD",
            "picLink": [
                "https://example.com/example1.img",
                "https://example.com/example2.img"
            ],
            "itemLink": "https://example.com/item/B01N1SE4E9",
            "variants": [
                {
                    "variantId": "AFNSJHFUHUAI",
                    "skuId": "ABC123",
                    "Name": "椰子皂-酱香型-买一送一",
                    "price": "20.00",
                    "imageUrl": "https://example.com/variant1.img"
                },
                {
                    "variantId": "SHFHGSHGFH",
                    "skuId": "ABCABC",
                    "Name": "椰子皂-浓香型-买一送二",
                    "price": "30.00",
                    "imageUrl": "https://example.com/variant2.img"
                }
            ],
            "itemPriceExt": "{\"discount\": \"5%\", \"specialOffer\": \"Buy 2 Get 1 Free\"}"
        }
    ]
}

不含变体示例

{
    "requestId": "req-001",
    "items": [
        {
            "platformItemId": "B01N1SE4E9",
            "itemState": 1,
            "itemName": "Sample Product",
            "currency": "USD",
            "picLink": ["https://example.com/example1.img"],
            "itemLink": "https://example.com/item/B01N1SE4E9",
            "variantId": "SHFHGSHGFH",
            "skuId": "ABCABC",
            "Name": "椰子皂-浓香型-买一送二",
            "price": "30.00"
        }
    ]
}

通过 CSV 文件同步

CSV 首行是标题行，后续每一行是一个商品。picLink、variants 等复杂字段的单元格内容必须是合法 JSON；按照 CSV 规范对其中的双引号进行转义。

{
   "fileUrl": "https://example.com/data.csv"
}

响应示例

{
  "errCode": 0,
  "errMsg": "success",
  "data": { "requestId": "req-001" }
}