创建商品（批量）

POST

/api/open/product/batchCreate

注意事项：
1：字段参数要求与单个创建商品一致
2：每批次最多创建50个商品
3：同批次时item_key字段值要唯一

请求参数

Query 参数

appid

integer

必需

开放平台的AppKey

默认值:

timestamp

integer

必需

当前时间戳（单位秒，5分钟内有效）

默认值:

seller_id

integer

可选

商家ID（仅商务对接传入，自研/第三方ERP对接忽略即可）

默认值:

sign

string

必需

签名MD5值（参考签名说明）

默认值:

Body 参数application/json

product_data

array [object {23}]

必需

>= 1 items<= 50 items

item_key

string

批次商品KEY

必需

原样返回，用于匹配商家自己的商品

示例值:

product-1product-2

item_biz_type

enum<integer> <int32>

商品类型ID

必需

枚举值：
2 : 普通商品
0 : 已验货
10 : 验货宝
16 : 品牌授权
19 : 闲鱼严选
24: 闲鱼特卖
26: 品牌捡漏

枚举值:

201016192426

示例值:

sp_biz_type

enum<integer> <int32>

商品分类ID

必需

枚举值：
1 : 手机
2 : 潮品
3 : 家电
8 : 乐器
9 : 3C数码
16 : 奢品
17 : 母婴
18 : 美妆个护
19 : 文玩/珠宝
20 : 游戏电玩
21 : 家居
22 : 虚拟游戏
23 : 租号
24 : 图书
25 : 卡券
27 : 食品
28 : 潮玩
29 : 二手车
30 : 宠植
31 : 工艺礼品
33 : 汽车服务
99 : 其他

枚举值:

123891617181920212223242527282930313399

示例值:

channel_cat_id

string

商品类目ID

必需

通过查询商品类目接口获取类目参数

示例值:

e11455b218c06e7ae10cfa39bf43dc0f

channel_pv

array [object {4}]

商品属性

可选

通过查询商品属性接口获取属性参数

price

integer <int64>

商品售价（分）

必需

注意：多规格商品时，必须是SKU其中一个金额

>= 1<= 9999999900

示例值:

199900

original_price

integer <int64>

商品原价（分）

可选

>= 0<= 9999999900

示例值:

199900

express_fee

integer <int64>

运费（分）

可选

stock

integer <int32>

商品库存

必需

注意：多规格商品，必须是SKU库存的合计

>= 1<= 399960

示例值:

outer_id

string

商家编码

可选

>= 1 字符<= 64 字符

示例值:

317837811

stuff_status

enum<integer> <int32>

商品成色

可选

枚举值：
0 : 无成色（普通商品可用）
100 : 全新
-1 : 准新
99 : 99新
95 : 95新
90 : 9新
80 : 8新
70 : 7新
60 : 6新
50 : 5新

-仅品牌捡漏类型可用-
40 : 未使用·中度瑕疵
30 : 未使用·轻微瑕疵
20 : 未使用·仅拆封
10 : 未使用·准新
100 : 全新未使用
-仅品牌捡漏类型可用-

及以下注意：非普通商品类型时必填~~

枚举值:

100-199959080706050403020100

默认值:

示例值:

100

publish_shop

array[object (店铺发布信息) {9}]

发布店铺

必需

bid_data

object (拍卖信息)

拍卖信息

可选

sku_items

array[object (SKU信息) {4}]

商品多规格信息

可选

book_data

object (图书信息)

图书信息

可选

food_data

object (食品信息)

食品信息

可选

report_data

object (验货报告信息)

验货报告信息

可选

注意：已验货类型的商品按需必填

flash_sale_type

enum<integer> <int32>

闲鱼特卖类型

可选

枚举值：
-仅闲鱼特卖类型可用-
1 : 临期
2 : 孤品
3 : 断码
4 : 微瑕
5 : 尾货
6 : 官翻
7 : 全新
8 : 福袋
99 : 其他
-仅闲鱼特卖类型可用-

-仅品牌捡漏类型可用-
2601 : 微瑕
2602 : 临期
2603 : 清仓
2604 : 官翻
-仅品牌捡漏类型可用-

枚举值:

12345678992601260226032604

示例值:

advent_data

object (闲鱼特卖信息)

闲鱼特卖信息

可选

闲鱼特卖类型为临期非食品行业时必传

