销售信息添加/变更（多店版）

开发之前请创建有数数据仓库 （dataSourceId），可将 dataSourceId 理解为数据的集合。创建一个数据仓库后，所有接口传输数据时都可重复使用。

请求地址

域名/data-api/v1/salesinfo/add

请求方法

POST

请求参数

参数名	样例	描述
app_id	abc	分配的app_id
nonce	61794670f155b	随机字符串
sign	sha256	签名算法
timestamp	1569232087	请求时间戳（秒级）
signature	aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5	签名结果

请求体参数

名称	类型	必填	描述
dataSourceId	string	Y	数据源id（create方法返回的data.dataSource.id）
salesinfo	array	Y	商品库存价格列表 数组最大长度 50
external_store_id	string	Y	客户侧店铺/仓库 id 字段长度最小 1 字节，长度最大 32 字节
seller_id	string		卖家 id，由平台类商家自己生成，长度最大 128 字节
external_sku_id	string	Y	您为商品 sku 分配的唯一 id。 色码款商品必填。 字段长度最小 1 字节，长度最大 128 字节
product_type	integer		商品类型，1：普通商品；2：赠品；3：小样；4：套装商品
price	object	Y	商品价格信息
daily_price	float		商品日常售价，单位：元，保留两位小数
current_price	float	Y	商品目前售价，单位：元，保留2位小数；大于等于0，最小值0；current_price需≤sku_price
sku_price	float	Y	商品原价，单位：元，保留2位小数；大于等于0，最小值0；current_price需≤sku_price
after_coupon_price	float		券后价，券后价=商品现价-券面额，单位元，保留 2 位小数
after_coupon_price_hm	float		惠买专项券后价，券后价=商品现价-券面额，单位元，保留 2 位小数
currency_translation	boolean		商品价格是否为外币汇率折算后价格，true:是；false：否，默认为false
sku_promotions	array		商品活动及促销价列表 数组最大长度 50
external_promotion_id	string	C	活动 id，当填写了 promotion_price 必填
promotion_price	float	C	活动价格，当填写了 external_promotion_id 必填
normal_product_info	array		关联的正品的价格，当该商品为小样时需填写，单位元，保留 2 位小数
sku_id	string		关联的商品id字段长度最小 1 字节，长度最大 128 字节
normal_product_price	float		正品价格
stock	object	Y	库存信息
available_status	integer		同一个商品在不同店仓中的上下架状态，1：上架；2：下架，为空默认为上架
sku_stock_status	integer	Y	同一个商品在不同店仓中的销售状态 1：库存＞0；2：库存≤0（常见为售罄/暂无库存商品在页面底部展示，可标记为状态2）
stock_total	integer	C	商品总库存量，当product_type=3（小样）时必填
sales_num	integer		展示销量
sales_num_type	integer		展示销量口径，1：近 30 天销量；2：历史累计销量
delivery_info	array		配送信息
freight_amount	float		运费金额，单位元，保留 2 位小数
location	array		地址信息
country_code	string		国家编码，CN 字段长度最小 1 字节，长度最大 64 字节
country_name	string		国家名称，中国 字段长度最小 1 字节，长度最大 64 字节
province_code	integer		省份编码，使用《民政部行政区划代码》，440000
province_name	string		省份名称，XX省 字段长度最小 1 字节，长度最大 64 字节
city_code	integer		城市编码，使用《民政部行政区划代码》
city_name	string		城市名称，XX市 字段长度最小 1 字节，长度最大 64 字节
district_code	integer		区/县编码，使用《民政部行政区划代码》
district_name	string		区/县名称，XX市 字段长度最小 1 字节，长度最大 64 字节
target_url_props	object		商品目标页信息
url_miniprogram	string	C	微信小程序落地页 url，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appid	string	C	微信小程序 appid，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_username	string	C	小程序原始ID，登录小程序管理后台-设置-基本设置-帐号信息中，gh_xx，当落地页为微信小程序时必填字段长度最小 1 字节，长度最大 100 字节
url_miniprogram_qq	string	C	qq小程序落地页 url，当落地页为QQ小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appid_qq	string	C	qq小程序 appid，当落地页为QQ小程序时必填 字段长度最小 1 字节，长度最大 100 字节
url_h5	string	C	h5落地页url 字段长度最小 1 字节，长度最大 100 字节
url_h5_2	string		h5落地页url 字段长度最小 1 字节，长度最大 1000 字节
url_h5_3	string		h5落地页url 字段长度最小 1 字节，长度最大 1000 字节
coupon_info	array		优惠券信息
coupon_id	string		券批次id 字段长度最小 1 字节，长度最大 100 字节
coupon_type	integer		券类型，1：公开券；2：CPS优惠券；3：渠道专享券；4：定向券；5：满折券
amount_coupon	float		券面额，单位元，保留 2 位小数，字段长度最小 1 字节，长度最大 100 字节
stock_status	integer		卡券的库存状态 1：库存＞0；2：库存≤0
url_list	string		券地址
amount_minimum	float		使用卡券的最低消费金额，单位元，保留 2 位小数
show_start_time	string		展示开始时间/券领取开始时间，unix毫秒级时间戳，为空表示永久
show_end_time	string		展示结束时间/券领取结束时间，unix毫秒级时间戳，为空表示永久
start_time	string		券有效使用开始时间，unix毫秒级时间戳，为空表示永久
end_time	string		券有效使用结束时间，unix毫秒级时间戳，为空表示永久
available_num_per_person	integer		每个用户可领取优惠券数量上限
total_num	integer		实际总数量
store_num	integer		优惠券剩余张数
status	integer		优惠券状态，1：过期；0：未过期
tag_info	object		商品的标签信息 数组最大长度 10
custom_tag	array		商品的标签信息 数组最大长度 50
tag_name	string		标签名称，长度最大 2048 字节
tag_value	string[]		标签值，数组，长度最大 2048 字节
third_promotion_info	object		CPS业务必填，第三方推广信息
commission_rate	float	C	佣金比例，2位小数，不带百分号，如 10% 填10.00
promote_status	integer	C	推广状态；1：推广中；0：停止推广
commission_amount	float		佣金 = 商品现价*佣金比例
commission_amount_after_coupon	float		券后佣金 =（商品现价-券面额）*佣金比例
start_time	string		推广计划开始时间,unix毫秒级时间戳，为空表示永久
end_time	string		推广计划结束时间,unix毫秒级时间戳，为空表示永久
exclusive_info	object		专属商品信息
exclusive_status	integer		专属商品标识，1：专属商品；0：普通商品
kol_id	array		可推广商品的达人ID，如 54321836
is_deleted	integer		商家标记商品 salesinfo 信息已删除，0：未删除；1：已删除，为空默认为 0

