线下销售信息添加/更新

前置条件

获得 数据源，并在 资产分发 打开该数据源ID 的指定应用场景的分发开关。

请求地址

https://api.e.qq.com/v1.3/salesinfo/add

所属权限

数据上报（User Actions）

请求方法

POST

请求参数

参数名	描述
access_token	密钥信息，可在 DataNexus 的 数据源 - 【查看密钥】获取
timestamp	当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce	随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型

application/json

请求体参数

阅读说明：Y - 必填；C - 条件选填（conditional），请关注“描述”信息；空 - 非必填

名称	类型	必填	描述
account_id	integer	Y	推广帐号 id或 DataNexus 账号 id
user_action_set_id	integer	Y	DataNexus数据源id
data_set_id	integer	Y	DataNexus数据集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 位小数
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		展示销量
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：渠道专享券
amount_coupon	float		券面额，单位元，保留 2 位小数，字段长度最小 1 字节，长度最大 100 字节
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

请求示例

{
  "account_id": 1111111111,
  "user_action_set_id": 1111111111,
  "data_set_id": 1111111111,
  "salesinfo": [
    {
      "external_sku_id": "HB-P-fcmjsb280g",
      "external_store_id": "MRYXBJN-SHIFUOYING",
      "price": {
        "current_price": 8.9,
        "daily_price": 10.0,
        "sku_price": 10.0,
        "sku_promotions": [
          {
            "external_promotion_id": "XB-S-fcmjsb280g",
            "promotion_price": 7.9
          }
        ]
      },
      "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": ["法国"]
          }
        ]
      }
    }
  ]
}

应答体结构

名称	类型	是否一定返回	描述
code	integer	Y	返回码，等于0表示成功，不等于0表示错误，具体见文档附录
message	string	Y	错误描述，code不等于0时，message为错误描述
message_cn	string		中文错误描述，code不等于0时，message_cn为错误情况的中文描述
data	object		资源数据，具体返回内容见各接口定义，只在code等于0时可能返回
errors	object		详细错误信息，只在code不等于0时可能返回

应答示例

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

该内容是否有帮助？