Skip to main content
Version: 1.0 版本

3.0 结算单管理

将多个任务生成可支付订单,完成支付操作

3.1 生成结算单

简要描述
  • 根据任务 ID，生成结算单
请求 URL
  • /task/openapi/v1/bill/create
请求方式
  • POST
返回类型
  • JSON
请求参数说明
参数名必选类型说明
/是Array任务 ID 数组 demo:[1,2,3]

返回参数说明

参数名类型说明
idLong结算单 id
billCodestring结算单号
billAmountbigdecimal结算金额
billStatusstring结算状态参考数据字典[0004-结算单状态]
failedtasksArray创建失败的任务列表
请求参数示例
[423092]
正确返回示例
{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": {
    "id": 528,
    "billCode": "S2020072000002",
    "billAmount": 663.29,
    "billStatus": "1",
    "failedtasks": null
  }
}
错误返回示例
{
  "msg": "参数缺失",
  "code": "010001",
  "success": false,
  "data": null
}
备注

3.2 结算单列表

简要描述
  • 查询结算单列表(默认分页,size:20)
请求 URL
  • /task/openapi/v1/bill/list
请求方式
  • GET
返回类型
  • JSON
请求参数说明
参数名必选类型说明
pageNo否Long页码，默认 1
billCode否string结算单号
billStatusstring结算状态参考数据字典-0004-结算单状态
startDate否string创建时间起（格式：2020-07-20 00:00:00）
endDate否string创建时间止（格式：2020-07-20 23:59:59）

返回参数说明

参数名类型说明
pageNoLong页码
pageSizeLong分页条数
pageCountLong总页数
totalCountLong总数
idLong结算单 id
billCodestring结算单号
Long任务条数
billAmountbigdecimal结算金额
taskAmountbigdecimal任务金额
serviceAmountbigdecimal服务费
billStatusstring结算状态参考数据字典-0004-结算单状态
正确返回示例
{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": {
    "pageNo": 1,
    "pageSize": 20,
    "pageCount": 1,
    "totalCount": 6,
    "entityList": [
      {
        "id": 527,
        "billCode": "S2020072000001",
        "billAmount": 541.03,
        "billStatus": "1",
        "createTimeStr": "2020-07-20 15:07:05"
      },
      {
        "id": 526,
        "billCode": "S2020071700101",
        "billAmount": 1312.31,
        "billStatus": "3",
        "createTimeStr": "2020-07-17 16:16:21"
      }
    ]
  }
}
备注

3.3 结算单明细列表

简要描述
  • 分页查询结算单明细列表
请求 URL
  • /task/openapi/v1/bill/list_detail
请求方式
  • GET
返回类型
  • JSON
请求参数说明
参数名必选类型说明
pageNo否Long页码，默认 1
billCode否string结算单号
billStatus否string结算状态参考数据字典-0004-结算单状态
realName否string真实姓名
identityNo否string身份证
phone否string手机号
startDate否string创建时间起（格式：2020-07-20 00:00:00）
endDate否string创建时间止（格式：2020-07-20 23:59:59）

返回参数说明

参数名类型说明
pageNoLong页码
pageSizeLong分页条数
pageCountLong总页数
totalCountLong总数
idLong结算单明细 id
billCodestring结算单号
billAmountbigdecimal结算金额
billStatusstring结算状态参考数据字典-0004-结算单状态
realNamestring真实姓名
identityNostring身份证
bankAccountNostring银行卡
phonestring手机号
taskStatus否string
taskNamestring任务名称
taskAmountstring任务金额
taskCodestring任务号
createTimeStrstring创建时间
正确返回示例
{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": {
    "pageNo": 1,
    "pageSize": 20,
    "pageCount": 1,
    "totalCount": 1,
    "entityList": [
      {
        "id": null,
        "billCode": "S2020072000002",
        "taskAmount": 663.29,
        "serviceAmount": 39.79,
        "billAmount": 703.08,
        "billStatus": "1",
        "taskCode": "T20200717000007",
        "taskName": "信息服务",
        "taskStatus": "10",
        "realName": "彻蕉腐",
        "identityNo": "311501198010066243",
        "phone": "18690902491",
        "bankAccountNo": "4027910064983472",
        "createTimeStr": "2020-07-20 15:19:47"
      }
    ]
  }
}
备注

3.4 结算单发起支付

简要描述
  • 根据结算单 ID，发起支付
请求 URL
  • /task/openapi/v1/bill/pay
请求方式
  • POST
返回类型
  • JSON
请求参数说明
参数名必选类型说明
/是Array结算单 ID 数组

返回参数说明

参数名类型说明
idLong结算单 id
billCodestring结算单号
billAmountbigdecimal结算金额
billStatusstring结算状态参考数据字典-0004-结算单状态
createTimeStrstring创建时间
请求参数示例
[423092]
正确返回示例
{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": [
    {
      "id": 525,
      "billCode": "S2020071700005",
      "billAmount": 407,
      "billStatus": "1",
      "createTimeStr": "2020-07-17 11:32:12"
    }
  ]
}
错误返回示例
{
  "msg": "参数缺失",
  "code": "010001",
  "success": false,
  "data": null
}
备注

3.5 结算单取消支付

简要描述
  • 根据结算单 ID，取消支付（只能取消申请中状态的结算单）
请求 URL
  • /task/openapi/v1/bill/pay_cancel
请求方式
  • POST
返回类型
  • JSON
请求参数说明
参数名必选类型说明
/是Array结算单 ID 数组

返回参数说明

参数名类型说明
idLong结算单 id
billCodestring结算单号
billAmountbigdecimal结算金额
billStatusstring结算状态参考数据字典-0004-结算单状态
createTimeStrstring创建时间
请求参数示例
[525]
正确返回示例
{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": [
    {
      "id": 525,
      "billCode": "S2020071700005",
      "billAmount": 407,
      "billStatus": "8",
      "createTimeStr": "2020-07-17 11:32:12"
    }
  ]
}
错误返回示例
{
  "msg": "参数缺失",
  "code": "010001",
  "success": false,
  "data": null
}
备注
  • 更多返回错误代码请看首页的错误代码描述