# 汇总订单添加/变更

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

上报时效要求：

每天 6:00 前完成前一天的数据上报。

# 请求地址

域名/data-api/v1/order/add_order_sum

# 请求方法

POST

# 请求参数

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

# 请求体类型

application/json

# 请求体参数

名称	类型	必填	描述
dataSourceId	string	Y	数据源id（create方法返回的data.dataSource.id）
orders	array	Y	订单列表数组最大长度 50
ref_date	string	Y	日期，unix时间戳，字段长度为13字节
give_order_amount_sum	float	Y	接入的数据源（如小程序），在统计日期，产生过下单的用户实付金额（orders.payment_amount）之和（含下单后取消，只要生成订单号就计算）
give_order_num_sum	integer	Y	接入的数据源（如小程序），在统计日期，产生过下单的订单数量之和（含下单后取消，只要生成订单号就计算）
payment_amount_sum	float	Y	接入的数据源（如小程序），在统计日期，产生过支付完成的用户实付金额（orders.payment_amount）之和（含支付成功后取消/退款，只要支付成功过就计算）
payed_num_sum	integer	Y	接入的数据源（如小程序），在统计日期，产生过支付完成的订单数量之和（含支付成功后取消/退款，只要支付成功过就计算）

# 请求体示例

{
    "dataSourceId": "101",
    "orders": [
        {
            "ref_date": "1643212800000",
            "give_order_amount_sum": 1000000.01,
            "give_order_num_sum": 1100,
            "payment_amount_sum": 1000000.01,
            "payed_num_sum": 1100
        }
    ]
}

# 应答体结构

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

# 应答示例

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

# 常见FAQ

问：ref_date的时间戳如何传？

答：如传 ”1 月 27 日“，传 1 月 27 日 0:00:00 的时间即可。

问：日期应该是 9 字节，13 字节如何传？

答：后面几位传 0 即可。

← 退款订单添加/变更上报页面访问 →