订单状态变更

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

请求地址

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

请求方法

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
external_order_id	string	Y	商家订单号
order_status	string	Y	主订单状态，1150已支付待发货，1160已发货，1180销售完成/已收货，1280退款中，1290退货完成
status_change_time	string	Y	状态变更时间，unix毫秒级时间，如 order_status状态为 1150 ，则传 1150（已支付待发货）状态变更的时间

请求体示例

{
    "dataSourceId":"123",
    "orders":[
        {
            "external_order_id":"ORDER_2888811",
            "order_status":"1180",
            "status_change_time":"1607148404000"
        }
    ]
}

应答体结构

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

应答示例

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

---

常见FAQ

问：创建数据仓库时返回retcode: 16 errmsg: data_source_already_exist，该如何处理？

答：该返回代表该接口已创建过数据仓库，请使用获取有数数据仓库接口获取已创建好的 dataSourceId 。

问：订单状态很多，该传哪些状态？

答：必传的订单状态有 1110 待支付，1130未支付取消，1140已支付未发货取消，1150 已支付待发货，1160 已发货，1180 销售完成/已收货。具体可参考枚举列表 。

问：1130未支付取消和1140已支付未发货取消的区别是？

答：1130未支付取消是指用户下单后，在支付之前发起的取消订单，该状态下的订单不会计入 GMV；1140已支付未发货取消是指用户下单支付后，在发货之前发起的取消订单，该状态下的订单会计入 GMV。

问：订单同步的时效性要求是？

答：订单要求实时上报（5分钟内）。

更多疑问，可前往常见问题清单。