# 子订单添加/变更

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

# 请求地址

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

# 请求方法

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_sub_order_id	string	Y	商家子订单号
external_order_id	string	Y	关联的商家订单号
create_time	string	Y	子订单创建时间，unix时间戳字段长度为 13 字节
order_status	string	Y	子订单状态，1140已支付未发货取消，1150已支付待发货/已支付待核销，1160已发货，1180销售完成/已收货/已核销
status_change_time	string	Y	子订单状态变更时间，unix毫秒级时间，如 order_status状态为 1150 ，则传 1150（已支付待发货）状态变更的时间
goods_info	array	Y	子订单商品信息，数组类型，每个sku存一个数组单位
external_sku_id	string	Y	sku 编号
goods_num	integer	Y	商品数量
is_deleted	integer		商家标记订单已删除，0：未删除；1：已删除，为空默认为 0

# 请求体示例

{
  "dataSourceId": "101",
  "orders": [
    {
      "external_sub_order_id": "3445222201",
      "external_order_id": "34452222",
      "create_time": "1572395131732",
      "order_status": "1150", // 见<枚举列表>页
      "status_change_time": "1572395131732",
      "goods_info": [
        {
          "external_sku_id": "cS1cWjrkFbFUA",
          "goods_num": 2
        },
        {
          "external_sku_id": "caaajrkFbFUA",
          "goods_num": 1
        }
      ],
      "is_deleted": 0
    }
  ]
}

# 应答体结构

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

# 应答示例

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

# 常见FAQ

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

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

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

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

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

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

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

← 订单添加/变更订单状态变更 →