接口說(shuō)明
本接口功能為在微信公眾號(hào)拉起發(fā)票卡券列表,用戶勾選需要提交報(bào)銷的發(fā)票后,開發(fā)者獲得所選發(fā)票的標(biāo)識(shí)信息。
本接口的調(diào)用須遵循JS-SDK的調(diào)用方法,請(qǐng)?jiān)陂_發(fā)前閱讀[微信JS-SDK接口文檔](http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115&token=&lang=zh_CN" target="_blank)以熟悉開發(fā)術(shù)語(yǔ)和基本接口的調(diào)用。
請(qǐng)求方式
調(diào)用chooseInvoice接口
請(qǐng)求參數(shù)
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
timestamp | string(32) | 是 | 時(shí)間戳,采用 unix 十位時(shí)間戳 |
nonceStr | string(32) | 是 | 隨機(jī)字符串 |
返回結(jié)果
用戶點(diǎn)擊確認(rèn)或取消后,將按下表所列字段格式及含義返回結(jié)果。
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
err_msg | string | 是 | ok:選取發(fā)票成功,fail:選取發(fā)票失敗,cancel:選取發(fā)票取消 |
choose_invoice_info | object | 否 | 用戶選中的發(fā)票列表 |
choose_invoice_info的對(duì)象包括以下字段
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
card_id | string | 是 | 所選發(fā)票卡券的 card_id |
encrypt_code | string | 是 | 所選發(fā)票卡券的加密 code ,報(bào)銷方可以通過 card_id 和 encrypt_code 獲得報(bào)銷發(fā)票的信息 |
app_id | string | 是 | 開票方的 appid |
示例代碼
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)); } }); });
接口說(shuō)明
支持在微信小程序中直接拉起電子發(fā)票列表
詳細(xì)接口文檔請(qǐng)參見小程序API發(fā)票部分
接口說(shuō)明
企業(yè)微信2.1新增了選擇電子發(fā)票的js-API接口,使用企業(yè)微信的企業(yè)將企業(yè)微信更新至2.1以上版本后,可快速實(shí)現(xiàn)在企業(yè)微信中選中電子發(fā)票的功能。
詳細(xì)接口文檔請(qǐng)參見企業(yè)微信API電子發(fā)票部分。
接口說(shuō)明
對(duì)于自建移動(dòng)辦公應(yīng)用的企業(yè)及為企業(yè)提供獨(dú)立報(bào)銷App的報(bào)銷服務(wù)商,微信提供了外部App拉起發(fā)票列表的接口。與微信內(nèi)拉起發(fā)票列表接口相似,外部App開發(fā)者在用戶勾選并點(diǎn)擊確認(rèn)后,可以獲得發(fā)票的標(biāo)識(shí)數(shù)據(jù)。
該接口須遵循JS-SDK的調(diào)用方法,請(qǐng)?jiān)陂_發(fā)前務(wù)必檢查自己是否滿足以下條件:
1 獲得一個(gè)已認(rèn)證的 微信開放平臺(tái) 賬號(hào);
2 在微信開放平臺(tái)上創(chuàng)建一個(gè)應(yīng)用并提交應(yīng)用通過審核。未注冊(cè)應(yīng)用的開發(fā)者可在開發(fā)者應(yīng)用登記頁(yè)面進(jìn)行登記;
3 通讀 微信開放平臺(tái)資源中心 中關(guān)于SDK使用的基本方法,并正確導(dǎo)入到自身的應(yīng)用中。
請(qǐng)求方式
iOS應(yīng)用
參考?jí)嚎s包內(nèi)的OpenSDK1.7.7文件,使用時(shí)調(diào)用WXChooseInvoice類。其中需要簽名的部分,參考JS-SDK的調(diào)用方式。 示例代碼
—(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];//發(fā)送
Android應(yīng)用
參考?jí)嚎s包內(nèi),進(jìn)入jar文件,使用時(shí)調(diào)用ChooseCardFromWXCardPackage類,并傳入CardType為“INVOICE”。其中需要簽名的部分,參考JS-SDK的調(diào)用方式。
返回結(jié)果
用戶點(diǎn)擊確認(rèn)或取消后,將按下表所列字段格式及含義返回結(jié)果。
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
err_msg | string | 是 | ok:選取發(fā)票成功,fail:選取發(fā)票失敗,cancel:選取發(fā)票取消 |
choose_invoice_info | object | 否 | 用戶選中的發(fā)票列表 |
choose_invoice_info的對(duì)象包括以下字段
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
card_id | string | 是 | 所選發(fā)票卡券的 card_id |
encrypt_code | string | 是 | 所選發(fā)票卡券的加密 code ,報(bào)銷方可以通過 card_id 和 encrypt_code 獲得報(bào)銷發(fā)票的信息 |
app_id | string | 是 | 開票方的 appid |
接口說(shuō)明
通過該接口查詢電子發(fā)票的結(jié)構(gòu)化信息,并獲取發(fā)票PDF文件。
請(qǐng)求方式
請(qǐng)求URL:https://api.weixin.qq.com/card/invoice/reimburse/getinvoiceinfo?access_token={access_token}
請(qǐng)求方法:POST
請(qǐng)求參數(shù)
請(qǐng)求參數(shù)使用JSON格式,字段如下:
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
card_id | string | 是 | 發(fā)票卡券的 card_id |
encrypt_code | string | 是 | 發(fā)票卡券的加密 code ,和 card_id 共同構(gòu)成一張發(fā)票卡券的唯一標(biāo)識(shí) |
返回結(jié)果
返回結(jié)果為JSON格式,字段如下:
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
errcode | Int | 是 | 錯(cuò)誤碼 |
errmsg | String | 是 | 錯(cuò)誤信息 |
當(dāng)錯(cuò)誤碼為0時(shí),有以下信息:
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
card_id | String | 是 | 發(fā)票 id |
begin_time | Int | 是 | 發(fā)票的有效期起始時(shí)間 |
end_time | Int | 是 | 發(fā)票的有效期截止時(shí)間 |
openid | String | 是 | 用戶標(biāo)識(shí) |
type | String | 是 | 發(fā)票的類型,如廣東增值稅普通發(fā)票 |
payee | String | 是 | 發(fā)票的收款方 |
detail | String | 是 | 發(fā)票詳情 |
user_info | Object | 是 | 用戶可在發(fā)票票面看到的主要信息 |
user_info包含以下信息:
參數(shù) | 類型 | 是否必填 | 描述 |
---|---|---|---|
fee | Int | 是 | 發(fā)票加稅合計(jì)金額,以分為單位 |
title | String | 是 | 發(fā)票的抬頭 |
billing_time | Int | 是 | 開票時(shí)間,為十位時(shí)間戳(utc+8) |
billing_no | String | 是 | 發(fā)票代碼 |
billing_code | String | 是 | 發(fā)票號(hào)碼 |
info | List | 否 | 商品信息結(jié)構(gòu),見下方說(shuō)明 |
fee_without_tax | Int | 是 | 不含稅金額,以分為單位 |
tax | Int | 是 | 稅額,以分為單位 |
如沒特殊注明,文章均為善微網(wǎng)絡(luò)原創(chuàng),轉(zhuǎn)載請(qǐng)注明來(lái)自http://www.tianfbx.com/news/608.html ? |