增值稅紙質(zhì)票調(diào)用說明(稅收分類版)V13

發(fā)票管理系統(tǒng)（分類編碼版）

使用說明

版本號：V3.5航天信息廣東有限公司日期：2016年8月一、總體說明系統(tǒng)服務(wù)提供的是HTTP協(xié)議接口。理論上只要請求地址及參數(shù)符合要求都能成功調(diào)用本軟件實現(xiàn)開票等操作。系統(tǒng)規(guī)定參數(shù)傳輸格式為JSON格式。以下提供java版本的調(diào)用方式實例。如若是其他語言需要調(diào)用本系統(tǒng)，可以仿照java版本的調(diào)用方式組織請求參數(shù)提交請求。二、HTTP接口說明接口地址：http://localhost:9876/TaxHttpService/tax_請先讀這里:通過API提交參數(shù)時,參數(shù)內(nèi)容編碼必須為utf-8發(fā)送參數(shù)的key統(tǒng)一為inputJson,參數(shù)格式為JSON字符串格式。例如獲取下張發(fā)票接口:http://localhost:9876/TaxHttpService/tax_getInfo參數(shù):inputJson={"infoKind”:O}返回參數(shù)為json字符串格式，具體鍵值對如下。注意:鍵值表中紅色字體標(biāo)示必填,灰色背景的表示不用,但是要傳空值.另外,以下實例均為get請求方式，建議在實際使用時采用post請求方式發(fā)送參數(shù)，避免參數(shù)截斷的情況發(fā)生.1.打開金稅卡打開金稅卡是執(zhí)行其他開票業(yè)務(wù)的前提，并且，每次使用程序只需要打開一次金稅卡，然后調(diào)用其他接口，直到程序關(guān)閉。參數(shù)說明：發(fā)送參數(shù)例如:http://localhost:9876/TaxHttpService/taxopenCardkey類型描述Value無接收參數(shù)例如：{"TaxCode":"123456789012345","MachineNo":0,"RetMsg":"金稅卡成功開啟","RetCode":"1011",TsInvEmpty":0,"IsLockReached":0,"IsRepReached":0}key類型長度描述ValueRetCodeString4字節(jié)返回碼1011:打開成功3001:已經(jīng)打開1001:打開失敗1007:金稅卡已被占用RetMsgString200字節(jié)返回描述

TaxCodeString20字節(jié)稅號MachineNoInt5字節(jié)分機號IsInvEmptyInt1字節(jié)是否有發(fā)票InvLimitdoubleWqzpW專票開票限額IsLockReachedInt1字節(jié)鎖死期0未鎖死,1鎖死IsRepReachedint1字節(jié)抄稅期0未到抄稅期，已到抄稅期獲取發(fā)票信息查詢下張發(fā)票的信息或者查詢是否有下張發(fā)票參數(shù)說明：發(fā)送參數(shù)例如：http://localhost:9876/TaxHttpService/tax_getInfo參數(shù):inputJson={"infoKind":2}key類型長度描述ValueinfoKindint2字節(jié)發(fā)票種類0專用發(fā)票,2普通發(fā)票接收參數(shù)例如:{"InfoTypeCode":"1234567890","InfoNumber":"123456","TaxClock":"2014-05-0509:13:44","RetMsg":"讀取發(fā)票信息成功","RetCode":"3011","infoKind":"0","InvStock":983}key類型長度描述ValueRetCodeString4字節(jié)返回碼3011:查詢成功3001:查詢失敗RetMsgString200字節(jié)返回描述TaxClockString50字節(jié)當(dāng)前時間yyyy-MM-ddHH:mm:ss格式時間InfoTypeCodeString20字節(jié)開具發(fā)票的十位代碼。infoNumberString8字節(jié)下次開票的八位號碼。infoKindString2字節(jié)發(fā)票種類0專用發(fā)票,2普通發(fā)票InvStockString10字節(jié)剩余發(fā)票數(shù)量

