品为灵工2.0API接口文档

文档修订历史

1.文档概述

本文档是品为灵工专为合作商户提供的系统对接说明文档。为了协助我们的合作伙伴成功接入品为灵工提供的服务，请务必依据文档内容开发部署。

特别声明：1、未经品为灵工许可，不得将品为灵工提供的接口技术、安全协议及证书等以任何方式提供给第三方使用，请合作伙伴妥善保存。

​ 2、在不改变原有参数的前提下，品为灵工保留接口新增参数的权力，请合作伙伴进行兼容，恕不另行通知。

​ 3、本文档的解释权归品为灵工所有。

2.应用范围

3.接口规范介绍

3.1请求规范

1.请求采用HTTPS POST方式请求( 参数在 RequestBody 中 Content-Type application/json)；

2.编码格式统一为utf-8；

3.数据格式统一为json；

4.请求签名采用MD5或者RSA签名（建议使用RSA加密）；

5.IP白名单限制测试环境、生产环境均需提供ip进行白名单配置；

6.测试环境IP及生产请联系运营人员获取；

7.文档中Y代表必输项，N代表非必输，C代表条件传输。

3.2关于签名

为保证您与品为灵工之间消息来往的安全性，防止支付或者通知的数据被伪造、篡改，品为灵工要求对所有来往的信息加入签名机制。

签名算法使用SHA256withRSA。

除sign字段外所有值不为空的参数均需参与签名。

采用RSA加密方式需加签与业务参数data需进行加密，得到元数据需解密获取并验签。

密钥生成长度为1024位。

密钥生成格式为PKCS#8。

签名JSON字符串排序为字典序。

3.2.1RSA签名

在您与品为灵工的交易中， 会使用到两对公私钥，即企业公私钥与品为灵工公私钥。

企业公私钥：用于您向品为灵工发送请求时的加签与验签。 该公私钥由您自己生成， 其中，私钥用于对您发往品为的数据签名，自己保存；公钥需要提交给品为灵工，当品为灵工收到您发来的数据时用该公钥验证签名。

品为灵工公私钥：用于品为灵工向您发送通知或者响应时的加签与验签。该公私钥由品为灵工生成，其中，品为灵工私钥不提供；品为灵工公钥可于品为灵工系统安全中心中自行下载。

• 生成请求报文

建议使用平台提供的方法获取秘钥。

    /**
                 * 生成秘钥
                 * 将私钥保存，公钥上传到品为灵工平台
                 * @throws Exception
                 */
                public static void getRsaKey() throws Exception {
                    Map<String, String> keyMap = MyRSA.genKeyPair();
                    String publicKey = MyRSA.getPublicKey(keyMap);
                    String privateKey = MyRSA.getPrivateKey(keyMap);
                    System.out.println("公钥："+publicKey);
                    System.out.println("私钥："+privateKey);
                }
					Copy to clipboardErrorCopied

• 生成请求报文

1.将业务参数组装成JSON字符串格式；

2.使用品为灵工平台公钥对提交的业务参数进行加密；

3.除文档中明确标注不参与签名的参数外，所有值不为空的参数均需参与签名，使用对接方私钥进行签名；

4.将签名数据和加密数据组装发送品为灵工平台。

    /**
                 * 生成发送数据包
                 * @param appId
                 * @param bbxPublicKey 品为灵工公钥
                 * @param myPrivateKey 对接方的私钥
                 * @param data 需要发送请求的业务数据（未加密）
                 * @return
                 * @throws Exception
                 */
                public static String createSendMsg(String appId,String bbxPublicKey,String myPrivateKey,String data) throws Exception {
                    BaseDataVo vo = new BaseDataVo();
                    vo.setAppid(appId);
                    vo.setNonceStr(RandomStringUtils.randomAlphanumeric(20));
                    vo.setReqMsgId(UUID.randomUUID().toString().replace("-",""));
                    vo.setSignType("RSA");
                    vo.setTimestamp(String.valueOf(System.currentTimeMillis()));
                    String encryptData = MyRSA.encryptByPublicKey( data,bbxPublicKey);//使用品为灵工公钥进行加密
                    vo.setData(encryptData);
                    String signData = MyRSA.sign(JSON.toJSONString(vo),myPrivateKey);//使用我的私钥进行签名,对所有数据进行签名
                    vo.setSign(signData);
                    //vo.setData(encryptData);
                    return JSON.toJSONString(vo);
                }
            Copy to clipboardErrorCopied

• 验签解密平台报文

1.格式转换平台返回报文为对象或JSON；

2.使用品为灵工平台公钥对数据进行验签；

3.使用对接方私钥对业务数据data进行解密，放入对象。

     /**
                 * 收到数据后进行解密验签（包含回调）
                 * 解密&验签
                 * @param publicKey 使用品为灵工平台公钥进行验签
                 * @param privateKey 使用对接方的私钥进行解密
                 * @param data
                 * @return
                 */
                public static BaseDataVo  decryptAndVerify(String publicKey, String privateKey, String data) throws Exception {
                    BaseDataVo vo = JSONObject.parseObject(data, BaseDataVo.class);
                    String signData = vo.getSign();
                    vo.setSign(null);//签名数据需要移除掉，不然会导致验签失败
                    boolean verify = MyRSA.verify(JSON.toJSONString(vo),publicKey, signData); //使用品为灵工平台公钥进行验签，除sign外的所有数据进行验签
                    vo.setVerify(verify);
                    if(verify) {//验签失败不进行解密
                        String decrypt = MyRSA.decryptByPrivateKey(JSON.toJSONString(vo.getData()), privateKey);//使用我的私钥进行解密
                        vo.setData(decrypt);
                    }
                    return vo;
                }Copy to clipboardErrorCopied

• 特别说明

当品为灵工通知您时，品为灵工会使用品为灵工私钥进行加签，企业提供公钥进行加密业务数据，请您进行验签以确保数据的准确性，并解密业务数据已获取元数据。

回调验签解密方式与同步接口请求方法一致。

JAVA示例代码下载

C#示例代码下载

PHP示例代码下载

nodejs示例代码下载

3.2.2关于请求报文公共头

3.2.3关于响应报文公共头

3.3回调通知

所有通知类接口均根据接入方提供URL进行异步回调，接收方返回200即不再进行回调，若无响应则进行1、2、4、5、10、15分钟间隔回调，六次回调均无响应成功则不再进行回调，请发起主动查询获取结果。

回调通知接口需要对接方依据本文档规定进行相应的接收数据接口开发。

3.4关于分页

所有返回数据可能会产生大量数据的接口，均通过分页的方式返回。平台默认每页100条数据。分页请求需添加参数pageNum，表示第几页。

4名称解释

对接方：本文档阅读用户，对接的企业用户或者渠道用户。

月大小额限制拦截：月限额分为月限额与月大额限额，未超过月限额结算费率使用小额费率，超过月限额使用大额费率。超过月大额选择不允许进行结算支付。若企业配置是否允许小额转大额为否，则超过月限额不允许结算支付。同园区根据其业务规模支持范围具有不同的月限额设置。

年限额拦截：当自由职业者本年累计发放额度超过年限额时，平台不允许发放。不同园区根据其业务规模支持范围具有不同的年限额设置。

三月限额拦截：当自由职业者连续三个月（包含本月）发放额度都超过三月限额时，平台不允许发放。不同园区根据其业务规模支持范围具有不同的三月限额设置。

补缴服务费：企业配置是否允许小额转大额为是的情况下，当结算支付的某个自由职业者月累计发放超过月限额时，结算费率由小额费率变为大额费率，并且本月之前累积发放的金额也需要按照大额费率进行补缴，补缴的该部分费用成为补缴服务费。计算公式为：本月累计发放金额 *（大额费率-小额费率）。

定向招募：企业发布任务不对外公开，内部定向分派给指定的自由职业者完成该任务并进行结算。

自由招募：企业发布的任务面向社会发布，所有具有相应技能的自由职业者均可以认领该任务，企业进行审核。

5.接口详情

本章仅描述接口api的业务意义以及其业务参数，公共参数详见3.2.3公共参数说明部分。

5.1企业入驻

5.1.1入驻申请

• 说明

企业接入平台首先需要进行入驻申请，平台审核通过之后会为企业分配对应的园区并进行开户，同时设置服务费率、支持的项目类型、任务类型以及对应的开票类目等信息。

企业申请时，建议配置上回调URL。平台审核通过或者拒绝之后会自动通过回调URL告知企业。

企业的费率、账号等信息，平台通过回调接口告知企业，支持园区、项目类型、任务类型等信息需要通过其他接口进行主动查询。

• 接口API

/interface/company/register

• 请求参数

• 请求示例

