变更历史

日期	变更描述	变更人	版本
2025/03/13	添加接口出入参字段长度	池宇	V1.2
2020/11/12	添加接口“根据流水号查询发票信息附加税号名称不一致标识”	陈焕威	V1.1
2020/07/08	编写第三方接入规范初稿	李创	V1.0

对接约定

发票云API采用RESTfull的设计方式，客户端通过HTTP协议的GET、POST(目前主要是这两种)方法请求进行调用。
Restful：参考资料
http://www.infoq.com/cn/articles/designing-restful-http-apps-roth
API的调用地址基本上遵循如下约定的方式：
API地址前缀+ 服务 + 资源+ 参数

测试环境: https://api-dev.piaozone.com/test

正式环境: https://api.piaozone.com

**对接过程中需要：**发票云授权标识（client_id）、授权密钥（client_secret）、加密密钥（encrypt_key）进行授权，每个环境的授权不同，获取方式可以找实施人员协助提供

接口返回约定： 若无特别说明，接口返回如下

根据报销单信息查询当前对应的封面/影像/发票

请求方式： POST

数据格式: application/json

请求地址: /m6/bill/expense/message/query/expenseId/thirdparty?reqid=${reqid}&access_token={access_token}

access_token参考：获取AccessToken（下同）

Query参数：

参数名	类型	长度	是否必填	说明	示例
reqid	String	16	是	当前13位毫秒级时间戳加3位随机数字	1661306277676

请求数据：请求的json数据。需采用AES128加密再传输，加密方式参考：JAVA方式、C++方式、C#方式

参数	类型	长度	说明
expenseId	string	最大长度50	报销单id

返回结果：

发票数据格式请参考：进项发票数据格式

请求示例：

根据流水号查询发票信息附加税号名称不一致标识

请求方式： POST

数据格式: application/json

请求地址: m4/bill/fpzs/invoice/verificate/query?reqid=${reqid}&access_token={access_token}

Query参数：

参数名	类型	长度	是否必填	说明	示例
reqid	String	16	是	当前13位毫秒级时间戳加3位随机数字	1661306277676

请求数据：请求的json数据。需采用AES128加密再传输，加密方式参考：JAVA方式、C++方式、C#方式

参数	类型	长度	说明
serialNo	string	最大长度32	发票流水号
taxNo	string	最大长度20	企业税号
companyName	string	最大长度100	企业名称
bxd_key	string	最大长度50	报销单ID
ticketParam	string	4	报销拦截参数:四位数，例1010，参数规则顺序： 0 不允许 1 允许第1位：已报销过的发票是否允许导入第2位：发票抬头与企业名称不一致的发票是否允许导入第3位：发票抬头与税号不一致发票是否允许导入第4位：发票查验不通过的发票是否允许导入

返回结果：

发票数据格式请参考：发票数据规范

接口示例：

根据影像编号查询报销单ID和报销单编号

请求方式： POST

数据格式: application/json

请求地址: /m6/bill/expense/expenseInfo/query/thirdparty?reqid=${reqid}&access_token={access_token}

Query参数：

参数名	类型	长度	是否必填	说明	示例
reqid	String	16	是	当前13位毫秒级时间戳加3位随机数字	1661306277676

请求数据：请求的json数据。需采用AES128加密再传输，加密方式参考：JAVA方式、C++方式、C#方式

参数	类型	长度	说明
scanBillNo	string	最大长度120	影像编号

返回结果：

clientId错误返回结果：

接口示例：
参照：根据报销单信息查询当前对应的封面/影像/发票接口示例

第三方发票报销查询

变更历史#

对接约定#

根据报销单信息查询当前对应的封面/影像/发票#

根据流水号查询发票信息附加税号名称不一致标识#

根据影像编号查询报销单ID和报销单编号#

变更历史

对接约定

根据报销单信息查询当前对应的封面/影像/发票

根据流水号查询发票信息附加税号名称不一致标识

根据影像编号查询报销单ID和报销单编号