1 微信公众号拉起发票列表

2 微信小程序拉起发票列表

3 企业微信拉起发票列表

4 外部App拉起发票列表

5 查询报销发票信息

6 批量查询报销发票信息

7 报销方更新发票状态

8 报销方批量更新发票状态

9 发票报销状态一览表

10 错误码

# 1 微信公众号拉起发票列表

接口说明

本接口功能为在微信公众号拉起发票卡券列表，用户勾选需要提交报销的发票后，开发者获得所选发票的标识信息。

本接口的调用须遵循JS-SDK的调用方法，请在开发前阅读[微信JS-SDK接口文档](http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115&token=&lang=zh_CN" target="_blank)以熟悉开发术语和基本接口的调用。

请求方式

调用chooseInvoice接口

请求参数

返回结果

用户点击确认或取消后，将按下表所列字段格式及含义返回结果。

choose_invoice_info的对象包括以下字段

示例代码

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", 
        }, function(res) {
            alert(JSON.stringify(res));
        }
    });
});

# 2 微信小程序拉起发票列表

接口说明

支持在微信小程序中直接拉起电子发票列表

详细接口文档请参见小程序API发票部分

# 3 企业微信拉起发票列表

接口说明

企业微信2.1新增了选择电子发票的js-API接口，使用企业微信的企业将企业微信更新至2.1以上版本后，可快速实现在企业微信中选中电子发票的功能。

详细接口文档请参见企业微信API电子发票部分。

# 4 外部App拉起发票列表

接口说明

对于自建移动办公应用的企业及为企业提供独立报销App的报销服务商，微信提供了外部App拉起发票列表的接口。与微信内拉起发票列表接口相似，外部App开发者在用户勾选并点击确认后，可以获得发票的标识数据。

该接口须遵循JS-SDK的调用方法，请在开发前务必检查自己是否满足以下条件：

1 获得一个已认证的 微信开放平台 账号；

2 在微信开放平台上创建一个应用并提交应用通过审核。未注册应用的开发者可在开发者应用登记页面进行登记；

3 通读 微信开放平台资源中心 中关于SDK使用的基本方法，并正确导入到自身的应用中。

请求方式

iOS应用

参考压缩包内的OpenSDK1.7.7文件，使用时调用WXChooseInvoice类。其中需要签名的部分，参考JS-SDK的调用方式。 示例代码

