第三方APP调用小程序授权准备

1、进入微信开放平台创建企业自己的移动应用：https://open.weixin.qq.com/

2、填写基本信息，平台信息需要填写android、ios具体信息

3、提交审核通过后，进入该应用进行小程序关联

4、进行微信认证

第三方APP集成拉取小程序SDk

具体打开方式参考微信官方网站**

https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=21526646437Y6nEC&token=&lang=zh_CN

发票云小程序参数说明：

参数名	类型	长度	是否必须	备注	值
userName	String	15	是	小程序原始ID	生产：gh_bfa83b5cd310 测试：gh_cb39a37583e3
path	String	-	是	跳转小程序路径	"pages/index/index?scene=${userKey}&source=app" userKey由下方接口获取
miniprogramType	int	1	是	小程序模式	0

Android开发示例

开发前需到微信开发平台下载Android开发工具包（SDK），可在“资源中心-开发资源-资源下载-Android资源下载”按照指引操作。

调用接口：WXLaunchMiniProgram

移动应用跳转到小程序示例：

回调说明

iOS开发示例

开发前需到微信开发平台下载iOS开发工具包（SDK），可在“资源中心-开发资源-资源下载-iOS资源下载”按照指引操作。

移动应用跳转到小程序示例：

回调说明

第三方APP内部是H5页面对接则需要向前端提供js桥方法进行对接，如文档下方“云之家案例”

对接约定

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

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

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

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

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

调用小程序前，需要先获取userKey

获取userKey接口地址： baseUrl/m4/bill/wmp/get/user/key?access_token=${access_token}

请求方式： POST

请求content-type格式： application/json

请求的全部参数：

token的获取方式和其它接口一致

参数名	是否必须	长度	备注
bxd_key	是	最大长度50	报销单ID，如果需要同步附件信息，则必传
timestamp	是	13	用于签名验证
clientId	是	最大长度30	发票云分配的应用clientId
ghf_mc	是	最大长度100	购货方名称（校验发票抬头是否一致时使用）
tin	是	最大长度20	企业税号
cid	是	最大长度160	接入企业的用户ID
sign	是	32	签名, 签名规则见对接约定, clientSecret和clientId由发票云分配
encType	否	1	签名加密类型 0：MD5、1：SHA256、2：HMAC SHA256，不传默认MD5加密
random	是	-	随机码
ticketParam	是	5	过滤规则，格式如：1101
salerName	否	最大长度100	单据限制销方名称
salerTaxNo	否	最大长度20	单据限制销方税号
billType	否	是	单据类型
assembleByBillType	否	-	是否按单据类型(billType)组装推送给APP的数据。 1：组装；其他不组装
optMode	否	1	非必须，操作模式，0正常（默认） 1仅附件上传

ticketParam 参数规则顺序： 0 不允许 1 允许

第1位：已报销过的发票是否允许导入

第2位：发票抬头与企业名称不一致的发票是否允许导入

第3位：发票抬头与税号不一致发票是否允许导入

第4位：发票查验不通过的发票是否允许导入

billType参数规则：

参数值	备注
Tra	智能差旅行程单
Pur	智能物品采购报销单
BizOut	智能对公报销单
""	费用报销单传空字符串

请求的返回值：

导入发票跳转回App或小程序后，再次导发票请重新获取userkey避免失效

获取授权access_token

API地址前缀：基本不变的API访问URL地址，如下：

流程图：

接口请求说明：

http请求方式：POST

获取token接口地址： baseUrl/base/oauth/token

请求数据结构

请求参数描述：

参数	类型	长度	是否必须	描述
client_id	string	最大长度30	是	发票云授权标识
sign	String	32	是	签名，签名规则见对接约定
encType	Int	1	否	签名加密类型 0：MD5、1：SHA256、2：HMAC SHA256，不传默认MD5加密
timestamp	long	13	是	时间戳

返回参数描述：

参数	类型	长度	描述
access_token	string	最大长度255	用于后续访问的令牌，随机字符串
token_type	String	6	字符串，令牌类型，可以不用关注, 目前固定bearer
expires_in	string	-	长整型，令牌在多少秒内有效，单位为秒
errcode	String	4	操作结果码
description	string	-	操作描述

失败信息：

案例云之家轻应用

接口调用代码（js需客户方自己提供....）

参数说明

参数	类型	长度	描述
userName	String	15	小程序原始ID （"gh_bfa83b5cd310"）注意：每个环境对应的小程序不同，则原始ID要注意更换
path	String	-	"pages/index/index?scene=${userkey}&source=app";拉起小程序页面路径（app为固定值）
miniprogramType	Int	1	0 小程序的版本

回调说明

常见的对接问题

提示二维码失效

注：出现上述图1，图2问题，解决流程如下。

1：先通过图3（我的--新手指导）检查当前环境是什么小程序。

