编辑商品

将废弃

POST

/sop/product/edit

最后修改时间：2023-07-26 10:14:11

注意事项：
1：可以只传入需要更新的字段，没有传入的字段不会更新
2：多规格商品，如果已经发布到闲鱼则不能清空SKU，至少要保留一组
3：如果商品状态为销售中，则同步更新到闲鱼APP

请求参数

Query 参数

appid

string

必需

开放平台的AppKey

默认值:

timestamp

string

必需

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

默认值:

sign

string

必需

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

默认值:

Body 参数application/json

product_id

string

管家商品ID

必需

示例：219530767978565

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_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/edit?appid=&timestamp=&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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

必需

product_id

string

管家商品ID

必需

示例：219530767978565

product_status

integer

管家商品状态

必需

示例：10

示例

{
  "status": 0,
  "data": {
    "product_id": "string",
    "product_status": 0
  }
}

修改于 2023-07-26 10:14:11

创建商品（批量）

下架商品