京翎云享
  • 操作手册
  • 三方灵工平台对接接口
京翎云享
2024-09-04
目录

三方灵工平台对接接口

# 三方灵工平台对接接口

本接口专为与京翎云享合作的第三方灵活用工平台设计，旨在通过 API 调用的方式推进平台内客户业务的发展。有关接口的相关问题或对接细节，请通过专用接口对接群进行沟通。

# 一、名词解释

  1. 客户平台：指与京翎云享对接的第三方灵工平台；
  2. 商户：指通过客户平台接口接入京翎云享的企业；
  3. 用户：指C端用户，自由职业者。

# 二、功能结构

功能结构

提示：带有背景色的接口表示该接口既支持主动查询，也支持异步通知。
1

# 三、流程

流程图

1.接口调用顺序：以上为主流程的接口调用顺序，其他接口可根据实际需要调用。
2.任务自动终止逻辑：任务存在自动终止机制，请确保创建任务时填写的任务金额与任务内个人订单总金额一致。当个人订单总下发成功金额=任务金额时，系统将自动终止任务。如果出现金额不匹配的情况，请主动调用【终止任务】接口停止任务。
3.发票申请自动提交：发票申请将在每天00:30自动提交，无需客户手动操作。建议在每天01:00至09:00时间段内调用【查询发票申请记录】接口，保存相关信息，避免在推送发票附件时出现数据异常。
1
2
3

# 四、全局说明

# 1、请求地址

接入环境 API调用地址
生产环境-京翎自营 https://yun.jinglingyunxiang.com/task_platform/lhyg/v3
生产环境-蓝京翎 https://yun.lanjingling.cloud/task_platform/lhyg/v3
测试环境 https://devyun.jinglingyunxiang.com/task_platform/lhyg/v3

# 2、请求报文

# 2.1、Body部分

# （1）字段说明

字段 说明
bizData 请求参数（加密后）
sign sign由分配的平台label和tradeNo组成，tradeNo对应各个业务接口。字段之间使用英文","分隔，使用Base64进行编号。
//编号示例
String encodedString = Base64.getEncoder().encodeToString("label,tradeNo".getBytes());
//解码
byte[] decode = Base64.getDecoder().decode(encodedString);
1
2
3
4
{
    "bizData": "GDw9zz+ifJSBiWKdFjtr1YOFEpQGFReMhFHP9/YRDyGG7+J/v3GRtdoj2djOWx3BckhK6WgiSzVAUr1hrO4oDjFZp8qwvPTcnkOrx3o0KsW4c0N2PJ10E7Ptgzg5VgiqffdB9YYstSyceUUA6T+fHGjyFSfVwhnw19hm2QcPpONNUbIFH+VZLwd8IW9MdUFMHxf/XkEgtl7RfHeVjEnoNfSnGkEE6hLoqoUt2X56oFgf55PZ1ztp2xiO6uxp3Hthi/tigg7KXBItkqbfVanu8fPQLtvXA53ILmJkcAY+qMM0X5sLSDG+3hchqhOgC0mSsS9MfpBHA1ab7gA4iSh9KUiTZlthT6Hk5lnlGpInf+2sUbzSdIC/UlHlHGwJ1nraVf54+UGOrP3+hmeMHRUrCzFxXWpZmbnSOZZzdLEcBXhC4UgqURJwadxWhMwEJ8e2kK8bIK3wYGz6rOM+l4Nf+kOgXXpJlNc82edw+/jX/VhpTdbVPF6GTti7VcMfWkrAP3DrAh4t/0oy5XOgfo4eAUH46b8gbI1QgJ07KTyvVQSpSbYr+3xppmu65wJsC2OWe/L/A7siAF1vaVq5+/Jd29jBQsdgYDcgW1M0uGs+Noy3RgxrjZg800N2RdIt/rGqeOgc9NuHhd4v1RNGODbW5qgzelepVMKdtDWF5mp/ZK4B5lhhnEu8eahqAtfJPfdFN4DCzEikX2SElGvTqbtzFapdv5oroaXvsm7WhVUHf8d9gD8WA1OtB2qO1SYp38lezwAj+BCUSRxILJNxLxpJZMSr68MY40WevoBUc6HPvEL6SDRmelEHkhnzESqcFUtIPlNWMb59Gtkma04r9Sn2DabkRdY3A+X9JI3jqoQCuG9N7Q3S8Oq8IKkY+wnpgfO8nzv9UfRwF+jkmiyuyX0O7EK7HHknb/3nj6s4PCs7Nz5wQFro/0324q1xU+F6aTI6o11Ezn1peHOnwcYJW6+m+kD1NS8eUl+3defjTZIoUx7mhFJJsAmSNji2J0KN78AcbrD8WJUFxXd+QyVJ7r41/g==",
    "sign": "MSxWM1QwMDE="
}
1
2
3
4

# 3、请求方式

​ 所有接口均采用POST请求方式

# 3、请求报文加密

当前接口使用 AES 对称加密方式进行加密处理。以下是 Java 代码示例：

//bizData加密示例
//bizData为业务数据JSON，key为平台分配的密钥

public String encrypt(byte[] data, String key) {
        AES aes = SecureUtil.aes(key.getBytes(StandardCharsets.UTF_8));
        byte[] encrypted = aes.encrypt(data);
        return Base64.encode(encrypted);
    }
1
2
3
4
5
6
7
8
//sign编号示例
String encodedString = Base64.getEncoder().encodeToString("label,tradeNo".getBytes());
1
2

# 4、返回报文解析

当前接口使用 AES 对称加密方式对业务数据进行加密处理。下面是 Java 代码示例，展示如何解密这些加密数据。

//bizData解密示例
//bizData为业务数据JSON，key为平台分配的密钥
public String decrypt(String bizData, String key) {
        AES aes = SecureUtil.aes(key.getBytes(StandardCharsets.UTF_8));
        byte[] decode = Base64.decode(bizData);
        return aes.decryptStr(decode);
    }
1
2
3
4
5
6
7
//sign解码示例
byte[] decode = Base64.getDecoder().decode(encodedString);
1
2

# 5、JAVA 示例

示例代码 (opens new window)

# 五、接口说明

# 1、商户

# 1.1 新增商户

​ 该信息用于平台风控审核，以评估客户是否符合入驻京翎云享平台的条件。商户的开户信息将作为审核的重要依据，确保其符合京翎云享平台的合规要求。

# （1）请求码

​ V3C001

# （2）请求参数
参数名称 类型 是否必填 描述
name String 是 企业名称
businessType String 是 企业类型(请参照附件《企业类型》中的分类，将企业类型传入名称字段）
tradeid Integer 是 行业（请参照附件《行业表》中的行业 ID，将行业 ID 传入相应字段）
businessscope String 是 经营范围，长度限制500字符
practical String 是 实际经营地址
enterpriseProfile String 是 企业简介，长度限制500字符
issuingAuthority String 是 发证机关
establishTime String<date-time> 是 成立时间，例如{"establishTime":"YYYY-MM-DD 00:00:00"}
showName String 是 业务负责人姓名
bindPhone String 是 业务负责人手机号
mailbox String 是 业务负责人邮箱
frName String 是 法人姓名
frIdCard String 可选 法人身份证号
frIdCardFont String 可选 法人身份证人像面URL地址
frIdCardReverse String 可选 法人身份证国徽面URL地址
taxpayerType Integer 是 纳税人类型：1 - 一般人；2 - 小规模；
ticketsample Integer 是 开票类型：1 - 普；2 - 专；
taxpayerIdentificationNumber String 是 纳税人识别号
registeredAddress String 是 注册场所地址
registeredTelephone String 是 注册固定电话
shopDepositBank String 是 开户银行名称
shopPublicAccount String 是 开户账号
shopBankCode String 是 开户账号超网联行号
addresseeName String 可选 收件人姓名
contactNumber String 可选 收件人电话
receivingAddress String 可选 收件人地址
businessLicense String 是 营业执照URL地址
standardImg String 可选 开户许可证URL地址
# （3）请求示例
{
    "addresseeName": "昂寒梦",
    "bindPhone": "176****8765",
    "businessLicense": "https://yun.jinglingyunxiang.com/var/upload/structure.png",
    "businessType": "私有",
    "businessscope": "技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；安全咨询服务；企业管理咨询；贸易经纪；会议及展览服务；礼仪服务；信息系统集成服务；",
    "contactNumber": "15712939346",
    "enterpriseProfile": "北京****科技有限公司成立于2020年02月02日",
    "establishTime": "2021-08-09 00:00:00",
    "frIdCard": "12010219531015301X",
    "frIdCardFont": "https://yun.jinglingyunxiang.com/var/upload/structure.png",
    "frIdCardReverse": "https://yun.jinglingyunxiang.com/var/upload/structure.png",
    "frName": "韦龙",
    "ticketsample": 1,
    "issuingAuthority": "北京市朝阳区市场监督管理局",
    "mailbox": "246****11@qq.com",
    "name": "北京****科技有限公司",
    "platFormId": "",
    "practical": "北京市朝阳区XXX路XXX号101",
    "receivingAddress": "北京市朝阳区XXX路XXX号101",
    "registeredAddress": "北京市朝阳区XXX路XXX号101",
    "registeredTelephone": "176****9876",
    "shopBankCode": "313161000009",
    "shopDepositBank": "北京银行",
    "shopPublicAccount": "672643345262727",
    "showName": "昂寒梦",
    "taxpayerIdentificationNumber": "111111155555666790",
    "taxpayerType": 1,
    "tradeid": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 数据对象

data参数说明

参数名称 类型 描述
companyNo String 商户编号
examineStatus Integer 商户审核状态：2-待审核；3-已审核；4-审核失败；
examineMessage String 商户审核状态文字说明
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": {
        "companyNo": "1571755deaaa4d19b3425eac3dfeb4eb",
        "examineStatus": 2,
        "examineMessage": "待审核"
    }
}
1
2
3
4
5
6
7
8
9
10

