发票云(标准版)API文档
旗舰版标准版智能特性
旗舰版标准版智能特性
🤖 AI Support​​
  1. 影像
  • 整体介绍
  • 对接约定
  • 授权
    • 获取AccessToken
      POST
  • 开票
    • 产品介绍
    • 开发指南
    • 税控&数电同步开票
      • 业务场景下接口调用顺序
      • 1.01.读取税盘信息(czlx-7)
      • 1.02 .读取票种信息(czlx-30)
      • 1.03.发票开具(czlx-3)
      • 1.04.发票作废(czlx-6)
      • 1.05.发票查询(czlx-5)
      • 1.06.发票打印(czlx-4)
      • 1.07.专用发票申请红字信息表(czlx-20)
      • 1.08.查询专用发票申请红字信息表(czlx-18)
      • 1.09.批量打印(czlx-32)
      • 1.11.机动车销售统一发票开具(czlx-40)
      • 1.12.机动车销售统一发票查询(czlx-41)
      • 1.13.机动车销售统一发票红冲(czlx-42)
      • 1.15.核定票种查询(czlx-51)
      • 1.21.二手车-发票开具(czlx-43)
      • 1.22.二手车-发票查询(czlx-44)
      • 1.23.二手车-发票红冲(czlx-45)
      • 1.30 .查询授信额度接口(czlx-122)
      • 2.01.电子发票开具(czlx-110) ,【注】开数电票请对接:1.03.发票开具(czlx-3)
      • 2.02.电子发票信息查询(czlx-113)
      • 2.03.电子发票红冲 (只支持全额红冲)(czlx-114)
      • 2.04.刷新PDF(czlx-115)
      • 2.05.查询电子发票余量(czlx-116)
      • 3.01.查询税收分类编码信息(czlx-504)
      • 3.03.获取打印机列表(czlx-901)
    • 数电异步开票
      • 异步开票-v4
      • 查询异步开票结果-v4
    • 扫码开票
      • 上传销售单模式扫码开票
        • 接入指南
        • 1.token获取
        • 2.上传发票销售单接口
        • 3.回推接口地址
      • 自定义扫码开票
        • 接入指南
        • 1.对接方按规则组装二维码链接
        • 2.查询开票明细
        • 3.回推接口地址
    • 企业级-发票云销项查询
      • 根据业务条件查询当前企业的销项发票
  • 收票
    • 开发指南
    • 发票数据规范
    • 发票数据
      • 机动车发票数据
      • 火车票数据
      • 火车票退票凭证数据
      • 财政电子票据数据
      • 客运票/轮船票数据
      • 其他发票数据
      • 完税证明数据
      • 飞机票数据
      • 数电票(铁路电子客票)数据
      • 数电票(航空运输电子客票行程单)数据
      • 数电票(专票/普票)数据
      • 的士票数据
      • 定额发票数据
      • 通用机打(纸质/电子)发票数据
      • 过路过桥费数据
      • 二手车票数据
      • 专票和普票数据
      • 通行费发票数据
      • 海关缴款书数据
      • 发票文件数据
    • 企业级-发票云进项查询
      • 根据业务条件查询当前企业采集的发票
      • 根据代码号码查询当前企业采集的发票
      • 根据开票时间范围和采集时间范围查询当前企业采集的发票
      • 根据发票流水号或者发票代码号码查询当前企业采集的发票
      • 根据业务条件查询指定用户采集的发票
    • 税盘&数电票下载
      • 开发指南
      • 1、获取税款所属期信息
      • 2、进项发票表头采集
      • 3、发票不抵扣勾选
      • 4、海关缴款书抵扣勾选(税盘模式不支持)
      • 5、海关缴款书不抵扣勾选(税盘模式不支持)
      • 6、海关缴款书表头采集(税盘模式不支持)
      • 7、全量发票查询
      • 8、当前统计查询
      • 9、历史统计查询
      • 10、生成统计表
      • 11、撤销统计表
      • 12、确认统计表
      • 13、获取当前已勾选或往期已认证发票(税盘模式不支持)
      • 14、当期已勾选或往期已认证缴款书(税盘模式不支持)
      • 15、发票抵扣勾选
    • 电子凭证解析
      • billTypeCode表
      • 解析 + 验签 指定文件的xbrl信息
      • xbrl字符串转json
      • json转xbrl字符串
    • 发票异步下载
      • 进项全量发票采集-异步申请
      • 进项全量发票采集-异步结果查询
    • 发票数据规范
  • 查验识别
    • 开发指南
    • 发票查验(单张)
    • 发票查验(多张异步)
    • 发票识别+查验(单张)
    • 发票识别(多张)
    • 发票识别+查验(多张)
    • 数电票文件识别+查验
    • 返回状态码
  • 报销
    • 发票助手移动端-h5对接
    • 发票助手移动端-小程序对接
    • 第三方发票报销查询
    • 发票助手PC端对接
      • 对接流程
      • JS建立连接通道
      • 采集发票
      • 后端建立通道
      • 查看发票
      • 编辑单张发票
      • 分录操作
      • 常见问题
      • 获取userKey
      • 获取linkKey
      • 缓存单据
      • 保存单据
      • 更新单据状态
      • 根据发票流水号获取发票详细数据
      • 根据userkey查询单据下所有发票列表
      • 删除单据
      • 再次查验
      • 回写入账信息
      • 删除入账信息
  • 影像
    • 开发指南
    • 对接约定
    • 影像系统对接
    • 授权
      • 获取AccessToken(影像系统)
  • 档案
    • 异构系统接口定义
    • 发票返结构体
  1. 影像