{
                "sign": "dsfdsfdsgsdfds",
                "signType": "MD5",
                "appid": "156412121",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiSRDWxsTQ",
                "reqMsgId": "394b83504cfDFDSSDSedbb6af8e9247a9d6b",
                "data": {
                    "companyName": "北京接口科技有限公司",
                    "creditCode": "91110108MA04EN0G0G",
                    "companyAddr": "北京市大兴区丈八沟街道",
                    "companyMobile": "173196655242",
                    "companyEmail": "1564515@qq.com",
                    "businessScope": "建筑业行业",
                    "businessType": "土木工程建筑业",
                    "serviceTypeId": "1",
                    "registeredAssets": "500",
                    "regdate": "2022-03-01",
                    "bankName": "建设银行",
                    "bankAcct": "622365451052525",
                    "contactName": "张三",
                    "contactMobile": "17319852652",
                    "referralCode": "1",
                    "taskAuto": "1",
                    "legalPersonName": "王五",
                    "idNo": "632323190605269943",
                    "idCardFace": "http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1640327997055.jpg",
                    "idCardEmblem": "http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1640327997055.jpg",
                    "businessLicense": "http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1640327997055.jpg",
                    "accountLicense": "http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1640327997055.jpg",
                    "houseNumberImg": "http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1640327997055.jpg",
                    "officeSpaceImg": "http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1640327997055.jpg",
                    "receptionImg": "http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1640327997055.jpg",
                    "serviceTypeLicense": "http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1640327997055.jpg",
                    "callBackUrl": "https://www.baidu.com",
                    "companyTaxpayer": "1",
                    "estimateVolumeMonth": 100000
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "104-0020-001",
                "message": "企业已注册"
            }Copy to clipboardErrorCopied

{
                "code": "200",
                "data": {
                    "creditCode": "SFDFSSFDSFDSDSDFDS",
                    "companyName": "四平市公主岭市开发公司",
                    "businessId": "1030786725203726336",
                    "status": "04"
                },
                "appid": "964132147940167680",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "tctTWiceTx0iItQWIDxe",
                "timestamp": "1645770163620",
                "reqMsgId": "4dds1ss4ds4s4541fssss45cf44s"
            }Copy to clipboardErrorCopied

5.1.2入驻结果查询

• 说明

企业发起准入申请后，若没有发送回调URL，可通过该API查询审核状态。若发送了回调URL长时间没有收到回调通知，也可通过该接口进行查询。

• 接口API

/interface/company/queryCompanyInfo

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgEwI98RHIFO6/XApGgbVpuepnUOB0fLF",
                "signType": "RSA",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "394b83504cf947edbb6af8e9247a9d6b",
                "appid": "2022022800001",
                "data": 
                {
                    "businessId": "950709751405330432"
                }
            }Copy to clipboardErrorCopied

• 响应参数

companyRates 企业费率

acctInfo 账户信息

• 响应示例

{
                "code": "200",
                "data": {
                    "littleLimitRate": "",
                    "acctInfo": [
                        {
                            "acctNo": "30206465852697",
                            "parkName": "uat测试园区",
                            "zfCode": "pa_pay",
                            "limitAmount": 90000,
                            "bankName": "前端数据支持测试江西讫酉有限公司",
                            "acctName": "漳州市翠峦区开发公司",
                            "acctNoMaster": "15000100716415",
                            "parkId": 2,
                            "rechargeAccount": "30206465852697",
                            "rechargeAccountName": "漳州市翠峦区开发公司"
                        }
                    ],
                    "creditCode": "SFSFF1F1D4CDSSDSFS",
                    "companyName": "漳州市翠峦区开发公司",
                    "businessId": "1028346564185677824",
                    "largeLimitRate": "",
                    "signUrl": "http://xlg.zx2289.cn/?seqNo=1028346564185677824",
                    "companyRates": [
                        {
                            "feeRate": "0.0200",
                            "moneyEnd": 10000000,
                            "moneyStart": 0
                        }
                    ],
                    "status": "11"
                },
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "cM0sicJJ0ssPxCJMWRDb",
                "timestamp": "1645770163620",
                "reqMsgId": "ffsffccdcsss45scddf14s"
            }Copy to clipboardErrorCopied

5.1.3入驻结果回调

• 说明

若申请入驻参数中包含了回调URL，平台审核通过或者拒绝后会及时通过该接口告知对接方。该API包含审核状态、平台为企业开通的账号、服务费率等信息。

• 请求参数

acctInfo 账户信息

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgEwI98RHIFO6/XApGgbVpuepnUOB0fLF",
                "signType": "RSA",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "394b83504cf947edbb6af8e9247a9d6b",
                "appid": "2022022800001",
                "data": 
                {
                    "acctInfo": [
                        {
                            "acctNo": "30206465066104",
                            "parkName": "uat测试园区",
                            "zfCode": "pa_pay",
                            "limitAmount": 10000000,
                            "bankName": "前端数据支持测试江西讫酉有限公司",
                            "acctName": "北京接口科技有限公司",
                            "parkId": 2
                        }
                    ],
                    "creditCode": "91110108MA04EN0G0G",
                    "companyName": "北京接口科技有限公司",
                    "businessId": "950709751405330432",
                    "status": "11"
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "message": "请求成功"
            }Copy to clipboardErrorCopied

5.2园区信息

5.2.1园区信息查询

• 说明

企业申请入驻后，平台审核并为企业分配相应的园区以及相应支持的项目、任务类型。本API主要查询企业关联的园区及其各自支持的项目、任务类型关系。用于对接方创建项目、任务必要的数据选项支持。

• 接口API

/interface/baseInfo/queryParks

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgt+Qo+gl9s+6okHOL186+Mr+DW8eNVpuepnUOB0fLF",
                "signType": "RSA",
                "appid":"14561212",
                "timestamp": "1645770163620",
                "nonceStr":"{% mock 'string', 'MPzteIbCc0JiJRDWxsTQ', 20, 20 %}",
                "reqMsgId":"{% mock 'string', '44fdsf45dsf4s51cdfsd4s5c1', 20, 30 %}",
                "data": {
                    "businessId": "950709751405330432",
                }
            }Copy to clipboardErrorCopied

• 响应参数

itemType 园区支持项目类型

taskType 项目包含任务类型

• 响应示例

{
                "code": "200",
                "data": [
                    {
                        "itemType": [
                            {
                                "invoiceOneObjectName": "现代服务",
                                "itemTypeId": 2,
                                "itemTypeName": "人力资源服务",
                                "taskType": [
                                    {
                                        "invoiceTwoObjectName": "现代外包服务费",
                                        "taskTypeId": 106,
                                        "taskTypeName": "外包服务"
                                    }
                                ]
                            },
                            {
                                "invoiceOneObjectName": "现代服务",
                                "itemTypeId": 6,
                                "itemTypeName": "服务业",
                                "taskType": [
                                    {
                                        "invoiceTwoObjectName": "通用设备安装服务",
                                        "taskTypeId": 138,
                                        "taskTypeName": "通用设备安装服务"
                                    }
                                ]
                            }
                        ],
                        "parkId": 23,
                        "parkName": "湖南税猫科技有限公司"
                    }
                ],
                "appid": "954749107102408704",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "zb0TiTWisCMtxCxJCDW0",
                "timestamp": "1222332123",
                "reqMsgId": "sdscs5sfds455455fssf4cfsds"
            }
            Copy to clipboardErrorCopied

5.2.2项目任务类型信息查询

• 说明

本API返回企业支持的任务类型列表及其对应的项目类型和发票类目。请对接方一定要注意本API接口返回的数据信息，每一个任务类型都有其对应的发票类目，要认真核对企业的实际需求，创建项目、任务时一定要选择正确的项目类型和任务类型，平台只可以根据任务类型出具对应的发票。请一定要注意此项。

• 接口API

/interface/baseInfo/queryTaskTypes

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgt+Qo+gl9s+6okHOL186+Mr+DW8eNVpuepnUOB0fLF",
                "signType": "RSA",
                "appid":"14561212",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "394b83504cf947edbb6af8e9247a9d6b",
                "data": {
                    "businessId": "923962185565216768",
                }
            }Copy to clipboardErrorCopied

• 响应参数

serviceType 服务类型

deliveries 交付物种类

• 响应示例