# 1.2 更新商户

​ 仅更新提交的参数字段，未传递的字段将保持原样，不会被修改。

# （1）请求码

​ V3C002

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
name String 可选 企业名称
businessType String 可选 企业类型(参照附件《企业类型》)
tradeid Integer 可选 行业(参照附件《行业表》)
businessscope String 可选 经营范围，长度限制500字符
practical String 可选 实际经营地址
enterpriseProfile String 可选 企业简介，长度限制500字符
issuingAuthority String 可选 发证机关
establishTime String<date-time> 可选 成立时间，例如{"establishTime":"2024-01-01"}
showName String 可选 业务负责人姓名
bindPhone String 可选 业务负责人手机号
mailbox String 可选 业务负责人邮箱
frName String 可选 法人姓名
frIdCard String 可选 法人身份证号
frIdCardFont String 可选 法人身份证人像面URL地址
frIdCardReverse String 可选 法人身份证国徽面URL地址
taxpayerType Integer 可选 纳税人类型：1 - 一般人；2 - 小规模；
ticketsample Integer 可选 开票类型：1 - 普；2 - 专；
taxpayerIdentificationNumber String 可选 纳税人识别号
registeredAddress String 可选 注册场所地址
registeredTelephone String 可选 注册固定电话
shopDepositBank String 可选 开户银行名称
shopPublicAccount String 可选 开户账号
shopBankCode String 可选 开户账号超网联行号
addresseeName String 可选 收件人姓名
contactNumber String 可选 收件人电话
receivingAddress String 可选 收件人地址
businessLicense String 可选 营业执照URL地址
standardImg String 可选 开户许可证URL地址
# （3）请求示例
{
  	"companyNo": "1571755deaaa4d19b3425eac3dfeb4eb",
  	"addresseeName": "昂寒梦",
    "bindPhone": "176****8765",
    "businessLicense": "https://yun.jinglingyunxiang.com/var/upload/structure.png",
    "businessType": "私有",
    "businessscope": "技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；安全咨询服务；企业管理咨询；贸易经纪；会议及展览服务；礼仪服务；信息系统集成服务；",
    "contactNumber": "15712939346",
    "enterpriseProfile": "北京****科技有限公司成立于2020年02月02日",
    "establishTime": "2021-08-09 06:02:44",
    "frIdCard": "12010219531015301X",
    "frIdCardFont": "https://yun.jinglingyunxiang.com/var/upload/structure.png",
    "frIdCardReverse": "https://yun.jinglingyunxiang.com/var/upload/structure.png",
    "frName": "韦龙",
    "ticketsample": 1,
    "issuingAuthority": "北京市朝阳区市场监督管理局",
    "mailbox": "246****11@qq.com",
    "name": "北京****科技有限公司",
    "platFormId": "",
    "practical": "北京市朝阳区XXX路XXX号101",
    "receivingAddress": "北京市朝阳区XXX路XXX号101",
    "registeredAddress": "北京市朝阳区XXX路XXX号101",
    "registeredTelephone": "176****9876",
    "shopBankCode": "313161000009",
    "shopDepositBank": "北京银行",
    "shopPublicAccount": "672643345262727",
    "showName": "昂寒梦",
    "taxpayerIdentificationNumber": "111111155555666790",
    "taxpayerType": 1,
    "tradeid": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data String 更新结果文字描述，例：操作成功
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": "操作成功"
}
1
2
3
4
5
6

# 1.3 查询商户审核状态

​ 商户审核通过后，可正常开展业务。如审核被驳回，请根据驳回意见重新提交商户信息。

# （1）请求码

​ V3C003

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
# （3）请求示例
{
    "companyNo": "44ea4798ab334b60a3bee4ad7ee6a821"
}
1
2
3
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
data ObJect 例：操作成功
message String 返回消息
success Boolean 是否成功

data

参数名称 类型 描述
examineStatus Integer 商户审核状态：2-待审核；3-已审核；4-审核失败；
examineStatusInfo String 商户审核状态文字说明
examineMessage String 商户审核驳回原因
companyNo String 商户编号
thirdList Array[Object] 园区列表

thirdList 数组详情