影像系统对接

变更历史#

日期变更描述变更人版本
2021/06/06接口规范初版曹云V1.6.0
2021/08/18添加签名方式雷权春V1.8.0
2021/12/13接口补充曹云V2.0.0

对接约定#

获取影像tokn授权
发票云API采用RESTfull的设计方式,客户端通过HTTP协议的GET、POST(目前主要是这两种)方法请求进行调用。
Restful:参考资料
http://www.infoq.com/cn/articles/designing-restful-http-apps-roth
API的调用地址基本上遵循如下约定的方式:
API地址前缀+ 服务 + 资源+ 参数
私有化环境: baseUrl = {现场部署影像系统的ip或域名:现场部署影像系统的端口}
测试环境: baseUrl = https://api-dev.piaozone.com/test
正式环境: baseUrl = https://api.piaozone.com
对接过程中需要: 发票云授权标识(client_id)、授权密钥(client_secret)、加密密钥(encrypt_key)进行授权,每个环境的授权不同,获取方式可以找实施人员协助提供
image
接口返回约定: 若无特别说明,接口返回如下

签名方式#

1.
由client_id + client_secret + timestamp的值MD5加密生成sign。
2.
String checkSign = MD5.md5crypt(client_id + client_secret + timestamp);

获取影像token授权#

请求地址:
类型Post
IP:端口baseUrl
路径/archivebase/scan/login/token
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
clientIdString是企业授权,税号维度
signString是签名(由client_id + client_secret + timestamp的值MD5加密生成)
timestampLong是私有部署可为空,云服务必须传企业授权, 时间戳
fphoneNumberString是用户手机号码
fuserNameString是用户名称
fuserEmailString否用户邮箱
ftaxNoString否用户所在组织企业
feasUidString否该用户在对接系统的用户唯一ID
fsourceInteger是操作系统来源:1-发票云 2-eas 3-星空 4-苍穹 5-OA 6国信 7道克维斯 8单多啦 9优易迅 10 金茂 15 汉德 99其他
languageString否语言版本默认中国, zh-CN:中国、en-US:美国、es-ES :西班牙、fr-FR:法国、de-DE :德国
返回结果:
返回字段说明:
字段名称字段类型说明
accessTokenstring授权token
expiresTimeLong有效时间(秒)

文件上传(带文件加密)#

说明:文件上传有两种方式:
1.通过MultipartFile对象上传文件
2.通过文件访问地址上传文件

文件上传(文件方式)#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/file/upload?access_token={ access_token }
请求参数格式Content-Type: multipart/form-data; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fileMultipartFile是文件
hashTypeint是加密方式:0-无 1-MD5 2-SHA-256
返回结果:
返回字段说明:
字段名称字段类型说明
fileIdString文件存储fileId
hashCodeString文件加密后的值

文件上传(url方式)#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/file/uploadByUrl?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
urlString是文件
hashTypeint是加密方式:0-无 1-MD5 2-SHA-256
fileNameString否文件名
返回结果:
返回字段说明:
字段名称字段类型说明
fileIdString文件存储fileId
hashCodeString文件加密后的值

绑定单据影像关系#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/scanbill/add?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fscanBillNoString是影像编号
scanOutsideFileVoListList是影像集合
scanOutsideFileVoList集合内对象字段说明如下:
字段名称字段类型是否必填说明
coverFlagInt是是否是封面:0-发票 1-封面 2-附件(同一影像编号下只能有一个封面)
fileIdString是文件fileId
fcategoryNameString否影像类型
返回结果:

