批次管理 · V2.0.0
企业发起结算批次 SETTLEMENT_BATCH_INITIATION
用于企业发起结算批次的开放平台接口。具体字段、状态和业务约束以本页参数定义及正式接口文档为准。
接口价值
批次结算能力
功能对应
用于企业发起结算批次的开放平台接口。具体字段、状态和业务约束以本页参数定义及正式接口文档为准。
业务价值
适合串联结算批次发起、审批、支付、结果查询、回单和异常明细处理,便于系统化管理批次状态。
适合接入
适合需要把相关业务能力嵌入自有平台、SaaS、园区系统或企业内部系统的技术团队。具体业务适用性应结合真实场景与正式合作范围确认。
调用规范
公共调用信息
传输协议HTTPS
请求方式POST
报文格式JSON
字符集UTF-8
批次管理批次审批结果查询
公共请求参数
| 参数名称 | 参数说明 | 类型 | 长度 | 约束 | 说明 |
|---|---|---|---|---|---|
firstProviderCode | 一级服务商编号 | String | 18 | M | 由平台分配 |
secondProviderCode | 二级服务商编号 | String | 18 | O | 由平台分配 |
M = 必填,O = 选填,C = 条件必填。除特殊说明外参数类型均为 String;金额字段单位为元,并保留两位小数。
字段定义
业务请求参数
请求参数
| 参数名称 | 参数说明 | 长度 | 约束 | 描述 |
|---|---|---|---|---|
| parkCode | 园区编号 | 32 | M | |
| enterpriseCode | 企业编号 | 32 | M | |
| taskCode | 任务编号 | 32 | M | |
| channelCode | 通道编号 | 32 | M | 见编码表 6.10 |
| mainAcctNo | 主账号 | 128 | M | 调用用工企 业账户查询 获取 |
| subAcctNo | 子账号 | 128 | M | 调用用工企 业账户查询 获取 |
| voucherCodes | 完工凭证编号列表 | M | 最多1000条完 工凭证编号 | |
| batchRemark | 批次备注 | 20 | O | 默认值:服务费 |
字段定义
业务响应参数
响应参数
| 参数名称 | 参数说明 | 长度 | 约束 | 描述 |
|---|---|---|---|---|
| batchItems | 批次明细列表 | O |
响应子结构 1
| 参数名称 | 参数说明 | 长度 | 约束 | 描述 |
|---|---|---|---|---|
| voucherCode | 完工凭证编号 | 32 | M | |
| batchCode | 批次编号 | 32 | M | |
| batchDetailCode | 批次明细编号 | 32 | M |
FAQ
常见问题
SETTLEMENT_BATCH_INITIATION 接口是做什么的?
用于企业发起结算批次的开放平台接口。具体字段、状态和业务约束以本页参数定义及正式接口文档为准。
调用 SETTLEMENT_BATCH_INITIATION 前需要了解什么?
开放平台统一使用 HTTPS,通过 POST 调用 /openapi/v2/access-provider,请求和响应采用 JSON、UTF-8;公共请求参数包含 firstProviderCode(必填)和 secondProviderCode(选填)。具体报文结构、签名和加密规则以平台提供的正式接口手册/JAR包为准。
基于《开放平台接口 V2.0》正文整理,当前修订版本 V2.0.0,修订日期 2026-06-09。页面仅对附件中明确给出的接口字段进行结构化展示,不自行补造未提供的请求/响应定义。