京翎云享
  • 操作手册
  • 三方灵工平台对接接口
京翎云享
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://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 (AES/ECB/PKCS5Padding) 对称加密方式进行加密处理。以下是 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 (AES/ECB/PKCS5Padding) 对称加密方式对业务数据进行加密处理。下面是 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

# 五、接口说明

# 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 商户审核驳回原因
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,
  	"message": "succeed",
  	"success": true,
    "data": [
        {
            "thirdId": "eb142f379eea4d6c8e08ebe89e89d209",
            "thirdName": "江西京灵云达",
            "subAccountInfoList": []
        },
        {
            "thirdId": "798dd09db9184eb3b7a99ef9e171138f",
            "thirdName": "淅川县豹骑网络科技有限公司",
            "subAccountInfoList": [
                {
                    "settlementsId": 1,
                    "settlementsName": "平安银行",
                    "subAccountName": "测试专用110",
                    "subAccount": "30206465112068",
                    "balance": 0,
                    "collectionAccountName": "前端数据支持测试甘肃亚雄有限公司",
                    "collectionAccount": "30206465112068",
                    "collectionSubBranch": "1"
                },
                {
                    "settlementsId": 7,
                    "settlementsName": "微信",
                    "subAccountName": "测试专用110",
                    "subAccount": "20240811064903100006",
                    "balance": 0,
                    "collectionAccountName": "淅川测试渠道",
                    "collectionAccount": "jiangshujuan20240811064903100006",
                    "collectionSubBranch": "财付通-备付金账户"
                }
            ]
        }
    ]
}
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

# 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

# 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参数说明

参数名称 类型 描述
invoiceId Integer 发票类目ID（查询模板ID使用）
content String 发票类目名称
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": [
        {
            "invoiceId": 767,
            "content": "*信息技术服务*相关电路技术支持服务"
        },
        {
            "invoiceId": 790,
            "content": "*信息技术服务*信息技术服务费"
        },
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# （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）新增用户

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

# （1）请求码

​ V3U001

# （2）请求参数
参数名称 类型 是否必填 描述
companyNo String 是 商户编号
thirdNo String 可选 园区编号：C端协议签署主体为园区公司时，此项必填
flag Integer 是 重复数据处理规则：1-覆盖；2-跳过
operationFlag Integer 是 个人签约方式：1-传输协议文件url；2-返回签约URL
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 否 身份证反面照片的下载链接
servicePdf String 否 服务协议文件的下载链接，当operationFlag为1时，此项必填
idCardType String 否 证件照片类型：1-扫描件，2-复印件
userLibraryId String 是 资料级别：详见下方说明
资料级别说明：

	1.	级别 1：四要素信息 + 证件照片 + 协议（需要人工审核）
	2.	级别 2：四要素信息 + 证件照片（验证通过后直接放入正式用户库，并更新用户状态为已认证）
	3.	级别 3：四要素信息（验证通过后直接放入正式用户库，并更新用户状态为已认证）
	4.	级别 4：四要素信息 + 协议（需要人工审核）

字段要求：

	•	级别 1 和 2：证件照片类型、身份证正面照片、身份证反面照片等字段必填。
	•	级别 1 和 4：服务协议字段必填。