对外影像附件上传api接口#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/attachment/upload?access_token={ access_token }
请求参数格式Content-Type: multipart/form-data; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fileMultipartFile是文件
fscanBillNoString是影像编号
fcategoryNameString否影像类型
返回结果:

删除影像#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/scanbill/delete?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fscanBillNoString是影像编号
fileIdsList<String>否需要删除的影像fileId集合(为空则根据影像编号删除整单)
返回结果:

删除单据影像-整单删除(独立接口,不可逆)#

类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/delete?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
scanBillNoString是影像编号
deleteReasonString否删除单据原因
返回结果:

更新影像状态#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/scanbill/updateStatus?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fscanBillNoString是影像编号
fscanStatusInt是影像状态:2-影像已提交完毕(影像提交EAS后) 3-影像审核完成(ERP返回审核通过) 4-影像有误待重扫(影像被打回)
rejectReasonstring否退扫原因fscanStatus=4时可传
返回结果:

影像驳回(单功能接口)#

说明:联调方传回扫描件影像编号,将单据状态改为待重扫。注意做单据鉴权,是否有权限修改该单据状态。
请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/reject?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
scanBillNoString是影像编号
rejectReasonstring是驳回原因
返回结果:

撤销影像驳回(单功能接口)#

说明:联调方传回扫描件影像编号,撤销上一次的驳回操作,将单据状态改为已提交。注意做单据鉴权,是否有权限修改该单据状态。
请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/reject/cancel?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
scanBillNoString是影像编号
cancelRejectReasonstring是驳回撤销原因
返回结果:

单据审核通过-(单功能接口)#

说明:对接方传回影像单据编号,将单据状态改为已审核
请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/review?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
scanBillNoString是影像编号
返回结果:

获取单据影像明细#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/scanbill/getInfo?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fscanBillNoString是影像编号
返回结果:
返回字段说明:
字段名称字段类型说明
fscanBillNoString影像编号
scanOutsideFileVoList集合影像文件明细
scanOutsideFileVoList集合内单个对象字段说明如下:
字段名称字段类型说明
fileIdString文件存储fileId
hashTypeInt加密方式:0-无 1-MD5 2-SHA-256
hashCodeString文件加密后的值
fscanTypeInt扫描影像类型:0为封面、1为发票、2为附件
ffileTypeInt文件类型: 1-pdf 2-图片 3-其他 4-Excel 5-word 6-ppt
fscanOrderNoInt上传序号
fileNameString文件名
uploadModeInt影像采集渠道 0.扫描页面-导入附件 1.扫描页面-导入发票 2.扫描页面-启动扫描 3.扫描页面-新增封面-本地上传 4.扫描页面-新增封面-扫描仪上传 5.扫描页面-补扫影像-本地上传-发票 18.扫描页面-补扫影像-本地上传-附件 6.扫描页面-补扫影像-扫描仪导入 7.扫描页面-替扫影像-本地导入 8.扫描页面-替扫影像-扫描仪导入 9.补改页面-启动扫描 10.补改页面-本地导入 11.补改页面-替换封面-本地导入 12.补改页面-替换封面-扫描仪导入 13.收票同步 14.收单机 15.外部接口 16.附件助手 17.其他 18.扫描页面-补扫影像-本地上传-附件 19.扫描页面-导入影像 20.扫描页面-扫码获取
fscanFileAngleString文件旋转角度
labelList集合文件标签集合
labelList集合内单个对象字段说明如下:
字段名称字段类型说明
labelCodeString标签编号
labelNameString标签名称

影像文件下载#

请求地址:
类型Get
IP:端口baseUrl
路径/imgsys/bill/outside/scanbill/getFile?access_token={ access_token }&fileId=b56f8d7e67c945d7b9a263b69abb9e870
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
fileId=b56f8d7e67c945d7b9a263b69abb9e870
请求参数说明:
字段名称字段类型是否必填说明
fileIdString是文件fileId
返回结果:
文件输出流

获取影像调阅页面地址#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/getScanUrl?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
scanBillNoString是影像编号,多个用逗号隔开
fetchSourceInteger否仅当匹配模式下生效:1、展示报销岗的数据 2、展示扫描岗的数据,默认展示扫描岗的数据
isAllowRemarkBoolean否是否允许批注,不填的情况下默认以用户角色权限来控制
isAllowEditBoolean否是否允许补改,不填的情况下默认以用户角色权限来控制
isAllowRescanBoolean否是否允许打回重扫,不填的情况下默认以用户角色权限来控制
返回结果:
返回字段说明:
字段名称字段类型说明
urlString调阅页面地址