作廢發(fā)票作廢發(fā)票參數(shù)說明發(fā)送參數(shù)例如：http:〃localhost:9876/TaxHttpService/tax_cancel參數(shù):inputJson={"infoKind":2，‘typeCode”:“1234567890”"num'':"12345678''}key類型長度描述ValueinfoKindint2字節(jié)發(fā)票種類0專用發(fā)票,2普通發(fā)票typeCodeString20字節(jié)要作廢的發(fā)票代碼numString8字節(jié)要作廢的發(fā)票號碼接收參數(shù)例如:{"InfoTypeCode":"1234567890","InfoNumber":"123456","TaxClock":"2014-05-0509:13:44","RetMsg":"讀取發(fā)票信息成功","RetCode":"3011","infoKind":"0","InvStock":983}key類型長度描述ValueRetCodeString4字節(jié)返回碼6001：當(dāng)月發(fā)票庫未找到該發(fā)票。6002:該發(fā)票已作廢。:作廢成功。:未作廢。:作廢失敗。RetMsgString200字節(jié)返回描述4.打印發(fā)票作廢發(fā)票參數(shù)說明：發(fā)送參數(shù)例如：http:〃localhost:9876/TaxHttpService/tax_print參數(shù):inputlson={"infoKind":2,"typeCode”:“1234567890”"num”:"12345678”"printType':0,'confirmWin”:”0”}key類型長度描述ValueinfoKindInt2字節(jié)發(fā)票種類0專用發(fā)票,2普通發(fā)票typeCodeString20字節(jié)要打印的發(fā)票代碼numString8字節(jié)要打印的發(fā)票號碼

printTypeInt1字節(jié)打印類型0打印發(fā)票,1打印清單confirmWinInt1字節(jié)預(yù)覽0不預(yù)覽,1預(yù)覽接收參數(shù)key類型長度描述ValueRetCodeString4字節(jié)返回碼5001:未找到發(fā)票或清單。:打印成功。:未打印。:打印失敗。RetMsgString200字節(jié)返回描述5.開具增值稅發(fā)票信息開具發(fā)票接口參數(shù)說明稅局相關(guān)政策要求,發(fā)票開具的明細(xì)行需要指定分類編碼,所以接口需要進行調(diào)整,新增下列紅色部分字段發(fā)送參數(shù)例如：http://localhost:9876/TaxHttpService/tax_invoice參數(shù):inputJson:'{"billCode":"12345689","cAddress":'凍風(fēng)南方廣大","cBank":"工商銀行","cName":"c","cTaxCode":"111111111111111","cancelFlag":0,"cashier":'張三"「checker":"李四,"correspondingNumber":"","correspondingTypeCode":"","details":["zeroTax":"","taxDeduction":"","goodsNoVer":"1?0","goodsTaxNo":"10101013301","taxPre":"0","taxPreCon":免稅","amount":100,"discountAmount":0,"discountFlag":0,"discountRate":0,"goodsName":'備件","number":1,"price":100,"priceKind":1,"sequence":0,"standard":"","taxAmount":14.53,"taxItem":"","taxRate":17,"unit":"-"}],"discountFlag":0,"infoKind":2,"infoNumber":"","infoTypeCode":"","invoicer":"1","listName":"銷貨清單","negNoticeNo":"","negativeFlag":0,"notes":"","sAddress":"sAddress","sBank":"sBank","taxRate":17,"totalAmount":2000,"totalTaxAmount":234}'發(fā)票主體鍵值key類型長度描述ValueIsRequirebillCodeString20字節(jié)單據(jù)號否，若傳入則會判斷唯一。infoKindInt2字節(jié)發(fā)票類型0專用發(fā)票,2普通發(fā)票是cNameString100字節(jié)購方名稱是

