跳到主要内容

【渠道】商品信息批量新增​

接口描述：​

【渠道】商品信息批量新增

  由【平台】提供，企连云调用

URL​

  • 路径: POST /supplier/item/sync?app_id=12345678&timestamp=1724313684000&sign=b7071328a3971eb76548d435e731d8c0

请求方式​

  • POST

请求参数​

ContentType​

：application/json

Body Parameter​

名称类型必填最大长度描述示例值
app_keystring是-app_key43276baa5dca68a000001bbbbbb0fdddd
paramobject否请求body参数
└ itemsarray否商品新增集合
└ ext_idstring否-服务商商品id10982
└ category_idstring否-商品三级分类id1001001
└ typeint32否-商品类型101
└ namestring否-商品名称商品1018
└ logostring否-商品缩略图logo.jpg
└ guiding_priceint32否-商品划线价，单位分1590
└ priceint32否-商品售价，单位分1590
└ separated_priceint32否-分销价格，单位分1290
└ commissionint32否-佣金，单位分，和tr必须选一个500
└ take_ratestring否-tr比例：0.02500
└ start_timestring否-商品售卖时间2022-04-23 18:48:37
└ end_timestring否-售卖结束时间2022-04-29 18:48:37
└ show_start_timestring否-商品售卖展示开始时间2022-04-22 18:48:37
└ show_end_timestring否-商品售卖展示结束时间2022-04-29 18:48:37
└ available_timestring否-商品使用开始时间2022-04-23 18:48:37
└ unusable_timestring否-商品使用结束时间2022-04-29 18:48:37
└ statusint32否-商品状态：1-上架、2-下架1
└ purchase_limitint32否-购买数量限制：0-不限制100
└ imagesarray否-商品图片列表[http://image1.jpg,http://image2.jpg]
└ descriptionstring否-商品描述商品描述
└ image_descriptionarray否-商品、套餐描述图片[http://image1.jpg,http://image2.jpg]
└ image_pictures_textarray否-图文详情图片[http://image1.jpg,http://image2.jpg]
└ instructionobject否使用须知
└ entriesarray否准入说明
└ tilestring否-标题有效期
└ textarray否-描述[购买后35天有效 可用星期：星期1、星期2、星期3、星期4、星期5、星期6、星期7]
└ summaryarray否-概要说明[1、本套餐活动不可同时享受店里其他优惠活动，超出套餐内容费用，按店内实际收费另付,2、如部分菜品因时令或其他不可抗因素导致无法提供，商家将用等价菜品替换]
└ image_instructionarray否-使用须知图片,
└ show_tagsstring否-显示标签：免预约,过期退免预约,过期退
└ skusarray否商品sku列表
└ ext_idstring否-服务商sku_id10982
└ namestring否-服务商sku名称商品1018-sku1
└ descriptionstring否-sku描述sku描述
└ image_descriptionarray否-sku描述图片[http://image1.jpg,http://image2.jpg]
└ image_pictures_textarray否-图文描述图片[http://image1.jpg,http://image2.jpg]
└ instructionobject否使用须知
└ entriesarray否准入说明
└ tilestring否-标题有效期
└ textarray否-描述[购买后35天有效 可用星期：星期1、星期2、星期3、星期4、星期5、星期6、星期7]
└ summaryarray否-概要说明[1、本套餐活动不可同时享受店里其他优惠活动，超出套餐内容费用，按店内实际收费另付,2、如部分菜品因时令或其他不可抗因素导致无法提供，商家将用等价菜品替换]
└ image_instructionarray否-使用须知图片[http://image1.jpg,http://image2.jpg]
└ logostring否-服务商sku缩略图logo.jpg
└ imagesarray否-服务商sku图片列表[http://image1.jpg,http://image2.jpg]
└ ext_stockint32否-服务商sku库存同步1000
└ incr_stockint32否-追加分销sku库存1000
└ default_chosenint32否-sku是否默认选中1
└ guiding_priceint32否-sku划线价，单位分1590
└ priceint32否-sku价格，单位分1590
└ commissionint32否-sku佣金，单位分，和tr二选一500
└ take_ratestring否-tr比例0.02
└ show_tagsstring否-显示标签：免预约,过期退免预约,过期退

请求示例​

{
    "app_key": "43276baa5dca68a000001bbbbbb0fdddd",
    "param": {
        "items": [
            {
                "ext_id": "10982",
                "category_id": "1001001",
                "type": 101,
                "name": "商品1018",
                "logo": "logo.jpg",
                "guiding_price": 1590,
                "price": 1590,
                "separated_price": 1290,
                "commission": 500,
                "take_rate": "500",
                "start_time": "2022-04-23 18:48:37",
                "end_time": "2022-04-29 18:48:37",
                "show_start_time": "2022-04-22 18:48:37",
                "show_end_time": "2022-04-29 18:48:37",
                "available_time": "2022-04-23 18:48:37",
                "unusable_time": "2022-04-29 18:48:37",
                "status": 1,
                "purchase_limit": 100,
                "images": [
                    "http://image1.jpg",
                    "http://image2.jpg"
                ],
                "description": "商品描述",
                "image_description": [
                    "http://image1.jpg",
                    "http://image2.jpg"
                ],
                "image_pictures_text": [
                    "http://image1.jpg",
                    "http://image2.jpg"
                ],
                "instruction": {
                    "entries": [
                        {
                            "tile": "有效期",
                            "text": [
                                "购买后35天有效 可用星期：星期1、星期2、星期3、星期4、星期5、星期6、星期7"
                            ]
                        }
                    ],
                    "summary": [
                        "1、本套餐活动不可同时享受店里其他优惠活动，超出套餐内容费用，按店内实际收费另付",
                        "2、如部分菜品因时令或其他不可抗因素导致无法提供，商家将用等价菜品替换"
                    ]
                },
                "image_instruction": [
                    0,
                    0
                ],
                "show_tags": "免预约,过期退",
                "skus": [
                    {
                        "ext_id": "10982",
                        "name": "商品1018-sku1",
                        "description": "sku描述",
                        "image_description": [
                            "http://image1.jpg",
                            "http://image2.jpg"
                        ],
                        "image_pictures_text": [
                            "http://image1.jpg",
                            "http://image2.jpg"
                        ],
                        "instruction": {
                            "entries": [
                                {
                                    "tile": "有效期",
                                    "text": [
                                        "购买后35天有效 可用星期：星期1、星期2、星期3、星期4、星期5、星期6、星期7"
                                    ]
                                }
                            ],
                            "summary": [
                                "1、本套餐活动不可同时享受店里其他优惠活动，超出套餐内容费用，按店内实际收费另付",
                                "2、如部分菜品因时令或其他不可抗因素导致无法提供，商家将用等价菜品替换"
                            ]
                        },
                        "image_instruction": [
                            "http://image1.jpg",
                            "http://image2.jpg"
                        ],
                        "logo": "logo.jpg",
                        "images": [
                            "http://image1.jpg",
                            "http://image2.jpg"
                        ],
                        "ext_stock": 1000,
                        "incr_stock": 1000,
                        "default_chosen": 1,
                        "guiding_price": 1590,
                        "price": 1590,
                        "commission": 500,
                        "take_rate": "0.02",
                        "show_tags": "免预约,过期退"
                    }
                ]
            }
        ]
    }
}

响应参数​

名称类型必填最大长度描述示例值
errnostring否-服务响应状态0
errmsgstring否-服务响应状态说明success
dataarray否-响应数据

响应示例​

{
    "errno": "0",
    "errmsg": "success",
    "data": []
}

错误码​

无