目录
# 1. 开发准备
在开始开发前，请确认已提前做好以下准备工作：
（1）拥有微信服务号，并且已完成认证；
（2）拥有可以联网的打印机；
（3）拥有云端后台，可以对打印机发出指令。
# 2. 时序图
# 3. 拉起发票列表（微信内）
# 3.1 接口说明
该接口功能为在微信内拉起发票卡券列表（如下图所示），用户勾选需要提交打印的发票后，开发者获得所选发票的标识信息。
本接口的调用须遵循JS-SDK的调用方法，请在开发前阅读JS-SDK说明文档以熟悉开发术语和基本接口的调用。
# 3.2 请求方式
参考示例代码，传入下表中的参数即可成功拉起发票列表页。
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| timestamp | string(32) | 是 | 签名生成的时间戳，采用unix十位时间戳 |
| nonceStr | string(32) | 是 | 用于生成签名的随机字符串，签名生成方法， 参见 6.3 |
| signType | string(32) | 是 | 签名类型，签名生成方法见 参见6.3 |
| cardSign | string(64) | 是 | 发票签名，按照文档 生成完签名后作为参数传入， 参见6.3 |
# 3.3 返回结果
用户点击确认或取消后，将按下表所列字段格式及含义返回结果。
| 返回字段 | 类型 | 值 | 含义 |
|---|---|---|---|
| err_msg choose_invoice | string | ok | 选取发票成功 |
| fail | 选取发票失败 | ||
| cancel | 选取发票取消 | ||
| choose_invoice_info | object | 对象列表 | 用户选中的发票列表 |
choose_invoice_info的对象结构如下
{ card_id = @"", encrypt_code = @"" app_id=@"" }
各字段含义如下：
| 字段 | 类型 | 描述 |
|---|---|---|
| card_id | string | 所选发票卡券的card_id |
| encrypt_code | string | 所选发票卡券的加密code，打印服务商可以通过card_id和encrypt_code获得用户申请打印的发票信息及PDF文档 |
| app_id | string | 开票方的appid |
获得card_id和encrypt_code后，开发者可以按照 查询发票信息并获取PDF文档 一节的方法，获取每张发票的结构化信息及PDF文件。
# 3.4 示例代码
wx.config({
beta: true,
debug: false,
appId: "wx00000000000000",
timestamp: 1489030247,
nonceStr: "(9J4YRV[#@",
signature: "f027317f8910000000000000000000",
jsApiList: ['chooseInvoice']
});
wx.ready(function () {
wx.invoke('chooseInvoice', {
'timestamp': 1489030247, // 卡券签名时间戳
'nonceStr': "p(6N&7WOAF", // 卡券签名随机串
'signType': 'SHA1', // 签名方式，默认'SHA1'
'cardSign': "a72043eed36c74300000000000000000" // 卡券签名
}, function(res) {
alert(JSON.stringify(res));
}
});
});
# 4. 拉起发票列表（外部App）
# 4.1 接口说明
微信也支持外部App拉起发票列表的接口。与微信内拉起发票列表接口相似，在用户勾选并点击确认后，可以获得发票的标识数据。
该接口须遵循JS-SDK的调用方法，并且必须满足一定条件才能调用。请在开发前检查自己是否已满足以下条件：
1 ）获得一个已认证的微信开放平台账号；
2 ）在微信开放平台上创建一个应用并提交应用通过审核。未注册应用的开发者可在开发者应用登记页面进行登记；
3 ）已下载微信电子发票报销SDK，iOS及Android下载地址见电子发票文档资源下载部分；
4 ）通读 微信开放平台资源中心中关于SDK使用的基本方法，并正确导入到自身的应用中。
# 4.2 请求方式
iOS 应用
参考压缩包内的OpenSDK1.7.7文件，使用时调用WXChooseInvoice类。其中需要签名的部分，参考JS-SDK的调用方式。
Android 应用
参考压缩包内，进入jar文件，使用时调用WXChooseCard类，并传入CardType为“INVOICE”。其中需要签名的部分，参考JS-SDK的调用方式。
# 4.3 返回结果
返回结果请与微信内拉起发票列表的返回结果相同，参见3.3。
# 5 查询发票信息并获取PDF文档
# 6 获取api_ticket
# 7 发票签名方法
在应用JS-SDK和App SDK时需要进行签名，以便校验数据传输过程未被篡改，签名实现方法如下：
参与签名参数
| 参数 | 描述 |
|---|---|
| cardType | 填入INVOICE |
| timestamp | 拉起发票列表时使用的时间戳（utc+8） |
| appid | 调用该接口的appid |
| nonceStr | 随机字符串 |
| api_ticket | 通过acess_token换取的临时票据，详情 参见6.3 |
签名方法
将 api_ticket、appid、timestamp、nonceStr、cardType的value值进行字符串的字典序排序。再将所有参数字符串拼接成一个字符串进行sha1加密，得到cardSign。
例如：api_ticket=aaa、appid=aab、timestamp=abc、nonceStr=bbc、cardType=cde，那么先拼成字符串aaaaababcbbccde，再将此字符串进行sha1加密，得到cardSign。