请求体类型

application/json

请求示例

{
    "dataSourceId": "105",
    "salesinfo": [
        {
            "external_sku_id": "HB-P-fcmjsb280g",
            "external_store_id": "MRYXBJN-SHIFUOYING",
            "price": {
                "current_price": 8.90,
                "daily_price": 10.00,
                "sku_price": 10.00,
                "sku_promotions": [
                    {
                        "external_promotion_id": "XB-S-fcmjsb280g",
                        "promotion_price": 7.90
                    }
                ]
            },
            "stock": {
                "sku_stock_status": 1
            },
            "target_url_props": {
                "miniprogram_appid": "wx8186e1f37ac111ec",
                "url_miniprogram": "pages/index/index?productSku=HB-P-fcmjsb280g&fromSource=soso&goPage=productDetail"
            },
            "tag_info":{
                "custom_tag": [
                    {
                        "tag_name": "商品规格",
                        "tag_value": ["30ml"]
                    }, 
                    {
                        "tag_name": "营销卖点",
                        "tag_value": ["法式浪漫甜美", "鲜活愉悦", "自信清新"]
                    }, 
                    {
                        "tag_name": "适合肤质",
                        "tag_value": ["适合任何肤质"]
                    }, 
                    {
                        "tag_name": "原产国",
                        "tag_value": ["法国"]
                    }
                ]
            }      
        }
    ]
}

应答字段

名称	类型	描述
retcode	integer	返回码
errmsg	string	错误信息
data	json object	响应内容

应答示例

{
    "retcode": 0,
    "errmsg": "",
    "data": {}
}