签收流程发票导入接口
说明
通过该接口，根据发票的图片的地址下载发票验真并导入。
注意事项
- 每次最多只能查询50条数据；
- 如果发票状态为空，请传"" ，而不是null；
接口地址
/api/openapi/sign/invoice/url
请求类型
POST
请求参数
参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| smartSignReqDto |
SmartSignReqDto |
是 |
SmartSignReqDto 智能签收请求
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| entCode |
String |
是 |
企业 |
| operator |
String |
是 |
用户code |
| invoiceBagCode |
String |
是 |
发票袋code |
| formQRCode |
String |
是 |
单据的二维码code |
| formDataCode |
String |
是 |
单据code 用来区分是查询单个单据签收详情 如果次字段为空则表示查询发票袋下的所有单据的签收详情 |
| formCode |
String |
是 |
code |
| invoiceImageUrls |
List |
是 |
发票图片的地址 |
| imageStr |
String |
是 |
|
| unKnownEnum |
ProcessUnKnownEnum |
是 |
UNKNOWN_USER 用户不存在,UNKNOWN_DEPARTMENT 部门不存在,UNKNOWN_DEPARTMENT_PRINCIPAL 部门负责人不存在,UNANIMOUS_SKIP 会签情况下，若无人审批时使用， 因为如果直接返回空，会导致该会签节点在act_hi_task表中没有数据，所以需要为会签创建一个相应的task信息 AUTO_COMPLETE 仅仅是为了区分自动通过和跳过，当发现是审核人重复或者审批人重复是会塞这个值 |
| procTaskId |
String |
是 |
|
| signAccount |
boolean |
是 |
是否是签收月结 |
| formDataCodes |
List |
是 |
|
| signSummaryType |
String |
是 |
签收结果统计类型 {signAccount:统计月结签收结果， signInvoice：统计普通签收} |
| signForEnum |
String |
是 |
签收状态 用户筛选 已匹配、匹配失败的数据 {SIGN_FOR:已匹配, SIGN_FOR_FAIL:匹配失败, ALL:所有的数据} |
| signType |
SignAssociatedType |
是 |
用来区分查询普通签收以及月结签收详情 CTRIP,expense,INVOICE,ctrip |
| signManage |
boolean |
是 |
如果是从签收管理里进来的则返回一个任意的任务id，否则返回当前用户的任务id，主要是用来通过或者驳回单据 |
| draw |
int |
|
|
| start |
int |
|
|
| length |
int |
|
|
| columns |
List |
|
|
| order |
List |
|
DataTablesRequestColumnDto
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| data |
String |
|
|
| name |
String |
|
|
| searchable |
boolean |
|
|
| orderable |
boolean |
|
|
| search |
DataTablesRequestColumnSearchDto |
|
DataTablesRequestOrderDto
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| column |
int |
|
|
| dir |
String |
|
DataTablesRequestColumnSearchDto
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| value |
String |
|
|
| regex |
boolean |
|
参数样例
{
"start": 0,
"length": 10,
"entCode": 1336320000000,
"operator": 1336406400000,
"invoiceBagCode": "11010867663556711",
"formQRCode": "单据的二维码code",
"formDataCode": 1675063687693,
"formCode": "11010867663556711",
"imageStr": "11010867663556711",
"unKnownEnum": "11010867663556711",
"procTaskId": "11010867663556711",
"signType": "CTRIP expense INVOICE ctrip",
"signManage": true,
"formDataCodes": [],
"draw": 1,
"columns":[],
"order": []
}
响应参数
响应参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| code |
String |
是 |
枚举值，全局结果 ACK：成功； NACK：失败 |
| message |
String |
是 |
|
| success |
boolean |
是 |
是否成功 |
参数样例
{
"code": "ACK",
"message": "成功",
"success": true
}
修改记录
2023-02-08 新增签收流程发票导入接口文档
2024-03-04 修改文档