接口列表
- 说明:需要在header中传递Access-Key-Id和Open-Id, Access-Key-Id是发放的accessKeyId, Open-Id是主动获取的openid
公共header说明
| header key | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
| Content-Type | 是 | 固定值:application/json | |
| X-Amz-Date | 是 | 请求时间,格式:yyyyMMdd'T'HHmmss'Z'; TimeZone 为UTC; 使用sdk无需关注该参数 | |
| Authorization | 是 | 接口签名结果,签名方式请查看【接口签名】 | |
| Access-Key-Id | 是 | 主动申请【获取密钥】 | |
| Open-Id | 是 | 主动获取【获取openid】 | |
| Ignore-Warn | 否 | false | 用于忽略警告。新增或提交时等操作时会有警告导致接口失败,比如客户查重不通过、凭证余额出现赤字,Ignore-Warn=true时,会忽略相关警告,继续执行接口 |
| Save-As-Draft | 否 | false | 如果为true,新增单据时保存为草稿态,否则自动提交 |
对象标准接口
- 请求body结构说明,字段列表见数据字典
add接口 (beta)
-
写入单个对象数据接口
-
接口host:https://api2.77hub.com
-
接口路径:/v1/add
-
请求方式:POST
-
header参数
- 见公共header
-
参数说明:字段externalSystemCode/externalObjectType/externalObjectId 必填,externalObjectType+externalObjectId不能重复
-
参数示例(字段注释请以数据字典显示为准)
body:
{"json":"{\"objectType\":\"RevenueConfirmation\",\"data\":{\"billType.name\":\"收入确认单\",\"businessType.name\":\"收入确认单立账\",\"businessDate\":\"2020-01-01\",\"customer.name\":\"李雷\",\"invoiceType.name\":\"增值税专用发票\",\"currency.name\":\"人民币\",\"exchangeRate\":1,\"settleCustomer.name\":\"李雷\",\"revenueConfirmationItems\":[{\"project.name\":\"应收项目1\",\"product.name\":\"B商品\",\"quantity\":5,\"price\":1000,\"priceWithoutTax\":917.43,\"taxRate\":0.09,\"originAmount\":5000,\"amount\":5000,\"originAmountWithoutTax\":4587.16,\"amountWithoutTax\":4587.16,\"originTaxAmount\":412.84,\"taxAmount\":412.84,\"originPriceWithoutTax\":917.43,\"unit.name\":\"箱\"},{\"project.name\":\"应收项目1\",\"product.name\":\"B商品\",\"quantity\":5,\"price\":1000,\"priceWithoutTax\":917.43,\"taxRate\":0.09,\"originAmount\":5000,\"amount\":5000,\"originAmountWithoutTax\":4587.16,\"amountWithoutTax\":4587.16,\"originTaxAmount\":412.84,\"taxAmount\":412.84,\"originPriceWithoutTax\":917.43,\"unit.name\":\"箱\"}],\"externalObjectId\":1582709110221112331,\"externalObjectType\":\"RevenueConfirmation\",\"externalSystemCode\":\"110212001\"}}"}
// json的value值:
{
"objectType": "RevenueConfirmation", // 目标对象名称:收入确认单
"data": { // 数据项
"billType.name": "收入确认单", // 单据类型
"businessType.name": "收入确认单立账", // 业务类型
"businessDate": "2020-01-01", // 业务日期
"customer.name": "李雷", // 客户名称
"invoiceType.name": "增值税专用发票", // 发票类型
"currency.name": "人民币", // 币种
"exchangeRate": 1, // 汇率
"settleCustomer.name": "李雷", // 结算单位
"revenueConfirmationItems": [ // 收入确认单明细
{
"project.name": "应收项目1", // 项目名称
"product.name": "B商品", // 存货名称
"quantity": 5, // 数量
"price": 1000.000, // 单价
"priceWithoutTax": 917.430, // 本币无税单价
"taxRate": 0.09, // 税率
"originAmount": 5000.000, // 金额
"amount": 5000.000, // 金额
"originAmountWithoutTax": 4587.16, // 原币无税金额
"amountWithoutTax": 4587.16, // 本币无税金额
"originTaxAmount": 412.84, // 原币税额
"taxAmount": 412.84, // 本币税额
"originPriceWithoutTax": 917.430, // 原币无税单价
"unit.name": "箱" // 计量单位名称
},
{
"project.name": "应收项目1", // 项目名称
"product.name": "B商品", // 存货名称
"quantity": 5, // 数量
"price": 1000.000, // 单价
"priceWithoutTax": 917.430, // 本币无税单价
"taxRate": 0.09, // 税率
"originAmount": 5000.000, // 金额
"amount": 5000.000, // 金额
"originAmountWithoutTax": 4587.16, // 原币无税金额
"amountWithoutTax": 4587.16, // 本币无税金额
"originTaxAmount": 412.84, // 原币税额
"taxAmount": 412.84, // 本币税额
"originPriceWithoutTax": 917.430, // 原币无税单价
"unit.name": "箱" // 计量单位名称
}
],
"externalObjectId": 1582709110221112331, // 外部系统对象唯一标识
"externalObjectType": "RevenueConfirmation", // 外部系统对象类型
"externalSystemCode": "110212001" // 外部系统标识
}
}
- 接口响应
{
"json": "{\"id\":\"RMUEH160PG9000M\"}"
}
list接口
-
查询数据接口
-
接口host:https://api2.77hub.com
-
接口路径:/v1/list
-
请求方式:POST
-
header参数
- 见公共header
-
参数示例
body:
{"json":"{\"objectType\":\"Customer\",\"criteriaStr\":\"id is not null\",\"fields\":[\"id\",\"name\",{\"fieldName\":\"category\",\"fields\":[\"id\",\"name\"]},{\"fieldName\":\"contacts\",\"fields\":[\"id\",\"name\"]},\"code\"]}"}
// json的value值:
{
"objectType": "Customer", // 目标对象
"criteriaStr": "id is not null", // 查询参数 查询字段支持lastModifiedTime(TimeStamp)
"fields": [ // 查询字段列表
"id", // 主对象字段
"name", // 主对象字段
{
"fieldName": "category", // 外键字段 ps:如果字段有参照对照,如果字段名以id结尾,去掉id为fieldName,如果字段名不是以id结尾,字段名+Object为fieldName。此fieldName对应的字段为categoryId
"fields": [ // 外键字段对应对象字段列表
"id", // 外键字段对应对象字段
"name" // 外键字段对应对象字段
]
},
{
"fieldName": "contacts", // 外键字段对应对象子表
"fields": [ // 外键字段对应对象子表字段列表
"id", // 外键字段对应对象子表字段
"name" // 外键字段对应对象子表字段
]
},
"code" // 主对象字段
]
}
- 接口响应
{
"json": "{\"data\":{\"list\":[{\"id\":\"XLWV090002\",\"name\":\"企企1\",\"category\":{\"id\":\"FDWV8X52C\",\"name\":\"内部商户\"},\"contacts\":[],\"code\":\"00001\"},{\"id\":\"5XSE4W000K\",\"name\":\"企企2\",\"category\":{\"id\":\"TKTEK001U\",\"name\":\"成都\"},\"contacts\":[],\"code\":\"00002\"}]},\"errors\":[]}"
}
update接口
-
数据更新接口
-
接口host:https://api2.77hub.com
-
接口路径:/v1/update
-
请求方式:PUT
-
header参数
- 见公共header
-
参数示例
body:
{"json":"{\"objectType\":\"Customer\",\"data\":{\"id\":\"633GUN505MB0108\",\"categoryId\":\"89B1GN505UR0002\",\"code\":\"1002000001\",\"contacts\":[{\"id\":\"A5UK0R50LNT0027\",\"mobile\":\"18988889997\",\"editFlag\":\"update\"},{\"isPrimary\":false,\"name\":\"张三\",\"mobile\":\"13565678898\",\"isCooperated\":false,\"editFlag\":\"add\"}],\"addresses\":[{\"address\":\"\",\"isDefault\":true,\"id\":\"A5UK0R50LNT0026\",\"editFlag\":\"update\",\"countryId\":\"\",\"districtId\":\"\"}]}}"}
// json的value值
{
"objectType":"Customer", // 目标对象类型
"data":{ // 目标对象数据
"id":"633GUN505MB0108", // 目标对象id:必需指定
"categoryId":"89B1GN505UR0002",
"code":"1002000001",
"contacts":[ // 子对象
{
"id":"A5UK0R50LNT0027", // 子对象id:如果是更新,则必需指定
"mobile":"18988889997",
"editFlag":"update" // 子对象操作标记:update->更新(需指定子对象id) add->新增 delete->删除, 默认为add
},
{
"isPrimary":false,
"name":"12",
"mobile":"13565678898",
"isCooperated":false,
"editFlag":"add"
}
],
"addresses":[
{
"address":"",
"isDefault":true,
"id":"A5UK0R50LNT0026",
"editFlag":"update",
"countryId":"",
"districtId":""
}
]
}
}
- 接口响应
{
"json": "{\"success\":true}"
}
审批中修改接口
- 数据更新接口
- 接口host:https://api2.77hub.com
- 接口路径:/v1/approvingUpdate
- 请求方式:PUT
- 参数:和上面/update接口完全一致
delete接口
-
数据删除接口
-
接口host:https://api2.77hub.com
-
接口路径:/v1/delete
-
请求方式:POST
-
header参数
- 见公共header
-
参数示例
body:
{
"json": "{
\"objectType\":\"Customer\",
\"objectId\":\"SDFASFF00010999\"
}"
}
//json的value值:
{
"objectType": "Customer", // 目标对象类型
"objectId": "SDFASFF00010999" // 目标数据id
}
- 接口响应
{
"json": "{\"success\":true}"
}
addAutoSubmit接口 (beta)
- 写入单个对象数据接口,自动提交
- 接口host:https://api2.77hub.com
- 接口路径:/v1/addAutoSubmit
- 说明:参数及响应和add接口保持一致,新增后自动提交,提交任务结束后接口返回,提交失败自动删除单据,单据可能删除失败
根据code获取openid接口
- 接口host:https://api2.77hub.com
- 接口路径:/v1/code
- 请求方式:GET
- header参数
- 见公共header
- Open-Id 不用填
- 请求参数
- code:确认授权后收到的code
- 接口响应
- url:文件URL
{
"openid": "openid128kjsiiyysdlq7",// openid
"userId": "SDFESSDF777", // 授权的用户id
"tenantId": "DFVRHGYHRET9527" // 授权的企业id
}
企业信息接口
- 接口host:https://api2.77hub.com
- 接口路径:/v1/tenant
- 请求方式:GET
- header参数
- 见公共header
- 接口响应
{
"id": "1",
"name": "北京企企科技有限公司",
"error": ""
}
用户信息接口
- 接口描述:获取授权用户信息
- 接口host:https://api2.77hub.com
- 接口路径:/v1/user
- 请求方式:GET
- header参数
- 见公共header
- 接口响应
{
"id":"J32NV555ETN0023",
"name":"王小二",
"mobile":"13900000000",
"email":"",
"tenantName":"北京企企科技有限公司",
"gender":""
}
异步弃审接口
- 接口host:https://api2.77hub.com
- 接口路径:/v1/withdraw
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
- objectType:弃审的目标对象
- objectId:弃审的目标id
- reason:弃审原因
{
"objectType": "RevenueConfirmation",
"objectId": "0BX0JM5015D0001",
"reason": "弃审原因"
}
- 接口响应
- runningIds:执行中的id列表
- requestId:请求id,使用此参数查询异步任务执行状态
- failIds:执行失败的id及对应失败信息
{"json":"{\"runningIds\":[\"LQ2AK161U2H002S\"],\"successIds\":[],\"failIds\":{},\"warningIds\":{},\"userTaskActionValue\":\"manualWithdraw\",\"objectType\":\"RevenueConfirmation\",\"failedCount\":0,\"runningCount\":1,\"successCount\":0,\"warningCount\":0,\"totalCount\":1,\"taskId\":\"W9CAK161U2H002F\",\"isCompleted\":false,\"requestId\":\"time-df78f9c4-267e-4cbe-abcd-8ae2c796bbfb\"}"}
{
"runningIds": [
"LQ2AK161U2H002S"
],
"successIds": [],
"failIds": {},
"warningIds": {},
"userTaskActionValue": "manualWithdraw",
"objectType": "RevenueConfirmation",
"failedCount": 0,
"runningCount": 1,
"successCount": 0,
"warningCount": 0,
"totalCount": 1,
"taskId": "W9CAK161U2H002F",
"isCompleted": false,
"requestId": "time-df78f9c4-267e-4cbe-abcd-8ae2c796bbfb"
}
异步任务状态查询接口
-
接口host:https://api2.77hub.com
-
接口路径:/v1/asynctask
-
请求方式:POST
-
header参数
- 见公共header
-
请求参数
- requestId:异步接口响应的requestId
body:
{
"requestId":"time-5969aedb-e32a-4913-8da8-5a4d7ac3ad1b"
}
-
接口响应
- isCompleted:是否完成
- asyncTaskItems:异步任务项
- asyncTaskItemStatusObject:异步任务项状态
- lastErrorMsg:错误消息
{
"requestId":"",
"isCompleted":true,
"asyncTaskItems":[
{
"id":"W9CAK161U2H002K",
"billStatusObject":{
"id":"BillStatus.effective",
"title":"已生效"
},
"objectType":"RevenueConfirmation",
"objectId":"LQ2AK161U2H002S",
"asyncTaskItemStatus":"AsyncTaskItemStatus.succeeded",
"asyncTaskItemStatusObject":{
"id":"AsyncTaskItemStatus.succeeded",
"title":"成功"
},
"lastErrorMsg":"null",
"isRead":false
}
]
}
红冲接口
- 接口host:https://api2.77hub.com
- 接口路径:/v1/toredbill
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
- objectType:目标对象
- objectId:目标id
{
"objectType":"RevenueConfirmation",
"objectId":"0BX0JM5015D0001"
}
- 接口响应
- id:生成单id
- error:错误信息
{
"id": "PCL9KQ50LNT0001",
"error": ""
}
获取队列信息接口
- 接口host:https://api2.77hub.com
- 接口路径:/v1/queue
- 请求方式:GET
- header参数
- 见公共header
- 接口响应
- queueUrl:队列url
- queueHost:队列host
- queuePath:队列path
- error:错误信息
{
"queueUrl": "https://sqs.cn-north-1.amazonaws.com.cn/878775433445/Q7512J0010",
"queueHost": "https://sqs.cn-north-1.amazonaws.com.cn",
"queuePath": "/878775433445/Q7512J0010",
"error":""
}
同步任务接口
-
接口host:https://api2.77hub.com
-
接口路径:/v1/batchDo
-
请求方式:POST
-
header参数
- 见公共header
-
请求参数
- objectType:目标对象
- objectId:目标id
- action:执行动作,目前支持的动作:
| 动作 | 描述 |
|---|---|
| manualSubmit | 提交 |
| manualRestart | 撤回 |
| manualWithdraw | 弃审 |
| userAgree | 同意 |
| manualOpen | 打开 |
| manualClose | 关闭 |
{
"objectType":"Receipt",
"objectId":"J81N8S512DM000E",
"action":"manualSubmit",
"reason":"原因"
}
- 接口响应
- successIds:执行成功的id
- failIds:执行失败的id及对应失败信息
{
"json":"{\"successIds\":[],\"failIds\":{\"9GN9K161U2H001W\":{\"type\":\"error\",\"code\":\"0000\",\"message\":\"只有待提交,已退回的单据可以提交\"}},\"warningIds\":{}}"
}
异步任务接口
-
接口host:https://api2.77hub.com
-
接口路径:/v1/asyncBatchDo
-
请求方式:POST
-
header参数
- 见公共header
-
请求参数
- objectType:目标对象
- objectId:目标id
- closedBizDate:关闭日期,单位毫秒,关闭时必填
- action:执行动作,目前支持的动作:
| 动作 | 描述 |
|---|---|
| manualSubmit | 提交 |
| manualRestart | 撤回 |
| manualWithdraw | 弃审 |
| userAgree | 同意 |
| manualOpen | 打开 |
| manualClose | 关闭 |
{
"objectType":"Receipt",
"objectId":"J81N8S512DM000E",
"action":"manualSubmit",
"reason":"原因",
"closedBizDate": "1738944000000"
}
- 接口响应
- runningIds:执行中的id列表
- requestId:请求id,使用此参数查询异步任务执行状态
- failIds:执行失败的id及对应失败信息
{
"json":"{\"runningIds\":[\"H5WXH161U2H000H\"],\"successIds\":[],\"failIds\":{},\"warningIds\":{},\"userTaskActionValue\":\"manualWithdraw\",\"objectType\":\"RevenueConfirmation\",\"failedCount\":0,\"runningCount\":1,\"successCount\":0,\"warningCount\":0,\"totalCount\":1,\"taskId\":\"H5WXH161U2H0024\",\"isCompleted\":false,\"requestId\":\"time-50ca75b8-feb1-4fba-9bc3-f6008e322517\"}"
}
文件签名接口
- 接口host:https://api2.77hub.com
- 接口路径:/v1/attachment/signature/signedurl
- 请求方式:GET
- header参数
- 见公共header
- 请求参数
- key:目标文件key,必填
- isHttp:true返回http协议URL,否则返回https协议URL,默认false
- expiresIn:URL过期时间,单位秒,默认7天
- 接口响应
- url:文件URL
{"url":"https://www.77hub.com/"}
文件批量签名接口
- 接口host:https://api2.77hub.com
- 接口路径:/v1/attachment/signature/batchSignedUrl
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
- keys:目标文件key,必填
- isHttp:true返回http协议URL,否则返回https协议URL,默认false
- expiresIn:URL过期时间,单位秒,默认7天
{
"json": "{\"keys\":[\"1\",\"2\"],\"isHttp\":false,\"expiresIn\":3600}"
}
- 接口响应
- key为文件key,value为下载url
{
"json": "{\"1\":\"https://openapi.77hub.com/1\",\"2\":\"https://openapi.77hub.com/2\"}"
}
文件上传签名
-
接口host:https://api2.77hub.com
-
接口路径:/v1/attachment/signature/post
-
请求方式:GET
-
header参数
- 见公共header
-
请求参数
- fileName:待上传的文件名,必填
-
接口响应
{
"json": "{\n \"fields\": {\n \"x-amz-date\": \"20240606T062602Z\",\n \"x-amz-signature\": \"bf298741bbe5857cf19bda02d2060b2bfb5361d7795a3c96b50c17007a223873\",\n \"x-amz-meta-extension\": \"pdf\",\n \"Content-Disposition\": \"filename*=UTF-8''test.pdf\",\n \"x-amz-meta-name\": \"test.pdf\",\n \"acl\": \"bucket-owner-full-control\",\n \"key\": \"47l0lp505840001/2024/06/9dd4ae0e-8c4d-48f5-b0cf-5b7463240920.pdf\",\n \"x-amz-algorithm\": \"AWS4-HMAC-SHA256\",\n \"x-amz-credential\": \"AKIAYOSUOUKKR3KDSWNP/20240606/cn-northwest-1/s3/aws4_request\",\n \"Content-Type\": \"application/pdf\",\n \"policy\": \"eyAgICAgICJleHBpcmF0aW9uIjogIjIwMjQtMDYtMDZUMDc6MjY6MDIuMTA1WiIsCiAgICAgICJjb25kaXRpb25zIjogW3siYnVja2V0IjoiY24tbm9ydGh3ZXN0LTEtcTdsaW5rLXRlc3QifSx7IngtYW16LWRhdGUiOiIyMDI0MDYwNlQwNjI2MDJaIn0seyJ4LWFtei1tZXRhLWV4dGVuc2lvbiI6InBkZiJ9LHsiQ29udGVudC1EaXNwb3NpdGlvbiI6ImZpbGVuYW1lKj1VVEYtOCcndGVzdC5wZGYifSx7IngtYW16LW1ldGEtbmFtZSI6InRlc3QucGRmIn0seyJhY2wiOiJidWNrZXQtb3duZXItZnVsbC1jb250cm9sIn0seyJrZXkiOiI0N2wwbHA1MDU4NDAwMDEvMjAyNC8wNi85ZGQ0YWUwZS04YzRkLTQ4ZjUtYjBjZi01Yjc0NjMyNDA5MjAucGRmIn0seyJ4LWFtei1hbGdvcml0aG0iOiJBV1M0LUhNQUMtU0hBMjU2In0seyJ4LWFtei1jcmVkZW50aWFsIjoiQUtJQVlPU1VPVUtLUjNLRFNXTlAvMjAyNDA2MDYvY24tbm9ydGh3ZXN0LTEvczMvYXdzNF9yZXF1ZXN0In0seyJDb250ZW50LVR5cGUiOiJhcHBsaWNhdGlvbi9wZGYifV0KICAgIH0=\"\n },\n \"url\": \"https://s3.cn-northwest-1.amazonaws.com.cn/cn-northwest-1-q7link-test\"\n}"
} -
json内部结构
{
"fields": {
"x-amz-date": "20240606T062602Z",
"x-amz-signature": "bf298741bbe5857cf19bda02d2060b2bfb5361d7795a3c96b50c17007a223873",
"x-amz-meta-extension": "pdf",
"Content-Disposition": "filename*=UTF-8''test.pdf",
"x-amz-meta-name": "test.pdf",
"acl": "bucket-owner-full-control",
"key": "47l0lp505840001/2024/06/9dd4ae0e-8c4d-48f5-b0cf-5b7463240920.pdf",
"x-amz-algorithm": "AWS4-HMAC-SHA256",
"x-amz-credential": "AKIAYOSUOUKKR3KDSWNP/20240606/cn-northwest-1/s3/aws4_request",
"Content-Type": "application/pdf",
"policy": "eyAgICAgICJleHBpcmF0aW9uIjogIjIwMjQtMDYtMDZUMDc6MjY6MDIuMTA1WiIsCiAgICAgICJjb25kaXRpb25zIjogW3siYnVja2V0IjoiY24tbm9ydGh3ZXN0LTEtcTdsaW5rLXRlc3QifSx7IngtYW16LWRhdGUiOiIyMDI0MDYwNlQwNjI2MDJaIn0seyJ4LWFtei1tZXRhLWV4dGVuc2lvbiI6InBkZiJ9LHsiQ29udGVudC1EaXNwb3NpdGlvbiI6ImZpbGVuYW1lKj1VVEYtOCcndGVzdC5wZGYifSx7IngtYW16LW1ldGEtbmFtZSI6InRlc3QucGRmIn0seyJhY2wiOiJidWNrZXQtb3duZXItZnVsbC1jb250cm9sIn0seyJrZXkiOiI0N2wwbHA1MDU4NDAwMDEvMjAyNC8wNi85ZGQ0YWUwZS04YzRkLTQ4ZjUtYjBjZi01Yjc0NjMyNDA5MjAucGRmIn0seyJ4LWFtei1hbGdvcml0aG0iOiJBV1M0LUhNQUMtU0hBMjU2In0seyJ4LWFtei1jcmVkZW50aWFsIjoiQUtJQVlPU1VPVUtLUjNLRFNXTlAvMjAyNDA2MDYvY24tbm9ydGh3ZXN0LTEvczMvYXdzNF9yZXF1ZXN0In0seyJDb250ZW50LVR5cGUiOiJhcHBsaWNhdGlvbi9wZGYifV0KICAgIH0="
},
"url": "https://s3.cn-northwest-1.amazonaws.com.cn/cn-northwest-1-q7link-test"
}
文件上传说明
1. 通过接口请求文件上传签名
2. 解析响应中json的内部结构,拿到fields和url
3. 构建post请求,将fields作为请求参数,选择目标文件,将请求发送到上述url
4. fields中的key为文件唯一标识,将key保存到企企附件中或进行其他操作
代码示例见java sdk com.q7link.openapi.test.OpenapiRequestTest#testFileUpload
查询执行进度
-
接口host:https://api2.77hub.com
-
接口路径:/v1/usertask
-
请求方式:POST
-
header参数
- 见公共header
-
请求参数
- objectId:单据对象id
body:
{"objectId":"UGG9K161U2H000J"}
-
接口响应
- 待审批
[
{
"taskName": "财务经理审批", // 任务名称
"description": "", // 审批意见
"actionDate": 0, // 执行时间
"action": "待审批", // 当前动作
"userNames": "张三,王世强", // 用户
"isActed": false // 是否已执行
},
{
"taskName": "设置已提交",
"description": "",
"actionDate": 1631520004004,
"action": "提交",
"userNames": "王世强",
"isActed": true
}
]- 已生效
[
{
"taskName": "设置已生效",
"description": "",
"actionDate": 1631517743882,
"action": "生效",
"userNames": "王世强",
"isActed": true
},
{
"taskName": "财务经理审批",
"description": "这是同意意见",
"actionDate": 1631517740929,
"action": "同意",
"userNames": "王世强",
"isActed": true
},
{
"taskName": "设置已提交",
"description": "",
"actionDate": 1631517712289,
"action": "提交",
"userNames": "王世强",
"isActed": true
}
]
查询报表
-
接口host:https://api2.77hub.com
-
接口路径:/v1/reportdefinition
-
请求方式:POST
-
header参数
- 见公共header
-
请求参数
- params:json字符串(将json对象转义)
{
"params": "{\"id\":\"F5M8PQ50FKF0002\",\"outputType\":\"json\",\"queryObject\":{\"criteria\":{\"operator\":\"and\",\"values\":[{\"operator\":\"in\",\"values\":[\"K4WUXS50JUD0011\"],\"fieldName\":\"ownerExpenceOrg\",\"properties\":{\"isDefaultQueryTreeRootOnly\":false,\"isIncludeChildren\":false,\"isOrganizationRole\":true,\"orgRoleTypeIds\":[\"FinancialOrg\"]}},{\"operator\":\"between\",\"values\":[1609430400000,1640966399999],\"fieldName\":\"reimburseReportView.businessDate\",\"type\":\"Timestamp\"},{\"operator\":\"eq\",\"values\":[\"NUE2UQ50FKF0001\"],\"fieldName\":\"cost\"}]}}}"
}{// params结构详情
"id":"F5M8PQ50FKF0002", // 方案id
"outputType":"json", // 输出类型为json, 支持的类型:json/excel/pdf
"queryObject":{
"criteria":{ // 查询条件
"operator":"and", // 多条件间关系
"values":[
{ // 此条件解释为:ownerExpenceOrg in ('K4WUXS50JUD0011')
"operator":"in", // 支持in、eq(=)、like、gt(>)、ge(>=)等
"values":[
"K4WUXS50JUD0011"
],
"fieldName":"ownerExpenceOrg",
"properties":{
"isDefaultQueryTreeRootOnly":false,
"isIncludeChildren":false,
"isOrganizationRole":true,
"orgRoleTypeIds":[
"FinancialOrg"
]
}
},
{ // 此条件解释为:reimburseReportView.businessDate between 1609430400000 and 1640966399999
"operator":"between",
"values":[
1609430400000,
1640966399999
],
"fieldName":"reimburseReportView.businessDate",
"type":"Timestamp"
},
{ // 此条件解释为:cost = 'NUE2UQ50FKF0001'
"operator":"eq",
"values":[
"NUE2UQ50FKF0001"
],
"fieldName":"cost"
}
]
}
}
} -
接口响应
- data:json数据
- error:错误信息
- 示例(outputType=json)
{
"params": "{\"id\":\"F5M8PQ50FKF0002\",\"outputType\":\"json\",\"queryObject\":{\"criteria\":{\"operator\":\"and\",\"values\":[{\"operator\":\"in\",\"values\":[\"K4WUXS50JUD0011\"],\"fieldName\":\"ownerExpenceOrg\",\"properties\":{\"isDefaultQueryTreeRootOnly\":false,\"isIncludeChildren\":false,\"isOrganizationRole\":true,\"orgRoleTypeIds\":[\"FinancialOrg\"]}},{\"operator\":\"between\",\"values\":[1609430400000,1640966399999],\"fieldName\":\"reimburseReportView.businessDate\",\"type\":\"Timestamp\"},{\"operator\":\"eq\",\"values\":[\"NUE2UQ50FKF0001\"],\"fieldName\":\"cost\"}]}}}"
}{// params结构详情
"id":"F5M8PQ50FKF0002", // 方案id
"outputType":"json", // 输出类型为json, 支持的类型:json/excel/pdf
"queryObject":{
"criteria":{ // 查询条件
"operator":"and", // 多条件间关系
"values":[
{ // 此条件解释为:ownerExpenceOrg in ('K4WUXS50JUD0011')
"operator":"in", // 支持in、eq(=)、like、gt(>)、ge(>=)等
"values":[
"K4WUXS50JUD0011"
],
"fieldName":"ownerExpenceOrg",
"properties":{
"isDefaultQueryTreeRootOnly":false,
"isIncludeChildren":false,
"isOrganizationRole":true,
"orgRoleTypeIds":[
"FinancialOrg"
]
}
},
{ // 此条件解释为:reimburseReportView.businessDate between 1609430400000 and 1640966399999
"operator":"between",
"values":[
1609430400000,
1640966399999
],
"fieldName":"reimburseReportView.businessDate",
"type":"Timestamp"
},
{ // 此条件解释为:cost = 'NUE2UQ50FKF0001'
"operator":"eq",
"values":[
"NUE2UQ50FKF0001"
],
"fieldName":"cost"
}
]
}
}
} -
接口响应
- data:json数据
- error:错误信息
- 示例(outputType=json)
错误返回结果:
{
"error": "{\"type\":\"error\",\"code\":\"0008\",\"message\":\"对象没有找到\",\"description\":\"report definition not found for id: F5M8PQ50FKF0002\"}"
}
正确返回结果:
{
"data": "{ \"data\":{ \"title\":\"用户权益分配\", \"pageSettings\":{ \"titleFontSize\":16, \"titleAlign\":\"center\", \"fontSize\":10, \"subTitleFontSize\":12, \"subTitleAlign\":\"center\", \"minFontSize\":4, \"maxFontSize\":32, \"entLogoHeight\":22.677166, \"pageHeaderFontSize\":8, \"isPreview\":false, \"starPageNum\":1, \"pageRotate\":false, \"pageMargins\":[ 30, 30, 30, 30 ], \"cellPaddings\":[ 2, 2, 0, 2 ], \"adjustMinColumnSize\":30, \"isFillBlankRow\":false, \"isPageSubtotal\":false, \"isPageTotal\":false }, \"corners\":[ ], \"rows\":[ ], \"cols\":[ [ { \"startRowIndex\":0, \"startColIndex\":12, \"rowIndex\":0, \"colIndex\":12, \"rowSpan\":1, \"colSpan\":1, \"displayValue\":\"角色\", \"cellType\":\"colTitle\", \"aliasField\":\"roleName_TenantRightsAssignmentView\", \"aliasName\":\"roleName_TenantRightsAssignmentView\" } ] ], \"datas\":[ [ \"查询服务\", \"\", \"模组授权\", \"12.00\", \"50.00\", \"张三\", \"用户授权\", \"YG009\", \"在职\", \"测试四部\", \"18000595971\", \"\", \"系统用户\", \"UserStatus.incumbent\" ] ], \"metas\":{ }, \"totalRows\":[ ], \"dimSubTotalRows\":{ }, \"styleIdMap\":{ }, \"rowCondStyleIds\":{ }, \"totalCols\":[ ], \"dimSubTotalCols\":{ }, \"rowTotalDimInfo\":{ }, \"columns\":[ { \"width\":100, \"alignment\":\"left\", \"type\":\"String\" } ], \"layout\":[ \"moduleGroupId_TenantRightsAssignmentView\", \"moduleGroupAppId_TenantRightsAssignmentView\", \"authType_TenantRightsAssignmentView\", \"usedQty_TenantRightsAssignmentView\", \"acquiredQty_TenantRightsAssignmentView\", \"userName_TenantRightsAssignmentView\", \"grantType_TenantRightsAssignmentView\", \"userCode_TenantRightsAssignmentView\", \"userStatusTitle_TenantRightsAssignmentView\", \"userDepartmentName_TenantRightsAssignmentView\", \"userMobile_TenantRightsAssignmentView\", \"userEmail_TenantRightsAssignmentView\", \"roleName_TenantRightsAssignmentView\" ], \"dataIndexes\":{ \"moduleGroupId_TenantRightsAssignmentView\":0, \"moduleGroupAppId_TenantRightsAssignmentView\":1, \"authType_TenantRightsAssignmentView\":2, \"usedQty_TenantRightsAssignmentView\":3, \"acquiredQty_TenantRightsAssignmentView\":4, \"userName_TenantRightsAssignmentView\":5, \"grantType_TenantRightsAssignmentView\":6, \"userCode_TenantRightsAssignmentView\":7, \"userStatusTitle_TenantRightsAssignmentView\":8, \"userDepartmentName_TenantRightsAssignmentView\":9, \"userMobile_TenantRightsAssignmentView\":10, \"userEmail_TenantRightsAssignmentView\":11, \"roleName_TenantRightsAssignmentView\":12, \"userStatus\":13 }, \"extDatas\":[ ], \"extDataIndexes\":{ } }, \"reportMessages\":{ }}"
}
{
// data下结构详情
"data":{
"title":"用户权益分配",
"pageSettings":{
"titleFontSize":16,
"titleAlign":"center",
"fontSize":10,
"subTitleFontSize":12,
"subTitleAlign":"center",
"minFontSize":4,
"maxFontSize":32,
"entLogoHeight":22.677166,
"pageHeaderFontSize":8,
"isPreview":false,
"starPageNum":1,
"pageRotate":false,
"pageMargins":[
30,
30,
30,
30
],
"cellPaddings":[
2,
2,
0,
2
],
"adjustMinColumnSize":30,
"isFillBlankRow":false,
"isPageSubtotal":false,
"isPageTotal":false
},
"corners":[ // Corner区域数据,同cols
],
"rows":[ // // 列维度区域数据,同cols
],
"cols":[ // 列维度区域数据,二维数组,表示有m行n列的列维度数据
[
"查询服务",
"",
"模组授权",
"12.00",
"50.00",
"周小七",
"用户授权",
"1111110004",
"",
"总部",
"15386620539",
"",
"系统用户",
""
]
],
"metas":{
},
"totalRows":[ // 合计行索引
],
"dimSubTotalRows":{
},
"styleIdMap":{
},
"rowCondStyleIds":{
},
"totalCols":[ // 合计列索引
],
"dimSubTotalCols":{
},
"rowTotalDimInfo":{
},
"columns":[. // 所有列的布局信息(包括行维度列)
{
"width":100, // 列宽
"alignment":"left", // 对其方式
"type":"String". // 值类型
}
],
"layout":[
"moduleGroupId_TenantRightsAssignmentView",
"moduleGroupAppId_TenantRightsAssignmentView",
"authType_TenantRightsAssignmentView",
"usedQty_TenantRightsAssignmentView",
"acquiredQty_TenantRightsAssignmentView",
"userName_TenantRightsAssignmentView",
"grantType_TenantRightsAssignmentView",
"userCode_TenantRightsAssignmentView",
"userStatusTitle_TenantRightsAssignmentView",
"userDepartmentName_TenantRightsAssignmentView",
"userMobile_TenantRightsAssignmentView",
"userEmail_TenantRightsAssignmentView",
"roleName_TenantRightsAssignmentView"
],
"dataIndexes":{. // 值为对应的值在datas中的索引
"moduleGroupId_TenantRightsAssignmentView":0,
"moduleGroupAppId_TenantRightsAssignmentView":1,
"authType_TenantRightsAssignmentView":2,
"usedQty_TenantRightsAssignmentView":3,
"acquiredQty_TenantRightsAssignmentView":4,
"userName_TenantRightsAssignmentView":5,
"grantType_TenantRightsAssignmentView":6,
"userCode_TenantRightsAssignmentView":7,
"userStatusTitle_TenantRightsAssignmentView":8,
"userDepartmentName_TenantRightsAssignmentView":9,
"userMobile_TenantRightsAssignmentView":10,
"userEmail_TenantRightsAssignmentView":11,
"roleName_TenantRightsAssignmentView":12,
"userStatus":13
},
"extDatas":[
],
"extDataIndexes":{
}
},
"reportMessages":{
}
}
- 示例(outputType=excel)
{
"data": "\"https://openapi.77hub.com/static/images/logo_color.svg\"",
"error": ""
}
- 示例(outputType=pdf)
{
"data": "\"https://openapi.77hub.com/static/images/logo_color.svg\"",
"error": ""
}
项目变更
- 接口host:https://api2.77hub.com
- 接口路径:/v1/changeproject
- 请求方式:PUT
- header参数
- 见公共header
- 请求参数
- json:json字符串(将json对象转义)
{"json": "{\"data\":{\"id\":\"F5M8PQ50FKF0002\", \"description\": \"修改描述\"}}"}
{ // json结构
"data": { // 项目对象
"id": "F5M8PQ50FKF0002", // 项目id
"description": "修改描述" // 变更的项目字段
}
}
- 接口响应
- data:json数据
- error:错误信息
{
"json": "{\"success\":true}",
"error": ""
}
单据增量变更
- 接口host:https://api2.77hub.com
- 接口路径:/v1/changeBill
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
- json:json字符串(将json对象转义)
{
"json": "{\n \"objectType\": \"ArContract\",\n \"data\": {\n \"id\": \"AX16P86402A0095\",\n \"name\": \"测试合同\"\n }\n}"
}
{
"objectType": "ArContract",// 对象类型
"data": {
"id": "AX16P86402A0095", // 对象id
"name": "测试合同" // 数据项
}
}
- 接口响应
- data:json数据
- error:错误信息
{
"json": "{\"id\":\"x\"}",
"error": ""
}
工作日类型
-
接口host:https://api2.77hub.com
-
接口路径:/v1/workcalendar/querydatetype
-
请求方式:GET
-
header参数
- 见公共header
-
请求参数
- workCalendarId:String 工作日历id 非必填
- date:Timestamp 查询的工作日日期 必填
-
接口响应
- workDayType:String 工作日类型
{
"workDayType": "xxx"
}
部门分配
- 接口host:https://api2.77hub.com
- 接口路径:/v1/department/momanualassign
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{
"operateOrgId": "",// 发起分配的组织id,必填
"assignInfo": {
"objectId": "",// 待分配对象id
"usedOrgId": ""// 目标组织id,必填
}
}
- 接口响应
{
"error": "", // 错误信息
"successIds": "" // 成功的id
}
出纳确认
-
接口host:https://api2.77hub.com
-
接口路径:/v1/receipt/cashierconfirm
-
请求方式:POST
-
header参数
- 见公共header
-
请求参数
在一次请求中receiptId或paymentId不能同时指定
{
"receiptId": "", // 收款单id
"paymentId": "" // 付款单id
}
- 接口响应
{
"successIds": [""], // 成功的id
"failIds": "{\"1\":\"没有该记录\"}", // 失败的id及对应错误信息
"error": "" // 其他错误信息
}
取消出纳确认
- 接口host:https://api2.77hub.com
- 接口路径:/v1/receipt/cancelconfirm
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{
"objectType": "", // 对象类型
"objectId": "" // 对象id
}
- 接口响应
{
"successIds": [""], // 成功的id
"failIds": "{\"1\":\"没有该记录\"}", // 失败的id及对应错误信息
"error": "" // 其他错误信息
}
项目阶段执行开始
- 接口host:https://api2.77hub.com
- 接口路径:/v1/project/startStage
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{
"id": "1", // String,项目阶段id
"projectId": "1", // String,项目id
"date": "1672898824632", // Timestamp,开始日期,如果为空,则表示取消开始
"usedOrgId": "1" // String,项目的使用组织
}
- 接口响应
{
"error": "" // 错误信息
}
项目阶段执行完成
- 接口host:https://api2.77hub.com
- 接口路径:/v1/project/finishStage
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{
"id": "1", // String,项目阶段id
"projectId": "1", // String,项目id
"date": "1672898824632", // Timestamp,完成日期,如果为空,则表示取消完成
"usedOrgId": "1" // String,项目的使用组织
}
- 接口响应
{
"error": "" // 错误信息
}
打印预览
- 接口host:https://api2.77hub.com
- 接口路径:/v1/printPreview
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{
"objectType": "ReimburseApply", // 对象类型
"objectId": "U4DT9361UKQ001E", // 对象id
"templateId": "5hs1@zEZR" // 打印模板id
}
- 接口响应
{
"url": "", // pdf文件地址,有效期24小时
"error": "" // 错误信息
}
库存可用量、现存量
- 接口host:https://api2.77hub.com
- 接口路径:/v1/inventoryAvailQty
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{"json":"{\n \"productIds\": [\n \"LA5NF261UKQ00DD\",\n \"1\"\n ],\n \"warehouseIds\": [\n \"A3CL4461URL002A\",\n \"2\"\n ],\n \"batchNos\": [\n \"1\",\n \"2\"\n ],\n \"orgId\": \"\",\n \"atpDate\": 1686649339283\n}"}
json的value
{
"productIds": [ // 存货id列表
"LA5NF261UKQ00DD",
"1"
],
"warehouseIds": [ // 仓库id列表
"A3CL4461URL002A",
"2"
],
"atpDate": 1686649339283, // 供需日期,非必填,0时区毫秒时间戳,默认值为当前时间
"orgId": "", // 多组织企业必填
"batchNos": [ // 批次号,非必填
"1",
"2"
]
}
- 接口响应
{
"json": "[\n {\n \"onHandBaseQty\": 0,\n \"onHandAuxQty\": 0,\n \"availAuxQty\": 0,\n \"availBaseQty\": 10,\n \"invCtrlObject\": {\n \"id\": \"WNCR6461URL001E\",\n \"inventoryOrg\": {\n \"id\": \"K4WUXS50JUD0011\",\n \"name\": \"总账/资产集群1-多组织\"\n },\n \"product\": {\n \"code\": \"0000000038-010100-0001\",\n \"id\": \"LA5NF261UKQ00DD\",\n \"name\": \"冰箱12\",\n \"spec\": \"台\"\n },\n \"warehouse\": {\n \"id\": \"A3CL4461URL002A\",\n \"name\": \"成都仓库\"\n }\n },\n \"invCtrlObjectId\": \"WNCR6461URL001E\"\n }\n ]"
}
json的value
[
{
"onHandBaseQty": 0, // 主单位现存量
"onHandAuxQty": 0, // 辅单位现存量
"availBaseQty": 10, //主单位可用量
"availAuxQty": 0, //辅单位可用量
"invCtrlObject": {
"id": "WNCR6461URL001E",
"inventoryOrg": { // 组织信息
"id": "K4WUXS50JUD0011",
"name": "总账/资产集群1-多组织"
},
"product": { // 存货
"code": "0000000038-010100-0001",
"id": "LA5NF261UKQ00DD",
"name": "冰箱12",
"spec": "台"
},
"warehouse": { // 仓库
"id": "A3CL4461URL002A",
"name": "成都仓库"
}
},
"invCtrlObjectId": "WNCR6461URL001E"
}
]
成本查询
- 接口host:https://api2.77hub.com
- 接口路径:/v1/inventory/InvAcctgJournal/queryCost
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{"json":"{\n \"financialOrgId\": \"7DAWT461UAV0008\",\n \"invAcctgDefId\": \"9FDWT461UAV003G\",\n \"productIds\": [\n \"73DWT461UAV00CF\"\n ],\n \"projectIds\": [\n \"PS7VT461UAV00BB\"\n ],\n \"batchNos\": [\n \"123\"\n ],\n \"productCharacs\": [\n {\n \"csCcck69es1uav02Cck69es1uav03\": \"WJBWT461UAV00AF\",\n \"csGysck69f21uav01Cck69f21uav02\": \"Q4DWT461UAV006U\"\n },\n {\n \"csGysck69f21uav01Cck69f21uav02\": \"Q4DWT461UAV006U\"\n }\n ],\n \"queryType\": 3\n}"}
json的value
{
"financialOrgId": "7DAWT461UAV0008", // 财务组织,必填
"invAcctgDefId": "9FDWT461UAV003G", // 计价方案id,必填
"productIds": [ // 存货id,非必填
"73DWT461UAV00CF"
],
"projectIds": [ // 项目id,非必填
"PS7VT461UAV00BB"
],
"batchNos": [ // 批号,非必填
"123"
],
"productCharacs": [ // 存货特征,非必填
{
"csCcck69es1uav02Cck69es1uav03": "WJBWT461UAV00AF",
"csGysck69f21uav01Cck69f21uav02": "Q4DWT461UAV006U"
},
{
"csGysck69f21uav01Cck69f21uav02": "Q4DWT461UAV006U"
}
],
"queryType": 3 // 查询类型(1:最新采购成本(采购入库单、其它入库单) 2:最新出库成本(领用出库单、销售出库单、其它出库单) 3:最新结存成本) 必填
}
- 接口响应
{
"json": "[\n {\n \"id\": \"HX8V0661UC70027\",\n \"invAcctgObjectId\": \"TGDXT461UAV00AD\",\n \"productId\": \"73DWT461UAV00CF\",\n \"productName\": \"樱桃(存货核算专用+启特)\",\n \"productCode\": \"CH021\",\n \"productSpec\": \"箱\",\n \"projectId\": \"PS7VT461UAV00BC\",\n \"projectName\": \"宿舍建设项目\",\n \"acctgProductSpecId\": \"TGDXT461UAV00A6\",\n \"characs\": {\n \"csCcck69es1uav02Cck69es1uav03\": \"WJBWT461UAV00AF\"\n },\n \"originPrice\": 0E-8,\n \"price\": 0E-8,\n \"originBalancePrice\": 0E-8,\n \"balancePrice\": 0E-8\n }\n ]"
}
json的value
[
{
"id": "HX8V0661UC70027", // 存货明细账ID
"invAcctgObjectId": "TGDXT461UAV00AD", // 存货核算对象ID
"productId": "73DWT461UAV00CF", // 存货ID
"productName": "樱桃(存货核算专用+启特)", // 存货名称
"productCode": "CH021", // 存货编码
"productSpec": "箱", // 存货规格
"projectId": "PS7VT461UAV00BC", // 项目ID
"projectName": "宿舍建设项目", // 项目名称
"acctgProductSpecId": "TGDXT461UAV00A6", // 特征组合ID
"characs": { // 特征组合:特征ID->特征值映射
"csCcck69es1uav02Cck69es1uav03": "WJBWT461UAV00AF"
},
"originPrice": 0E-8, // 原币成本单价(根据queryType决定是采购、出库还是结存成本)
"price": 0E-8, // 本币成本单价
"originBalancePrice": 0E-8, // 原币结存成本单价
"balancePrice": 0E-8 // 本币结存成本单价
}
]
人员调动
- 接口host:https://api2.77hub.com
- 接口路径:/v1/user/transfer
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{"json": "{\n \"userId\": \"03LGK261UKQ00EP\",\n \"autoFinishJobRelationship\": true,\n \"transferInOrgId\": \"FJVC7X50C09000A\",\n \"transferInDeptId\": \"VNMMF461UWT00BC\",\n \"jobStartTime\": 1690387200000,\n \"type\": \"create\"\n}\n"}
json的value
{
"userId": "03LGK261UKQ00EP",
"autoFinishJobRelationship": true,
"transferInOrgId": "FJVC7X50C09000A",
"transferInDeptId": "VNMMF461UWT00BC",
"jobStartTime": 1690387200000,
"type": "create"
}
| 参数 | 名称 | 类型 | 说明 |
|---|---|---|---|
| userId | 人员 | String | 必填 |
| transferInOrgId | 调入组织 | String | 必填 |
| transferInDeptId | 调入部门 | String | 必填 |
| jobStartTime | 调入任职开始时间 | Timestamp | 必填 |
| jobEndTime | 调入任职结束时间 | Timestamp | 非必填 |
| autoFinishJobRelationship | 调入任职记录是否自动结束 | Boolean | 非必填 |
| type | create 其他传此值 update 选择是传此值,不检测人员是否已兼职过 | String | 必填 |
| supervisorId | 上级主管 | String | 非必填 |
| rankId | 职级 | String | 非必填 |
| positionId | 岗位 | String | 非必填 |
查询联行号
- 接口host:https://api2.77hub.com
- 接口路径:/v1/bank/query
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{"json": "{\n \"name\":\"工行\",\n \"pageNo\":1,\n \"pageSize\":10}"}
json的value
{
"name": "工行", // 必填;支持联行号、支行名称、银行名称、银行代码
"pageNo": 1, //必填
"pageSize": 10 //必填
}
- 返回结果
{"json":"[{\"id\":\"103100005098\",\"code\":\"103100005098\",\"name\":\"中国农业银行股份有限公司北京中关村支行\",\"epayBankCode\":\"ABC\",\"epayBankId\":\"RA344T50J040024\",\"bankId\":\"JTP2XT50JB30004\"},{\"id\":\"104100004064\",\"code\":\"104100004064\",\"name\":\"中国银行股份有限公司北京中关村北大街支行\",\"epayBankCode\":\"BOC\",\"epayBankId\":\"RA344T50J040025\",\"bankId\":\"JTP2XT50JB30003\"},{\"id\":\"104100005660\",\"code\":\"104100005660\",\"name\":\"中国银行股份有限公司北京中关村科技园区支行\",\"epayBankCode\":\"BOC\",\"epayBankId\":\"RA344T50J040025\",\"bankId\":\"JTP2XT50JB30003\"},{\"id\":\"104100006652\",\"code\":\"104100006652\",\"name\":\"中国银行股份有限公司北京中关村支行\",\"epayBankCode\":\"BOC\",\"epayBankId\":\"RA344T50J040025\",\"bankId\":\"JTP2XT50JB30003\"},{\"id\":\"104304383348\",\"code\":\"104304383348\",\"name\":\"中国银行股份有限公司溧阳中关村支行\",\"epayBankCode\":\"BOC\",\"epayBankId\":\"RA344T50J040025\",\"bankId\":\"JTP2XT50JB30003\"},{\"id\":\"303100000135\",\"code\":\"303100000135\",\"name\":\"中国光大银行股份有限公司北京中关村支行\",\"epayBankCode\":\"CEB\",\"epayBankId\":\"RA344T50J040050\",\"bankId\":\"JTP2XT50JB30009\"},{\"id\":\"305100001057\",\"code\":\"305100001057\",\"name\":\"中国民生银行股份有限公司北京中关村支行\",\"epayBankCode\":\"CMBC\",\"epayBankId\":\"RA344T50J040019\",\"bankId\":\"JTP2XT50JB30010\"},{\"id\":\"310100000052\",\"code\":\"310100000052\",\"name\":\"上海浦东发展银行北京中关村支行\",\"epayBankCode\":\"SPDB\",\"epayBankId\":\"RA344T50J040037\",\"bankId\":\"JTP2XT50JB30013\"},{\"id\":\"313100016035\",\"code\":\"313100016035\",\"name\":\"盛京银行股份有限公司北京中关村支行\",\"epayBankCode\":\"SJB\",\"epayBankId\":\"RA344T50J040115\",\"bankId\":\"JTP2XT50JB30069\"},{\"id\":\"597100000055\",\"code\":\"597100000055\",\"name\":\"韩亚银行(中国)有限公司北京中关村支行\",\"epayBankCode\":\"QTCB\",\"epayBankId\":\"RA344T50J040022\",\"bankId\":\"JTP2XT50JB30112\"}]"}
json的value
[
{
"id": "304100040091", // 企企中的数据id
"code": "304100040091", // 联行号
"name": "华夏银行北京中关村支行", // 支行名称
"epayBankCode": "HB" // 银行代码
},
{
"id": "313100000193",
"code": "313100000193",
"name": "北京银行中关村广场支行",
"epayBankCode": "BCCB"
}
]
查询支付指令单
- 接口host:https://api2.77hub.com
- 接口路径:/v1/EpaytransItem/list
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{
"json": "{\n \"batchSize\":100,\n \"accountCode\":[\"6229912712374623462634\"],\n \"epayTransId\": \"R1B9R9630T80001\"\n}"
}
json的value
{
"batchSize":100,
"accountCode":["6229912712374623462634"],
"epayTransId": "R1B9R9630T80001" // 不为空则按单笔指令单查询,否则按accountCode批量查询指令单
}
-
返回结果
{
"json": "[\n {\n \"code\": \"OD012024062000033\",\n \"transSeqNo\": \"2AN83860M6Q003J\",\n \"usage\": \"报销款\",\n \"externalObjectId\": \"\",\n \"toOpeningBankName\": \"中信银行股份有限公司上海虹口支行\",\n \"respSeqNo\": \"8293770_716861\",\n \"businessDate\": 1718812800000,\n \"createdOrgId\": \"K4WUXS50JUD0011\",\n \"bankEpayStatusId\": \"EpayStatus.success\",\n \"epayTransId\": \"2AN83860M6Q003C\",\n \"externalObjectType\": \"\",\n \"toPartyBankAccountId\": \"T9XQQX50J8U0010\",\n \"id\": \"2AN83860M6Q003J\",\n \"bankBusinessDate\": 1718868180000,\n \"toAcctCode\": \"6217680203121212\",\n \"toOpeningBankCode\": \"302290031155\",\n \"toEpayBankId\": \"RA344T50J040035\",\n \"externalSystemCode\": \"\",\n \"epayToAcctTypeId\": \"EpayToAcctType.toPerson\",\n \"transAmount\": 1169.43,\n \"bankRespMsg\": \"成功|转账结果查询接口访问成功\",\n \"epayStatusId\": \"EpayStatus.success\",\n \"bankRespCode\": \"S\",\n \"toAcctName\": \"张三\",\n \"epayBusinessDate\": 1718868180000\n }\n]"
}json的value
[
{
"code": "OD012024062000033",
"transSeqNo": "2AN83860M6Q003J",
"usage": "报销款",
"externalObjectId": "",
"toOpeningBankName": "中信银行股份有限公司上海虹口支行",
"respSeqNo": "8293770_716861",
"businessDate": 1718812800000,
"createdOrgId": "K4WUXS50JUD0011",
"bankEpayStatusId": "EpayStatus.success",
"epayTransId": "2AN83860M6Q003C",
"externalObjectType": "",
"toPartyBankAccountId": "T9XQQX50J8U0010",
"id": "2AN83860M6Q003J",
"bankBusinessDate": 1718868180000,
"toAcctCode": "6217680203121212",
"toOpeningBankCode": "302290031155",
"toEpayBankId": "RA344T50J040035",
"externalSystemCode": "",
"epayToAcctTypeId": "EpayToAcctType.toPerson",
"transAmount": 1169.43,
"bankRespMsg": "成功|转账结果查询接口访问成功",
"epayStatusId": "EpayStatus.success",
"bankRespCode": "S",
"toAcctName": "张三",
"epayBusinessDate": 1718868180000
}
]
更新支付指令单
-
接口host:https://api2.77hub.com
-
接口路径:/v1/EpaytransItem/update
-
请求方式:POST
-
header参数
- 见公共header
-
请求参数
{
"json": "{\n \"id\": \"F5S65861JVN001M\",\n \"bankRespMsg\": \"支付成功\",\n \"bankEpayStatusId\": \"EpayStatus.success\",\n \"bankRespCode\": \"0000\",\n \"respSeqNo\": \"121_saw_12\",\n \"bankBusinessDate\": 1720598798664\n}"
}json的value
{
"id": "F5S65861JVN001M",
"bankRespMsg": "支付成功",
"bankEpayStatusId": "EpayStatus.success",
"bankRespCode": "0000",
"respSeqNo": "121_saw_12",
"bankBusinessDate": 1720598798664
} -
返回结果
{
"json": "{\n \"responseTime\": 1720488970388,\n \"success\": true,\n \"code\": \"200\",\n \"msg\": \"成功\",\n \"data\": []\n}"
}json的value
// 成功
{
"responseTime": 1720488970388,
"success": true,
"code": "200",
"msg": "成功",
"data": []
}
// 失败
{
"responseTime": 1720599281888,
"success": false,
"code": "epay-cmb-001",
"msg": "必要参数缺失"
}
批量插入支付交易流水
-
接口host:https://api2.77hub.com
-
接口路径:/v1/EpayAccountTransJournal/asyncBatchIns
-
请求方式:POST
-
header参数
- 见公共header
-
请求参数
{
"json": "[{\"transAmount\":818.46,\"partyAccountCode\":\"123\",\"partyAccountName\":\"张三\",\"epayTransDirectionId\":\"EpayTransDirection.outgoing\",\"purpose\":\"sss\",\"bankAccountId\":\"5FQWKX50JMQ002M\",\"partyBankAccountId\":\"121212\",\"bizSeqNo\":\"843a318841e86219137d333a1119ad651acdce025869743\",\"bankSeqNo\":\"20220702G4145400112111561114C\",\"businessDate\":1720598694000,\"digest\":\"摘要\",\"comments\":\"cc\",\"refundMsg\":\"11\"},{\"transAmount\":818.46,\"partyAccountCode\":\"123\",\"partyAccountName\":\"李四\",\"epayTransDirectionId\":\"EpayTransDirection.outgoing\",\"purpose\":\"sss\",\"bankAccountId\":\"5FQWKX50JMQ002M\",\"partyBankAccountId\":\"121212\",\"bizSeqNo\":\"843a318841e8621913337d3a1119ad651acdce025869743\",\"bankSeqNo\":\"20220702G414522400112111564C\",\"businessDate\":1720598694000,\"digest\":\"摘要\",\"comments\":\"cc\",\"refundMsg\":\"11\"}]"
}json的value
[
{
"transAmount": 818.46,
"partyAccountCode": "123",
"partyAccountName": "张三",
"epayTransDirectionId": "EpayTransDirection.outgoing",
"purpose": "sss",
"bankAccountId": "5FQWKX50JMQ002M",
"partyBankAccountId": "121212",
"bizSeqNo": "843a318841e86219137d333a1119ad651acdce025869743",
"bankSeqNo": "20220702G4145400112111561114C",
"businessDate": 1720598694000,
"digest": "摘要",
"comments": "cc",
"refundMsg": "11"
},
{
"transAmount": 818.46,
"partyAccountCode": "123",
"partyAccountName": "李四",
"epayTransDirectionId": "EpayTransDirection.outgoing",
"purpose": "sss",
"bankAccountId": "5FQWKX50JMQ002M",
"partyBankAccountId": "121212",
"bizSeqNo": "843a318841e8621913337d3a1119ad651acdce025869743",
"bankSeqNo": "20220702G414522400112111564C",
"businessDate": 1720598694000,
"digest": "摘要",
"comments": "cc",
"refundMsg": "11"
}
] -
返回结果
{
"json": "{\n \"responseTime\": 1720488970388,\n \"success\": true,\n \"code\": \"200\",\n \"msg\": \"成功\",\n \"data\": []\n}"
}json的value
// 成功
{
"responseTime": 1720488970388,
"success": true,
"code": "200",
"msg": "成功",
"data": []
}
// 失败
{
"responseTime": 1720599281888,
"success": false,
"code": "epay-cmb-001",
"msg": "必要参数缺失"
}
招行回单
- 接口host:https://api2.77hub.com
- 接口路径:/v1/cmbReceipt
- 请求方式:POST
- header参数
- 见公共header
- 请求参数
{
"json": "{\n \"tenantId\": \"租户id\",\n \"bankAccountId\": \"账号\",\n \"date\": \"日期\",\n \"receiptList\": [\n {\n \"fileurl\": \"回单url111\",\n \"fintim\": \"回单完成时间\"\n },\n {\n \"fileurl\": \"回单url222\",\n \"fintim\": \"回单完成时间\"\n }\n ]\n}"
}
json的value
{
"tenantId": "租户id",
"bankAccountId": "账号",
"date": "日期",
"receiptList": [
{
"fileurl": "回单url111",
"fintim": "回单完成时间"
},
{
"fileurl": "回单url222",
"fintim": "回单完成时间"
}
]
}