批量同步商品信息

POST

/open-api/order/import_item

导入同步商品信息，支持新商品的导入和已有商品信息的同步，对系统中未存在的字段支持动态字段创建，对于已存在的字段进行传值导入。调用此接口需购买基础席位。

错误码	说明
21005	导入商品失败
21018	批量导入商品失败，商品价格不能为负

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

item_list

array [object {4}]

必需

商品信息列表最长100条。

integer

商品唯一标识id

必需

item_name

string

必需

商品名，最大32个字符

item_price

string

商品价格

必需

item_fields

array [object {2}]

必需

商品信息自定义字段列表，非商品基本字段。

示例

{
    "item_list": [
        {
            "id": 123,
            "item_name": "测试商品5",
            "item_price": "4.111",
            "item_fields": [
                {
                     "field_name": "商品描述",
                     "value": "编程视频"
                },
                {
                    "field_name": "商品类别",
                    "value": "虚拟商品"
                }
            ]
        },
        {
            "id": 321,
            "item_name": "测试商品6",
            "item_price": "4.89",
            "item_fields": [
                {
                     "field_name": "商品描述",
                     "value": "编程视频"
                },
                {
                    "field_name": "商品类别",
                    "value": "虚拟商品"
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/order/import_item?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "item_list": [
        {
            "id": 123,
            "item_name": "测试商品5",
            "item_price": "4.111",
            "item_fields": [
                {
                     "field_name": "商品描述",
                     "value": "编程视频"
                },
                {
                    "field_name": "商品类别",
                    "value": "虚拟商品"
                }
            ]
        },
        {
            "id": 321,
            "item_name": "测试商品6",
            "item_price": "4.89",
            "item_fields": [
                {
                     "field_name": "商品描述",
                     "value": "编程视频"
                },
                {
                    "field_name": "商品类别",
                    "value": "虚拟商品"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

状态码，0为正常，非0代表错误。

errmsg

string

必需

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

示例

{
    "errcode": 0,
    "errmsg": "ok"
}

🟢200正常返回

修改于 2024-06-27 03:05:14

批量同步店铺信息

批量同步订单信息v2