1
2
3
4
5
6
7
8
9
10
11
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "thirdNo": "",
    "flag": 1,
    "operationFlag": 1,
    "users": [
        {
            "bank": "北京银行",
            "bankcard": "672643345262727",
            "idCard": "12010219531015301X",
            "idCardAddress": "",
            "idCardFrontImage": "",
            "idCardReverseImage": "",
            "name": "张三",
            "phone": "157****9346",
            "servicePdf": "https://devyun.jinglingyunxiang.com/task_platform/uploadSSO/dwonloadFile?path=contract/2023/05/22/16847484877618121.pdf",
            "idCardType":"",
            "userLibraryId": 4
        }
    ]
}
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 审核驳回原因
# （5）返回示例
{
    "code": 200,
  	"message": "succeed",
  	"success": true,
    "data": [
        {
            "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
28
29
30
31
32
33

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

​ 平台风控在手动或系统自动审核用户信息后，将向客户平台推送个人信息的审核状态。请在 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 Integer 是 商户编号
thirdInfoNo Integer 是 园区编号
principalId String 是 地区ID
titleid Integer 是 任务模板ID
taxType Integer 是 发票类目ID
settlementsId Integer 是 结算渠道:1-平安银行;2 - 支付宝;4-招商银行;
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) 可选 任务自动终止时间，到达传递时间后，系统将自动终止任务
# （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"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# （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 Integer 是 商户编号
taskNo String 是 任务编号
thirdInfoNo String 是 园区编号
users Object 是 人员列表

users

名称 类型 必选 说明
apiOrderId String 是 客户平台结算ID
name String 是 姓名
idCard String 是 身份证号
bankCard String 是 银行卡号
amount Number 是 金额
meal String 是 任务内容
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "thirdInfoNo": "798dd09db9184eb3b7a99ef9e171138f",
    "taskNo": "01f1fc166df04e019df1d99a9790e52f",
    "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
# （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 Integer 是 商户编号
taskNo String 是 任务编号
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "taskNo": "e76f31287d0a47dcaddcb3de53428ba7"
}
1
2
3
4
# （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 Integer 是 商户编号
taskNo Integer 是 任务编号
apiOrderId Integer 可选 客户平台结算ID
orderId Integer 可选 订单ID
# （3）请求示例
{
    "companyNo": "e2c30c21f72248f395421143pl45529d",
    "taskNo": "2232013332764837a6936dd3423b149b",
    "apiOrderId": "",
    "orderId": "138658"
}
1
2
3
4
5
6
# （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 Integer 是 商户编号
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 提交支付时间
# （5）返回示例
{
    "code": 200,
    "message": "succeed",
    "success": true,
    "data": {
        "data": [
            {
                "receivingAccount": "6230580000054508325",
                "amounts": 10.00,
                "orderId": 138656,
                "phone": "17624018035",
                "idCard": "420322196101180420",
                "receivablesName": "祖起",
                "apiOrderId": "1010010",
                "failMessage": "",
                "statusMessage": "待支付",
                "receivingBankName": "平安银行",
                "status": 1,
                "paymentTime":"2024-08-13 09:09:33",
                "subPayTime":"2024-08-13 09:05:33
            }
        ],
        "pageSize": 10,
        "totalPageSize": 1,
        "currentPage": 1,
        "totalPageNum": 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

# （7）重新打款

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

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

# （1）请求码

​ V3T006

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

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

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

​ • 用途：

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

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

# （1）请求码

​ V3T007

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

data 数组详情

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

userVOList

参数名称 类型 描述
userName String 用户姓名
userIdCard String 身份证号
meal String 工作名称
wages Integer 任务金额
servicerate Integer 服务费率
fees Integer 服务费金额
# （5）返回示例
{
    "code": 200,
    "message": "succeed",
    "success": true,
    "data": {
        "feesCount": 1.0000,
        "wagesCount": 10.00,
        "userVOList": {
            "navigatepageNums": [
                1
            ],
            "startRow": 0,
            "hasNextPage": false,
            "prePage": 0,
            "nextPage": 0,
            "endRow": 0,
            "pageSize": 1,
            "list": [
                {
                    "meal": "现代服务*推广服务费",
                    "wages": 10.00,
                    "fees": 1.0000,
                    "userIdCard": "42032219600118042X",
                    "servicerate": 10.00,
                    "userName": "祖起"
                }
            ],
            "pageNum": 1,
            "navigatePages": 8,
            "navigateFirstPage": 1,
            "total": 1,
            "pages": 1,
            "size": 1,
            "isLastPage": true,
            "hasPreviousPage": false,
            "navigateLastPage": 1,
            "isFirstPage": 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

# （9）终止任务

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

​ • 终止操作：

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

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

​ • 发票申请：

​ • 系统每天 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

# 5、发票

# （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

# 6、流水

# （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

# 六、附件

# 《行业表》

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 其他
上次更新: 2024/10/30, 12:42:47
SaaS服务平台

←

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