私有化环境:baseUrl={现场部署影像系统的ip或域名:现场部署影像系统的端口}
接口返回约定:若无特别说明,接口返回如下
请求参数:
{"clientId":"vc0c6hjl23gnKCic","sign":"8b9c78fccedbb72eff1106c57505b8f6","timestamp":1463468225650,"fsource":2,"fuserName":"Demo","fphoneNumber":"13826485326","feasUid":1463468225650,"ftaxNo":"91500000747150346A","language":"zh-CN"}请求参数说明:
返回结果:
{"data":{"accessToken":"7ffe2cced2a0e3615a24705ee3","expiresTime":43200,"topic":"影像支撑系统token"},"errcode":"0000","description":"操作成功"}返回字段说明:
说明:文件上传有两种方式:
1.通过MultipartFile对象上传文件
2.通过文件访问地址上传文件
请求地址:
{"file":"选择的文件","hashType":2}请求参数说明:
{"errcode":"0000","description":"操作成功","data":{"fileId":"1bce618476fb45fc96ceb9d89847d9e20","hashCode":"04e699ff70fe9f22a763af91cd4b88caa6c4f45c3734bf373d35b4fc2968b862"}}返回字段说明:
{"fscanBillNo":"KDKDBX-2008-8888","scanOutsideFileVoList":[{"coverFlag":1,"fileId":"f004fd6898bf426ebf728df0e3865a6f0"},{"coverFlag":0,"fileId":"7d4ec48045a54d0f913105b713bae08f0"},{"coverFlag":2,"fileId":"5d4ec48045a54d0f913105b713bae08f0","fcategoryName":"合同"}]}请求参数说明:
scanOutsideFileVoList集合内对象字段说明如下:
{"errcode":"0000","description":"操作成功"}对外影像附件上传api接口请求地址:
{"file":"选择的文件","fscanBillNo":"KDKDBX-2008-8888","fcategoryName":"合同"}请求参数说明:
{"errcode":"0000","description":"操作成功"}删除影像请求地址:
{"fscanBillNo":"KDKDBX-2008-8888","fileIds":["1ecc1a7977b147c2ac81b2f9e41eaae00","44281dd7dc2f45c79368731f49a3a2770"]}请求参数说明:
{"scanBillNo":"KDKDC-02-20190328-03096","deleteReason":"理由"}请求参数说明:
{"errcode":"0000","description":"操作成功"}更新影像状态请求地址:
{"fscanBillNo":"KDKDBX-2008-8888","fscanStatus":4,"rejectReason":"不同意"}请求参数说明:
{"errcode":"0000","description":"操作成功"}影像驳回(单功能接口)说明:联调方传回扫描件影像编号,将单据状态改为待重扫。注意做单据鉴权,是否有权限修改该单据状态。
{"scanBillNo":"KDKDC-02-20190328-03096","rejectReason":"驳回原因"}请求参数说明:
{"errcode":"0000","description":"操作成功"}撤销影像驳回(单功能接口)说明:联调方传回扫描件影像编号,撤销上一次的驳回操作,将单据状态改为已提交。注意做单据鉴权,是否有权限修改该单据状态。
{"scanBillNo":"KDKDC-02-20190328-03096","cancelRejectReason":"驳回撤销原因"}请求参数说明:
{"errcode":"0000","description":"操作成功"}单据审核通过-(单功能接口)说明:对接方传回影像单据编号,将单据状态改为已审核
{"scanBillNo":"KDKDC-02-20190328-03096"}请求参数说明:
{"errcode":"0000","description":"操作成功"}获取单据影像明细请求地址:
{"fscanBillNo":"KDKDBX-2008-8888"}请求参数说明:
scanOutsideFileVoList集合内单个对象字段说明如下:
labelList集合内单个对象字段说明如下:
fileId=b56f8d7e67c945d7b9a263b69abb9e870
请求参数说明:
文件输出流
{"scanBillNo":"KDKDC-04-20210310-00105,KDKDC-04-20210310-00106","fetchSource":null,"isAllowRescan":false,"isAllowEdit":true,"isAllowRemark":false}请求参数说明:
{"fileId":"a0c01862bbc94ccf94bce8e3ad0440990","hashType":2}请求参数说明:
{"errcode":"0000","description":"操作成功","data":{"ffileId":"a0c01862bbc94ccf94bce8e3ad0440990","fhashCode":"6621d1abfcaf654a9eb5e515ee4eb27db0a6bf0f5383f2e7cb5c2b854ae1824a"}}同步收票影像通知接口说明:报销单导入发票完毕,提交单据后通知影像系统同步报销单影像内容。(注意:单据关联发票、附件变更时,需要同步通知影像系统。)
{"fclientId":"2pUf42GBaudn0Y7I1yQN","sign":"298e426464245a92f7a3f9eac8ac5510","fexpenseId":"/rfjhwlTTqKnCIvWU9aO/kpE9J8=","fexpenseNum":"BXD-2020-10-29-00000087","fscanBillNo":"KDBABXD-2020-10-29-00000087","fsource":2,"timestamp":"1603971353050","fcreatorId":"6Ygb9exz","fcreatorName":"老王","fcreatorPhone":"17299999999","fcreatorEmail":"adc@kingdee.com"}请求参数说明:
{"errcode":"0000","description":"操作成功"}{"errcode":"1301","description":"参数校验失败"}{"errcode":"1302","description":"报销单获取失败"}银行回单ocr识别接口请求地址:
{"fileName":"aa.pdf","fileBase64":""}请求参数说明:
{"errcode":"0","description":"ok","data":[{"ftradeId":"22705784-270","fpayeeBank":"中国银行深圳科技园支行","fpaymentBank":"招商银行","fpayeeAccount":"758857937943","fpayeeName":"金蝶软件(中国)有限公司","fpaymentAccount":"6214830236421219","famount":"CNY2,588.50","fpaymentName":"王荣","ftradeDate":null,"fcurrency":null,"floanSign":null,"fbusinessNum":null,"fabstract":null,"fused":null,"ffileName":"aa.pdf","fticketType":"中国银行_国内支付业务收款回单"},{"ftradeId":"26306422-268","fpayeeBank":"中国银行深圳科技园支行","fpaymentBank":"招商银行","fpayeeAccount":"758857937943","fpayeeName":"金蝶软件(中国)有限公司","fpaymentAccount":"6214857822022325","famount":"CNY2,059.90","fpaymentName":"张聪","ftradeDate":null,"fcurrency":null,"floanSign":null,"fbusinessNum":null,"fabstract":null,"fused":null,"ffileName":"aa.pdf","fticketType":"中国银行_国内支付业务收款回单"}]}返回字段说明:
请求参数
{"scanBillNo":"KDBABXD-2020-10-29-00000076","isRemark":false,"isRescan":false,"isEdit":false,"language":"zh_CN"}请求参数说明:
返回结果
{"system":"1","scanBillNo":"KDBABXD-2020-10-29-00000076","accessToken":"323ae962df0dded40a1bbc301379446a"}返回字段说明:
说明:可用于采集银行回单影像采集
返回:
{"fcode":"2020120417144698"//单据编号}返回:
{"errcode":"0000","description":"操作成功","data":{"fid":"11","fcode":"2020120417144698","ftenantNum":"1","ticketTypeNo":22,"ticketType":"中国银行_国内支付业务收款回单","ftradeId":"","fpayeeAccount":"4132558368839","fpayeeBank":"中国银行厦门开元支行蓄业部","fpayeeName":"厦门国贸集团股份有限公司","fpaymentAccount":"02-01430104000005","fpaymentBank":"中国农业银行股份有限公司天津新天地支","fpaymentName":"天津津通报关股份有限公剪","famount":3245.88,"fcurrency":"","ftradeDate":"2020年09月08日","ftradeDateTime":1599494400000,"ftradeType":"贷","ftradeTypeFlag":1,"ftradeNumber":"号;","fuse":"TH/10792604472020090875600027485029062","ffileName":"银行回单test1.PNG","fabstract":"","fuserId":1,"fuserName":"默认管理员账号","fcreateTime":1607073246000,"fupdateTime":1607073246000}}返回字段说明:
{"fileId":"043fda29a97440bd9cdb083a9538a7430"}请求参数说明:
返回:
文件流
说明:推荐使用以下格式接收银行回单明细数据
{"datas":{"infos":[{"fabstract":"","famount":3245.88,"fcode":"2012171652516679043","fcreateTime":1608195166000,"fcurrency":"","fdelFlag":0,"ffileName":"test1.PNG","fid":19,"fileId":"f38fc6f2cd9340bdb1831b29287398ac0","fpayeeAccount":"4132558368839","fpayeeBank":"中国银行厦门开元支行蓄业部","fpayeeName":"xx股份有限公司","fpaymentAccount":"02-01430104000005","fpaymentBank":"xx份有限公司天津新天地支","fpaymentName":"xx","fpushErpFlag":0,"ftenantNum":1,"ftradeDate":"2020年09月08日","ftradeDateTime":1599494400000,"ftradeId":"","ftradeNumber":"号;","ftradeType":"贷","ftradeTypeFlag":1,"fupdateTime":1608195166000,"fuse":"TH10792604472020090875600027485029062","fuserId":155,"fuserName":"liuguangzhong","ticketType":"中国银行_国内支付业务收款回单","ticketTypeNo":22}]}}请求参数说明:
{"errcode":"0000","description":"操作成功"}获取扫描页面地址请求地址:
{"scanBillNo":"KDKDC-02-20190328-03072"}请求参数说明:
{"errcode":"0000","data":{"url":"{URL}userKey=747592019122417190049511"},"description":"操作成功"}返回字段说明:
说明:大文件上传接口需要调用三个接口才能完成一次上传,按先后顺序调用三个接口如下:1.获取文件上传id2.分片上传3.分片合并成大文件
{"fileMd5":"52ef97778fc8c02c2bf2f3d8c071bd05","fileName":"【批量下载】TortoiseSVN-1.9.4.27285-x64-svn-1.9.4等.zip"}请求参数说明:
{"errcode":"0000","description":"操作成功","data":{"uploadId":"d0f62694-0899-479a-897b-8fe7127fb298"##文件上传id}}单文件拆分后的单个分片上传请求地址:
{"chunkMd5":"89e905d9bd3648ac5d441690653c11f9","chunkSize":3568048,"current":5,"fileMd5":"52ef97778fc8c02c2bf2f3d8c071bd05","total":5,"uploadId":"d0f62694-0899-479a-897b-8fe7127fb298","bytes":"d0f626940899479a897b8fe7127fb298"}请求参数说明:
{"errcode":"0000","description":"操作成功"}分片上传完成后的分片合并请求地址:
{"fileMd5":"52ef97778fc8c02c2bf2f3d8c071bd05","fileName":"【批量下载】TortoiseSVN-1.9.4.27285-x64-svn-1.9.4等.zip","finitStatus":0,"fscanBillNo":"20201014000001","fscanSerialNo":"影像0"}请求参数说明:
{"errcode":"0000","description":"操作成功","data":{"fileId":"1bce618476fb45fc96ceb9d89847d9e20"}}调用事例:
{"fscanBillNo":"88888","fbillId":"er_dailyreimbursebill_949790889272690688","fbillTypeCode":"FYBX","fbillTypeDes":"费用报销单","fapplyUserName":"刘德华","fapplyUserPhone":"18818789334","fapplyErpUserName":"liudehua","fapplyOrganizationCode":"ORG_CODE","fapplyOrganizationName":"发票云","fuploadFlag":0,"ferpDataId":"","fsource":"","fadditionalElectricDocs":0}请求参数说明:
{"errcode":"0000","description":"操作成功"}调用方ERP需提供获取单据信息的接口(非影像系统接口)该接口用于ERP推送单据池失败时,影像系统主动通过该接口进行拉取的降级处理
入参:
{"fscanBillNo":"88888"}返回:
{"fscanBillNo":"88888","fbillId":"er_dailyreimbursebill_949790889272690688","fbillTypeCode":"FYBX","fbillTypeDes":"费用报销单","fapplyUserName":"刘德华","fapplyUserPhone":"18818789334","fapplyErpUserName":"liudehua","fapplyOrganizationCode":"ORG_CODE","fapplyOrganizationName":"发票云"}返回字段说明见接口21入参说明
{"fscanBillNo":"88888"}请求参数说明:
{"errcode":"0000","description":"操作成功"}启用/禁用用户接口请求地址:
{"fphoneNumber":"16522331010","fuserName":"cy","fuserEmail":"1110@qq.com","fuserStatus":2,"reason":"离职"}