cAddressString100字節(jié)購方地址電話專用發(fā)票必選，普通發(fā)票可選cBankString100字節(jié)購方銀行賬號專用發(fā)票必選，普通發(fā)票可選cTaxCodeString20字節(jié)購方稅號專用發(fā)票必選，普通發(fā)票可選taxRateInt2字節(jié)稅率17,6,11等等必選cashierString8字節(jié)最長4個中文字收款人可選checkerString8字節(jié)最長4個中文字復(fù)核人可選invoicerString8字節(jié)最長4個中文字開票人必選listNameString10字節(jié)是否開具清單1表示開清單,空表示不開清單可選sAddressString100字節(jié)銷方地址電話專用發(fā)票必選，普通發(fā)票可選sBankString100字節(jié)銷方銀行賬號專用發(fā)票必選，普通發(fā)票可選notesString240字節(jié)備注若需開具紅字發(fā)票專票的需要添加“開具紅字增值稅專用發(fā)票信息表編號XXXXXXXXXXXXXXX"普票的需要添加“對應(yīng)正數(shù)發(fā)票代碼:XXXX號碼:XXXX”且需頂格，譬如有自定義的備注信息，需設(shè)置為：“對應(yīng)正數(shù)發(fā)票代碼:XXXX號碼:XXXX訂單號:XXX”detailsArray發(fā)票明細(xì)多條明細(xì)，每條明細(xì)參見明細(xì)鍵值表格必選cancelFlag作廢標(biāo)記可選

totalAmount總金額可選totalTaxAmount總稅額可選correspondingNumber對應(yīng)藍(lán)票號碼負(fù)數(shù)票時需要填入可選correspondingTypeCode對應(yīng)藍(lán)票代碼負(fù)數(shù)票時需要填入可選discountFlag折扣標(biāo)記可選negativeFlag負(fù)數(shù)標(biāo)志可選negNoticeNo通知單號專用發(fā)票且是負(fù)數(shù)票時需要輸入可選infoNumber發(fā)票號碼可選infoTypeCode發(fā)票代碼可選發(fā)票明細(xì)鍵值key類型長度描述ValueIsRequireamountDouble金額最多精確到小數(shù)點后2位必選goodsNameString100字節(jié)商品名稱必選目前折扣行是，譬如只往上折扣一行時goodsname寫成折扣(00.000%)；往上折扣多行譬如4時goodsname寫成折扣行數(shù)4(00.000%)括號都用半角百分比就是折扣金額除以往上折扣行數(shù)的總正數(shù)金額的絕對值numberDouble商品數(shù)量最多精確到小數(shù)點后8位可選pricedouble單價最多精確到小數(shù)點后8位可選unitString32字節(jié)單位可選

priceKindInt1字節(jié)含稅標(biāo)記0不含稅,1含稅必選standardString40字節(jié)商品規(guī)格可選taxRateInt2字節(jié)稅率17,6,11等等必選taxitemString4字節(jié)稅目4位數(shù)字可選新增字段goodsNoVer;//編碼版本固定1.0（必填）goodsTaxNo;//稅收分類編碼長度19字節(jié)（必填可選30101010102做測試）taxPre;//優(yōu)惠政策0不享受,1享受長度1字節(jié)（必填默認(rèn)為0不享受）taxPreCon;//-優(yōu)惠政策內(nèi)容：免稅長度20字節(jié)（選填）zeroTax;//零稅率標(biāo)志為空:非零稅率,0出口退稅,1免稅,2不征收,3普通零稅率長度2字節(jié)（選填）cropGoodsNo;//自編碼長度100字節(jié)taxDeduction;//差額扣除額數(shù)字（選填）taxAmountString稅額可選discountFlagString折扣標(biāo)記可選discountRateString折扣率可選sequenceString行號可選接收參數(shù)key類型長度描述ValueRetCodeString4字節(jié)返回碼4001:傳入數(shù)據(jù)不合法。

4002：開票前金稅卡狀態(tài)錯。4003:金稅卡開票調(diào)用錯誤。4004：開票后取金稅卡狀態(tài)錯。4011：開票成功。4012：開票失敗。