对外根据文件id获取文件加密hash值#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/scanbill/getFileHashCode?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fileIdString是文件fileId
hashTypeInt是加密方式: 1-MD5 2-SHA-256
返回结果:

同步收票影像通知#

接口说明:单据导入发票完毕,提交单据后通知影像系统同步单据影像内容。(注意:单据关联发票、附件变更时,需要同步通知影像系统。)
请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/outside/match/fpzs/inform?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fclientIdString是授权ID
signString是授权签名,详情见对接约定中的签名规则部分
timestampString是时间戳
fexpenseIdString是单据ID
fexpenseNumString是单据编号
fscanBillNoString是影像编号
fsourceint是来源类型操作系统来源 1-发票云 2-eas 3-星空 4-苍穹 5-OA 6国信 7道克维斯 8单多啦 9优易迅 10 金茂 15 汉德 99其他
fcreatorIdString否制单人ID
fcreatorNameString是制单人姓名
fcreatorPhoneString是制单人电话号码
fcreatorEmailString否制单人邮箱
返回结果:

获取移动端影像调阅地址接口#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/h5/getH5ViewPageUrl?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数
请求参数说明:
字段名称字段类型是否必填说明
scanBillNoInteger是影像编号
fetchSourceInteger否仅当匹配模式下生效:1、展示报销岗的数据 2、展示扫描岗的数据,默认展示扫描岗的数据
isRemarkBoolean是是否允许批注
isRescanBoolean是是否允许打回重扫
isEditBoolean是是否允许编辑
languageString是语言
返回结果
说明:userKey对应的缓存数据格式:
返回字段说明:
字段名称字段类型说明
h5ViewPageUrlString移动调阅页面地址

银行回单ocr识别接口#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/ocr/bankOcr?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fileNameString是文件名
fileBase64String是文件转化的base64字符串
返回结果:
返回字段说明:
字段名称字段类型说明
ftradeIdString交易流水号
fpayeeBankString收款银行
fpaymentBankString付款银行
fpayeeAccountString收款账户
fpayeeNameString收款人
fpaymentAccountString付款账号
fpaymentNameString付款人
famountString金额
ftradeDateString交易日期
fcurrencyString币种
floanSignString借贷标记
fbusinessNumString业务编号
fabstractString摘要
fusedString用途
ffileNameString文件名
fticketTypeString回单类型

获取银行回单助手页面地址接口#

v1版本#

说明:可用于采集银行回单影像采集(借贷方向是只从回单文件上获取)
请求地址:
类型Get
IP:端口baseUrl
路径/imgsys/bill/erp/bankReceipt/bankReceiptPageUrl?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
返回:
返回字段说明:
字段名称字段类型说明
bankReceiptPageUrlString银行回单采集页面地址

v2版本#

说明:可用于采集银行回单影像采集(原借贷方向是只从回单文件上获取,但是这种准确率太低且不可靠,例如同样一张回单,客户是付款方,那就应该是借,如果是收款方,那就是贷,也就是同样的一张回单,在不同的客户主体上录入,借贷方向是不一致的,因此基于此背景,新增了客户主体的信息用于更优化解析借贷方向)
请求地址:
类型POST
IP:端口baseUrl
路径/imgsys/bill/erp/bankReceipt/bankReceiptPageUrl/v2?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数
请求字段说明:
字段名称字段类型是否必填说明
accountNamesString否银行回单文件录入方的银行帐户号,最多可以同时传入30个,以英文逗号隔开
bankAccountsString否银行回单文件录入方的银行名称,最多可以同时传入30个,以英文逗号隔开
返回:
返回字段说明:
字段名称字段类型说明
bankReceiptPageUrlString银行回单采集页面地址

银行回单查看详情接口#

请求地址:
类型POST
IP:端口baseUrl
路径/imgsys/bill/erp/bankReceipt/detail?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数
返回:
返回字段说明:
字段名称字段类型说明
fcodeString实例对象唯一编号
ticketTypeString回单类型中文描述
ftradeIdString银行交易流水号
fpayeeAccountString收款人账号
fpayeeBankString收款方开户行名称
fpayeeNameString收款人户名
fpaymentAccountString付款人账号
fpaymentBankString付款方开户行名称
fpaymentNameString付款人户名
famountDecimal交易金额
fcurrencyString币种
ftradeDateString交易日期
ftradeTypeString借贷标记
ftradeNumberString业务参考号
fuseString用途
ffileNameString回单文件名
fabstractString摘要
fileIdString扫描件原件存储服务器的文件id

银行回单文件调阅接口#