—(void)getlnvoiceWithTicket: (NSString*)ticket whenComptetion: (void(^)(NSString* result, NSString*errorDesc) )comptetion{
BOOL isWXApplnstalled = [WXApi isWXApplnstalled]; 
if (!isWXApplnstalled) { // 用户没装微信，直接返回。
completion(nil.,@”Wechat Not installed”);
return;
}
_completion = completion;
WXChooselnvoiceReq *cardReq = [[WXChooselnvoiceReq alloc]initl; 
cardReq. applD = WechatlnvoiceAppld;
cardReq.timeStamp = [[NSDate date]timelntervalSince1970]; 
NSString* timeStamp = [NSString stringWithFormat:@”%d”,cardReq.timeStamp]; 
cardReq. nonceStr = @“sfim_invoice”;

NSString *cardSign = [self genCardSignWithNonceStr: cardReq.nonceStr andTimeStr:
timeStamp andApiTicket:ticket];
cardReq.cardSign = cardSign;
[WXApi sendReq:cardReq];//发送

Android应用

参考压缩包内，进入jar文件，使用时调用ChooseCardFromWXCardPackage类，并传入CardType为“INVOICE”。其中需要签名的部分，参考JS-SDK的调用方式。

返回结果

用户点击确认或取消后，将按下表所列字段格式及含义返回结果。

choose_invoice_info的对象包括以下字段

# 5 查询报销发票信息

接口说明

通过该接口查询电子发票的结构化信息，并获取发票PDF文件。

请求方式

请求URL：https://api.weixin.qq.com/card/invoice/reimburse/getinvoiceinfo?access_token={access_token}

请求方法：POST

请求参数

请求参数使用JSON格式，字段如下:

返回结果

返回结果为JSON格式，字段如下：

当错误码为0时，有以下信息：

user_info包含以下信息：

info为发票项目明细信息。数据格式表现为Object列表，每个Object包含以下信息：

示例代码

请求：
{
    "card_id": "pjZ8Yt5crPbAouhFqFf6JFgZv4Lc",
    "encrypt_code": "fbdt/fWy1VitQwhbKtSjNeR3BJyfpeJXfZjjGsdCXiM="
}
返回：
{
    "errcode": 0,
    "errmsg": "ok",
    "card_id": "pjZ8Yt5crPbAouhFqFf6JFgZv4Lc",
    "begin_time": 1476068114,
    "end_time": 1476168114,
    "user_card_status": "EXPIRE",
    "openid": "obLatjnG4vRXJvSO8p914rSK8-Vo",
    "type": "广东省增值税普通发票",
    "payee": "测试-收款方",
    "detail": "测试-detail",
    "user_info": {
        "fee": 1100,
        "title": "XX公司",
        "billing_time": 1468322401,
        "billing_no": "hello",
        "billing_code": "world",
            "info": [
                {
                    "name": "绿巨人",
                    "num": 10,
                    "unit": "吨",
                    "price": 4
                }
        ],
        "accept": true,
        "fee_without_tax": 2345,
        "tax": 123,
        "pdf_url": "pdf_url",
        " reimburse_status": "INVOICE_REIMBURSE_INIT",
    }
}

# 6 批量查询报销发票信息

接口说明

通过该接口批量查询电子发票的结构化信息，并获取发票PDF文件。

请求方式

请求URL：https://api.weixin.qq.com/card/invoice/reimburse/getinvoicebatch?access_token={access_token}

请求方法：POST

请求参数

请求参数使用JSON格式，字段如下:

item_list每个对象包含以下字段

返回结果

返回结果为JSON格式，字段如下：

当错误码为0时，item_list每个对象包含以下信息：

user_info包含以下信息：

info为发票项目明细信息。数据格式表现为Object列表，每个Object包含以下信息：

示例代码

请求：
{
    "item_list": [
        {
            "card_id": "pjZ8Yt7KKEXWMpETmwG2ZZxX2m6E",
            "encrypt_code": "O/mPnGTpBu22a1szmK2 "
        },
        {
            "card_id": "pjZ8YtxSguaLUaaDqzeAf385soJM",
            "encrypt_code": "O/mPnGTpBu22a1szmK2ogz "
        }
    ]
}
返回：
{
    "errcode": 0,
    "errmsg": "ok",
    "item_list": [
        {
            "user_info": {
                "fee": 123,
                "title": "灌哥发票",
                "billing_time": 1504085973,
                "billing_no": "1504085973",
                "billing_code": "aabbccdd",
                "info": [
                    {
                        "name": "牙膏",
                        "num": 3,
                        "unit": "个",
                        "price": 10000
                    }
                ],
                "fee_without_tax": 2345, 
                "tax": 123, 
                "detail": "项目", 
                "pdf_url": "http://pdfurl", 
                "reimburse_status": "INVOICE_REIMBURSE_INIT", 
                "order_id": "1504085935", 
                "check_code": "check_code", 
                "buyer_number": "buyer_number"
            }, 
            "card_id": "pjZ8Yt7KKEXWMpETmwG2ZZxX2m6E", 
            "openid": "oZI8Fj8L63WugQsljlzzfCcw3AkQ", 
            "type": "广东省增值税普通发票", 
            "payee": "测试-收款方", 
            "detail": "detail"
        }, 
        {
            "user_info": {
                "fee": 123, 
                "title": "灌哥发票", 
                "billing_time": 1504083578, 
                "billing_no": "1504083578", 
                "billing_code": "aabbccdd", 
                "info": [
                    {
                        "name": "牙膏", 
                        "num": 3, 
                        "unit": "个", 
                        "price": 10000
                    }
                ], 
                "fee_without_tax": 2345, 
                "tax": 123, 
                "detail": "项目", 
                "pdf_url": " http://pdfurl", 
                "reimburse_status": "INVOICE_REIMBURSE_INIT", 
                "order_id": "1504083522", 
                "check_code": "check_code", 
                "buyer_number": "buyer_number"
            }, 
            "card_id": "pjZ8YtxSguaLUaaDqzeAf385soJM", 
            "openid": "oZI8Fj8L63WugQsljlzzfCcw3AkQ", 
            "type": "广东省增值税普通发票", 
            "payee": "测试-收款方", 
            "detail": "detail"
        }
    ]
}

# 7 报销方更新发票状态

接口说明

报销企业和报销服务商可以通过该接口对某一张发票进行锁定、解锁和报销操作。各操作的业务含义及在用户端的表现如下：

锁定：电子发票进入了企业的报销流程时应该执行锁定操作，执行锁定操作后的电子发票仍然会存在于用户卡包内，但无法重复提交报销。

解锁：当电子发票由于各种原因，无法完成报销流程时，应执行解锁操作。执行锁定操作后的电子发票将恢复可以被提交的状态。

报销：当电子发票报销完成后，应该使用本接口执行报销操作。执行报销操作后的电子发票将从用户的卡包中移除，用户可以在卡包的消息中查看到电子发票的核销信息。注意，报销为不可逆操作，请开发者慎重调用。

请求方式

请求URL：https://api.weixin.qq.com/card/invoice/reimburse/updateinvoicestatus?access_token={access_token}

请求方法：POST

请求参数

请求参数使用JSON格式，字段如下:

返回结果

返回结果为JSON格式，字段如下：

示例代码

请求：
{
    "card_id": "pjZ8Yt5crPbAouhFqFf6JFgZv4Lc",
    "encrypt_code": "fbdt/fWy1VitQwhbKtSjNeR3BJyfpeJXfZjjGsdCXiM=",
    "reimburse_status": "INVOICE_REIMBURSE_INIT"
}
返回：
{
    "errcode": 0,
    "errmsg": "ok"
}

# 8 报销方批量更新发票状态

接口说明

发票平台可以通过该接口对某一张发票进行锁定、解锁和报销操作，注意，报销状态为不可逆状态，请开发者慎重调用。

注意：

1 报销方须保证在报销、锁定、解锁后及时将状态同步至微信侧，保证用户发票可以正常使用

2 批量更新发票状态接口为事务性操作，如果其中一张发票更新失败，列表中的其它发票状态更新也会无法执行，恢复到接口调用前的状态

请求方式

请求URL：https://api.weixin.qq.com/card/invoice/reimburse/updatestatusbatch?access_token={access_token}

请求方法：POST

请求参数

请求参数使用JSON格式，字段如下:

invoice_list每个对象包含以下字段：

返回结果

返回结果为JSON格式，字段如下：

示例代码

请求：
{
    "openid": "{openid}",
    "reimburse_status": "{reimburse_status}",
    "invoice_list":
    [
        {"card_id":"cardid_1","encrypt_code":"encrypt_code_1"},
        {"card_id":"cardid_2","encrypt_code":"encrypt_code_2"}
    ]
}
返回：
{
    "errcode": 0,
    "errmsg": "ok"
}

# 9 发票报销状态一览表

# 10 错误码