inspect_data

object (验货宝信息)

验货宝信息

可选

商品类型为验货宝时必传

brand_data

object (品牌捡漏信息)

品牌捡漏信息

可选

detail_images

array [object {3}]

详情图片

可选

sku_images

array [object {4}]

规格图片

可选

示例

{
  "product_data": [
    {
      "item_key": "item1",
      "item_biz_type": 2,
      "sp_biz_type": 1,
      "category_id": 50025386,
      "channel_cat_id": "e11455b218c06e7ae10cfa39bf43dc0f",
      "channel_pv": [
        {
          "property_id": "b5e5462c028aba7f1921b9e373cead75",
          "property_name": "交易形式",
          "value_id": "8a3445658e0bc44687b43d68bdc44732",
          "value_name": "代下单"
        },
        {
          "property_id": "96ad8793a2fdb81bb108d382c4e6ea42",
          "property_name": "面值",
          "value_id": "38ed5f6522cd7ab6",
          "value_name": "100元"
        }
      ],
      "price": 550000,
      "original_price": 700000,
      "express_fee": 100,
      "stock": 10,
      "outer_id": "2021110112345",
      "stuff_status": 100,
      "publish_shop": [
        {
          "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
          ],
          "user_name": "闲鱼会员名",
          "province": 130000,
          "city": 130100,
          "district": 130101,
          "title": "商品标题",
          "content": "商品描述。",
          "service_support": "SDR"
        }
      ],
      "sku_items": [
        {
          "price": 500000,
          "stock": 10,
          "outer_id": "",
          "sku_text": "颜色:白色;容量:128G"
        },
        {
          "price": 600000,
          "stock": 10,
          "outer_id": "",
          "sku_text": "颜色:白色;容量:256G"
        },
        {
          "price": 500000,
          "stock": 10,
          "outer_id": "",
          "sku_text": "颜色:黑色;容量:128G"
        },
        {
          "price": 600000,
          "stock": 10,
          "outer_id": "",
          "sku_text": "颜色:黑色;容量:256G"
        }
      ],
      "book_data": {
        "title": "北京法源寺",
        "author": "李敖",
        "publisher": "中国友谊出版公司",
        "isbn": "9787505720176"
      },
      "food_data": {
        "pack": "罐装",
        "spec": "150",
        "brand": "伏特加伏特加",
        "expire": {
          "num": 360,
          "unit": "天"
        },
        "production": {
          "date": "2021-11-29",
          "address": {
            "detail": "北京市东城区x街道",
            "province": 130000,
            "city": 130100,
            "district": 130101
          }
        }
      },
      "report_data": {
        "used_car": {
          "report_url": "https://xxxxxx.com"
        },
        "beauty_makeup": {
          "org_id": 181,
          "brand": "欧莱雅",
          "spec": "小瓶装",
          "level": "全新",
          "org_name": "哈哈哈",
          "qc_result": "通过",
          "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
          ]
        },
        "game": {
          "qc_no": "123123",
          "qc_result": "符合",
          "title": "测试游戏",
          "platform": "小霸王",
          "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
          ]
        },
        "curio": {
          "org_id": 191,
          "org_name": "NGC评级",
          "size": "12mmx14mm",
          "material": "陶瓷",
          "qc_no": "3131319",
          "qc_result": "真品",
          "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
          ]
        },
        "jewelry": {
          "org_name": "某某平台",
          "shape": "圆形",
          "color": "白色",
          "weight": "125g",
          "qc_no": "3131319",
          "qc_desc": "无瑕疵",
          "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
          ]
        },
        "valuable": {
          "org_id": 162,
          "org_name": "国检",
          "qc_no": "454545",
          "qc_result": "符合",
          "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
          ]
        }
      }
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/api/open/product/batchCreate?appid=&timestamp=&seller_id={{seller_id}}&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product_data": [
        {
            "item_key": "item1",
            "item_biz_type": 2,
            "sp_biz_type": 1,
            "category_id": 50025386,
            "channel_cat_id": "e11455b218c06e7ae10cfa39bf43dc0f",
            "channel_pv": [
                {
                    "property_id": "b5e5462c028aba7f1921b9e373cead75",
                    "property_name": "交易形式",
                    "value_id": "8a3445658e0bc44687b43d68bdc44732",
                    "value_name": "代下单"
                },
                {
                    "property_id": "96ad8793a2fdb81bb108d382c4e6ea42",
                    "property_name": "面值",
                    "value_id": "38ed5f6522cd7ab6",
                    "value_name": "100元"
                }
            ],
            "price": 550000,
            "original_price": 700000,
            "express_fee": 100,
            "stock": 10,
            "outer_id": "2021110112345",
            "stuff_status": 100,
            "publish_shop": [
                {
                    "images": [
                        "https://xxx.com/xxx1.jpg",
                        "https://xxx.com/xxx2.jpg"
                    ],
                    "user_name": "闲鱼会员名",
                    "province": 130000,
                    "city": 130100,
                    "district": 130101,
                    "title": "商品标题",
                    "content": "商品描述。",
                    "service_support": "SDR"
                }
            ],
            "sku_items": [
                {
                    "price": 500000,
                    "stock": 10,
                    "outer_id": "",
                    "sku_text": "颜色:白色;容量:128G"
                },
                {
                    "price": 600000,
                    "stock": 10,
                    "outer_id": "",
                    "sku_text": "颜色:白色;容量:256G"
                },
                {
                    "price": 500000,
                    "stock": 10,
                    "outer_id": "",
                    "sku_text": "颜色:黑色;容量:128G"
                },
                {
                    "price": 600000,
                    "stock": 10,
                    "outer_id": "",
                    "sku_text": "颜色:黑色;容量:256G"
                }
            ],
            "book_data": {
                "title": "北京法源寺",
                "author": "李敖",
                "publisher": "中国友谊出版公司",
                "isbn": "9787505720176"
            },
            "food_data": {
                "pack": "罐装",
                "spec": "150",
                "brand": "伏特加伏特加",
                "expire": {
                    "num": 360,
                    "unit": "天"
                },
                "production": {
                    "date": "2021-11-29",
                    "address": {
                        "detail": "北京市东城区x街道",
                        "province": 130000,
                        "city": 130100,
                        "district": 130101
                    }
                }
            },
            "report_data": {
                "used_car": {
                    "report_url": "https://xxxxxx.com"
                },
                "beauty_makeup": {
                    "org_id": 181,
                    "brand": "欧莱雅",
                    "spec": "小瓶装",
                    "level": "全新",
                    "org_name": "哈哈哈",
                    "qc_result": "通过",
                    "images": [
                        "https://xxx.com/xxx1.jpg",
                        "https://xxx.com/xxx2.jpg"
                    ]
                },
                "game": {
                    "qc_no": "123123",
                    "qc_result": "符合",
                    "title": "测试游戏",
                    "platform": "小霸王",
                    "images": [
                        "https://xxx.com/xxx1.jpg",
                        "https://xxx.com/xxx2.jpg"
                    ]
                },
                "curio": {
                    "org_id": 191,
                    "org_name": "NGC评级",
                    "size": "12mmx14mm",
                    "material": "陶瓷",
                    "qc_no": "3131319",
                    "qc_result": "真品",
                    "images": [
                        "https://xxx.com/xxx1.jpg",
                        "https://xxx.com/xxx2.jpg"
                    ]
                },
                "jewelry": {
                    "org_name": "某某平台",
                    "shape": "圆形",
                    "color": "白色",
                    "weight": "125g",
                    "qc_no": "3131319",
                    "qc_desc": "无瑕疵",
                    "images": [
                        "https://xxx.com/xxx1.jpg",
                        "https://xxx.com/xxx2.jpg"
                    ]
                },
                "valuable": {
                    "org_id": 162,
                    "org_name": "国检",
                    "qc_no": "454545",
                    "qc_result": "符合",
                    "images": [
                        "https://xxx.com/xxx1.jpg",
                        "https://xxx.com/xxx2.jpg"
                    ]
                }
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer <int32>

必需

默认值:

msg

string

必需

默认值:

data

object

必需

success

array [object {3}]

必需

error

array [object {2}]

必需

示例

{
  "code": 0,
  "msg": "OK",
  "data": {
    "success": [
      {
        "item_key": "string",
        "product_id": 0,
        "product_status": 0
      }
    ],
    "error": [
      {
        "item_key": "string",
        "msg": "string"
      }
    ]
  }
}

🟢200失败

修改于 2024-08-15 11:12:33

创建商品（单个）

上架商品