{
                "appid": "964132147940167680",
                "signType": "RSA",
                "code": "200",
                "message": "操作成功",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "timestamp": "1645770163620",
                "reqMsgId": "394b83504cf947edbb6af8e9247a9d6b",
                "data": [
                    {
                        "deliveries": [
                            {
                                "id": 1,
                                "name": "测试及验收报告",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 35,
                        "invoiceLevelTwo": 1,
                        "invoiceOneObjectName": "数据研发技术服务",
                        "invoiceTaxCode": "3040105000000000000",
                        "invoiceTwoObjectName": "研发和技术服务",
                        "itemType": 1,
                        "itemTypeName": "专业服务",
                        "serviceType": [
                            {
                                "name": "计算机软件服务",
                                "id": 1
                            }
                        ],
                        "taskType": 12,
                        "taskTypeName": "数据研发"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 2,
                                "name": "解决方案",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 37,
                        "invoiceLevelTwo": 3,
                        "invoiceOneObjectName": "专业税务顾问",
                        "invoiceTaxCode": "3040603020000000000",
                        "invoiceTwoObjectName": "专业税务顾问",
                        "itemType": 1,
                        "itemTypeName": "专业服务",
                        "serviceType": [
                            {
                                "name": "财务/审计/税务服务",
                                "id": 2
                            }
                        ],
                        "taskType": 14,
                        "taskTypeName": "专业税务顾问"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 3,
                                "name": "服务验收材料",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 39,
                        "invoiceLevelTwo": 4,
                        "invoiceOneObjectName": "人力资源管理咨询费",
                        "invoiceTaxCode": "3040803990000000000",
                        "invoiceTwoObjectName": "人力资源服务",
                        "itemType": 2,
                        "itemTypeName": "人力资源服务",
                        "serviceType": [
                            {
                                "name": "人力资源服务",
                                "id": 3
                            }
                        ],
                        "taskType": 16,
                        "taskTypeName": "人力资源管理咨询"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 3,
                                "name": "服务验收材料",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 41,
                        "invoiceLevelTwo": 4,
                        "invoiceOneObjectName": "代发业务服务",
                        "invoiceTaxCode": "3040803990000000000",
                        "invoiceTwoObjectName": "人力资源服务",
                        "itemType": 2,
                        "itemTypeName": "人力资源服务",
                        "serviceType": [
                            {
                                "name": "人力资源服务",
                                "id": 3
                            }
                        ],
                        "taskType": 18,
                        "taskTypeName": "代发业务"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 3,
                                "name": "服务验收材料",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 43,
                        "invoiceLevelTwo": 4,
                        "invoiceOneObjectName": "其他人力资源服务",
                        "invoiceTaxCode": "3040803990000000000",
                        "invoiceTwoObjectName": "人力资源服务",
                        "itemType": 2,
                        "itemTypeName": "人力资源服务",
                        "serviceType": [
                            {
                                "name": "人力资源服务",
                                "id": 3
                            }
                        ],
                        "taskType": 20,
                        "taskTypeName": "其他人力资源服务"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 3,
                                "name": "服务验收材料",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 44,
                        "invoiceLevelTwo": 4,
                        "invoiceOneObjectName": "劳务服务费",
                        "invoiceTaxCode": "3040803990000000000",
                        "invoiceTwoObjectName": "人力资源服务",
                        "itemType": 2,
                        "itemTypeName": "人力资源服务",
                        "serviceType": [
                            {
                                "name": "人力资源服务",
                                "id": 3
                            }
                        ],
                        "taskType": 21,
                        "taskTypeName": "劳务服务"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 3,
                                "name": "服务验收材料",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 46,
                        "invoiceLevelTwo": 4,
                        "invoiceOneObjectName": "人力资源外包服务费",
                        "invoiceTaxCode": "3040803990000000000",
                        "invoiceTwoObjectName": "人力资源服务",
                        "itemType": 2,
                        "itemTypeName": "人力资源服务",
                        "serviceType": [
                            {
                                "name": "人力资源服务",
                                "id": 3
                            }
                        ],
                        "taskType": 23,
                        "taskTypeName": "人力资源外包"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 1,
                                "name": "测试及验收报告",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 193,
                        "invoiceLevelTwo": 1,
                        "invoiceOneObjectName": "专业技术服务",
                        "invoiceTaxCode": "3040105000000000000",
                        "invoiceTwoObjectName": "研发和技术服务",
                        "itemType": 1,
                        "itemTypeName": "专业服务",
                        "serviceType": [
                            {
                                "name": "学术/科研服务",
                                "id": 16
                            }
                        ],
                        "taskType": 170,
                        "taskTypeName": "专业技术服务"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 1,
                                "name": "测试及验收报告",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 194,
                        "invoiceLevelTwo": 1,
                        "invoiceOneObjectName": "合同能源管理服务",
                        "invoiceTaxCode": "3040103000000000000",
                        "invoiceTwoObjectName": "研发和技术服务",
                        "itemType": 1,
                        "itemTypeName": "专业服务",
                        "serviceType": [
                            {
                                "name": "企业服务",
                                "id": 4
                            }
                        ],
                        "taskType": 171,
                        "taskTypeName": "合同能源管理"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 1,
                                "name": "测试及验收报告",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 195,
                        "invoiceLevelTwo": 1,
                        "invoiceOneObjectName": "工程勘察勘探服务",
                        "invoiceTaxCode": "3040104010000000000",
                        "invoiceTwoObjectName": "研发和技术服务",
                        "itemType": 11,
                        "itemTypeName": "房地产/建筑",
                        "serviceType": [
                            {
                                "name": "工程施工/勘察服务",
                                "id": 30
                            }
                        ],
                        "taskType": 172,
                        "taskTypeName": "工程勘察勘探"
                    },
                    {
                        "deliveries": [
                            {
                                "id": 1,
                                "name": "测试及验收报告",
                                "type": "1"
                            }
                        ],
                        "invoiceLevelOne": 196,
                        "invoiceLevelTwo": 1,
                        "invoiceOneObjectName": "技术咨询",
                        "invoiceTaxCode": "3040105000000000000",
                        "invoiceTwoObjectName": "研发和技术服务",
                        "itemType": 1,
                        "itemTypeName": "专业服务",
                        "serviceType": [
                            {
                                "name": "咨询服务",
                                "id": 10
                            }
                        ],
                        "taskType": 173,
                        "taskTypeName": "研发技术咨询"
                    }
                ]
            }Copy to clipboardErrorCopied

5.3企业项目信息

5.3.1发布项目和任务

• 说明

企业发布任务首先需要具有对应的项目，发布项目时需要注意的事项如下：

1.园区编码：请确保上传本企业支持的园区编码（园区信息查询接口），不同的园区账号是不一样的，充值时要注意充值账号要与项目的分包园区相对应，否则将无法向完成任务的自由职业者进行支付；

2.项目类型：同园区编码，只允许上送本企业支持的项目类型，不同的项目类型所包含的任务类型是不一样的，请根据分包业务实际场景在支持的范围内，上传正确的项目类型；

3.项目名称：同一个企业的项目名称不可以重复。请注意不要创建灵活用工业务法律法规不允许的项目，项目名称需要具有实际的业务意义，不允许随意命名；

4.任务名称：同一个企业的任务名称不可以重复。请注意需要上送具有实际业务意义的任务名称；

5.任务类型：同项目类型，只允许上送本企业支持的任务类型。平台实际分包业务完成，企业向自由职业者进行结算后，平台根据任务类型及其相对应的结算金额开具相应额度的发票；

6.招募模式：API接口当前版本仅支持定向招募，需要自由招募请登录品为灵工管理系统进行任务发布；

7.交付模式：API接口当前版本仅支持统一上传交付物。

一个项目可支持多个任务。每个任务可根据项目和任务的交付特点向已经完成任务的自由职业者进行结算。项目和任务不支持更改。若有新的业务场景，需要重新创建项目和任务。

项目和任务分为两个事务进行处理，外部code为项目返回状态，taskInfo列表内部code为任务创建返回状态，可能会出现项目创建成功任务创建失败的情况。对接方重新创建任务需要调发布任务API去再次执行。

• 接口API

/interface/item/create

• 请求参数

taskInfo 任务信息

• 请求示例

{
                "sign": "2312",
                "signType": "MD5",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "44fdsf45dsf4s51cdfsd4s5c1",
                "appid": "56523245121",
                "data": {
                    "parkId": "2",
                    "businessId": "950709751405330432",
                    "itemTitle": "自动化项目{% mock 'increment' %}",
                    "commissionType": "01",
                    "commissionLow": "1",
                    "itemTypeId": "1",
                    "commissionHigh": "100",
                    "itemPeriod": "01",
                    "firstPeriodStart": "2022-03-01",
                    "firstPeriodEnd": "2022-03-30",
                    "secondPeriodStart": "",
                    "secondPeriodEnd": "",
                    "threePeriodStart": "",
                    "threePeriodEnd": "",
                    "checkRequire": "01",
                    "checkPeriod": "1",
                    "checkDateStart": "",
                    "checkDateEnd": "",
                    "commissionDesc": "按任务天数*折算每天工时*任务工作量*工时单价，工时单价2000-2200元；按比例计费5%-30%或固定价格结算；生产、打包等外包服务20-30元/小时；培训1000-5000一次，等",
                    "taskInfo": [{
                        "taskTitle": "自动化任务{% mock 'increment' %}",
                        "taskTypeId": "172",
                        "commissionType": "01",
                        "commissionLow": "1",
                        "commissionHigh": "100",
                        "taskPeriod": "01",
                        "firstPeriodStart": "2022-03-01",
                        "firstPeriodEnd": "2022-03-01",
                        "secondPeriodStart": "",
                        "secondPeriodEnd": "",
                        "threePeriodStart": "",
                        "threePeriodEnd": "",
                        "checkRequire": "01",
                        "checkPeriod": "1",
                        "checkDateStart": "",
                        "checkDateEnd": "",
                        "recruitType": "2",
                        "deliveryType": "2",
                        "callBackUrl": "https://www.baidu.com/",
                        "commissionDesc": "按任务天数*折算每天工时*任务工作量*工时单价，工时单价2000-2200元；按比例计费5%-30%或固定价格结算；生产、打包等外包服务20-30元/小时；培训1000-5000一次，等"
                    }]
                }
            }Copy to clipboardErrorCopied

• 响应参数

taskInfo 任务信息

• 响应示例

{
                "code": "200",
                "data": {
                    "itemId": "1030793913628413952",
                    "itemTitle": "复处素图可民的项目",
                    "taskInfo": [
                        {
                            "status": "02",
                            "taskId": "1030793914190450688",
                            "taskTitle": "海省候流关产的任务"
                        }
                    ]
                },
                "appid": "964132147940167680",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "bRQWtDQDxtRxItsstiJt",
                "timestamp": "1645770163620",
                "reqMsgId": "f1sfdsdc455ds5d5415fsssd5df4"
            }Copy to clipboardErrorCopied

5.3.2查询企业任务信息

• 说明

查询企业发布项目及其包含任务的详细信息。

• 接口API

/interface/item/myItem

• 请求参数

• 请求示例

{
            "sign":"456126",
            "signType":"MD5",
            "APPID":"1235645",
            "timestamp":"1645770163620",
            "nonceStr":"MPzteIbCc04iSRDWxsTQ",
            "reqMsgId":"394b83504cfFDSSDSedbb6af8e92417a9d6b",
            "data":{
                    "businessId": "923947685818540032",
                    "itemId":"932235285394247680"
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "data": {
                    "rows": [
                        {
                            "checkDateEnd": "",
                            "checkDateStart": "",
                            "checkRequire": "01",
                            "commissionHigh": 20000,
                            "commissionLow": 10000,
                            "commissionType": "01",
                            "firstPeriodEnd": "2022-01-26",
                            "firstPeriodStart": "2022-01-12",
                            "issueTime": "2022-01-16 11:30:12",
                            "itemDesc": "我公司需要开展房地产/建筑项目，项目不分期完成，预计完成时间为2022-01-12至2022-01-26，需要自由职业者提供企业服务,咨询服务,学术/科研服务,工程施工/勘察服务,工程设计服务,新闻/出版服务,计算机软件服务等服务",
                            "itemId": "932235285394247680",
                            "itemPeriod": "01",
                            "itemTitle": "项目发布测试2",
                            "itemTypeId": "11",
                            "itemTypeName": "房地产/建筑",
                            "status": "01",
                            "taskInfo": [
                                {
                                    "checkPeriod": "2",
                                    "checkRequire": "01",
                                    "commissionHigh": 20000,
                                    "commissionLow": 10000,
                                    "commissionType": "01",
                                    "firstPeriodEnd": "2022-01-20",
                                    "firstPeriodStart": "2022-01-06",
                                    "issueTime": "2022-01-16 11:30:49",
                                    "itemPeriod": "02",
                                    "parkId": "2",
                                    "parkName": "uat测试园区",
                                    "secondPeriodEnd": "2022-02-03",
                                    "secondPeriodStart": "2022-01-20",
                                    "status": "02",
                                    "taskDesc": "我公司需要开展企业服务,咨询服务,学术/科研服务,工程施工/勘察服务,工程设计服务,新闻/出版服务,计算机软件服务项目，现面向自由职业者发布工程勘察勘探任务；任务二期完成，一期完成时间为2022-01-06至2022-01-20，二期完成时间为2022-01-20至2022-02-03，需要自由职业者提供咨询服务，学术/科研服务，工程施工/勘察服务，工程设计服务，新闻/出版服务，计算机软件服务，诚邀具备企业服务，咨询，学术/科研，工程施工/勘察，广告/公关/会展，技术服务，计算机服务的自由职业者",
                                    "taskId": "932235441678209024",
                                    "taskTitle": "任务测试2",
                                    "taskType": "172",
                                    "taskTypeName": "工程勘察勘探",
                                    "verifyStandard": "按周完成任务计划规定范围内各项工作内容，提交符合行业标准和任务目标的工作成果，包括测试及验收报告等"
                                },
                                {
                                    "checkPeriod": "1",
                                    "checkRequire": "01",
                                    "commissionHigh": 20000,
                                    "commissionLow": 10000,
                                    "commissionType": "01",
                                    "firstPeriodEnd": "2022-01-28",
                                    "firstPeriodStart": "2022-01-07",
                                    "issueTime": "2022-01-20 20:55:01",
                                    "itemPeriod": "01",
                                    "parkId": "2",
                                    "parkName": "uat测试园区",
                                    "status": "03",
                                    "taskDesc": "我公司需要开展企业服务,咨询服务,学术/科研服务,工程施工/勘察服务,计算机软件服务项目，现面向自由职业者发布工程勘察勘探任务；任务不分期完成，预计完成时间为2022-01-07至2022-01-28，需要自由职业者提供咨询服务，学术/科研服务，工程施工/勘察服务，计算机软件服务，诚邀具备企业服务，咨询，学术/科研，工程施工/勘察，广告/公关/会展，技术服务，计算机服务的自由职业者",
                                    "taskId": "933826975498489856",
                                    "taskTitle": "房地产任务",
                                    "taskType": "172",
                                    "taskTypeName": "工程勘察勘探",
                                    "verifyStandard": "按月完成任务计划规定范围内各项工作内容，提交符合行业标准和任务目标的工作成果，包括测试及验收报告等"
                                }
                            ],
                            "verifyStandard": "按周完成项目计划规定范围内各项工作内容，提交符合行业标准和项目目标的工作成果"
                        }
                    ]
                },
                "appid": "964132147940167680",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "MPzteIbCc04iSRDWxsTQ",
                "timestamp": "1645770163620",
                "reqMsgId": "394b83504cfFDSSDSedbb6af8e92417a9d6b"
            }Copy to clipboardErrorCopied

5.4企业任务信息

5.4.1企业发布任务信息

• 说明

企业首先需要发布项目，然后在项目下发布任务。发布任务需要平台进行审核，审核通过之后方可对任务进行自由职业者招募。其他注意事项请参考创建项目说明中与任务相关的内容。

建议对接方发布任务时，上送回调URL，这样平台在任务审核状态发生变化时，可第一时间通知对接方。

• 前置条件

已发布项目

• 接口API

/interface/task/create

• 请求参数

• 请求示例

{
                "sign": "5645612345",
                "appid": "14561212",
                "signType": "MD5",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiSRDWxsTQ",
                "reqMsgId": "394b83504cfDFDSSDSedbb6af8e9247a9d6b",
                "data": {
                    "businessId": "923947685818540032",
                    "itemId":"932235285394247680",
                    "taskTitle": "导出自由职业者项目22222",
                    "taskTypeId": "172",
                    "commissionType": "01",
                    "commissionLow": "10000",
                    "commissionHigh": "20000",
                    "taskPeriod": "04",
                    "firstPeriodStart": "",
                    "firstPeriodEnd": "",
                    "secondPeriodStart": "",
                    "secondPeriodEnd": "",
                    "threePeriodStart": "",
                    "threePeriodEnd": "",
                    "checkRequire": "01",
                    "checkPeriod": "1",
                    "checkDateStart": "2022-02-03",
                    "checkDateEnd": "2022-03-03",
                    "recruitType": "2",
                    "deliveryType": "2",
                    "callBackUrl": "https://www.baidu.com",
                    "commissionDesc": "按任务天数*折算每天工时*任务工作量*工时单价，工时单价2000-2200元；按比例计费5%-30%或固定价格结算；生产、打包等外包服务20-30元/小时；培训1000-5000一次，等"
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "data": {
                    "status": "02",
                    "taskId": "1030798226442473472",
                    "taskTitle": "原速等军例四的项目"
                },
                "appid": "964132147940167680",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "JbbcWJJcxRbMMxIxIsPC",
                "timestamp": "1645770163620",
                "reqMsgId": "dsdd4544sf45s5sdffs5cf5c44s1"
            }Copy to clipboardErrorCopied

5.4.2企业查询任务信息

• 说明

查询企业发布任务信息,分页返回。

• 接口API

/interface/task/mytask

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgt+Qo+gl9s+6okHOL186+Mr+DW8eNVpuepnUOB0fLF",
                "signType": "RSA",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "394b83504cf947edbb6af8e9247a9d6b",
                "appid": "14561212",
                "data": {
                    "itemId": "932235285394247680",
                    "businessId": "923947685818540032",
                    "taskId": "951522764807618560"
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "total": 1,
                "code": "200",
                "message": "操作成功",
                "data": [
                    {
                        "checkPeriod": "1",
                        "checkRequire": "01",
                        "commissionHigh": 20000,
                        "commissionLow": 10000,
                        "commissionType": "01",
                        "issueTime": "2022-03-10 16:51:45",
                        "itemPeriod": "04",
                        "parkId": "2",
                        "parkName": "uat测试园区",
                        "status": "02",
                        "taskDesc": "我公司需要开展工程施工/勘察服务项目，现面向自由职业者发布工程勘察勘探任务；任务不限制完成需要自由职业者提供工程施工/勘察服务等服务，诚邀具备工程施工/勘察的自由职业者",
                        "taskId": "951522764807618560",
                        "taskTitle": "导出自由职业者项目22222",
                        "taskType": "172",
                        "taskTypeName": "工程勘察勘探",
                        "verifyStandard": "按月完成项目计划规定范围内各项工作内容，提交符合行业标准和项目目标的工作成果，包括测试及验收报告等"
                    }
                ],
                "appid": "964132147940167680",
                "signType": "RSA",
                "nonceStr": "WPJJTJCCiJPtTTWcIJDM",
                "timestamp": "1645770163620",
                "reqMsgId": "5sds415fd4d4d4s1d4csfcc1f55444"
            }Copy to clipboardErrorCopied

5.4.3企业任务审核结果回调通知

• 说明

若创建任务时上送了回调URL，则在任务审核状态发生变化时，平台会自动调用回调URL通知企业。

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgEwI98RHIFO6/XApGgbVpuepnUOB0fLF",
                "signType": "RSA",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "394b83504cf947edbb6af8e9247a9d6b",
                "data": {
                     "businessId":"923947685818540032",
                    "taskId":"951522764807618560",
                     "taskTitle": "导出自由职业者项目22222"
                    "taskTypeId":"172",
                    "status":"03"
                 }
                
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "message": "请求成功"
            }Copy to clipboardErrorCopied

5.5自由职业者定向招募

5.5.1定向招募（批量）

• 说明

1.发布的任务审核通过之后，可基于此任务进行招募，当前版本API接口仅支持定向招募；

2.本接口结果通过异步方式进行调用，通过上送回调地址URL通知对接方招募结果；

3.每个批次最多支持5000条自由职业者信息。 平台根据身份证号进行重复校验，仅第一条成功；

4.定向招募包含的主要后台操有实名认证、签约、与任务关联。自由职业者首先进行实名认证，不通过则回调通知对接方，通过后则进行电子签约并与任务关联；

5.自由职业者与任务关联之后，进行工作任务，对接方在自由职业者完成任务或者达到阶段验收标准时，可对自由职业者进行结算。

• 前置条件

已发布任务

• 接口API

/interface/recruit/recruitBatch

• 请求参数

freelancers 招募信息

• 请求示例

{
                "sign": "111",
                "signType": "RSA",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId":"RENYJ8aN0d5i1OpL014550223",
                "appid":"111",
                "timestamp":"1645770163620",
                "data":{
                    "taskId":"949014714065793024",
                    "businessId":"923947685818540032",
                    "outBatchNo": "RENYJ8aN0d579i1OpL0155032",
                    "notityUrl":"http://47.112.129.249:12121/interfacecallback/callback",
                    "total":2,
                    "freelancers" :[
                        {
                            "outSeqNo":"11908013708393840654",
                            "name":"李珊",
                            "idno":"110101199003076894",
                            "mobile":"13000000002",
                            "idCardFace":"http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1648437243133.HEIC",
                            "idCardEmblem":"http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1648437257807.HEIC"
                        },
                        {
                            "outSeqNo":"11908013708393840343",
                            "name":"李珊2",
                            "idno":"110101199003073677",
                            "mobile":"13000000003",
                            "idCardFace":"http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1648437243133.HEIC",
                            "idCardEmblem":"http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1648437257807.HEIC"
                        }
                    ]
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "data": "1030802593061064704",
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "0QiWsDCTJPe0QIPxcCtJ",
                "timestamp": "1645770163620",
                "reqMsgId": "s54f5fcs54415dsd444c4dfdc"
            }Copy to clipboardErrorCopied

5.5.2定向招募（单个）

• 说明

针对单个自由职业者进行招募，为批量招募的补充接口。本接口实时（同步）返回招募结果信息。

返回签约链接需联系运营配置

图片建议压缩，接口响应速度与图片大小成正比

若您需要使用微信小程序签约，请在上线之前与我们联系处理跨域问题

• 前置条件

已发布任务

• 接口API

/interface/recruit/recruitOne

• 请求参数

• 请求示例

{
                "sign": "111",
                "signType": "RSA",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "RENYJ8aN0d579i1OpL01455028",
                "appid": "111",
                "timestamp": "1645770163620",
                "data": {
                    "businessId": "923947685818540032",
                    "taskId": "925394812432265216",
                    "outBatchNo": "RENYJ8aN0d579i1OpL01455028",
                    "name": "测试09",
                    "idno": "XXX",
                    "mobile": "13000000002"
                }
            }Copy to clipboardErrorCopied

• 响应参数

data

• 响应示例

{
                "code": "200",
                "data": {
                    "idCardPic": "0",
                    "hasSign": "1"
                },
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "签约成功",
                "nonceStr": "eI0zDJWJbx0xIxIIRDJ0",
                "timestamp": "1645770163620",
                "reqMsgId": "d455dcfff5sc1s54d41ddd"
            }Copy to clipboardErrorCopied

5.5.3批量结算

• 说明

自由职业者完成企业发布的任务或者达到任务阶段性验收标准，企业验收后通过此接口对自由职业者发起结算。结算需要注意的事项如下：

1.结算结果平台通过异步回调的方式通知对接方，需要对接方上送回调URL地址；

2.批量结算每个批次最多支持5000条；

3.每条结算金额不可超过企业账号所归属支付通道（银行）的单笔限额（账户查询接口）；

4.结算自由职业者账户必须是自由职业者本人的银行卡或者支付宝账户；

5.结算时平台将服务费和结算费用一起扣除。若企业账户余额不足，则整个批次无法发起支付，结算单自动关闭。

6.单笔不得超过银行打款限额，超过限额需自行拆单，限额请在5.1.2 入驻结果查询

7.结算单备注 只允许 中文、英文字母 (大小写) 和中英文逗号、句号、中划线、下划线、数字，其他都不支持

• 前置条件

1.企业对已发布任务；

2.招募自由职业者；

3.完成签约。

• 接口API

/interface/settle/settleBatch

• 请求参数

freelancers 结算信息

• 请求示例

{
                "sign": "111",
                "signType": "RSA",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "RENYJ8aN0d579i1OpL01455015",
                "appid": "111",
                "timestamp": "1645770163620",
                "data": {
                    "businessId": "923947685818540032",
                    "taskId": "925394812432265216",
                    "acctNo": "30206465066036",
                    "outBatchNo": "RENYJ8aN0d579i1OpL01455015",
                    "notityUrl": "http://47.112.129.249:12121/callback/callback",
                    "totalSettleFee": 20,
                    "total": 2,
                    "freelancers": [{
                            "name": "测试09",
                            "idno": "XXX",
                            "outSeqNo": "11908013708393840654",
                            "acctNo": "XXX",
                            "settleFee": 10,
                            "remark": ""
                        },
                        {
                            "name": "测试10",
                            "idno": "XXX",
                            "outSeqNo": "11908013708393840655",
                            "acctNo": "XXX",
                            "settleFee": 10,
                            "remark": ""
                        }
            
                    ]
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "tWi0cMTRPJbbWJTD0JPb",
                "timestamp": "1645770163620",
                "reqMsgId": "55sd5ff4ssd45f5cf44f4s"
            }Copy to clipboardErrorCopied

5.5.4定向招募&批量结算

• 说明

批量招募与批量结算的合并接口，先进行批量招募然后自动进行批量结算。

单笔不得超过银行打款限额，超过限额需自行拆单了，限额请在5.1.2 入驻结果查询

结算单备注 只允许 中文、英文字母 (大小写) 和中英文逗号、句号、中划线、下划线、数字，其他都不支持

• 接口API

/interface/recruit/recruitSettleBatch

• 请求参数

freelancers 自由职业者信息

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgEwI98RHIFO6/XApGgbVpuepnUOB0fLF",
                "signType": "RSA",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId":"RENYJ8aN0d579i1OpL01455088",
                "appid":"111",
                "timestamp":"1645770163620",
                "data":{
                    "taskId":"925394812432265216",
                    "acctNo":"30206465066036",
                     "businessId":"923947685818540032",
                    "outBatchNo": "RENYJ8aN0d579i1OpL01455088",
                    "notityUrl":"http://47.112.129.249:12121/callback/callback",
                    "totalSettleFee":20,
                    "total":2,
                    "freelancers":[
                        {
                            "name":"测试09",
                            "idno":"XXX",
                            "outSeqNo":"11908013708393840654",
                            "mobile":"XXX",
                            "acctNo":"XXX",
                            "settleFee":10,
                            "idCardFace":"http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1648437243133.HEIC",
                            "idCardEmblem":"http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1648437257807.HEIC",
                            "remark":""
                        },
                        {
                            "name":"测试10",
                            "idno":"XXX",
                            "outSeqNo":"11908013708393840655",
                            "acctNo":"XXX",
                            "mobile":"XXX",
                            "settleFee":10,
                            "idCardFace":"http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1648437243133.HEIC",
                            "idCardEmblem":"http://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/web/file1648437257807.HEIC",
                            "remark":""
                        }
            
                    ]
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "data": "1030810243249262592",
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "PTisJIsTtDezTDRDicRJ",
                "timestamp": "1645770163620",
                "reqMsgId": "dcsd5fff4s455dfscsfdfffd"
            }Copy to clipboardErrorCopied

5.5.5定向招募结果查询

• 说明

可根据任务ID 和批次号进行查询，若批次号为空则返回指定任务招募成功的自由职业者信息，若批次号不为空，则分会指定批次的招募详情。返回结果分页。

若任务编号为空，则返回该企业已关联的所有自由职业者

• 接口API

/interface/recruit/queryBatch

• 请求参数

• 请求示例

{
                "sign": "111",
                "signType": "RSA",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId":"RENYJ8aN0d579i1OpL01455088",
                "appid":"952212545266184192",
                "timestamp":"1645770163620",
                "data":{
                    "businessId":"950709751405330432",
                    "taskId":"954313364803301376",
                    "outBatchNo":"230000198903172903"
                }
            }Copy to clipboardErrorCopied

• 响应参数

data 参数

rows 参数

• 响应示例

{
                "code": "200",
                "data": {
                    "total": 10,
                    "outBatchNo": "dD1sfdcsdds1dFccsdCDAD1FSfCC1fdC",
                    "batchNo": "1255932551579799552",
                    "rows": [
                        {
                            "batchNo": "1255932551579799552",
                            "outSeqNo": "5DFC4d4D5AFFFdd1d1d161F4d506AS04",
                            "authTime": "2022-03-31 11:48:25",
                            "hasAuth": "2",
                            "hasSign": "1",
                            "idno": "XXX",
                            "mobile": "XXX",
                            "name": "XXX",
                            "signChannel": "01",
                            "signContractUrl": "https://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/bblg2021/pdf/%E6%9D%A8%E8%89%B3-110101200503070195-20220331114828.pdf?Expires=1964058509&OSSAccessKeyId=LTAI4Fi1uQq4A26wEMjLJLr9&Signature=MPHTW3wNr0ODOcrVidiLUyYQAhE%3D",
                            "signTime": "2022-03-31 11:48:30",
                            "signType": "3",
                            "status": "1",
                            "idCardEmblem": "",
                            "idCardFace": "",
                            "idCardPic": "0",
                        },
                        {
                            "batchNo": "1255932551579799552",
                            "outSeqNo": "83bdece8eee67b49a9ba80c4aff61aa0",
                            "idno": "XXX",
                            "mobile": "XXX",
                            "msg": "与现有姓名[顾芳]不匹配",
                            "name": "张三",
                            "status": "0"
                        },
                        {
                            "batchNo": "1255932551579799552",
                            "outSeqNo": "cb11202f1bf7a8e57d4accc32ea4ea5d",
                            "authTime": "2022-03-31 11:25:25",
                            "hasAuth": "2",
                            "hasSign": "1",
                            "idno": "XXX",
                            "mobile": "XXX",
                            "name": "XXX",
                            "signChannel": "01",
                            "signContractUrl": "https://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/bblg2021/pdf/%E6%B1%9F%E8%8A%B3-110101200503076095-20220331112534.pdf?Expires=1964057136&OSSAccessKeyId=LTAI4Fi1uQq4A26wEMjLJLr9&Signature=cNzaWLWyMhnCKvBC6E5oh6Zmhr8%3D",
                            "signTime": "2022-03-31 11:25:36",
                            "signType": "3",
                            "status": "1",
                            "idCardEmblem": "",
                            "idCardFace": "",
                            "idCardPic": "0",
                        },
                        {
                            "batchNo": "1255932551579799552",
                            "outSeqNo": "ecc8fe73a4a0f861d959f69f4fc6e4c7",
                            "authTime": "2022-03-31 11:25:25",
                            "hasAuth": "2",
                            "hasSign": "1",
                            "idno": "XXX",
                            "mobile": "XXX",
                            "name": "XXX",
                            "signChannel": "01",
                            "signContractUrl": "https://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/bblg2021/pdf/%E7%A7%A6%E6%B6%9B-110101200503073978-20220331112537.pdf?Expires=1964057137&OSSAccessKeyId=LTAI4Fi1uQq4A26wEMjLJLr9&Signature=Q1BzciH8oqt1ETt0kY2kXuBWlws%3D",
                            "signTime": "2022-03-31 11:25:38",
                            "signType": "3",
                            "status": "1",
                            "idCardEmblem": "",
                            "idCardFace": "",
                            "idCardPic": "0",
                        },
                        {
                            "batchNo": "1255932551579799552",
                            "outSeqNo": "d3bd1421440a0e063df30ddea6a62405",
                            "authTime": "2022-03-31 11:25:25",
                            "hasAuth": "2",
                            "hasSign": "1",
                            "idno": "XXX",
                            "mobile": "XXX",
                            "name": "XXX",
                            "signChannel": "01",
                            "signContractUrl": "https://uat2.oss-cn-shanghai.aliyuncs.com/bblg2021/bblg2021/pdf/%E9%AB%98%E8%89%B3-110101200503076837-20220331112538.pdf?Expires=1964057139&OSSAccessKeyId=LTAI4Fi1uQq4A26wEMjLJLr9&Signature=kwA5bOxUC09FFaASrH9Xe%2BGJen8%3D",
                            "signTime": "2022-03-31 11:25:40",
                            "signType": "3",
                            "status": "1",
                            "idCardEmblem": "",
                            "idCardFace": "",
                            "idCardPic": "0",
                        }
                    ]
                },
                "appid": "952212545266184192",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "timestamp": "1645770163620",
                "reqMsgId": "RENYJ8aN0d579i1OpL01455088"
            }Copy to clipboardErrorCopied

5.5.6批量结算结果查询

• 说明

按批次查询结算结果

• 接口API

/interface/settle/queryBatch

• 请求参数

• 请求示例

{
                "sign": "111",
                "signType": "RSA",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId":"RENYJ8aN0d579i1OpL01455015",
                "appid":"111",
                "timestamp":"1645770163620",
                 
                "data":{
                  "businessId":"923947685818540032",
                    "outBatchNo": "RENYJ8aN0d579i1OpL01455015"
                }
            }Copy to clipboardErrorCopied

• 响应参数

data 业务数据对象

freelancers 结算自由职业者信息

• 响应示例

{
                "code": "200",
                "data": {
                    "acctNo": "30206465066036",
                    "batchNo": "1048282965882945536",
                    "businessId": "923947685818540032",
                    "failNum": 0,
                    "freelancers": [
                        {
                            "acctNo": "6222844938147881",
                            "bankName": "交通银行",
                            "bjServiceFee": 0,
                            "idno": "XXX",
                            "mobile": "XXX",
                            "msg": "模拟交易成功",
                            "name": "XXX",
                            "outBatchNo": "0N95559Y19RD9EE1YE7I",
                            "outSeqNo": "1669971734",
                            "payTime": "2022-12-02 17:02:32",
                            "remark": "接口结算数据1",
                            "seqNo": "1048282971260043264",
                            "serviceFee": 9,
                            "serviceRate": "0.021000",
                            "settleFee": 400,
                            "status": "1"
                        },
                        {
                            "acctNo": "6222844938147899",
                            "bankName": "交通银行",
                            "bjServiceFee": 0,
                            "idno": "XXX",
                            "mobile": "XXX",
                            "msg": "模拟交易成功",
                            "name": "XXX",
                            "outBatchNo": "0N95559Y19RD9EE1YE7I",
                            "outSeqNo": "1669971734",
                            "payTime": "2022-12-02 17:02:31",
                            "remark": "接口结算数据2",
                            "seqNo": "1048282971260043265",
                            "serviceFee": 4,
                            "serviceRate": "0.021000",
                            "settleFee": 200,
                            "status": "1"
                        },
                        {
                            "acctNo": "6222844938147907",
                            "bankName": "交通银行",
                            "bjServiceFee": 0,
                            "idno": "XXX",
                            "mobile": "XXX",
                            "msg": "模拟交易成功",
                            "name": "XXX",
                            "outBatchNo": "0N95559Y19RD9EE1YE7I",
                            "outSeqNo": "1669971734",
                            "payTime": "2022-12-02 17:02:29",
                            "remark": "接口结算数据3",
                            "seqNo": "1048282971260043266",
                            "serviceFee": 2,
                            "serviceRate": "0.021000",
                            "settleFee": 100,
                            "status": "1"
                        },
                        {
                            "acctNo": "XXX",
                            "bankName": "交通银行",
                            "bjServiceFee": 0,
                            "idno": "XXX",
                            "mobile": "XXX",
                            "msg": "模拟交易成功",
                            "name": "XXX",
                            "outBatchNo": "0N95559Y19RD9EE1YE7I",
                            "outSeqNo": "1669971734",
                            "payTime": "2022-12-02 17:02:33",
                            "remark": "接口结算数据4",
                            "seqNo": "1048282971260043267",
                            "serviceFee": 4,
                            "serviceRate": "0.021000",
                            "settleFee": 200,
                            "status": "1"
                        },
                        {
                            "acctNo": "XX",
                            "bankName": "交通银行",
                            "bjServiceFee": 0,
                            "idno": "XX",
                            "mobile": "XX",
                            "msg": "XX",
                            "name": "年龄110107",
                            "outBatchNo": "0N95559Y19RD9EE1YE7I",
                            "outSeqNo": "1669971734",
                            "payTime": "2022-12-02 17:02:34",
                            "remark": "接口结算数据5",
                            "seqNo": "1048282971260043268",
                            "serviceFee": 6,
                            "serviceRate": "0.021000",
                            "settleFee": 300,
                            "status": "1"
                        }
                    ],
                    "outBatchNo": "0N95559Y19RD9EE1YE7I",
                    "serviceFee": 25,
                    "successNum": 5,
                    "successSettleFee": 1200,
                    "taskId": "1036959508602089472"
                },
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "izTQWJDDcDRCDzJRxtet",
                "timestamp": "1645770163620",
                "reqMsgId": "s5dd4dfs5s5ss44dss4s54"
            }Copy to clipboardErrorCopied

5.5.7招募结算回调

• 说明

当招募、结算失败或者成功时，平台会自动根据对接方上送的回调URL地址发送回调请求，通知对接方招募或结算的动态信息、若失败则停止后续操作；

由于银行单笔限额，我方会根据实际情况进行账单拆分，因此会有【部分成功】状态返回。

• 接口API

批量招募、批量结算、批量招募&结算 上送数据中的回调URL。

• 请求参数

• 请求示例

{
                "outBatchNo": "QrIe8t8aN0d579i1OpL0145510",
                "batchNo": "1048282971260043269",
                "outSeqNo":"AERFE454A5FA55645465AW",
                "seqNo":"1048282971260043268",
                "name": "XX",
                "idno": "XX",
                "status": "02",
                "acctNo": "XX",
                "serviceFee": 1,
                "settleFee": 10,
                "serviceRate": 6,
                "bjServiceFee": 0,
                "successFee": 10,
                "failFee": 0,
                "failCount": 0,
                "successCount": 1,
                "successServiceFee": 1,
                "failServiceFee": 0,
                "msg": "模拟交易成功"
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "message": "成功"
            }Copy to clipboardErrorCopied

5.5.8 签约回调

• 说明

当自由职业者使用短信完成签约时，通过该回调通知对接方

• 接口API

任何在该企业下自由职业者完成签约均会出发该回调

• 请求参数

• 请求示例

{
                "data": {
                    "viewContractUrl": "https://testapi.fadada.com:8443/api//viewdocs.action?app_id=405769&timestamp=20220425094748&v=2.0&msg_digest=OEU4QThDQ0VDNkEzNzM0MEM0QTJGQzBDNTEyOTBDMjRGMEYxMUMyRQ==&transaction_id=968085413812236288&send_app_id=null",
                    "name": "XX",
                    "businessId": "956855132958670848",
                    "idNo": "XX",
                    "hasSign": "1"
                },
                "appid": "964132147940167680",
                "nonceStr": "8lx1e25aum3rD1jwWW3v",
                "reqMsgId": "968086072028557312",
                "timestamp": "1650851305870"
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "message": "成功"
            }Copy to clipboardErrorCopied

5.5.9 自由职业者签约查询

• 说明

在签约前使用该接口确认签约状态

• 接口API

  /interface/recruit/signFind

• 请求参数

• 请求示例

{
                "sign": "111",
                "signType": "RSA",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId":"RENYJ8aN0d579i1OpL01455015",
                "appid":"111",
                "timestamp":"1645770163620",
              
                "data":{
                  "businessId":"923947685818540032",
                  "idNo": "XX"
                }
            }Copy to clipboardErrorCopied

• 响应参数

​ data参数

• 响应示例

{
                "code": "200",
                "data": {
                    "signDownloadUrl": "https://testapi.fadada.com:8443/api//getdocs.action?app_id=406886&timestamp=20221015112146&v=2.0&msg_digest=ODlEQkY1NUQ1NDIwOThDNDRGRDY2NzRDNkYyMzdGMTI0RjMzQjNGMw==&transaction_id=1030802662602625024&send_app_id=null",
                    "businessId": "1028346564185677824",
                    "sign": "1",
                    "signUrl": "https://testapi.fadada.com:8443/api//viewdocs.action?app_id=406886&timestamp=20221015112146&v=2.0&msg_digest=ODlEQkY1NUQ1NDIwOThDNDRGRDY2NzRDNkYyMzdGMTI0RjMzQjNGMw==&transaction_id=1030802662602625024&send_app_id=null",
                    "idCardPic": "0",
                    "idNo": "XX"
                },
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "0DeRbstcIWbJCDPsi0zI",
                "timestamp": "1645770163620",
                "reqMsgId": "4ss5sffdf45s4451d155c44sf55"
            }Copy to clipboardErrorCopied

5.5.10 自由职业者解绑

• 说明

自由职业者解除合作 短信模板 【{短信抬头}】我们是{园区公司名称}，鉴于您在{企业名称}内提交了解除申请，我们已为您解除了相关合作，请您知悉，特此通知！

• 接口API

  /interface/recruit/stopOne

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgt+Qo+gl9s+6okHOL186+Mr+DW8eNVpuepnUOB0fLF",
                "signType": "RSA",
                "appid":"953353798355742720",
                "timestamp": "1645770163620",
                "nonceStr":"12312asda1231asd",
                "reqMsgId":"123123asgfasdgsdajhiohj12",
                "data": {
                    "businessId": "923947685818540032",
                    "idno": "XX",
                    "isSendMessage": "1"
                }   
            }Copy to clipboardErrorCopied

• 响应参数

无业务参数

• 响应示例

{
                "code": "200",
                "appid": "953353798355742720",
                "signType": "RSA",
                "message": "解绑成功",
                "nonceStr": "JCJJcRCebJTtxDCMJJPW",
                "timestamp": "1645770163620",
                "reqMsgId": "ss51dfssf1ssd4sd44fcfssfdf55"
            }
            Copy to clipboardErrorCopied

5.5.11 自由职业者退票通知

• 说明

当自由职业者发生退款或者银行退汇等退票情况时进行通知

• 接口API

• 如有需要,请登录API账户进行配置

• 请求参数

• 请求示例

{
              "data": {
                "msg": "发放退款冲抵",
                "serviceFee": -0.05,
                "settleFee": -1.00,
                "refundTime": "2023-05-06 12:00:00",
                "businessId": "1104376926064017408",
                "mobile": "XX",
                "idno": "XX",
                "acctNo": "XX",
                "outBatchNo": "1105073507019587584",
                "name": "XX",
                "bankNo": "6217001180026096936",
                "serviceRate": 0.050000,
                "outSeqNo": "1105073507472572421"
              },
              "appid": "1104332740187316224",
              "nonceStr": "6jQUS9e8TQK9PvBhXFdu",
              "reqMsgId": "1105076750912319488",
              "timestamp": "1683512428771"
            }Copy to clipboardErrorCopied

• 响应参数

无业务参数

• 响应示例

{
              "code": "200",
              "message": "成功"
            }Copy to clipboardErrorCopied

5.5.12 自由职业者银行卡信息查询接口

• 说明

根据自由职业者身份证号码和所传企业编码查询自由职业者银行卡信息,当自由职业者和企业没有关联时查询失败

• 接口API

• 如有需要,请登录API账户进行配置

• 请求参数

• 响应参数

data 业务数据

rows 数据数组

• 请求示例

{
              "sign": "fh5bg2w6fvsUsgt+Qo+gl9s+6okHOL186+Mr+DW8eNVpuepnUOB0fLF",
              "signType": "RSA",
              "appid":"953353798355742720",
              "timestamp": "1645770163620",
              "nonceStr":"12312asda1231asd",
              "reqMsgId":"123123asgfasdgsdajhiohj12",
              "data": {
                "businessId": "923947685818540032",
                "idno": "xxxx"
              }
            }Copy to clipboardErrorCopied

• 响应示例

{
                "code": "200",
                "data": {
                    "total": 2,
                    "rows": [
                        {
                           "bankNo": "123456",
                           "bankName": "中国银行"
                        },
                        {
                          "bankNo": "1234567",
                          "bankName": ""
                       }
                    ]
                },
                "appid": "952156277277065216",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "Izs00tWtWcWsTzxbWCRs",
                "timestamp": "1645770163620",
                "reqMsgId": "15d4sscs5sdffsf4s1c5ds54ddcf"
            }Copy to clipboardErrorCopied

• 响应示例

• 无rows数据数组

{
              "code": "200",
              "data": {
                "rows": [],
                "total": 0
              },
              "appid": "1021840009235656704",
              "signType": "RSA",
              "message": "操作成功",
              "nonceStr": "MPzteIbC1c0Ji2JRD2WxsTQ211",
              "timestamp": "1692603326594",
              "reqMsgId": "cSDD5DD22x5SF525DF"
            }Copy to clipboardErrorCopied

5.6查询企业账户信息

5.6.1查询企业账户信息

• 说明

查询企业账户基本信息及实时余额信息

• 接口API

/interface/acct/queryAll

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgEwI98RHIFO6/XApGgbVpuepnUOB0fLF",
                "signType": "RSA",
                "appid": "156412124",
                "timestamp": "1645770163620",
                "nonceStr":"ID0tIWCsDJRWRzRJteJe",
                "reqMsgId":"s5cd5c14dd5544d4dd5ssff54s1",
                "data": {
                    "businessId": "950687944577482752",
                }
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "data": [
                    {
                        "acctNo": "30206465852697",
                        "zfCode": "pa_pay",
                        "unBalanceFee": 0,
                        "balanceFee": 9965524,
                        "frozenFee": 0,
                        "bankName": "前端数据支持测试江西讫酉有限公司",
                        "acctName": "漳州市翠峦区开发公司",
                        "rechargeFEE": 10000000,
                        "status": "1"
                    }
                ],
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "eRMsTz00RJ0IM0JQWbJM",
                "timestamp": "1645770163620",
                "reqMsgId": "dfs4415s4s444dfd15sc51sss"
            }Copy to clipboardErrorCopied

5.6.2查询企业账户流水

• 说明

查询企业账户流水，结算流水返回批次统计数据，同个批次返回一条结算金额统计和服务费统计信息。结算发放明细通过下个接口调用查询，分页返回。

• 接口API

/interface/acct/tranHist

• 请求参数

• 请求示例

{
                "sign": "dsfdsfdsgsdfds",
                "signType": "MD5",
                "appid": "156412121",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiS9DWxsTQ",
                "reqMsgId": "394b83504cfDFuSSDSedbb6af8e9247a9d64",
                "data": {
                    "businessId": "923947685818540032",
                    "startTime": "2021-06-07 15:02:01",
                    "endTime": "2022-09-03 15:02:01",
                    "pageNum": "1"
                }
            }Copy to clipboardErrorCopied

• 响应参数

data 业务数据

rows 数据数组

• 响应示例

{
                "code": "200",
                "data": {
                    "total": 30,
                    "rows": [
                        {
                            "acctNo": "30206465852697",
                            "balance": 9965524,
                            "dealFee": 10000,
                            "dealId": "103081024644951654404",
                            "dealTime": "2022-10-15 11:51:55",
                            "dealType": "04",
                            "isDeal": "0",
                            "parkId": 2,
                            "uNBalance": 0,
                            "zfCode": "pa_pay"
                        },
                    ]
                },
                "appid": "952156277277065216",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "Izs00tWtWcWsTzxbWCRs",
                "timestamp": "1645770163620",
                "reqMsgId": "15d4sscs5sdffsf4s1c5ds54ddcf"
            }Copy to clipboardErrorCopied

5.6.3查询结算明细

• 说明

查询企业账户发放明细流水

• 接口API

/interface/acct/settleHist

• 请求参数

• 请求示例

{
            "sign":"dsfdsfdsgsdfds",
            "signType":"MD5",
            "appid":"156412121",
            "timestamp":"1645770163620",
            "nonceStr":"MPzteIbCc0JiSRDWxsTQ",
            "reqMsgId":"394b83504cfDFDSSDSedbb6af8e9247a9d64",
            "data":{    
                "businessId":"897186468647141376",
                "startTime":"2021-06-07 00:00:00",
                "endTime":"2023-09-03 23:23:23",
                "pageNum":"1"
                }
            }Copy to clipboardErrorCopied

• 响应参数

data 业务数据

rows 数据数组

• 响应示例

{
                "code": "200",
                "data": {
                    "total": 24,
                    "rows": [
                        {
                            "acctNo": "XX",
                            "bjServiceFee": 0,
                            "idno": "XX",
                            "limitLevel": "2",
                            "mobile": "XX",
                            "msg": "模拟交易成功",
                            "name": "XX",
                            "outSeqNo": "O202203121548000001",
                            "payTime":"202-10-15 11:51:57",
                            "remark": "测试123456",
                            "seqNo": "952231873877274624",
                            "serviceFee": 1180,
                            "serviceRate": "0.0590",
                            "settleFee": 20000,
                            "status": "02"
                        },
                    ]
                },
                "appid": "952156277277065216",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "J0TWMxDbibC0CDQIRQcz",
                "timestamp": "1645770163620",
                "reqMsgId": "4f541dsdsddfsfs45ffddf5f"
            }Copy to clipboardErrorCopied

5.6.4企业来账通知

• 说明

企业账户充值后回调通知

• 请求参数

• 请求示例

{
              "parkName": "uat测试园区",
              "dealId": "Z952289579908648960",
              "businessId": "952168772687507456",
              "dealFee": 1000000.0,
              "dealType": "01",
              "counterpartyAcctNo": "6212261901014812729",
              "parkId": 2,
              "acctNo": "30206465066117",
              "dealTime": 1647014400000,
              "zfCode": "pa_pay",
              "UNBalance": 0.0,
              "isDeal": 0,
              "counterpartyAcctName": "上海麦克风文化传媒有限公司",
              "counterpartyBankName": "中国工商银行"
            }Copy to clipboardErrorCopied

• 响应参数

• 响应示例

{
                "code": "200",
                "message": "请求成功"
            }Copy to clipboardErrorCopied

5.6.5 企业子账号余额不足推送

• 说明

企业子账号余额不足推送，需要在API接入-企业管理中，配置对应余额不足推送地址，推送提示金额。 该推送每五分钟进行一次，推送方式为POST方式。

• 推送示例参数

• 推送参数

  {
                "data": {
                    "subAccountList": ["123456"],
                    "pushData": [{
                        "msg": "账号 123456 余额不足 1000",
                        "subAcctNo": "123456"
                    }]
                },
                "appid": "123",
                "nonceStr": "9MdNJJY9fYf9JcBAsjiO",
                "reqMsgId": "1149281330811584512",
                "timestamp": "1694051622057"
              }Copy to clipboardErrorCopied

5.7交付

5.8开票

5.8.1可开票信息查询

• 说明

可开票信息查询

• 接口API

/interface/invoice/availableBalance

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgEwI98RHIFO6/XApGgbVpuepnUOB0fLF",
                "signType": "RSA",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "394b83504cf947edbb6af8e9247a9d6b",
                "appid": "2022022800001",
                "data": {
                    "businessId": "111111111"
                }
            }Copy to clipboardErrorCopied

• 响应参数

invoice 开票信息

• 响应示例

{
                "code": "200",
                "data": [
                    {
                        "parkName": "uat测试园区",
                        "invoice": [
                            {
                                "ableInvoiceFee": 34472,
                                "applyInvoiceFee": 4,
                                "hasInvoiceFee": 0,
                                "oneObjectName": "一般税务咨询",
                                "twoObjectName": "一般税务咨询"
                            }
                        ],
                        "parkId": 2
                    }
                ],
                "appid": "964132147940167680",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "czWxPccTP0iWcsbQWPtx",
                "timestamp": "1645770163620",
                "reqMsgId": "c5554ssf4ddc4f4fs44f4s4ds"
            }Copy to clipboardErrorCopied

5.8.2开票申请

• 说明

开票申请

• 接口API

/interface/invoice/apply

• 请求参数

• 请求示例

{
                "sign": "nisi",
                "signType": "labore qui Excepteur",
                "timestamp": "2016-01-02 19:10:24",
                "nonceStr": "13077019832592220035",
                "reqMsgId": "19621104533972982320788225792085",
                "appid": "1004",
                "data": {
                    "businessId": "950687944577482752",
                    "outOrderNo": "525713419905370516",
                    "parkId": 15,
                    "oneObjectName": "安全保护服务",
                    "twoObjectName": "安全保护服务",
                    "invoiceTotalFee": "1000",
                    "invoiceType": "3",
                    "invoiceAddress": "黑龙江省长治市钦北区",
                    "invoicePhone": "18120063804",
                    "invoiceAcctNo": "13024512563",
                    "invoiceBankName": "中国农业银行",
                    "postalAddress": "黑龙江省长治市钦北区",
                    "postalMobile": "18167126416",
                    "postalUserName": "常平",
                    "postalEmail": "n.pym@qq.com",
                    "remark": "proident laborum eiusmod ullamco cupidatat",
                    "postRemark": "sunt elit mollit in",
                    "callBackUrl": "http://baidu.com"
                }
            }Copy to clipboardErrorCopied

• 响应参数

  无业务数据

• 响应示例

{
                "code": "200",
                "appid": "964132147940167680",
                "signType": "labore qui Excepteur",
                "message": "操作成功",
                "nonceStr": "IzbIPtRzsI0eTWJtxCCx",
                "timestamp": "1451733024000",
                "reqMsgId": "c4f5sff5ss4f445cfs4sfsd4dfs"
            }Copy to clipboardErrorCopied

5.8.3发票信息查询

• 说明

已申请的发票信息查询

• 接口API

/interface/invoice/myInvoice

• 请求参数

• 请求示例

{
                "appid": "2022030713000002",
                "data": {
                    "businessId": "950687944577482752",
                    "outOrderNo":"951069391180107776"
                },
                "nonceStr": "NaFc54bnlQhUWCa34Rmx",
                "reqMsgId": "286ebd3ebb3f4036ae1b3e391b17bb68",
                "sign": "E51701238995FD0ECFEA0CB2637F4C33",
                "signType": "MD5",
                "timestamp": 1646798376200
            }Copy to clipboardErrorCopied

• 响应参数

invoices 发票信息

• 响应示例

{
                "code": "200",
                "data": {
                    "applyTime": "2022-10-15 13:28:25",
                    "businessId": "1028346564185677824",
                    "invoiceAcctNo": "13024512563",
                    "invoiceAddress": "陕西省西安市雁塔区",
                    "invoiceBankName": "中国农业银行",
                    "invoicePhone": "18120063804",
                    "invoiceTotalFee": 1,
                    "invoiceType": "3",
                    "invoices": [
                        {
                            "invoiceTotalFee": 0.01,
                            "invoiceNum":"123124",
                            "invoiceUrl":"https://file_url",
                            "invoicePdfUrl":"https://file_url"
                        }
                    ],
                    "oneObjectName": "一般税务咨询",
                    "outOrderNo": "brv5PKlIdm_sAoW",
                    "parkId": 2,
                    "postRemark": "接口开票邮寄时候的信息",
                    "postalAddress": "陕西省西安市雁塔区",
                    "postalEmail": "n.pym@qq.com",
                    "postalMobile": "18167126416",
                    "postalUserName": "常平",
                    "remark": "接口开发票测试信息调用",
                    "status": "01",
                    "twoObjectName": "一般税务咨询"
                },
                "appid": "964132147940167680",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "QD0xCCPQWRCDJtRWJ0eJ",
                "timestamp": "1646798376200",
                "reqMsgId": "45s5sc5454s5fcssd541fscc1fsfs"
            }Copy to clipboardErrorCopied

5.8.4开票结果回调

• 说明

根据申请填写URL进行回调

• 请求参数

invoices 发票信息

• 请求示例

• 响应参数

• 响应示例

{
                "code": "200",
                "message": "请求成功"
            }Copy to clipboardErrorCopied

5.9自由职业者白名单

5.9.1申请自由职业者白名单

• 说明

申请自由职业者白名单

年龄限制和董监高 需在拦截之后申请，申请后处理状态和结果需使用 5.9.3 风控待办列表 查询

• 接口API

/interface/whitelist/apply

• 请求参数

freelancerInfo 自由职业者信息

listType 白名单类型

• 请求示例

{
                "appid": "2022030713000002",
                "data": {
                    "businessId": "950687944577482752",
                    "freelancerInfo": [
                        {
                            "acctNo": "XXX",
                            "idno": "XX",
                            "listType": "1",
                            "mobile": "XX",
                            "freeName": "XX",
                            "remark": "实名认证"
                        }
                    ]
                },
                "nonceStr": "NaFc54bnlQhUWCa34Rmx",
                "reqMsgId": "286ebd3ebb3f4036ae1b3e391b17bb68",
                "sign": "E51701238995FD0ECFEA0CB2637F4C33",
                "signType": "MD5",
                "timestamp": 1646798376200
            }Copy to clipboardErrorCopied

• 响应参数

data 业务数据

freelancerInfo 自由职业者信息

status 状态

• 响应示例

{
                "code": "200",
                "data": {
                    "businessId": "950687944577482752",
                    "freelancerInfo": [
                        {
                            "acctNo": "XX",
                            "idno": "XX",
                            "listType": "1",
                            "massage": "审核中",
                            "mobile": "XX",
                            "remark": "实名认证",
                            "status": "00"
                        }
                    ]
                },
                "appid": "964132147940167680",
                "signType": "MD5",
                "message": "操作成功",
                "nonceStr": "IJxJCJDeItTbCicCIPxT",
                "timestamp": "1646798376200",
                "reqMsgId": "1s45s4c45sdds4fffs5f5ss5ffss"
            }Copy to clipboardErrorCopied

5.9.2自由职业者添加白名单结果查询

• 说明

自由职业者添加白名单后查询审核结果

• 接口API

/interface/whitelist/query

• 请求参数

freelancerInfo 自由职业者信息

• 请求示例

{
                "appid": "2022030713000002",
                "data": {
                    "businessId": "950687944577482752",
                    "listType":"2",
                    "freelancerInfo": [
                        {
                            "idno": "XX",
                            "freeName": "XX"
                        }
                    ]
                },
                "nonceStr": "NaFc54bnlQhUWCa34Rmx",
                "reqMsgId": "286ebd3ebb3f4036ae1b3e391b17bb68",
                "sign": "E51701238995FD0ECFEA0CB2637F4C33",
                "signType": "MD5",
                "timestamp": 1646798376200
            }Copy to clipboardErrorCopied

• 响应参数

freelancerInfo 自由者业者信息

status 状态

• 响应示例

{
                "code": "200",
                "data": {
                    "businessId": "950687944577482752",
                    "freelancerInfo": [
                        {
                            "acctNo": "XX",
                            "idno": "XXX",
                            "listType": "2",
                            "mobile": "XX",
                            "name": "XX",
                            "remark": "实名认证",
                            "status": "00"
                        }
                    ]
                },
                "message": "操作成功",
                "nonceStr": "X01zPF1ruWlDmgRXFeyU",
                "timestamp": 1646817372883
            }Copy to clipboardErrorCopied

5.9.3 风控待办列表查询

• 说明

查询被风控拦截的待办信息

• 接口API

/interface/whitelist/queryRiskList

• 请求参数

freelancerInfo 自由职业者信息

• 请求示例

{
                "sign": "111",
                "signType": "RSA",
               "nonceStr":"sJtcbIbsWPbxbxtiWTeb",
                "reqMsgId":"fd45cfff1scfdf1d54fd5dd",
                "appid":"958315895086878720",
                "timestamp":"1645770163620",
                "data":{
                  "businessId":"923947685818540032",
                    "riskType": "4", 
                    "idno":"430623299418055565", 
                    "status":"01" 
                }
            }Copy to clipboardErrorCopied

• 响应参数

rows

dealResult状态

• 响应示例

{
                "code": "200",
                "data": {
                    "total": 1,
                    "rows": [
                        {
                            "dealResult": "1",
                            "idno": "152522199710162313",
                            "name": "年龄110107",
                            "riskTime": "2022-11-01 11:07:34",
                            "riskType": "4",
                            "status": "02"
                        }
                    ]
                },
                "appid": "958315895086878720",
                "signType": "RSA",
                "message": "操作成功",
                "nonceStr": "bDsTQJDbxJQIcMiWTCWD",
                "timestamp": "1645770163620",
                "reqMsgId": "cfcd5s5dfd1fc44fd55sdfs"
            }Copy to clipboardErrorCopied

5.10完税证明

5.10.1完税证明下载

• 说明

已完税信息查询

• 接口API

/interface/taxpay/proveInfo

• 请求参数

• 请求示例

{
                "sign": "fh5bg2w6fvsUsgEwI98RHIFO6/XApGgbVpuepnUOB0fLF",
                "signType": "RSA",
                "timestamp": "1645770163620",
                "nonceStr": "MPzteIbCc0JiJRDWxsTQ",
                "reqMsgId": "394b83504cf947edbb6af8e9247a9d6b",
                "appid": "2022022800001",
                "data": {
                    "businessId": "923947685818540032",
                    "date": "2022-02"
                }
            }Copy to clipboardErrorCopied

• 响应参数