参数名称 类型 描述
thirdNo String 园区编号
thirdName String 园区名称
status Integer 园区状态：0-正常；1-下架；2-暂停；（仅状态为0时，可正常创建任务）
statusMsg String 园区状态文字说明
minAge Integer 最小年龄（大于等于）
maxAge Integer 最大年龄（小于等于）
monthPayLimit Number 单人单月限额（小于）
yearPayLimit Number 单人单年限额（小于）
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": {
        "companyNo": "e2c30c21f72248f395421143pl45529d",
        "examineStatus": 4,
        "examineStatusInfo": "审核驳回",
        "examineMessage": "驳回原因",
        "thirdList": [
            {
                "thirdNo": "eb142f379eea4d6c8e08ebe89e89d209",
              	"thirdName": "湖南*****有限公司",
                "monthPayLimit": 123.00,
                "yearPayLimit": 23,
                "maxAge": 70,
                "minAge": 18,
                "status": 0,
                "statusMsg": "正常"
            },
            {
                "thirdNo": "798dd09db9184eb3b7a99ef9e171138f",
              	"thirdName": "湖南*****有限公司",
                "monthPayLimit": 123.00,
                "yearPayLimit": 23,
                "maxAge": 70,
                "minAge": 18,
                "status": 0,
                "statusMsg": "正常"
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# 1.4、商户审核状态异步通知

​ 风控审核客户资料通过后，审核结果将推送至客户平台。请在 IT 对接群中提供接收回调的接口地址。

# （1）请求码

​ 请在IT对接群提供请求URl

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
examineStatus Integer 是 商户审核状态：2-待审核；3-已审核；4-审核失败；
examineStatusInfo String 是 商户审核状态文字说明
examineMessage String 是 商户审核驳回原因
thirdList Array[Object] 是 园区列表

thirdList 数组详情

参数名称 类型 是否必填 描述
thirdNo String 是 园区编号
thirdName String 是 园区名称
status Integer 是 园区状态
statusMsg String 是 园区状态文字说明
minAge Integer 是 最小年龄（大于等于）
maxAge Integer 是 最大年龄（小于等于）
monthPayLimit Number 是 单人单月限额（小于）
yearPayLimit Number 是 单人单年限额（小于）
# （3）请求示例
{
    "examineStatus": 4,
    "examineStatusInfo": "审核驳回",
    "examineMessage": "驳回原因",
    "thirdList": [
        {
            "thirdNo": "eb142f379eea4d6c8e08ebe89e89d209",
            "thirdName": "湖南*****有限公司",
            "monthPayLimit": 123.00,
            "yearPayLimit": 23,
            "maxAge": 70,
            "minAge": 18,
            "status": 0,
            "statusMsg": "正常"
        },
        {
            "thirdNo": "798dd09db9184eb3b7a99ef9e171138f",
            "thirdName": "湖南*****有限公司",
            "monthPayLimit": 123.00,
            "yearPayLimit": 23,
            "maxAge": 70,
            "minAge": 18,
            "status": 0,
            "statusMsg": "正常"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 1.5、查询子账户余额

​ 通过商户编号和园区编号，您可以查询商户在不同园区的子账户余额。目前，常用的支付渠道包括平安银行和招商银行。

# （1）请求码

​ V3C004

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
thirdNo String 可选 园区编号
# （3）请求示例
{
    "companyNo": "44ea4798ab334b60a3bee4ad7ee6a821",
    "thirdNo ":"2983674283hdiwsujdyf2u386"
}
1
2
3
4
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Array[Object] 返回数据

data 详情

参数名称 类型 描述
thirdNo String 园区编号
thirdName String 园区名称
subAccountInfoList Array[Object] 子账户列表

subAccountInfoList 详情

参数名称 类型 描述
settlementsId Integer 支付渠道Id
settlementsName String 支付渠道名称
subAccountName String 子账户名称
subAccount String 子账户号
balance Number 子账户余额
collectionAccount String 收款账号（线下汇款使用）
collectionAccountName String 收款户名（线下汇款使用）
collectionSubBranch String 收款支行（线下汇款使用）
# （5）返回示例
{
  "code": 200,
  "data": [
    {
      "subAccountInfoList": [
        {
          "balance": 0.5,
          "collectionAccount": "2021*****4643",
          "collectionAccountName": "于**",
          "collectionSubBranch": "",
          "settlementsId": 2,
          "settlementsName": "支付宝",
          "subAccount": "2024*****77440",
          "subAccountName": "测试企业40（测试）"
        },
        {
          "balance": 186463.86,
          "collectionAccount": "7559156******500783",
          "collectionAccountName": "招商银行-薪智-企业网银新20161070",
          "collectionSubBranch": "招商银行深圳分行",
          "lockRechargeBalance": 0,
          "returnBalance": 15.05,
          "returnLockBalance": 0.01,
          "settlementsId": 4,
          "settlementsName": "招商银行",
          "subAccount": "120****783",
          "subAccountName": "测试企业40（测试）"
        }
      ],
      "thirdName": "江西京灵云达",
      "thirdNo": "eb142f379eea4d6c8e08ebe89e89d209"
    }
     "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# 1.6、推送合同

​ 在商户成功推送后，请通过当前接口上传商户与园区签署的合同文件。

# （1）请求码

​ V3C005

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
thirdNo String 是 园区编号
contractFileUrl String 是 协议文件URL地址
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "thirdNo": "798dd09db9184eb3b7a99ef9e171138f",
  	"contractFileUrl": "https://devyun.jinglingyunxiang.com/task_platform/uploadSSO/dwonloadFile?path=contract/2024/08/12/17234680463749242.pdf",
}
1
2
3
4
5
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data String 推送结果文字说明
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": "推送成功"
}
1
2
3
4
5
6

# 1.7、查询客户平台绑定的商户

​ 客户可通过此接口查询绑定的商户

# （1）请求码

​ V3D002

# （2）请求参数

​ 无

# （3）请求示例
{}
1
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 数据对象

data参数说明

参数名称 类型 描述
companyName String 商户名称
companyNo String 商户编码
# （5）返回示例
{
  "code": 200,
  "data": [
    {
      "companyName": "测试科技有限公司",
      "companyNo": "8bc3a441e062490bacb0de1c589712df"
    }
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10

# 2、园区

# （1）查询发票类目

​ 查询客户绑定园区后，您可以获取可开发票的类目列表。

# （1）请求码

​ V3TH001

# （2）请求参数
参数名 类型 是否必填 说明
thirdNo String 是 园区编号
currentPage Integer 可选 页码，默认为1
pageSize Integer 可选 条数，默认为10,最大支持100条
# （3）请求示例
{
    "thirdNo": "798dd09db9184eb3b7a99ef9e171138f",
    "currentPage": 1,
    "pageSize": 10
}
1
2
3
4
5
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 数据对象

data-list参数说明

参数名称 类型 描述
invoiceId Integer 发票类目ID（查询模板ID使用）
content String 发票类目名称
# （5）返回示例
{
  "code": 200,
  "data": {
    "endRow": 10,
    "hasNextPage": true,
    "hasPreviousPage": false,
    "isFirstPage": true,
    "isLastPage": false,
    "list": [
      {
        "content": "测试类目",
        "invoiceId": 1384
      },
      {
        "content": "*现代服务*管理服务费",
        "invoiceId": 917
      }
    ],
    "navigateFirstPage": 1,
    "navigateLastPage": 2,
    "navigatePages": 8,
    "navigatepageNums": [
      1,
      2
    ],
    "nextPage": 2,
    "pageNum": 1,
    "pageSize": 10,
    "pages": 2,
    "prePage": 0,
    "size": 10,
    "startRow": 1,
    "total": 16
  },
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

# （2）查询任务模板

​ 通过发票类目 ID 查询当前类目下的已审核通过的任务模板。

# （1）请求码

​ V3TH002

# （2）请求参数
参数名 类型 是否必填 说明
invoiceId Integer 是 发票类目ID
currentPage Integer 可选 页码，默认为1
pageSize Integer 可选 条数，默认为10，最大条数100条
# （3）请求示例
{
    "invoiceId": 624,
    "currentPage": 1,
    "pageSize": 10
}
1
2
3
4
5
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 数据对象

data参数说明

参数名称 类型 描述
id Integer 模板ID，创建任务使用
taskType String 任务名称
description String 业务场景描述
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": [
        {
            "id": 968,
            "taskType": "经纪代理服务费",
            "description": "1、负责北京，河北，天津房产推广，代理销售\n2、能吃苦，适应出差。\n3、对京津冀周边地区了解熟悉"
        },
        {
            "id": 969,
            "taskType": "代理服务费",
            "description": "1、诚实守信，吃苦耐劳\n2、熟悉北京，河北，天津，山东周边环境\n3、适应出差，对客户有服务态度。"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# （3）查询平台绑定的园区

​ 通过此接口查询客户绑定的园区

# （1）请求码

​ V3D001

# （2）请求参数

​ 无

# （3）请求示例
{}
1
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 数据对象

data参数说明

参数名称 类型 描述
apiThirdId String 园区编码
thirdName String 园区名称
# （5）返回示例
{
  "code": 200,
  "data": [
    {
      "apiThirdId": "798dd09db9184eb3b7a99ef9e171138f",
      "thirdName": "淅川县豹骑网络科技有限公司"
    }
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10

# 3、用户

# （1）新增用户

​ 推送个人认证信息后，用户认证通过即可开始任务流程。

# （1）请求码

​ V3U001

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
thirdNo String 是 园区编号
flag Integer 是 重复数据处理规则：1-覆盖；2-跳过
operationFlag Integer 是 个人签约方式：1-传输协议文件url；2-返回签约URL（全流程）；3-返回签约URL
users Array[Object] 是 用户列表

users

参数名称 类型 是否必填 描述
name String 是 姓名
idCard String 是 证件号码
phone String 是 手机号
bankcard String 是 银行卡
bank String 否 银行名称，按照附件表 (opens new window)匹配银行名称（bank_name字段）
idCardAddress String 否 常驻地址
idCardFrontImage String 否 身份证正面照片的下载链接，图片大小限制3MB以内
idCardReverseImage String 否 身份证反面照片的下载链接，图片大小限制3MB以内
faceEvidence String 否 人脸识别证据链，视频MP4或图片格式
servicePdf String 否 服务协议文件的下载链接，当operationFlag为1时，此项必填
idCardType String 否 证件照片类型：1-扫描件，2-复印件
个人签约方式说明：
如果operationFlag=1，协议需要进行人工审核；
如果operationFlag=2，返回签约地址，用户自行完成签约，无需人工审核。
1
2
3
# （3）请求示例
{
  "companyNo": "e2c30c21f72248f395421143pl45529d",
  "flag": 1,
  "thirdNo": "eb142f379eea4d6c8e08ebe89e89d209",
  "operationFlag": 1,
  "users": [
    {
      "bank": "",
      "bankcard": "6216*****72205",
      "idCard": "150*****33968",
      "idCardAddress": "",
      "idCardFrontImage": "https://devyunoss.jinglingyunxiang.com/idCard/2025/10/11/17601706854583469.jpg",
      "idCardReverseImage": "https://devyunoss.jinglingyunxiang.com/idCard/2025/10/11/17601706901306325.jpg",
      "name": "***",
      "phone": "176****34",
      "servicePdf": "https://devyun.jinglingyunxiang.com/task_platform/uploadSSO/dwonloadFile?path=contract/2025/12/10/1765333503258997.pdf",
      "idCardType": "",
      "faceEvidence": "https://devyunoss.jinglingyunxiang.com/video/2025/12/11/17654455114003739.jpg"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 数据对象

data 说明

参数名称 类型 描述
pushStatus Integer 提交状态：1-全部成功；2-部分成功；3-全部失败
pushStatusMsg String 推送状态文字说明
users Array[Object] 用户列表

users 说明

参数名称 类型 描述
name String 姓名
idCard String 身份证
phone String 手机号
bankcard String 银行卡
signUrl String 签约地址
status Integer 用户信息提交状态：1-成功；2-失败
statusMsg String 用户信息提交状态文字说明
# （5）返回示例
{
    "code": 200,
	  "message": "succeed",
  	"success": true,
    "data": {
        "pushStatus": 1,
        "pushStatusMsg": "全部成功",
        "users": [
            {
                "statusMsg": "提交成功",
                "phone": "15282107957",
                "idCard": "12010219531015301X",
                "name": "小江",
                "signUrl": "http://devyunoss.jinglingyunxiang.com/userSignature/2024/08/13/17235374277369290.jpg?Expires=1723623827&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=La3RKMwgolvwAYst9ZsAXJhTPao%3D",
                "bankcard": "672643345262727",
                "status": 1
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# （2）查询用户审核状态

​ 获取用户的审核状态后：

​ • 审核通过：用户可以正常进行任务流程。

​ • 审核未通过：请根据驳回原因修改个人信息后重新提交。

# （1）请求码

​ V3U002

# （2）请求参数
参数名 类型 是否必填 说明
companyNo String 是 商户编号
idCard String 否 用户身份证号，传入此项查询单人
currentPage Integer 可选 页码，默认为1
pageSize Integer 可选 条数，默认为10，最大条数100条
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "idCard": "",
    "currentPage": 1,
    "pageSize": 10
}
1
2
3
4
5
6
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Array[Object] 数据对象

data 说明

参数名称 类型 描述
name StringInteger 姓名
idCard String 身份证
phone String 手机号
bankcard String 银行卡
status String 用户审核状态：1-待审核；3-审核通过；4-审核失败；10-待扫码签约
message String 用户审核状态文字说明
remark String 审核驳回原因
servicePdfList String 协议列表
# （5）返回示例
{
  "code": 200,
  "data": {
    "endRow": 0,
    "hasNextPage": false,
    "hasPreviousPage": false,
    "isFirstPage": true,
    "isLastPage": true,
    "list": [
      {
        "bankCard": "621****2205",
        "idCard": "150****3968",
        "message": "审核通过",
        "name": "路*迪",
        "phone": "17***834",
        "remark": "",
        "servicePdfList": [
          "https://devyunoss.jinglingyunxiang.com/contract/2026/01/10/17680231229027066.pdf?Expires=1768360094&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=cxL%2F2W5ljLlXjbiGbkHTWxkGUVQ%3D",
          "https://devyunoss.jinglingyunxiang.com/contract/2026/01/12/17682084121673539.pdf?Expires=1768360094&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=VWWviUX2vLXOiTnPBJDy0TiJdN4%3D",
          "https://devyunoss.jinglingyunxiang.com/contract/2026/01/12/17682084763225442.pdf?Expires=1768360094&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=MDxqSMf%2BgxTkG8iycMlgpdgQj9w%3D"
        ],
        "status": 3
      }
    ],
    "navigateFirstPage": 1,
    "navigateLastPage": 1,
    "navigatePages": 8,
    "navigatepageNums": [
      1
    ],
    "nextPage": 0,
    "pageNum": 1,
    "pageSize": 1,
    "pages": 1,
    "prePage": 0,
    "size": 1,
    "startRow": 0,
    "total": 1
  },
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

# （3）新增用户（适用数据量较大的客户）

​ 批量推送个人认证信息，用户认证通过即可开始任务流程。

# （1）请求码

​ V3UA001

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
thirdNo String 是 园区编号
flag Integer 是 重复数据处理规则：1-覆盖；2-跳过
operationFlag Integer 是 个人签约方式：1-传输协议文件url；2-返回签约URL
batchNo String 是 批次号
users Array[Object] 是 用户列表

users

参数名称 类型 是否必填 描述
name String 是 姓名
idCard String 是 证件号码
phone String 是 手机号
bankcard String 是 银行卡
bank String 否 银行名称，按照附件表 (opens new window)匹配银行名称（bank_name字段）
idCardAddress String 否 常驻地址
idCardFrontImage String 否 身份证正面照片的下载链接
idCardReverseImage String 否 身份证反面照片的下载链接
faceEvidence String 否 人脸识别证据链，视频MP4或图片格式
servicePdf String 否 服务协议文件的下载链接，当operationFlag为1时，此项必填
idCardType String 否 证件照片类型：1-扫描件，2-复印件
个人签约方式说明：
如果operationFlag=1，协议需要进行人工审核；
如果operationFlag=2，返回签约地址，用户自行完成签约，无需人工审核。
1
2
3
# （3）请求示例
{
  "companyNo": "e2c30c21f72248f395421143pl45529d",
  "flag": 1,
  "thirdNo": "eb142f379eea4d6c8e08ebe89e89d209",
  "operationFlag": 2,
  "batchNo":"20251246aasd",
  "users": [
    {
      "bank": "",
      "bankcard": "62148111147766",
      "idCard": "150424****3968",
      "idCardAddress": "",
      "idCardFrontImage": "https://devyunoss.jinglingyunxiang.com/idCard/2025/10/11/17601706854583469.jpg",
      "idCardReverseImage": "https://devyunoss.jinglingyunxiang.com/idCard/2025/10/11/17601706901306325.jpg",
      "name": "路*迪",
      "phone": "17614***3434",
      "servicePdf": "",
      "idCardType": "",
      "faceEvidence": ""
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
# （5）返回示例
{"code":200,"message":"succeed","success":true}
1

# （4）查询用户审核状态

此接口可获取用户审核状态、协议列表以及签约链接

​ 获取用户的审核状态后：

​ • 审核通过：用户可以正常进行任务流程。

​ • 审核未通过：请根据驳回原因修改个人信息后重新提交。

# （1）请求码

​ V3UA002

# （2）请求参数
参数名 类型 是否必填 说明
companyNo String 是 商户编号
idCard String 否 用户身份证号，传入此项查询单人
batchNo String 是 批次号
currentPage Integer 可选 页码，默认为1
pageSize Integer 可选 条数，默认为10，最大条数100条
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "batchNo":"20251246aasd"
    "idCard": "",
    "currentPage": 1,
    "pageSize": 10
}
1
2
3
4
5
6
7
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Array[Object] 数据对象

data 说明

参数名称 类型 描述
name StringInteger 姓名
idCard String 身份证
phone String 手机号
bankcard String 银行卡
status String 用户审核状态：1-待审核；3-审核通过；4-审核失败；10-待扫码签约
message String 用户审核状态文字说明
remark String 审核驳回原因
servicePdfList String 协议列表
signURL String 签约链接
# （5）返回示例
{
    "code": 200,
    "data": {
        "navigatepageNums": [
            1
        ],
        "startRow": 0,
        "hasNextPage": false,
        "prePage": 0,
        "nextPage": 0,
        "endRow": 9,
        "pageSize": 10,
        "list": [
            {
                "bankCard": "6230520080033039678",
                "phone": "13025188120",
                "servicePdfList": [
                    "https://devyunoss.jinglingyunxiang.com/contract/2026/02/10/1770711319355684.pdf?Expires=1770874942&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=9jzRHN3W2KWLdjf9bdIM%2BRyxZsc%3D",
                    "https://devyunoss.jinglingyunxiang.com/contract/2026/02/10/1770711467606149.pdf?Expires=1770874942&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=%2BEVXTF5UvOAEwO3RnB2YvabRKaU%3D",
                    "https://devyunoss.jinglingyunxiang.com/contract/2026/02/10/17707142747021514.pdf?Expires=1770874942&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=tvzcf7bcvXcMR%2FP1NhySIqDMJZ4%3D",
                    "https://devyunoss.jinglingyunxiang.com/contract/2026/02/10/17707144612352907.pdf?Expires=1770874942&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=IVnSknUItRebcSmvzjcMIlvJLpw%3D",
                    "https://devyunoss.jinglingyunxiang.com/contract/2026/02/11/17707882246761580.pdf?Expires=1770874942&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=c4tCyTKdc0gdzYutUM34h9iHjwc%3D"
                ],
                "idCard": "440181199406255756",
                "name": "邓仕添",
                "message": "审核通过",
                "status": 3
            },
            {
                "bankCard": "6214832962338013",
                "phone": "18220059136",
                "servicePdfList": [
                    "https://devyunoss.jinglingyunxiang.com/contract/2026/02/10/17707144631046134.pdf?Expires=1770874942&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=E05H09HHpSxMvf9HmtdER51olHs%3D",
                    "https://devyunoss.jinglingyunxiang.com/contract/2026/02/11/17707882267716643.pdf?Expires=1770874942&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=V3Z4OaDUQU27qFX4qZGfQjsuELU%3D"
                ],
                "idCard": "610423200107221345",
                "name": "李盼盼",
                "message": "审核通过",
                "status": 3
            }
        ],
        "pageNum": 1,
        "navigatePages": 8,
        "navigateFirstPage": 1,
        "total": 10,
        "pages": 1,
        "size": 10,
        "isLastPage": true,
        "hasPreviousPage": false,
        "navigateLastPage": 1,
        "isFirstPage": true
    },
    "success": true,
    "message": "succeed"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# （4）用户新增银行卡

若用户银行卡更换，可通过此接口为用户新增银行卡。

# （1）请求码

​ V3U004

# （2）请求参数
参数名 类型 是否必填 说明
companyNo String 是 商户编号
idCard String 是 用户身份证号，传入此项查询单人
bankCard String 是 银行卡号
isDefault Integer 是 是否设置为默认银行卡，1-是，2-否
# （3）请求示例
{
    "companyNo":"e2c30c21f72248f395421143pl45529d",
    "idCard":"150424199902033968",
    "bankCard":"6230580000442338294",
    "isDefault":1
}
1
2
3
4
5
6
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Array[Object] 数据对象

data 说明

参数名称 类型 描述
bankCard String 银行卡号
bankName String 所属银行
# （5）返回示例
{
    "code": 200,
    "data": {
        "bankCard": "6230580000442338294",
        "bankName": "平安银行"
    },
    "success": true,
    "message": "succeed"
}
1
2
3
4
5
6
7
8
9

# （4）用户审核状态异步通知

​ 平台风控在手动或系统自动审核用户信息后，将向客户平台推送个人信息的审核状态。请在 IT 对接群中提供接收回调的接口地址。

# （1）请求码

​ 请在IT对接群提供请求URl

# （2）请求参数
参数名称 类型 描述
name StringInteger 姓名
idCard String 身份证
phone String 手机号
bankcard String 银行卡
status String 用户审核状态：1-待审核；3-审核通过；4-审核失败；10-待扫码签约
message String 用户审核状态文字说明
remark String 审核驳回原因
# （3）请求示例
[
        {
            "bankCard": "672643345262727",
            "phone": "133****9999",
            "idCard": "512311188903123710",
            "name": "程成",
            "status": 3,
            "message": "审核通过"
        },
        {
            "bankCard": "6726433454456727",
            "phone": "151****4846",
            "idCard": "412723199609082981",
            "name": "张三",
            "status": 3,
            "message": "审核通过"
        },
        {
            "bankCard": "6726433245262727",
            "phone": "150****2567",
            "idCard": "130321189710097820",
            "name": "李梅丽",
            "status": 4,
            "remark": "请输入正确的银行名称",
            "message": "审核失败"
        }
    ]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 4、任务

# （1）创建任务

​ 通过上方接口查询到的相关信息，按照公司实际业务场景创建任务；

​ 任务开始时间与截止时间的间隔需大于3天；

​ 报名开始时间与截止时间的间隔需大于3天；

​ 通过【查询子账户余额】接口获取结算渠道 ID。

# （1）请求码

​ V3T001

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 商户编号
thirdInfoNo String 是 园区编号
principalId String 是 地区ID
titleid Integer 是 任务模板ID
taxType Integer 是 发票类目ID
settlementsId Integer 是 结算渠道:1-平安银行;2 - 支付宝;4-招商银行；15-华夏银行
firstInvoiceStyle Integer 作废 首选发票样式 1-电子发票 2-纸质发票（此项作废，目前发票均为电子发票）
enrollStartTime String(date-time) 是 报名开始时间
enrollEndTime String(date-time) 是 报名截止时间
startTime String(date-time) 是 任务开始时间
endTime String(date-time) 是 任务结束时间
budget Number 是 预算金额
enrollNum Integer 是 需求人数
remark String 可选 备注
autoEndTime String(date-time) 可选 任务自动终止时间，到达传递时间后，系统将自动终止任务
taskType Integer 可选 任务类型：0-正常下发 1-数据导入
# （3）请求示例
{ 
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "thirdInfoNo": "798dd09db9184eb3b7a99ef9e171138f",
    "principalId": "1,3409",
    "titleid": 1178,
    "taxType": 1092,
    "settlementsId": 4, 
    "firstInvoiceStyle": 0,
    "enrollStartTime": "2024-08-19 06:02:44",
    "enrollEndTime": "2024-09-30 06:02:44",
    "startTime": "2024-08-19 06:02:44",
    "endTime": "2024-09-30 06:02:44",
    "enrollNum": 1,
    "budget": 30,
    "remark": "测试专有",
    "autoEndTime": "2024-08-30 06:02:44"
    "taskType":0
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 数据对象

data参数说明

参数名称 类型 描述
taskNo String 任务编号
# （5）返回示例
{
    "code": 200,
    "message": "succeed",
  	"success": true,
    "data": {
        "taskNo": "3e2291ea66af4e479213274bd0680d33"
    }
}
1
2
3
4
5
6
7
8

# （2）任务派发

​ 对已创建的任务进行派发操作，相当于指派人员接取任务。

# （1）请求码

​ V3T002

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 商户编号
taskNo String 是 任务编号
thirdInfoNo String 是 园区编号
users Object 是 人员列表
pushBatchNo String 否 推送批次号

users

名称 类型 必选 说明
apiOrderId String 是 客户平台结算ID
name String 是 姓名
idCard String 是 身份证号
bankCard String 是 银行卡号
amount Number 是 金额
meal String 是 任务内容
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "thirdInfoNo": "798dd09db9184eb3b7a99ef9e171138f",
    "taskNo": "01f1fc166df04e019df1d99a9790e52f",
    "pushBatchNo": "20260123",
    "users": [
        {
            "amount": 10,
            "apiOrderId": "00010",
            "bankCard": "6214831150131511",
            "idCard": "211322199802237278",
            "meal": "现代服务*推广服务费",
            "name": "吴极客"
        },
        {
            "amount": 10,
            "apiOrderId": "00010",
            "bankCard": "6214831150131511",
            "idCard": "211322199802237278",
            "meal": "现代服务*推广服务费",
            "name": "吴极客"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 此项暂无信息

users

名称 类型 必选 说明
apiOrderId String 是 客户平台结算ID
name String 是 姓名
idCard String 是 身份证号
bankCard String 是 银行卡号
amount Number 是 金额
meal String 是 任务内容
errMsg String 是 错误信息
# （5）返回示例
{
    "code": 500,
    "data": {
        "users": [
            {
                "meal": "现代服务*推广服务费",
                "amount": 10,
                "bankCard": "6214831150131511",
                "idCard": "211322199802237278",
                "errMsg": "null，证件号与上传姓名不符",
                "name": "张三",
                "apiOrderId": "500010"
            }
        ]
    },
    "success": false,
    "message": "派发失败"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# （3）任务验收

​ 个人任务的工作成果进行验收操作，当前仅支持一键验收功能，暂不支持单独验收。

# （1）请求码

V3T003

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 商户编号
taskNo String 是 任务编号
pushBatchNo String 否 推送批次号
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "taskNo": "e76f31287d0a47dcaddcb3de53428ba7",
    "pushBatchNo": "20260123"
}
1
2
3
4
5
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 此项暂无信息
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": null
}
1
2
3
4
5
6

# （4）任务支付

​ 对验收通过的个人任务进行结算佣金操作，调用当前接口会向个人绑定的结算账户支付任务佣金。

# （1）请求码

​ V3T004

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 商户编号
taskNo String 是 任务编号
apiOrderId String 可选 客户平台结算ID
orderId String 可选 订单ID
pushBatchNo String 可选 推送批次号
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "taskNo": "2232013332764837a6936dd3423b149b",
    "apiOrderId": "",
    "orderId": "",
    "pushBatchNo": "20260123"
}
1
2
3
4
5
6
7
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 此项暂无信息
# （5）返回示例
{
    "code": 200,
  	"message": "支付提交成功",
  	"success": true,
}
1
2
3
4
5

# （5）查询支付结果

​ 获取个人已提交支付订单的支付结果，支持批量查询。

# （1）请求码

​ V3T005

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 商户编号
taskNo String 是 任务ID
orderId ListInteger 可选 订单ID
apiOrderId ListString 可选 客户平台结算ID
currentPage Integer 是 页码;(默认为1)
pageSize Integer 是 条数;(默认为10)
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "taskNo": "021cc1a41e6e4686b01bfe5a50d86252",
    "orderId": [],
    "apiOrderId": ["35741"],
    "pageSize": 10,
    "currentPage": 1
}
1
2
3
4
5
6
7
8
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 个人订单列表

data. Data 数组详情`

参数名称 类型 描述
orderId Integer 订单ID
apiOrderId String 客户平台结算ID
receivablesName String 姓名
idCard String 证件号码
phone String 联系电话
receivingAccount String 银行卡号
receivingBankName String 所属银行
amounts Integer 实际到手金额
status Integer 支付状态：1-待支付；2-支付成功；3-失败；5-支付中；
statusMessage String 支付状态文字说明
failMessage String 失败原因
paymentTime Date 支付时间
subPayTime Date 提交支付时间
taxAmount Integer 个税金额
vatAmount Integer 增值税金额
# （5）返回示例
{
  "code": 200,
  "data": {
    "endRow": 1,
    "hasNextPage": false,
    "hasPreviousPage": false,
    "isFirstPage": true,
    "isLastPage": true,
    "list": [
      {
        "amounts": 91687.38,
        "apiOrderId": "1000001",
        "idCard": "150424199902033968",
        "orderId": 155232,
        "phone": "17614866834",
        "receivablesName": "路亚迪",
        "receivingAccount": "6216690100010972205",
        "receivingBankName": "中国银行",
        "status": 1,
        "statusMessage": "待支付",
        "taxAmount": 5400,
        "vatAmount": 2912.62
      }
    ],
    "navigateFirstPage": 1,
    "navigateLastPage": 1,
    "navigatePages": 8,
    "navigatepageNums": [
      1
    ],
    "nextPage": 0,
    "pageNum": 1,
    "pageSize": 2,
    "pages": 1,
    "prePage": 0,
    "size": 2,
    "startRow": 0,
    "total": 2
  },
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

# （6）查询任务流水号

此接口可通过任务编号获取任务流水号

# （1）请求码

​ V3T012

# （2）请求参数
名称 类型 必选 说明
taskNo String 是 任务编号
# （3）请求示例
{
    "taskNo":"e5da5b5cc4b94f9d891ac2308f8cb3d9"
}
1
2
3
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data String 任务流水号
# （5）返回示例
{
    "code": 200,
    "data": "20260107114038147ld9",
    "success": true,
    "message": "succeed"
}
1
2
3
4
5
6

# （7）查询任务列表

可通过此接口查看商户不同状态的任务列表

# （1）请求码

​ V3T016

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 公司编号
taskNo String 可选 任务编号
startTime Date 可选 任务开始时间
endTime Date 可选 任务结束时间
statusList list 可选 任务状态列表： 4进行中，5验收中，7已完成
currentPage Integer 可选 页码，默认为1
pageSize Integer 可选 条数，默认为10
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "task_no": "0450758f3b9348a9a9cdf3d90d6a000f",
    "startTime": "2026-01-04 06:02:44",
    "endTime": "2026-01-04 18:02:44",
    "statusList": [4,5,7],
    "currentPage": 1,
    "pageSize": 10
}
1
2
3
4
5
6
7
8
9
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 此项暂无信息

data. Data 数组说明

参数名称 类型 描述
no String 商户端任务流水号
enrollEndTime Date 报名截止时间
enrollStartTime Date 报名开始时间
releaseTime Date 发布时间
constructionPeriod Integer 任务时间（天）
remark String 备注
originalAmount Integer 任务金额
name String 任务内容
taskNo String 任务接口编号
startTime Date 任务开始时间
endTime Date 任务结束时间
status Integer 任务状态： 4进行中，5验收中，7已完成
# （5）返回示例
{
    "code": 200,
    "data": {
        "navigatepageNums": [
            1
        ],
        "startRow": 0,
        "hasNextPage": false,
        "prePage": 0,
        "nextPage": 0,
        "endRow": 0,
        "pageSize": 1,
        "list": [
            {
                "no": "20260104165842991a6i",
                "enrollEndTime": "2024-09-30 06:02:44",
                "releaseTime": "2026-01-04 16:58:43",
                "constructionPeriod": 42,
                "remark": "测试专有",
                "enrollStartTime": "2024-08-19 06:02:44",
                "originalAmount": 30.0000,
                "createTime": "2026-01-04 16:58:42.991",
                "name": "现代服务*推广服务费",
                "taskNo": "0450758f3b9348a9a9cdf3d90d6a000f",
                "startTime": "2024-08-19 06:02:44",
                "endTime": "2024-09-30 06:02:44",
                "status": 4
            }
        ],
        "pageNum": 1,
        "navigatePages": 8,
        "navigateFirstPage": 1,
        "total": 0,
        "pages": 1,
        "size": 1,
        "isLastPage": true,
        "hasPreviousPage": false,
        "navigateLastPage": 1,
        "isFirstPage": true
    },
    "success": true,
    "message": "succeed"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# （8）重新打款

​ 当个人订单的支付结果为失败时，请通过此接口重新发起支付。调用接口后，平台将自动获取个人最新信息，并重新发起支付动作。

​ • 银行卡问题处理：如果订单失败的原因是个人银行卡问题或需要更换收款银行卡，请先更新个人信息，审核通过后再发起支付。

# （1）请求码

​ V3T006

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 公司编号
taskNo String 是 任务编号
apiOrderId Integer 可选 客户平台结算ID
orderId Integer 可选 订单ID
pushBatchNo String 可选 推送批次号
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "taskNo": "2232013332764837a6936dd3423b149b",
    "apiOrderId": "320010",
    "orderId": "138658",
    "pushBatchNo": "20260123"
}
1
2
3
4
5
6
7
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data String 重试打款提交结果
# （5）返回示例
{
    "code": 200,
    "data": "重新打款提交成功",
    "success": true,
    "message": "succeed"
}
1
2
3
4
5
6

# （9）查询任务人员详情

​ 查询任务人员详情时，当前接口将返回所有进入结算阶段的任务订单详情。

​ • 用途：

​ • 关联匹配：用于匹配京翎云享平台的 orderId 和客户平台的结算 ID 之间的关联关系。

​ • 确认操作：可用于在终止任务前进行确认。

# （1）请求码

​ V3T007

# （2）请求参数
参数名 类型 是否必填 说明
companyNo String 是 商户编号
taskNo String 否 任务编号
currentPage Integer 可选 页码，默认为1
pageSize Integer 可选 条数，默认为10，最大条数100条
apiOrderId String 否 客户平台结算ID
# （3）请求示例
{
  "companyNo": "e2c30c21f72248f395421143pl45529d",
  "taskNo": "b073139ae51242fc8123b63e13bd475b",
  "apiOrderId": "500010",
  "currentPage": 1,
  "pageSize": 10
}
1
2
3
4
5
6
7
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 订单详情

data 数组详情

参数名称 类型 描述
feesCount Integer 实际下发总金额
wagesCount Integer 实际扣除服务费总金额
userVOList Object 订单明细列表

userVOList

参数名称 类型 描述
servicerate Number 服务费率
userName String 用户姓名
userIdCard String 身份证号
meal String 工作名称
wages Number 任务金额
servicerate Number 服务费率
fees Number 服务费金额
amounts Number 实际到手金额
personPersonalTax Number 个税金额（个人承担）
personalTax Number 个税金额（公司承担）
addedTax Number 增值税金额
addedTaxType Integer 增值税类型
apiOrderId String 客户平台结算ID
# （5）返回示例
{
  "code": 200,
  "data": {
    "feesCount": 0.5,
    "userVOList": {
      "endRow": 0,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "isFirstPage": true,
      "isLastPage": true,
      "list": [
        {
          "addedTax": 0,
          "addedTaxType": 1,
          "amounts": 10,
          "apiOrderId": "500010",
          "fees": 0.5,
          "meal": "现代服务*推广服务费",
          "personPersonalTax": 0,
          "personalTax": 0,
          "servicerate": 5,
          "userIdCard": "211322********7278",
          "userName": "吴*客",
          "wages": 10
        }
      ],
      "navigateFirstPage": 1,
      "navigateLastPage": 1,
      "navigatePages": 8,
      "navigatepageNums": [
        1
      ],
      "nextPage": 0,
      "pageNum": 1,
      "pageSize": 1,
      "pages": 1,
      "prePage": 0,
      "size": 1,
      "startRow": 0,
      "total": 1
    },
    "wagesCount": 10
  },
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# （10）终止任务

​ 当客户任务尚未完成但不再下发时，请调用此接口终止任务。

​ • 终止操作：

​ • 终止任务将自动将任务数据更新为实际下发金额和实际扣除的服务费，任务状态将变更为已完成。

​ • 为确保数据准确，请在所有任务下发成功后再进行任务终止。

​ • 发票申请：

​ • 系统每天 00:30 自动提交任务状态为已完成的发票申请。请及时终止任务，以避免影响开票进度。

# （1）请求码

​ V3T008

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 商户编号
taskNo String 是 任务编号
# （3）请求示例
{
  "companyNo": "e2c30c21f72248f395421143pl45529d",
  "taskNo": "e76f31287d0a47dcaddcb3de53428ba7"
}
1
2
3
4
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 此项暂无信息
# （5）返回示例
{
    "code": 200,
    "success": true,
    "message": "succeed"
}
1
2
3
4
5

# （11）个税预算接口

​ 通过个人信息获取个税信息。

# （1）请求码

​ V3T017

# （2）请求参数
名称 类型 必选 说明
companyNo String 是 商户编号
thirdNo String 是 园区编号
users Object 是 人员列表

userVOList

名称 类型 必选 说明
name String 是 姓名
idCard String 是 身份证号
jiesuanAmount String 是 结算金额
# （3）请求示例
{
  "companyNo": "e2c30c21f72248f395421143pl45529d",
  "thirdNo": "sdana1p7g988war7nt1ybcz3",
  "users": [
    {
      "name": "路亚迪",
      "idCard": "150424199902033968",
      "jiesuanAmount": "213000"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 此项暂无信息

data 数组详情

参数名称 类型 描述
name String 姓名
idCard String 身份证号
jiesuanAmount Integer 结算金额
amounts Integer 实际到手金额
frees Integer 服务费
personalTax Integer 个人承担个税
companyTax Integer 公司承担个税
addedTax Integer 增值税
cityTax Integer 城建税
eduTax Integer 教育税
localEduTax Integer 地方教育税
commission Integer 手续费
# （5）返回示例
{
  "code": 200,
  "data": [
    {
      "addedTax": 2137.62,
      "amounts": 210862.38,
      "cityTax": 21.38,
      "commission": 0,
      "companyTax": 0,
      "eduTax": 21.38,
      "frees": 10650,
      "idCard": "150424199902033968",
      "jiesuanAmount": 213000,
      "localEduTax": 21.38,
      "name": "路亚迪",
      "personalTax": 0
    }
  ],
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

# 五、外部数据导入

​ 本部分仅适用有同步数据需求的客户，调用导入接口前需要调用V3T001接口创建任务

# （1）外部数据推送

​ 此接口用于推送下发数据到创建的任务中。

# （1）请求码

​ V3T013

# （2）请求参数
参数名称 类型 是否必填 描述
batchNo string 是 批次唯一标识
companyNo string 是 商户编号
taskNo string 是 任务编号
personalType integer 是 个税计算方式：1-任务金额（税前金额），2-实际到手金额（税后金额）
payStatus integer 是 支付状态：1-待支付，2-支付完成；当使用我司平台核算个人个税时，传入1；仅作为同步成功订单使用时，传入2；
users array 是 人员列表
# users
参数名称 类型 是否必填 描述
amount string 是 金额
bankCard string 是 银行卡号
errMsg string 否 错误原因
idCard string 是 身份证号
meal string 是 任务内容
name string 是 姓名
paymentTime string 否 payStatus=2 必填
subPayTime string 否 payStatus=2 必填
# （3）请求示例
{
  "batchNo": "apitest002",
  "companyNo": "e2c30c21f72248f395421143pl45529d",
  "taskNo": "38ede91310ac4956ac4d9201ceb8f051",
  "personalType": 2,
  "payStatus": 2,
  "users": [
    {
      "amount": 9200,
      "bankCard": "621483****47766",
      "errMsg": "",
      "idCard": "15042****033968",
      "meal": "现代服务*推广服务费",
      "name": "***",
      "paymentTime": "2025-12-27 10:00:00",
     "subPayTime": "2025-12-27 09:00:00"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
# （5）返回示例
{
    "code": 200,
    "success": true,
    "message": "succeed"
}
1
2
3
4
5

# （1）查询推送状态与信息

​ 下发数据推送成功后，通过此接口查看推送的状态以及支付信息。

# （1）请求码

​ V3T014

# （2）请求参数
参数名称 类型 是否必填 说明
taskNo string 是 任务编号
batchNo string 是 批次唯一标识
currentPage integer 是 页码
pageSize integer 是 条数
# （3）请求示例
{
    "taskNo": "bb40dd5b49bd4d6b891bd7289978b26c",
    "batchNo": "2026124601",
    "currentPage": 1,
    "pageSize": 10
}
1
2
3
4
5
6
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
data object 支付信息
# data[list]
参数名称 类型 说明
list array 数据列表
amount number 金额
apiOrderId string 客户结算ID
failMessage string 失败消息
idCard string 身份证号
orderId number 订单ID
paymentTime string 支付时间
phone string 手机号
receivablesName string 收款人姓名
receivingAccount string 收款账户
receivingBankName string 收款银行名称
status integer 状态码：1-处理中 2-处理成功 3-处理失败 4-待支付 5-支付成功 6-支付失败
statusMessage string 状态消息
subPayTime string 提交支付时间
taxAmount number 税额
vatAmount number 增值税额
# （5）返回示例
{
    "code": 200,
    "data": {
        "navigatepageNums": [
            1
        ],
        "startRow": 0,
        "hasNextPage": false,
        "prePage": 0,
        "nextPage": 0,
        "endRow": 1,
        "pageSize": 2,
        "list": [
            {
                "receivingAccount": "6214831961947766",
                "amounts": 10000,
                "idCard": "现代服务*推广服务费",
                "receivablesName": "路亚迪",
                "apiOrderId": "21884",
                "failMessage": "数据异常",
                "statusMessage": "支付失败",
                "status": 6
            },
            {
                "receivingAccount": "6214831961947766",
                "amounts": 10000,
                "idCard": "150424199902033968",
                "receivablesName": "路亚迪",
                "apiOrderId": "21883",
                "failMessage": "系统正在升级中，请等待升级完成后提交支付/重试",
                "statusMessage": "支付失败",
                "status": 6
            }
        ],
        "pageNum": 1,
        "navigatePages": 8,
        "navigateFirstPage": 1,
        "total": 2,
        "pages": 1,
        "size": 2,
        "isLastPage": true,
        "hasPreviousPage": false,
        "navigateLastPage": 1,
        "isFirstPage": true
    },
    "success": true,
    "message": "succeed"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# （3）更改支付状态

​ 查询数据状态返回处理成功和待支付时可掉此接口更改支付状态。

# （1）请求码

​ V3T015

# （2）请求参数
参数名称 类型 是否必填 描述
batchNo string 是 批次唯一标识
companyNo string 是 商户编号
paymentTime string 是 支付成功时间
subPayTime string 是 提交支付时间
taskNo string 是 任务编号
apiOrderIds object 是 客户结算ID列表，V3T014返回的apiorderId
# apiOrderIds
参数名称 类型 是否必填 描述
apiOrderId string 否 客户方结算ID：按照id更改状态
没有id按照批次更改状态
paymentTime string 否 支付时间：有客户结算ID必填
subPayTime string 否 提交支付时间：有客户结算ID必填
# （3）请求示例
{
    "apiOrderIds": [
        {
            "apiOrderId": "2154",
            "paymentTime": "2025-12-27 10:00:00",
            "subPayTime": "2025-12-27 09:00:00"
        },
        {
            "apiOrderId": "2153",
            "paymentTime": "2025-12-27 10:00:00",
            "subPayTime": "2025-12-27 09:00:00"
        }

    ],
    "batchNo": "20251232",
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "paymentTime": "2025-12-27 10:00:00",
    "subPayTime": "2025-12-27 09:00:00",
    "taskNo": "60f6b1cebb3a4c7e8fde3e7648fc35dc"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
# （5）返回示例
{
    "code": 200,
    "success": true,
    "message": "succeed"
}
1
2
3
4
5

# 6、发票

# （1）查询发票申请记录

​ 获取发票申请记录明细

​ • 自动提交：系统每天 00:30 自动提交发票申请，无需客户手动申请。

​ • 建议操作：建议在每天 01:00 至 09:00 时间区间内调用接口，以保存相关发票申请记录信息，避免在推送发票附件时出现数据异常。

# （1）请求码

​ V3I001

# （2）请求参数
参数名 类型 是否必填 说明
companyNo String 是 商户编号
taskNo String 否 任务编号
currentPage Integer 可选 页码，默认为1
pageSize Integer 可选 条数，默认为10，最大条数100条
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "taskNo": "eyey823623525272rert",
    "currentPage": 1,
    "pageSize": 10
}
1
2
3
4
5
6
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 此项暂无信息

data 数组详情

参数名称 类型 描述
drawer String 园区名称
title String 商户名称
taxpayerIdentificationNumber String 纳税人识别号
refisteredAddressAndPhone String 地址、电话
shoeDepositBankAndAccount String 银行、账号
invoiceContents String 发票类目
createTime Date 创建时间
amounts BigDecimal 申请金额
status Integer 发票状态：1-待开票，5-已开票
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": [
        {
            "invoiceContents": "*现代服务*市场推广费",
            "amounts": 726.00,
            "createTime": "2024-08-13T10:18:06.217",
            "drawer": "淅川县豹骑网络科技有限公司",
            "shoeDepositBankAndAccount": "北京十里河支行 15000100716415",
            "title": "测试企业40（测试）",
            "taxpayerIdentificationNumber": "91110117MA7EKJ2651",
            "refisteredAddressAndPhone": "注册地址 15712939346"，
            "status": 
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# （2）获取发票附件

​ 客户可以通过任务编号查询对应发票申请的附件。建议在任务完成后的次日 14:00 后进行查询，以确保附件信息的完整性和准确性。

# （1）请求码

​ V3I002

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
taskNo String 是 任务编号
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "taskNo": "eyey823623525272rert"
}
1
2
3
4
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 发票附件数据

data 数组详情

参数名称 类型 描述
attachments Array[String] 发票附件列表
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": {
        "attachments": [
            "https://devyunoss.jinglingyunxiang.com/invoice/2024/08/13/17235170486663085.png?Expires=1723603452&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=gyvl5Yj324USU6hXjSaiHKWfntU%3D"
        ]
    }
}
1
2
3
4
5
6
7
8
9
10

# （3）发票附件异步通知

​ 发票开出后，系统将自动向客户平台推送发票附件。请在 IT 对接群中提供接收回调的接口地址。

# （1）请求码

​ 请在IT对接群提供请求URl

# （2）请求参数
参数名称 类型 是否必填 描述
taskNo String 是 任务编号
attachments Array[String] 是 发票附件列表
# （3）请求示例
{
  	"taskNo":"eyey823623525272rert",
    "attachments": [
        "https://devyunoss.jinglingyunxiang.com/invoice/2024/08/13/17235170486663085.png?Expires=1723603452&OSSAccessKeyId=LTAI5tDL3iqZFggr3hSmXqbT&Signature=gyvl5Yj324USU6hXjSaiHKWfntU%3D"
    ]
}
1
2
3
4
5
6

# 7、流水

# （1）查询流水

​ 通过支付渠道及对应子账号，多维度查询客户子账户的流水明细。请保存业务流水号，以便后续获取回单。

​ • 查询时间：可以在下发完成后的次日上午 9 点后获取流水明细。

# （1）请求码

​ V3A001

# （2）请求参数
参数名称 类型 是否必填 描述
settlementsId integer 是 结算渠道 1 - 平安银行 4-招商银行(仅支持当前两个渠道)
subAccountNo string 是 子账号
startTime string(date-time) 是 开始时间
endTime string(date-time) 是 结束时间
direction string 否 借贷标识
maxAmount Integer 否 最大金额
minAmount Integer 否 最小金额
payeeAccountName string 否 对方账户账名称
payeeAccountNo string 否 对方账户号
remark string 否 备注
subAccountName string 否 子账名称
currentPage Integer 是 页码
pageSize Integer 是 条数
# （3）请求示例
{
  "direction": "",
  "endTime": "2024-08-13 14:15:22",
  "maxAmount": "",
  "minAmount": "",
  "currentPage": 1,
  "payeeAccountName": "",
  "payeeAccountNo": "",
  "remark": "",
  "settlementsId": 1,
  "pageSize": 10,
  "startTime": "2024-08-1 14:15:22",
  "subAccountName": "前端数据支持测试广西态矗有限公司",
  "subAccountNo": "30206465024024"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 流水列表

data.data 数组详情

名称 类型 说明
abstracts String 中文摘要
balance Number 交易后余额
bizFlowNo String 业务流水号
ccyCode String 币种
dcFlag String 借贷标识 D:借(支出),C:贷(存入)
mainAccount String 总账户账号
mainAccountName String 总账户名称
oppAccountName String 对方账户名
oppAccountNo String 对方账号（实体）
oppBankName String 对方行名
remark String 备注
subAccount String 子账户账号
subAccoutName String 子账户名称
tranAmount Number 交易金额
transferTime String(date-time) 交易时间
updateTime String(date-time) 流水取得时间
# （5）返回示例
{
    "code": 200,
    "data": {
        "data": [
            {
                "transferTime": 1722412380000,
                "abstracts": "n",
                "mainAccount": "15000100716415",
                "ccyCode": "RMB",
                "remark": "服务费和个税-任务号-20240731154542754jp5",
                "updateTime": 1722412625970,
                "subAccount": "30206465024024",
                "mainAccountName": "前端数据支持测试广西态矗有限公司",
                "dcFlag": "D",
                "balance": 888739351.60,
                "subAccoutName": "前端数据支持测试广西态矗有限公司",
                "oppAccountName": "前端数据支持测试广西态矗有限公司",
                "oppBankName": "平安银行深圳分行营业部",
                "tranAmount": 10.00,
                "bizFlowNo": "8043432407312167426320",
                "oppAccountNo": "30006465000000"
            },
            {
                "transferTime": 1722412260000,
                "abstracts": "网银",
                "mainAccount": "15000100716415",
                "ccyCode": "RMB",
                "remark": "测试测试",
                "updateTime": 1722412625970,
                "subAccount": "30206465024024",
                "mainAccountName": "前端数据支持测试广西态矗有限公司",
                "dcFlag": "D",
                "balance": 888739361.60,
                "subAccoutName": "前端数据支持测试广西态矗有限公司",
                "oppAccountName": "祖起",
                "oppBankName": "平安银行",
                "tranAmount": 100.00,
                "bizFlowNo": "8043432407311167425654",
                "oppAccountNo": "6230580000054508325"
            }
        ],
        "pageSize": 10,
        "totalPageSize": 477,
        "currentPage": 0,
        "totalPageNum": 48
    },
    "success": true,
    "message": "succeed"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# （2）查询回单

​ 通过【查询流水】接口返回的业务流水号，获取对应流水的回单。请在下发完成后的次日下午 3 点后进行查询。

# （1）请求码

​ V3A002

# （2）请求参数
参数名称 类型 是否必填 描述
bizFlowNos Array[String] 是 业务流水号列表
settlementsId Integer 是 支付渠道
# （3）请求示例
{
    "bizFlowNos": [
        "2185402202070053837717"
    ],
    "settlementsId": 1
}
1
2
3
4
5
6
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 流水列表

data 数组详情

名称 类型 说明
bizFlowNo String 业务流水号
url String 回单下载地址
# （5）返回示例
{
    "code": 200,
    "message": "succeed",
    "success": true,
    "data": [
        {
            "bizFlowNo": "2185402202070053837717",
            "url": "https://yun.qukaigong.com/var/upload/taskplatform/receipt/RECPDF_15967488280042_20220207/15967488280042_20220207_3240792202074300737602_C_LCS_000001_001.pdf"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11

# （3）据业务订单号查询电子回单和明细

​ 通过任务单号获取个人资金流水明细以及回单。

# （1）请求码

​ V3D007

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
taskNo String 否 任务编号
currentPage Integer 是 当前页码
pageSize Integer 是 条数
apiOrderId String 否 客户结算ID
startTime String(date-time) 否 任务开始时间
endTime String(date-time) 否 任务结束时间
payStartTime String(date-time) 否 支付完成开始时间
payEndTime String(date-time) 否 支付完成结束时间
name String 否 用户姓名
idCard String 否 身份证号码
pushBatchNo String 否 推送批次号
# （3）请求示例
{
    "companyNo":"2e03ca52ad834e629883d299db528561",
    "currentPage":1,
    "pageSize":10,
    "apiOrderId":"",
    "taskNo":"334074bee42c4270842c479fc15d4b",
    "startTime":"",
    "endTime":"",
    "payStartTime":"",
    "payEndTime":"",
    "name": "",
    "idCard":""，
    "pushBatchNo": "20260123"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 流水及回单列表

data 数组详情

名称 类型 说明
no String 任务流水号
name String 用户姓名
idCard String 身份证号
receivingBankAccount String 收款账号
wages Integer 任务金额
amounts Integer 实际到手金额
serviceMoney Integer 服务费金额
personPersonalTax Integer 个人个税金额
personalTax Integer 公司个税金额
addedTax Integer 增值税金额
cityTax Integer 城建税
eduTax Integer 教育费
localEduTax Integer 地方教育费
meal String 任务名称
receipt String 回单
paymentTime String 支付时间
status String 任务状态：1：未打款2：已打款3：挂起 4：删除 5：结果未知 6:退票 7:系统处理中（支付）8：自动清分不足 9:重试处理中
# （5）返回示例
{
  "code": 200,
  "data": {
    "endRow": 2,
    "hasNextPage": false,
    "hasPreviousPage": false,
    "isFirstPage": true,
    "isLastPage": true,
    "list": [
      {
        "addedTax": 0,
        "apiOrderId": "xm00010",
        "cityTax": 0,
        "amounts":8,
        "countWages": 10.5,
        "eduTax": 0,
        "idCard": "211322199802237278",
        "localEduTax": 0,
        "meal": "现代服务*推广服务费",
        "name": "吴极客",
        "no": "20260305164135280rvt",
        "personPersonalTax": 2,
        "personalTax": 0,
        "receivingBankAccount": "6214831150131511",
        "serviceMoney": 0.5,
        "status": 1,
        "wages": 10
      }
    ],
    "navigateFirstPage": 1,
    "navigateLastPage": 1,
    "navigatePages": 8,
    "navigatepageNums": [
      1
    ],
    "nextPage": 0,
    "pageNum": 1,
    "pageSize": 10,
    "pages": 1,
    "prePage": 0,
    "size": 2,
    "startRow": 1,
    "total": 2
  },
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# 8、退款

# （1）申请退款

# （1）请求码

​ V3D003

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编码
thirdInfoNo String 是 园区编码
accountName String 是 收款账户名称
receiveAccount String 是 收款账户
refundAmount Integer 是 退款金额
bankId Integer 是 银行ID：1-平安银行，4-招商银行
# （3）请求示例
{
  "companyNo": "e2c30c21f72248f395421143pl45529d",
  "thirdInfoNo": "798dd09db9184eb3b7a99ef9e171138f",
  "accountName": "测试企业40",
  "receiveAccount": "755915678010909",
  "refundAmount": 1,
  "bankId": 1,
  "settlementBank": "平安银行"
}
1
2
3
4
5
6
7
8
9
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
# （5）返回示例
{
  "code": 200,
  "message": "succeed",
  "success": true
}
1
2
3
4
5

# （2）退款申请列表

# （1）请求码

​ V3D004

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编码
thirdInfoNo String 是 园区编码
currentPage Integer 否 当前页码
pageSize Integer 否 条数
settlementId Integer 否 结算渠道：1-平安银行，4-招商银行
startTime String 否 退款申请开始时间
endTime String 否 退款申请结束时间
# （3）请求示例
{
  "currentPage": 1,
  "pageSize": 10,
  "companyNo": "e2c30c21f72248f395421143pl45529d",
  "thirdInfoNo": "798dd09db9184eb3b7a99ef9e171138f",
  "settlementId": 1,
  "startTime": "2025-04-14 00:00:00",
  "endTime": "2025-04-15 00:00:00"
}
1
2
3
4
5
6
7
8
9
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 退款申请列表详情

dataList 数组详情

参数名称 类型 描述
balance Integer 账户余额
bankId Integer 结算渠道：1-平安银行，4-招商银行
companyName String 商户名称
companyNo String 商户编码
exclusiveAccount String 子账号
createTime String(date-time) 退款申请时间
gathering String 收款账号
nickName String 收款账户
publicAccount String 公共账户（对公打款账户）
refundMoney Integer 退款金额
roleId String 审核人id，未审核显示0
settlementBank String 收款账号开户银行
settlementBankCode String 收款账号银行编码
thirdInfoNo String 园区编码
thirdName String 园区名称
# （5）返回示例
{
  "code": 200,
  "data": {
    "endRow": 0,
    "hasNextPage": false,
    "hasPreviousPage": false,
    "isFirstPage": true,
    "isLastPage": true,
    "list": [
      {
        "balance": 162570847,
        "bankId": 1,
        "companyName": "测试企业40",
        "companyNo": "e2c30c21f72248f395421143pl45529d",
        "createTime": 1744593921000,
        "exclusiveAccount": "30206465258633",
        "gathering": "755915678010909",
        "id": 485,
        "nickName": "测试企业40",
        "publicAccount": "30208384110783",
        "refundMoney": 1,
        "roleId": "0",
        "settlementBank": "平安银行",
        "settlementBankCode": "307584007998",
        "thirdInfoNo": "798dd09db9184eb3b7a99ef9e171138f",
        "thirdName": "淅川县豹骑网络科技有限公司"
      }
    ],
    "navigateFirstPage": 1,
    "navigateLastPage": 1,
    "navigatePages": 8,
    "navigatepageNums": [
      1
    ],
    "nextPage": 0,
    "pageNum": 1,
    "pageSize": 1,
    "pages": 1,
    "prePage": 0,
    "size": 1,
    "startRow": 0,
    "total": 1
  },
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# （3）查询银行列表

# （1）请求码

​ V3D005

# （2）请求参数
参数名称 类型 是否必填 描述
currentPage String 否 当前页码
pageSize String 否 条数
# （3）请求示例
{
"currentPage": 1,
"pageSize": 10
}
1
2
3
4
# （4）返回结果
参数名称 类型 描述
code Integer 返回编码
message String 返回消息
success Boolean 是否成功
data Object 银行列表

dataList 数组详情

参数名称 类型 描述
bankName String 银行名称
# （5）返回示例

{
  "code": 200,
  "data": {
    "endRow": 9,
    "hasNextPage": false,
    "hasPreviousPage": false,
    "isFirstPage": true,
    "isLastPage": true,
    "list": [
      {
        "bankName": "中国银行"
      },
      {
        "bankName": "招商银行"
      },
      {
        "bankName": "兴业银行"
      }
    ],
    "navigateFirstPage": 1,
    "navigateLastPage": 1,
    "navigatePages": 8,
    "navigatepageNums": [
      1
    ],
    "nextPage": 0,
    "pageNum": 1,
    "pageSize": 10,
    "pages": 1,
    "prePage": 0,
    "size": 10,
    "startRow": 0,
    "total": 10
  },
  "message": "succeed",
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# 六、附件

# 《行业表》

ID 行业名称
1 电信
2 制造业
3 文化娱乐-影视
4 文化娱乐-其他
5 共用事业
6 教育
7 服务
8 娱乐
9 高科技
10 能源
11 咨询
12 金融-银行
13 金融-保险经纪代理
14 金融-其他
15 零售
16 建筑-建筑劳务
17 建筑-其他
18 房地产-房地产经纪
19 房地产-其他
20 医药行业
21 人力资源
22 其他行业

# 《公司类型》

id 企业类型
1 国有企业
2 集体企业
3 股份合作企业
4 联营企业
5 有限责任公司
6 股份有限公司
7 私营企业
8 合资经营企业（港或澳、台资）
9 合作经营企业（港或澳、台资）
10 港澳台商独资经营企业
11 港澳台商投资股份有限公司
12 其他港澳台商投资企业
13 中外合资经营企业
14 中外合作经营企业
15 外资企业
16 外商投资股份有限公司
17 其他外商投资企业
18 其他
上次更新: 2026/03/20, 22:34:36
数据接口对接

←

Theme by Vdoing | Copyright © -2026 ©2016-2025 京翎云享平台 版权所有 ICP证： 京ICP备2023008449号-1