# 设置订单分账信息

# 接口调用请求说明

接口强制校验来源IP

  1. 调用本接口前请先检查是否已经添加分账方
  2. 在订单结算前可以为订单设置分账信息。成功设置订单分账信息后,会在订单结算时统一为分账方进行分账。订单结算时间为售后期结束后。售后期概念见生成订单接口
  3. 如需修改订单分账信息,可以多次调用本接口,结算时会以最后一次调用时所设置的分账信息为准。但需注意,每次调用本接口会更新该订单下的整个分账列表。设置分账信息成功后可以通过获取订单详情接口得到订单commission_info.
  4. 每种sku的分账信息需要单独设置,每种sku所设置的总分账比例不能超过sku实付价的30%。
  5. 如果订单结算时某个sku曾发生过退款(包括部分退款以及全部退款),则该sku不参与分账,该sku下所设置的分账信息无效。
  6. 每个分账方分账成功后会有一条结算成功回调.收到结算成功回调后可以通过获取订单详情接口在订单settlement_info中找到对应分账记录。
http请求方式:POST
https://api.weixin.qq.com/shop/commission/setordercommission?access_token=xxxxxxxxx

# 请求参数示例

{
    "order_id": 123455,
    "out_order_id": "xxxxx",
    "openid": "oTVP50O53a7jgmawAmxKukNlq3XI",
    "commission_list": [
    {
        "mchid":"1234567",
        "account_type":0,
        "out_product_id":"product_123",
        "out_sku_id":"sku_123",
        "amount":15,
        "commission_type":1
    }
    ]
}

# 回包示例

{
    "errcode": 0,
    "errmsg":"ok"
}

# 请求参数说明

参数 类型 是否必填 说明
order_id string 订单ID
out_order_id string 商家自定义订单ID,与 order_id 二选一
openid string 下单用户的openid
commission_list CommissionRecord[] 分账信息

CommissionRecord

参数 类型 是否必填 说明
mchid string 商户号
account_type number 账户类型,0:商户,默认值为0
out_product_id string 外部商品编号
out_sku_id string 外部sku编号
amount number sku的总分账金额,单位为分
commission_type number 分账类型,1:服务商,默认值为1

# 回包参数说明

参数 类型 说明
errcode number 错误码
errmsg string 错误信息

# 返回码

返回码 错误类型
-1 系统异常
48001 无权限调用该api
1010011 订单不存在,请检查订单号及openid
1012004 分账方不存在
1012005 分账商品在订单中不存在
1012006 商品分账比例不符合要求
1012007 订单已经开始结算,不可设置分账信息