创建商品（批量） - 闲管家开放平台（作废）

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

请求参数

Query 参数

appid

string

必需

开放平台的AppKey

默认值:

timestamp

string

必需

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

默认值:

sign

string

必需

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

默认值:

Body 参数application/json

array of:

item_biz_type

enum<integer>

商品类型ID

必需

示例：2

枚举值:

257890

sp_biz_type

enum<integer>

商品分类ID

必需

示例：1

枚举值:

12389161718192021222324252728293031

channel_cat_id

string

商品类目ID

必需

示例：e11455b218c06e7ae10cfa39bf43dc0f

original_price

integer

商品原价（分）

可选

示例：299900

>= 0<= 9999999900

price

integer

商品售价（分）

必需

示例：199900（多规格商品，必须是SKU其中一个金额）

>= 1<= 9999999900

stock

integer

商品库存

必需

示例：99（多规格商品，必须是SKU库存的合计）

>= 0<= 9999

默认值:

title

string

商品标题

必需

示例：iPhone 12 128G 黑色

>= 1 字符<= 30 字符

images

array[string]

商品图片URL

必需

示例：[xx,xx]（第一张为商品主图）

>= 1 items<= 30 items

desc

string

商品描述

必需

注意：不支持HTML代码，可使用\n换行

>= 5 字符<= 5000 字符

sku_items

array [object {4}]

商品SKU

可选

注意：最多设置两个规格，每个规格限制1~20个属性值

price

integer

SKU售价（分）

必需

示例：199900

>= 1<= 9999999900

stock

integer

SKU库存

必需

示例：99

>= 0<= 9999

sku_text

string

SKU规格

必需

示例：颜色:黑色;容量:128G
注意：规格名称限制4个字符以内，属性值限制20个字符以内

outer_id

string

商家SKU编码

必需

示例：317837811-1

>= 1 字符<= 64 字符

district_id

integer

发货地区ID

必需

示例：440305

outer_id

string

商家编码

可选

示例：317837811

>= 1 字符<= 64 字符

stuff_status

enum<integer>

商品成色

可选

示例：100（非普通商品类型时必填）

枚举值:

100-199959080706050

express_fee

integer

运费（分）

可选

示例：100

>= 0

默认值:

book_data

object

图书信息

可选

仅图书商品传入

title

string

书名

必需

示例：北京法源寺

>= 1 字符<= 64 字符

author

string

作者

必需

示例：李敖

>= 1 字符<= 30 字符

publisher

string

出版社

必需

示例：中国友谊出版公司

>= 1 字符<= 30 字符

isbn

string

ISBN码

必需

示例：9787505720176

>= 10 字符<= 13 字符

food_data

object

食品信息

必需

仅食品商品传入

brand

string

品牌

必需

示例：周黑鸭

>= 1 字符<= 30 字符

spec

string

规格

必需

示例：鸭翅

>= 1 字符<= 30 字符

pack

string

包装种类

必需

示例：盒装

>= 1 字符<= 10 字符

expire

object

保质期信息

必需

production

object

生产信息

必需

sp_guarantee

string

商品标签

可选

示例：1,2（最多设置两个）

标签字典:
1: 100%验货
2: 正品鉴别
3: 七天包退
4: 一年质保
5: 48小时发货
7: 质量问题包退
8: 一物一证

report_data

object

验货报告信息

可选

仅已验货自检商品类型传入

jewelry

object

珠宝信息

可选

仅珠宝分类传入

valuable

object

奢品信息

可选

仅奢品分类传入

curio

object

文玩信息

可选

仅文玩分类传入

beauty_makeup

object

美妆信息

可选

仅美妆分类传入

virtual_account

object

（已作废）虚拟账号/租号信息

可选

仅虚拟账号/租号分类传入

used_car

object

二手车信息

可选

仅二手车分类传入

game

object

游戏信息

可选

仅信息分类传入

support_sdr_policy

enum<integer>

是否支持七天无理由

可选

枚举值:

support_nfr_policy

enum<integer>

是否支持描述不符包邮退

可选

枚举值:

support_fd24hs_policy

enum<integer>

是否支持极速发货-24小时

可选

枚举值:

support_fd10ms_policy

enum<integer>

是否支持极速发货-10分钟

可选

枚举值:

item_key

string

批次商品KEY

必需

示例：2021110801

authorize_id

string

闲鱼号授权ID

可选

示例：194863423377477

示例

[
    {
        "item_key": "2021110801",
        "item_biz_type": 2,
        "sp_biz_type": 1,
        "channel_cat_id": "xxx",
        "original_price": 700000,
        "price": 550000,
        "stock": 10,
        "title": "iPhone 12 128G 黑色",
        "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
        ],
        "desc": "商品描述",
        "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"
            }
        ],
        "district_id": 440305,
        "outer_id": "2021110112345",
        "stuff_status": 100,
        "express_fee": 10,
        "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街道",
                    "region": [
                        110000,
                        110100,
                        110101
                    ]
                }
            }
        }
    },
    {
        "item_key": "2021110802",
        "item_biz_type": 2,
        "sp_biz_type": 1,
        "channel_cat_id": "xxx",
        "original_price": 700000,
        "price": 550000,
        "stock": 10,
        "title": "iPhone 12 128G 黑色",
        "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
        ],
        "desc": "商品描述",
        "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"
            }
        ],
        "district_id": 440305,
        "outer_id": "2021110112345",
        "stuff_status": 100,
        "express_fee": 10,
        "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街道",
                    "region": [
                        110000,
                        110100,
                        110101
                    ]
                }
            }
        }
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.goofish.pro/sop/product/batchCreate?appid=&timestamp=&sign=' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "item_key": "2021110801",
        "item_biz_type": 2,
        "sp_biz_type": 1,
        "channel_cat_id": "xxx",
        "original_price": 700000,
        "price": 550000,
        "stock": 10,
        "title": "iPhone 12 128G 黑色",
        "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
        ],
        "desc": "商品描述",
        "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"
            }
        ],
        "district_id": 440305,
        "outer_id": "2021110112345",
        "stuff_status": 100,
        "express_fee": 10,
        "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街道",
                    "region": [
                        110000,
                        110100,
                        110101
                    ]
                }
            }
        }
    },
    {
        "item_key": "2021110802",
        "item_biz_type": 2,
        "sp_biz_type": 1,
        "channel_cat_id": "xxx",
        "original_price": 700000,
        "price": 550000,
        "stock": 10,
        "title": "iPhone 12 128G 黑色",
        "images": [
            "https://xxx.com/xxx1.jpg",
            "https://xxx.com/xxx2.jpg"
        ],
        "desc": "商品描述",
        "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"
            }
        ],
        "district_id": 440305,
        "outer_id": "2021110112345",
        "stuff_status": 100,
        "express_fee": 10,
        "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街道",
                    "region": [
                        110000,
                        110100,
                        110101
                    ]
                }
            }
        }
    }
]'

返回响应

🟢200成功

application/json

Body

status

integer

必需

data

object

必需

success

array [object {3}]

必需

error

array [object {2}]

必需

示例

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