获取商品

接口调用请求说明

http请求方式:POST
https://api.weixin.qq.com/shop/spu/get?access_token=xxxxxxxxx

请求参数示例

{
    "product_id": 324545,
    "out_product_id": "51514515",
    "need_edit_spu": 1      // 默认0:获取线上数据, 1:获取草稿数据
}

回包示例

{
    "errcode": 0,
    "errmsg":"ok",
    "spu":
    {
        "out_product_id": "1234566",
        "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
        "path": "plugin-private://wx34345ae5855f892d/pages/productDetail/productDetail?productId=2176180",
        "head_img": 
        [
            "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
        ],
        "desc_info": 
        {
            "desc": "xxxx",
            "imgs": 
            [
                "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
            ]
        },
        "audit_info": {
            "submit_time" :  "2021-03-09 15:14:08",
            "audit_time": "2021-03-09 15:16:08",
            "reject_reason": "不通过",
        },
        "third_cat_id": 6666,
        "brand_id": 2100000000,
        "info_version": "xxx",
        "create_time": "2020-12-25 00:00:00",
        "update_time": "2020-12-26 00:00:00",
        "skus":
        [
            {
                "out_product_id": "1234566",
                "out_sku_id": "1024",
                "thumb_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/100778/17/13648/424215/5e590a40E2d68e774/e171d222a0c9b763.jpg",
                "sale_price": 1300,
                "market_price": 1500,
                "stock_num": 100,
                "sku_code": "A24525252",
                "barcode": "13251454",
                "sku_attrs": 
                [
                    {
                        "attr_key": "选择颜色",
                        "attr_value": "红蓝主机"
                    },
                    {
                        "attr_key": "选择套装",
                        "attr_value": "主机+保护套"
                    }
                ]
            }
        ] 
    }
}

请求参数说明

参数 类型 是否必填 说明
out_product_id string 商家自定义商品ID,与product_id二选一
product_id number 交易组件平台内部商品ID,与out_product_id二选一
need_edit_spu number 默认0:获取线上数据, 1:获取草稿数据

回包参数说明

参数 类型 说明
errcode number 错误码
errmsg string 错误信息
spu.product_id number 交易组件平台内部商品ID
spu.out_product_id string 商家自定义商品ID
spu.title string 标题
spu.path string 绑定的小程序商品路径
spu.head_img string array 主图,多张,列表
spu.desc_info.desc string 商品详情图文
spu.desc_info.imgs string array 商品详情图片
spu.audit_info object 商品审核信息
spu.audit_info.submit_time string 上一次提交时间, yyyy-MM-dd HH:mm:ss
spu.audit_info.audit_time string 上一次审核时间, yyyy-MM-dd HH:mm:ss
spu.audit_info.reject_reason string 拒绝理由,只有edit_status为3时出现
spu.audit_info.audit_id string 审核单id
spu.status number 商品线上状态
spu.edit_status number 商品草稿状态
spu.third_cat_id number 第三级类目ID
spu.brand_id number 品牌id
spu.create_time string 创建时间
spu.update_time string 更新时间
spu.info_version string 预留字段,用于版本控制
spu.skus[] object array sku数组
spu.skus[].out_product_id string 商家自定义商品ID
spu.skus[].out_sku_id string 商家自定义skuID
spu.skus[].thumb_img string sku小图
spu.skus[].sale_price number 售卖价格,以分为单位
spu.skus[].market_price number 市场价格,以分为单位
spu.skus[].stock_num number 库存
spu.skus[].barcode string 条形码
spu.skus[].sku_code string 商品编码
spu.skus[].sku_attrs[].attr_key string 销售属性key(自定义)
spu.skus[].sku_attrs[].attr_value string 销售属性value(自定义)
spu.supplier string 供应商名称
spu.express_fee number 快递费用,以分为单位
spu.product_type string 商品属性,如:1、预售商品,2、虚拟电子凭证商品,3、自定义
spu.sell_time string 定时上架时间
spu.pick_up_type string array 配送方式 1快递 2同城 3上门自提 4点餐
spu.onsale number 0-不在售 1-在售
spu.unitname string 商品单位
spu.unitfactor number 包装因子

枚举-edit_status

枚举值 描述
1 未审核
2 审核中
3 审核失败
4 审核成功

枚举-status

枚举值 描述
0 初始值
5 上架
11 自主下架
13 违规下架/风控系统下架