ORD-102 提交派发数据

✅ 接口能力

该接口包含校验、计算费用明细和生成订单的能力，默认创建成功的订单为待支付状态，可先调用ORD-101验证派发数据完成预校验和费用明细计算，也可直接跳过该预校验步骤.

✅计算流程

本系统派发采用 [子订单核算、主订单聚合] 的处理逻辑，具体流程如下：

单人维度计算
针对 API 传入的每个发放人员【即本系统的子订单】，分别计算以下核心金额：

orderAmount | 子订单金额：服务费 + 税金 + 到账金额；

serviceAmount | 服务费：按既定费率规则计算；

taxAmount | 税金：依据适用税率及计税基数核算；

receivedAmount | 到账金额：扣除上述服务费和税金后得出

批量聚合统计
系统会聚合同一批次的所有子订单生成当前的主订单，对每个发放人员【即本系统的子订单】的计算结果进行对应累加：

orderAmount | 主订单总金额 = 总服务费 + 总税金 + 总的到账金额

serviceAmount | 总服务费 = 所有子订单服务费之和

taxAmount | 总税金 = 所有子订单税金之和

receivedAmount | 总到账金额 = 所有子订单到账金额之和

【上述金额字段均保留两位小数，遵循四舍五入规则】

✅测试人员配置

测试环境-招商银行支付-派发人员：

收款人	身份证号	银行卡号	手机号
鲁贺滢	500235199105040042	6214837811201973	17749555520

在测试环境下，仅以上指定人员可正常完成支付流程；其他人员进行支付时，因不为招商银行指定测试人员，订单将持续处于 “支付中” 状态

❗ 规则限制

⚠️因劳务报酬涉及个税申报规范，相关订单需遵守以下限制：

每月最后一天 23:00 起，禁止创建新订单；

待支付订单若当月未完成支付，次月将自动取消；

订单支付截止时间为每月最后一天的23:50

（注：经营所得相关订单不受上述限制）

派发人员数据上限1000条

订单的收入性质和开票方式取决于任务的收入性质和开票方式

请求参数

Authorization

Header 参数

Body 参数application/json

示例

{
    "companyId": 1743889921536,
    "dutyId": 3124589873664,
    "outOrderNo":"2021548796521",
    "orderDetailList": [
        {
            "outOrderDetailNo": "2197802177543",
            "personName": "顼建辉",
            "personIdNumber": "132302197802170311",
            "personBank": "6217000130060243390",
            "personTel": "15931072440",
            "amount": "10",
            "remark": "派发"
        },
        {
            "outOrderDetailNo": "3197682177575",
            "personName": "魏明宇",
            "personIdNumber": "411421199902277773",
            "personBank": "623059134401715798",
            "personTel": "18338707522",
            "amount": "10",
            "remark": "结算"
        }
    ],
    "settleType": "SETTLEMENT_AMOUNT"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
	"code": 0,
	"message": "成功",
	"context": {
		"orderId": "3336099698688",
		"orderAmount": 10.16,
		"totalNum": 1,
		"settlementAmount": 10,
		"serviceAmount": 0.2,
		"serviceRate": 2,
		"taxAmount": 0.05,
		"receivedAmount": 9.91,
		"submitList": [
			{
				"orderDetailNo": "ZB20250707000011",
				"outOrderDetailNo": "2197802177543",
				"orderAmount": 10.16,
				"settlementAmount": 10,
				"receivedAmount": 9.91,
				"serviceAmount": 0.2,
				"taxAmount": 0.05,
				"personName": "顼建辉",
				"personTel": "15931072440",
				"personBank": "6217000130060243390",
				"personIdNumber": "132302197802170311",
				"remark": "派发"
			}
		],
		"notSubmitList": [
			{
				"personName": "魏明宇",
				"personIdNumber": "411421199902277773",
				"personBank": "623059134401715798",
				"personTel": "18338707522",
				"settlementAmount": 10,
				"remark": "结算",
				"errorMsg": "存在未交易完成的订单!",
				"outOrderDetailNo": "3197682177575"
			}
		]
	},
	"traceId": "686b5cf5c6283308c5a564747a0f1d3e",
	"spanId": "958e70e4508a3b04"
}

ORD-102 提交派发数据

✅ 接口能力#

✅计算流程#

✅测试人员配置#