关联外部系统单据
业务场景
进入每刻报销->设置->单据与流程->选择某一自定义表单->选择 关联单据 组件->选择 允许关联外部单据
Figure: img_4.png
查询外部系统单据接口说明
请求参数说明
注意：只有用户在提单时候的点击请求才会带有以下请求参数，如果是审批人员在单据详情点击，每刻不会推送信息，只会直接访问外部系统返回的url。
| 字段名称 |
字段类型 |
必有 |
字段说明 |
| keyWord |
String |
是 |
搜索关键字，由用户在界面上输入 |
| start |
int |
是 |
开始条数 |
| length |
int |
是 |
当前页显示条数 |
| formData |
|
是 |
每刻推送的表单数据格式 |
| verification |
Boolean |
是 |
是否用于校验，默认false |
| formCodes |
List<String> |
否 |
单据导入外部单据时，需额外支持该字段的精确查找 |
请求类型
POST
请求参数示例
{
"keyWord":"",
"start":10,
"length":10,
"formData": {
},
"verification":false
}
响应参数说明
- url加密，根据（文档）查看相应加解密规则。（如有需求，请联系每刻实施人员）
| 字段名称 |
字段类型 |
必有 |
字段说明 |
| success |
boolean |
是 |
响应是否成功。true：业务成功；false：业务失败 |
| errorMsg |
String |
是 |
错误信息，当success为false时，每刻会将该信息回显 |
| data |
dataDto |
是 |
外部数据 |
dataDto
| 字段名称 |
字段类型 |
必有 |
字段说明 |
| recordsTotal |
int |
是 |
总条数，每刻会根据该数据做前端分页显示 |
| isEncrypt |
boolean |
是 |
返回的url是否加密。若为true，请参考上方url加密说明 |
| dataList |
dataListDtos |
是 |
外部单据数据 |
dataListDtos
| 字段名称 |
字段类型 |
必有 |
字段说明 |
| formName |
String |
是 |
事由 |
| formCode |
String |
是 |
外部单据号 |
| submitData |
Long |
是 |
13位毫秒时间戳 |
| submitUser |
String |
是 |
外部单据提单人姓名 |
| formAmount |
AmountInput |
是 |
金额 |
| url |
String |
是 |
需要跳转的url |
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| currency |
String(3) |
是 |
币种，目前是人民币 CNY |
| amount |
BigDecimal |
是 |
金额，可为0或空值 |
响应参数示例
{
"data": {
"recordsTotal": 0,
"dataList": [{
"formName": "事由（必传）",
"formCode": "外部单据id（必传）",
"submitData": 1647402541183,
"submitUser": "提单人",
"formAmount": {
"amount": 91.1,
"currency": "CNY"
},
"url": "跳转url"
}, {
"formName": "事由（必传）",
"formCode": "外部单据id（必传）",
"submitData": "1640966400000",
"submitUser": "提单人",
"formAmount": {
"amount": 91.1,
"currency": "CNY"
},
"url": "跳转url"
}],
"isEncrypt": false
},
"errorMsg": "success",
"success": true
}
每刻系统案例
更新记录
- 2023-07-10 外部接口支持url加密，新增isEncrypt表示是否对url进行加密
- 2023-11-22 返参新增formCode参数，用于外部单据号返回。删除formDataCode参数，此参数会在单据提交成功后自生成一个全局唯一的每刻单据内码，可在单据详情接口查询。
- 2026-02-24 入参新增formCodes参数，用于精确查询外部单据