2：检查客户配置（如下图：苍穹费用报销）的发票云小程序id和小程序模式是否跟图3匹配。

参数说明

名称	userName	miniprogramType	对应环境	小程序版本名称
金蝶发票云	gh_bfa83b5cd310	0	生产 api.piaozone.com	pwy-release x.x.x
票无忧100	gh_cb39a37583e3	0	测试 api-dev.piaozome.com/test	pwy-test x.x.x

注：

1：云之家客户仅绑定了一个小程序，因此，切换环境调试时，只需要修改对应的 miniprogramType 值，userName 不变；对接测试环境时跳转小程序后可能需要给用户添加访问权限

2：其他App客户如果同时绑定金蝶发票云和票无忧100 了，则只需要调整userName即可切换调试环境

小程序返回App并传递发票，附件数据

数据接收方式请参考上面android和ios示例中的回调部分

发票云返回的数据格式如下

消息格式： {"type":"selectedInvoices", data: {}}

type为saveBill时为导入时的发票数据

费用单据的数据格式：billType为空字符串

智能差旅行程单的数据数据格式, billType为：Tra

智能物品采购单据-数据数据格式, billType为：Pur

智能对公单据-数据数据格式, billType为：BizOut

以上操作为移动端界面通过小程序采集发票流程

报销单据与发票关系处理(重点)

请查看接口文档11.0：发票助手PC web端对接

报销单据上查看关联发票(重点)

1.1 通过报销单ID查询

接口地址：baseUrl/m4/fpzs/bxdInvoices?bxd_key={报销单ID}&client_id={创建当前报销单的发票云授权标识}&timestamp={时间戳}&sign={签名}

请求方式： GET

参数说明

参数	类型	长度	描述
bxd_key	String	最大长度50	报销单ID
client_id	String	最大长度30	创建当前报销单的发票云授权标识
timestamp	String	13	时间戳
sign	String	32	签名规则见对接约定, clientSecret和clientId由发票云分配
encType	Int	1	签名加密类型 0：MD5、1：SHA256、2：HMAC SHA256，不传默认MD5加密

请求接口参数示例

1.2 单据分录上通过事件代码查询

接口地址：baseUrl/m4/fpzs/expense/invoices/certifacate/query?event_code=${eventCode}

请求方式： GET

参数说明

参数	类型	长度	描述
envent_code	String	-	事件代码（如下接口获取）

1.2.1获取事件代码eventCode=f2adb2cb45a3ac1b129c581102a0d266

接口地址： baseUrl/base/oauth/eventCode

请求方式： POST

请求content-type格式： application/json

参数说明

参数	类型	长度	描述
client_id	String	最大长度30	创建当前报销单的发票云授权标识
timestamp	String	13	时间戳
sign	String	32	签名规则见对接约定, clientSecret和clientId由发票云分配
encType	Int	1	签名加密类型 0：MD5、1：SHA256、2：HMAC SHA256，不传默认MD5加密
type	String	22	EXPENSE_SERIALNO_QUERY //固定值
buyerName	String	最大长度100	购方抬头
buyerTaxNo	String	最大长度20	购方税号
ticketParam	String	5	发票校验过滤规则，格式如：1101
certifacateSerialNos	Array	-	附件流水号
invoiceSerialNos	Array	-	发票流水号
expenseId	String	最大长度50	报销单ID

请求接口参数示例

小程序跳转小程序对接收票流程

客户小程序跳转

参数说明

参数	类型	长度	描述
appId	String	18	目标小程序应用ID（测试环境：wxb5de26c7f5dc89c6 ，生产环境：wxa3a3844ae7205f76 ）
userKey	String	32	由上诉接口获取

客户小程序接收

数据说明

通过流水号获取发票，附件详情

查看文档：发票助手PC web端对接

发票助手移动端-小程序对接

第三方APP调用小程序授权准备#

第三方APP集成拉取小程序SDk#

具体打开方式参考微信官方网站**#

发票云小程序参数说明：#

Android开发示例#

iOS开发示例#

对接约定#

调用小程序前，需要先获取userKey#

获取授权access_token#

案例 云之家轻应用#

常见的对接问题#

小程序返回App并传递发票，附件数据#

报销单据与发票关系处理(重点)#

报销单据上查看关联发票(重点)#

小程序跳转小程序对接收票流程#

第三方APP调用小程序授权准备

第三方APP集成拉取小程序SDk

具体打开方式参考微信官方网站**

发票云小程序参数说明：

Android开发示例

iOS开发示例

对接约定

调用小程序前，需要先获取userKey

获取授权access_token

案例云之家轻应用

常见的对接问题

小程序返回App并传递发票，附件数据

报销单据与发票关系处理(重点)

报销单据上查看关联发票(重点)

小程序跳转小程序对接收票流程