跳到主要内容

线下销售信息添加/更新


前置条件

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


请求地址​

https://api.e.qq.com/v3.0/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_idintegerY推广帐号 id或 DataNexus 账号 id
user_action_set_idintegerYDataNexus数据源id
data_set_idintegerYDataNexus数据集id
salesinfoarrayY商品库存价格列表 数组最大长度 50
external_store_idstringY客户侧店铺/仓库 id 字段长度最小 1 字节，长度最大 32 字节
seller_idstring卖家 id，由平台类商家自己生成，长度最大 128 字节
external_sku_idstringY您为商品 sku 分配的唯一 id。 色码款商品必填。 字段长度最小 1 字节，长度最大 128 字节
product_typeinteger商品类型，1：普通商品；2：赠品；3：小样；4：套装商品
priceobjectY商品价格信息
daily_pricefloat商品日常售价，单位：元，保留两位小数
current_pricefloatY商品目前售价，单位：元，保留2位小数；大于等于0，最小值0；current_price需≤sku_price
sku_pricefloatY商品原价，单位：元，保留2位小数；大于等于0，最小值0；current_price需≤sku_price
after_coupon_pricefloat券后价，券后价=商品现价-券面额，单位元，保留 2 位小数
currency_translationboolean商品价格是否为外币汇率折算后价格，true:是；false：否，默认为false
sku_promotionsarray商品活动及促销价列表 数组最大长度 50
external_promotion_idstringC活动 id，当填写了 promotion_price 必填
promotion_pricefloatC活动价格，当填写了 external_promotion_id 必填
normal_product_infoarray关联的正品的价格，当该商品为小样时需填写，单位元，保留 2 位小数
sku_idstring关联的商品id字段长度最小 1 字节，长度最大 128 字节
normal_product_pricefloat正品价格
stockobjectY库存信息
available_statusinteger同一个商品在不同店仓中的上下架状态，1：上架；2：下架，为空默认为上架
sku_stock_statusintegerY同一个商品在不同店仓中的销售状态 1：库存＞0；2：库存≤0（常见为售罄/暂无库存商品在页面底部展示，可标记为状态2）
stock_totalintegerC商品总库存量，当product_type=3（小样）时必填
sales_numinteger展示销量
delivery_infoarray配送信息
freight_amountfloat运费金额，单位元，保留 2 位小数
locationarray地址信息
country_codestring国家编码，CN 字段长度最小 1 字节，长度最大 64 字节
country_namestring国家名称，中国 字段长度最小 1 字节，长度最大 64 字节
province_codeinteger省份编码，使用《民政部行政区划代码》，440000
province_namestring省份名称，XX省 字段长度最小 1 字节，长度最大 64 字节
city_codeinteger城市编码，使用《民政部行政区划代码》
city_namestring城市名称，XX市 字段长度最小 1 字节，长度最大 64 字节
district_codeinteger区/县编码，使用《民政部行政区划代码》
district_namestring区/县名称，XX市 字段长度最小 1 字节，长度最大 64 字节
target_url_propsobject商品目标页信息
url_miniprogramstringC微信小程序落地页 url，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appidstringC微信小程序 appid，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_usernamestringC小程序原始ID，登录小程序管理后台-设置-基本设置-帐号信息中，gh_xx，当落地页为微信小程序时必填字段长度最小 1 字节，长度最大 100 字节
url_miniprogram_qqstringCqq小程序落地页 url，当落地页为QQ小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appid_qqstringCqq小程序 appid，当落地页为QQ小程序时必填 字段长度最小 1 字节，长度最大 100 字节
url_h5stringCh5落地页url 字段长度最小 1 字节，长度最大 100 字节
url_h5_2stringh5落地页url 字段长度最小 1 字节，长度最大 1000 字节
url_h5_3stringh5落地页url 字段长度最小 1 字节，长度最大 1000 字节
coupon_infoarray优惠券信息
coupon_idstring券批次id 字段长度最小 1 字节，长度最大 100 字节
coupon_typeinteger券类型，1：公开券；2：CPS优惠券；3：渠道专享券
amount_couponfloat券面额，单位元，保留 2 位小数，字段长度最小 1 字节，长度最大 100 字节
url_liststring券地址
amount_minimumfloat使用卡券的最低消费金额，单位元，保留 2 位小数
show_start_timestring展示开始时间/券领取开始时间，unix毫秒级时间戳，为空表示永久
show_end_timestring展示结束时间/券领取结束时间，unix毫秒级时间戳，为空表示永久
start_timestring券有效使用开始时间，unix毫秒级时间戳，为空表示永久
end_timestring券有效使用结束时间，unix毫秒级时间戳，为空表示永久
available_num_per_personinteger每个用户可领取优惠券数量上限
total_numinteger实际总数量
store_numinteger优惠券剩余张数
statusinteger优惠券状态，1：过期；0：未过期
tag_infoobject商品的标签信息 数组最大长度 10
custom_tagarray商品的标签信息 数组最大长度 50
tag_namestring标签名称，长度最大 2048 字节
tag_valuestring[]标签值，长度最大 2048 字节
third_promotion_infoobjectCPS业务必填，第三方推广信息
commission_ratefloatC佣金比例，2位小数，不带百分号，如 10% 填10.00
promote_statusintegerC推广状态；1：推广中；0：停止推广
commission_amountfloat佣金 = 商品现价*佣金比例
commission_amount_after_couponfloat券后佣金 =（商品现价-券面额）*佣金比例
start_timestring推广计划开始时间,unix毫秒级时间戳，为空表示永久
end_timestring推广计划结束时间,unix毫秒级时间戳，为空表示永久
exclusive_infoobject专属商品信息
exclusive_statusinteger专属商品标识，1：专属商品；0：普通商品
kol_idarray可推广商品的达人ID，如54321836
is_deletedinteger商家标记商品 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": ["法国"]
          }
        ]
      }
    }
  ]
}

应答体结构​

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

应答示例​

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



该内容是否有帮助？