请求地址:
类型Get
IP:端口baseUrl
路径/imgsys/bill/erp/bankReceipt/view?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数
请求参数说明:
字段名称字段类型是否必填说明
fileIdString是银行回单fileId
返回:
文件流

银行回单回推调用方接口#

说明:推荐使用以下格式接收银行回单明细数据
请求地址:
类型POST
IP:端口baseUrl
路径
请求参数格式Content-Type: application/json; charset=utf-8
请求参数
请求参数说明:
参数名类型说明
fileIdString原件存储服务器的文件id
ticketTypeString回单类型中文描述
ftradeIdString银行交易流水号
fpayeeAccountString收款人账号
fpayeeBankString收款方开户行名称
fpayeeNameString收款人户名
fpaymentAccountString付款人账号
fpaymentBankString付款方开户行名称
fpaymentNameString付款人户名
famountString交易金额
fcurrencyString币种
ftradeDateString交易日期
ftradeTypeString借贷标记---借或者贷
ftradeNumberString业务参考号
fuseString用途
ffileNameString回单文件名
fabstractString摘要
返回:

获取扫描页面地址#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/getHomeUrl?access_token={access_token}
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
scanBillNoString是影像编号(正规流程可以不传此body参数。主要用于兼容扫描时,已经明确影像编号且只采集该影像单据的场景。)
返回结果:
返回字段说明:
字段名称字段类型说明
urlString扫描页面地址

大文件上传#

说明:大文件上传接口需要调用三个接口才能完成一次上传,按先后顺序调用三个接口如下:
1.获取文件上传id
2.分片上传
3.分片合并成大文件

获取文件上传id#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/largeFile/getUploadId?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fileMd5String是文件MD5值
fileNameString是文件名
返回结果:

单文件拆分后的单个分片上传#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/largeFile/uploadChunk?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
chunkMd5String是分片MD5值
chunkSizeString是分片大小
currentint是当前上传分片序号
fileMd5String是大文件MD5值
totalInt是总分片数
uploadIdString是单文件上传id
bytes比特数组(byte[])是分片比特数组
返回结果:

分片上传完成后的分片合并#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/outside/largeFile/mergeFile?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fileMd5String是大文件MD5值
fileNameString是文件名
finitStatusInt是0-继续上传 1-(清除原有影像)重新上传
fscanBillNoString是影像编号
fscanSerialNoString是同一单据下的文件上传序号(如影像0、影像1等)
返回结果:
调用事例:

接收ERP单据推送接口#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/signPost/erpBillPush?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fscanBillNoString是影像编号
fbillIdString是ERP单据唯一值(单据整个生命周期都不可变)
fbillTypeCodeString是单据类型编码
fbillTypeDesString是单据类型名称
fapplyUserNameString是提单人姓名
fapplyUserPhoneString是提单人电话号码
fapplyErpUserNameString是提单人ERP用户名(非姓名)
fapplyOrganizationCodeString是提单组织编码
fapplyOrganizationNameString是提单组织名称
fuploadFlagint是是否允许当前单据走上传流程,0则表示允许上传,1则不允许上传
ferpDataIdString是操作系统的数据中心
fsourceint是操作系统来源:1-发票云 2-eas 3-星空 4-苍穹 5-OA 6国信 7道克维斯 8单多啦 9优易迅 10 金茂 15 汉德 99其他
fadditionalElectricDocsint否当系统配置允许纯电自动提交的情况下,是否允许当前单据自动提交流程,0则表示允许,1则不允许
返回结果:

调用方ERP需提供 获取单据信息的接口(非影像系统接口)#

该接口用于 ERP推送单据池失败时,影像系统主动通过该接口进行拉取的降级处理
入参:
返回:
返回字段说明 见接口21入参说明

接收ERP单据可邮寄通知接口#

请求地址:
类型Post
IP:端口baseUrl
路径/imgsys/bill/signPost/erpBillEnablePost?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fscanBillNoString是影像编号
返回结果:

启用/禁用用户接口#

请求地址:
类型Post
IP:端口baseUrl
路径/archivebase/bill/portal/user/operator?access_token={ access_token }
请求参数格式Content-Type: application/json; charset=utf-8
请求参数:
请求参数说明:
字段名称字段类型是否必填说明
fphoneNumberString否电话(电话、用户名、邮箱三个字段必填其一)
fuserNameString否用户名(电话、用户名、邮箱三个字段必填其一)
fuserEmailString否邮箱(电话、用户名、邮箱三个字段必填其一)
fuserStatusInt是1-启用 2-禁用
reasonString是启用/禁用原因
返回结果:

#

上一页
对接约定
下一页
获取AccessToken(影像系统)
Built with