1、稅控開票服務(wù)器組件接口規(guī)范（標(biāo)準(zhǔn)版）稅控項(xiàng)目組2015 年 9 月.目錄目錄2第一章概述31. 接口概述32. 適用范圍3第二章接口調(diào)用方式41. 本地 ActiveX 組件調(diào)用42. 本地 DLL 調(diào)用6第三章接口定義61. 參數(shù)設(shè)置62. 稅控鑰匙信息查詢73. 發(fā)票開具94. 發(fā)票作廢155. 發(fā)票查詢176. 發(fā)票領(lǐng)購(gòu)信息查詢207. 發(fā)票打印228. 頁(yè)邊距設(shè)置239. 查詢當(dāng)前未開票號(hào)2410. 發(fā)票領(lǐng)購(gòu)信息分發(fā)2611. 發(fā)票領(lǐng)購(gòu)信息退回27.第一章概述1. 接口概述企業(yè)核心業(yè)務(wù)系統(tǒng)通過(guò)接口實(shí)現(xiàn)與稅控開票服務(wù)器的通信，完成發(fā)票管理、發(fā)票開具和稅控服務(wù)器信息查詢功能。 接口根據(jù)調(diào)用

2、方式的不同分為遠(yuǎn)程Servlet接口和本地 ActiveX 組件接口。企業(yè)核心業(yè)務(wù)系統(tǒng)遠(yuǎn)程 Servlet接口稅控服務(wù)器稅控開票服務(wù)器本地 ActiveX 組件開票終端2. 適用范圍本接口規(guī)范僅適用于開票端通過(guò)組件接口ActiveX 控件和 Servlet接口方式訪問(wèn)稅控開票服務(wù)器。.第二章接口調(diào)用方式本地接口提供 ActiveX 控件和 DLL 兩種調(diào)用方式，接口列表見(jiàn)下表。序號(hào)接口 ID接口說(shuō)明其它說(shuō)明120001參數(shù)設(shè)置本地接口220002稅控鑰匙信息查詢本地接口310008發(fā)票開具本地接口410009發(fā)票作廢本地接口510010發(fā)票查詢本地接口610005發(fā)票領(lǐng)購(gòu)信息查詢本地接口720

3、004發(fā)票打印本地接口820003打印頁(yè)邊距設(shè)置本地接口910004查詢當(dāng)前未開票號(hào)本地接口1010006發(fā)票領(lǐng)購(gòu)信息分發(fā)本地接口1110007發(fā)票領(lǐng)購(gòu)信息退回本地接口1. 本地 ActiveX 組件調(diào)用ActiveX 組件文件名： NISEC_SKSCX.ocxActiveX 組件 GUID：CLASSID=clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F函數(shù)定義：String Operate(string sInputInfo);參數(shù)：sInputInfo輸入 XML 信息返回值 :返回結(jié)果 XML 字符串調(diào)用示例：ActiveX組件調(diào)用示例funct

4、ion SetParameter().var sInputInfo =rnrnrn192.168.0.1rn7001rn00000000rnrn;alert(sInputInfo);tryret = sk.Operate(sInputInfo);alert(ret);catch(e)alert(e.message + ,errno: + e.number);function KeyQuery()varsInputInfo=rnrnrn00000000rnrn;alert(sInputInfo);tryret = sk.Operate(sInputInfo);alert(ret);catch(e

5、)alert(e.message + ,errno: + e.number);ActiveX組 件 調(diào) 用 示 例.2. 本地 DLL 調(diào)用DLL文件名： NISEC_SKSC.dll函數(shù)定義：void_stdcallPostAndRecvEx(INLPSTR pszPost,OUT LPSTR pszRecv)參數(shù)：pszPost輸入 XML 信息pszRecv返回 XML 信息返回值 :無(wú)第三章接口定義接口中的 xml 數(shù)據(jù)項(xiàng)，如無(wú)特殊說(shuō)明，遵從以下規(guī)則：金額字段單位統(tǒng)一為元，小數(shù)點(diǎn)后精確到兩位。日期字段格式統(tǒng)一為“ YYYYMMDD”。1. 參數(shù)設(shè)置1.1 接口說(shuō)明參數(shù)設(shè)置接口完成服務(wù)器

6、IP 地址、端口號(hào)和稅控鑰匙口令的設(shè)置功能，僅ActiveX 接口提供該接口，其它接口調(diào)用前必須首先調(diào)用參數(shù)設(shè)置接口。1.2 請(qǐng)求數(shù)據(jù)請(qǐng)求報(bào)文：服務(wù)器 IP 地址 服務(wù)器端口號(hào)稅控鑰匙口令 注冊(cè)碼 .參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是200012comment交易描述30是參數(shù)設(shè)置3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4servletip稅控開票服務(wù)器15是IP 地址5servletport稅控開票服務(wù)器5是端口號(hào)6keypwd稅控鑰匙口令8是7zcm注冊(cè)碼512是1.3 返回?cái)?shù)據(jù)響應(yīng)報(bào)文：返回代碼 返回信息 參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是

7、200012comment交易描述30是獲取服務(wù)器基本信息3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4returncode返回代碼8是0 成功，其它失敗5returnmsg返回信息160是2. 稅控鑰匙信息查詢2.1 接口說(shuō)明提供查詢稅控鑰匙基本信息的接口，主要查詢企業(yè)納稅人識(shí)別號(hào)和稅控鑰匙編號(hào)。僅本地組件接口提供該接口，需要保證稅控鑰匙與本地電腦連接正常。.2.2 請(qǐng)求數(shù)據(jù)請(qǐng)求報(bào)文： 88888888參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是200022comment交易描述30是稅控鑰匙信息查詢3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4keypwd稅控鑰匙口

8、令8是2.3 返回?cái)?shù)據(jù)響應(yīng)報(bào)文：返回代碼 返回信息 納稅人識(shí)別號(hào) 稅控鑰匙編號(hào)參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是200022comment交易描述30是稅控鑰匙信息查詢3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4returncode返回代碼8是0 成功，其它失敗5returnmsg返回信息160是6nsrsbh納稅人識(shí)別號(hào)20否7keyno稅控鑰匙編號(hào)14否前兩位固定為“ 33”.3. 發(fā)票開具3.1 接口說(shuō)明發(fā)票開具接口實(shí)現(xiàn)發(fā)票的正數(shù)開具和負(fù)數(shù)開具，開具成功后由稅控服務(wù)器生成稅控碼，并由本地稅控鑰匙生成發(fā)票簽名。該接口根據(jù)不同的發(fā)票類型，參數(shù)定義不同。3.2 請(qǐng)求

9、數(shù)據(jù)1. 增值稅專用發(fā)票（發(fā)票類型代碼： 004 ）請(qǐng)求報(bào)文：開票終端標(biāo)識(shí)發(fā)票類型代碼發(fā)票請(qǐng)求流水號(hào)開票類型 特殊票種標(biāo)識(shí)銷貨單位識(shí)別號(hào) 銷貨單位名稱銷貨單位地址電話銷貨單位銀行帳號(hào).購(gòu)貨單位識(shí)別號(hào) 購(gòu)貨單位名稱購(gòu)貨單位地址電話購(gòu)貨單位銀行帳號(hào) 清單標(biāo)志 發(fā)票行性質(zhì) 商品名稱 商品稅目 規(guī)格型號(hào) 單位 商品數(shù)量 單價(jià) 金額 稅率 稅額 含稅標(biāo)志 合計(jì)金額 合計(jì)稅額 價(jià)稅合計(jì) 備注 收款人 復(fù)核人 開票人 信息表編號(hào) 原發(fā)票代碼 原發(fā)票號(hào)碼 簽名參數(shù) 參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是100082comment交易描述8是發(fā)票開具3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示

10、國(guó)稅4kpzdbs開票終端標(biāo)識(shí)16是開票終端唯一性標(biāo)識(shí)5fplxdm發(fā)票類型代碼3是6kplx開票類型1是0：正數(shù)票開具1：負(fù)數(shù)票開具7fpqqlsh發(fā)票請(qǐng)求流水號(hào)100否如果為空就不校驗(yàn)，有值就不能重復(fù)8tspz特殊票種標(biāo)識(shí)2是“00”不是“01”農(nóng)產(chǎn)品銷售“02”農(nóng)產(chǎn)品收購(gòu).9xhdwsbh銷貨單位識(shí)別號(hào)20是與稅控服務(wù)器保持一致10xhdwmc銷貨單位名稱100是與稅控服務(wù)器保持一致11xhdwdzdh銷貨單位地址電100是話12xhdwyhzh銷貨單位銀行賬100是號(hào)13ghdwsbh購(gòu)貨單位識(shí)別號(hào)20是14ghdwmc購(gòu)貨單位名稱100是15ghdwdzdh購(gòu)貨單位地址電100是話1

11、6ghdwyhzh購(gòu)貨單位銀行賬100是號(hào)17qdbz清單標(biāo)志1是0：無(wú)清單1：帶清單18fphxz發(fā)票行性質(zhì)1是0 正常行1 折扣行2 被折扣行19spmc商品名稱72是折扣行商品名稱規(guī)則：折扣行數(shù) N（XX.XXX%）20spsm商品稅目20否保留字段，目前為空21ggxh規(guī)格型號(hào)36否22dw單位14否23spsl商品數(shù)量12否小數(shù)點(diǎn)后 6 位24dj單價(jià)12否小數(shù)點(diǎn)后 6 位25je金額12是小數(shù)點(diǎn)后 2 位，正負(fù)26sl稅率12是小數(shù)點(diǎn)后 2 位27se稅額12是小數(shù)點(diǎn)后 2 位，正負(fù)28hsbz含稅標(biāo)志1是0 不含稅1 含稅29hjje合計(jì)金額12是小數(shù)點(diǎn)后 2 位，不含稅，正負(fù)3

12、0hjse合計(jì)稅額12是小數(shù)點(diǎn)后 2 位，正負(fù)31jshj加稅合計(jì)12是小數(shù)點(diǎn)后 2 位，正負(fù)32bz備注150否33skr收款人16否34fhr復(fù)核人16否35kpr開票人20是中文名稱36tzdbh信息表編號(hào)20否37yfpdm原發(fā)票代碼10否38yfphm原發(fā)票號(hào)碼8否38qmcs簽名參數(shù)16否.2. 增值稅普通發(fā)票（發(fā)票類型代碼： 007 ）請(qǐng)求報(bào)文：開票終端標(biāo)識(shí)發(fā)票類型代碼發(fā)票請(qǐng)求流水號(hào)開票類型 特殊票種標(biāo)識(shí)銷貨單位識(shí)別號(hào) 銷貨單位名稱銷貨單位地址電話銷貨單位銀行帳號(hào)購(gòu)貨單位識(shí)別號(hào) 購(gòu)貨單位名稱購(gòu)貨單位地址電話購(gòu)貨單位銀行帳號(hào) 清單標(biāo)志 發(fā)票行性質(zhì) 商品名稱 商品稅目 規(guī)格型號(hào) 單位

13、 商品數(shù)量 單價(jià) . 金額 稅率 稅額 含稅標(biāo)志 合計(jì)金額 合計(jì)稅額 價(jià)稅合計(jì) 備注 收款人 復(fù)核人 開票人 信息表編號(hào) 原發(fā)票代碼 原發(fā)票號(hào)碼 簽名參數(shù) 參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是100082comment交易描述8是發(fā)票開具3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4kpzdbs開票終端標(biāo)識(shí)16是開票終端唯一性標(biāo)識(shí)5fplxdm發(fā)票類型代碼3是6fpqqlsh發(fā)票請(qǐng)求流水號(hào)100否如果為空就不校驗(yàn)，有值就不能重復(fù)7kplx開票類型1是0：正數(shù)票開具1：負(fù)數(shù)票開具8tspz特殊票種標(biāo)識(shí)2是“00”不是“01”農(nóng)產(chǎn)品銷售“02”農(nóng)產(chǎn)品收購(gòu)9xhdwsbh銷貨

14、單位識(shí)別號(hào)20是與稅控服務(wù)器保持一致10xhdwmc銷貨單位名稱100是與稅控服務(wù)器保持一致11xhdwdzdh銷貨單位地址電100是話12xhdwyhzh銷貨單位銀行帳100是號(hào)13ghdwsbh購(gòu)貨單位識(shí)別號(hào)20否14ghdwmc購(gòu)貨單位名稱100是15ghdwdzdh購(gòu)貨單位地址電100否話16ghdwyhzh購(gòu)貨單位銀行帳100否號(hào)17qdbz清單標(biāo)志1是0：無(wú)清單.1：帶清單18fphxz發(fā)票行性質(zhì)1是0 正常行1 折扣行2 被折扣行19spmc商品名稱72是折扣行商品名稱規(guī)則：折扣行數(shù) N（XX.XXX%）20spsm商品稅目20否保留字段，目前為空21ggxh規(guī)格型號(hào)36否22d

15、w單位14否23spsl商品數(shù)量12否小數(shù)點(diǎn)后 6 位24dj單價(jià)12否小數(shù)點(diǎn)后 6 位25je金額12是小數(shù)點(diǎn)后 2 位26sl稅率12是小數(shù)點(diǎn)后 2 位27se稅額12是小數(shù)點(diǎn)后 2 位28hsbz含稅標(biāo)志1是0 不含稅1 含稅29hjje合計(jì)金額12是小數(shù)點(diǎn)后 2 位，不含稅30hjse合計(jì)稅額12是小數(shù)點(diǎn)后 2 位31jshj加稅合計(jì)12是小數(shù)點(diǎn)后 2 位32bz備注160否33skr收款人16否34fhr復(fù)核人16否35kpr開票人20是36tzdbh信息表編號(hào)20否37yfpdm原發(fā)票代碼10否38yfphm原發(fā)票號(hào)碼8否38qmcs簽名參數(shù)16否3.3 返回?cái)?shù)據(jù)響應(yīng)報(bào)文：返回代碼

16、 返回信息 發(fā)票代碼 發(fā)票號(hào)碼 開票日期 稅控碼 校驗(yàn)碼 二維碼 .參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是100082comment交易描述8是發(fā)票開具3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4returncode返回代碼8是0 成功，其它失敗5returnmsg返回信息160是6jqbh稅控服務(wù)器編號(hào)12否7fpdm發(fā)票代碼12否8fphm發(fā)票號(hào)碼8否9kprq開票日期14否YYYYMMDDHHMMSS10skm稅控碼112否4 行，每行 28 個(gè)字符11jym校驗(yàn)碼22否增值稅普票有效，增值稅專票固定為空12ewm二維碼8192否電子發(fā)票有效4. 發(fā)票作廢4.1

17、接口說(shuō)明通過(guò)發(fā)票作廢接口對(duì)已開具的問(wèn)題發(fā)票和未開具的空白發(fā)票進(jìn)行作廢處理。已開發(fā)票作廢要求發(fā)票當(dāng)月開具且未抄報(bào)，空白發(fā)票作廢要求從當(dāng)前第一張未開具發(fā)票開始逐張順序作廢。4.2 請(qǐng)求數(shù)據(jù)請(qǐng)求報(bào)文：開票終端標(biāo)識(shí)發(fā)票類型代碼作廢類型 發(fā)票代碼 發(fā)票號(hào)碼 合計(jì)金額 作廢人 .參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是100092comment交易描述8是發(fā)票作廢3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4kpzdbs開票終端標(biāo)識(shí)16是開票終端唯一性標(biāo)識(shí)5fplxdm發(fā)票類型代碼3是6zflx作廢類型1是0：空白票作廢1：已開票作廢7fpdm發(fā)票代碼10是8fphm發(fā)票號(hào)碼8是9hj

18、je合計(jì)金額8否空白作廢時(shí)為空10zfr作廢人20是4.3 返回?cái)?shù)據(jù)響應(yīng)報(bào)文：返回代碼 返回信息 發(fā)票代碼 發(fā)票號(hào)碼 作廢日期 參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是100092comment交易描述8是發(fā)票作廢3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4returncode返回代碼8是0 成功，其它失敗5returnmsg返回信息160是6fpdm發(fā)票代碼10否7fphm發(fā)票號(hào)碼8否8zfrq作廢日期14否格式 YYYYMMDDHHMMSS.5. 發(fā)票查詢5.1 接口說(shuō)明發(fā)票查詢接口實(shí)現(xiàn)通過(guò)接口讀取稅控服務(wù)器發(fā)票開具明細(xì)信息，可用于發(fā)票補(bǔ)打。按開票日期查詢時(shí)，僅提供查

19、詢一天內(nèi)的發(fā)票明細(xì)；按發(fā)票段查詢時(shí)，僅支持查詢單張發(fā)票明細(xì)。5.2 請(qǐng)求數(shù)據(jù)請(qǐng)求報(bào)文：開票終端標(biāo)識(shí)發(fā)票類型代碼查詢方式 查詢條件 參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是100102comment交易描述8是發(fā)票查詢3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4kpzdbs開票終端標(biāo)識(shí)16是開票終端唯一性標(biāo)識(shí)5fplxdm發(fā)票類型代碼3是6cxfs查詢方式1是0：按發(fā)票號(hào)碼段查詢1：按時(shí)間段查詢7cxtj查詢條件是cxfs 為 0 時(shí)：發(fā)票代碼 +發(fā)票起始號(hào)碼 +發(fā)票終止號(hào)碼cxfs 為 1 時(shí)：起始日期 +終止日期YYYYMMDD5.3 返回?cái)?shù)據(jù)響應(yīng)報(bào)文：.1. 增值稅專

20、用發(fā)票（發(fā)票類型代碼： 004 ）返回代碼 返回信息 發(fā)票代碼 發(fā)票號(hào)碼 發(fā)票狀態(tài) 上傳標(biāo)志 開票日期YYYYMMDDHHMMSS稅控服務(wù)器編號(hào) 稅控碼 校驗(yàn)碼 銷貨單位識(shí)別號(hào) 銷貨單位名稱銷貨單位地址電話銷貨單位銀行帳號(hào)購(gòu)貨單位識(shí)別號(hào) 購(gòu)貨單位名稱購(gòu)貨單位地址電話購(gòu)貨單位銀行帳號(hào)發(fā)票行性質(zhì) 商品名稱 商品稅目 規(guī)格型號(hào) 單位 商品數(shù)量 單價(jià) 金額 稅率 稅額 含稅標(biāo)志 發(fā)票行性質(zhì) 商品名稱 商品稅目 規(guī)格型號(hào) 單位 商品數(shù)量 單價(jià) 金額 .稅率 稅額 含稅標(biāo)志 稅率 金額 稅額 綜合稅率 合計(jì)金額 合計(jì)稅額 價(jià)稅合計(jì) 備注 收款人 復(fù)核人 開票人 加密版本號(hào) 主要商品名稱 商品稅目 清單標(biāo)志 所屬月份 開票機(jī)號(hào) 信息表編號(hào) 原發(fā)票代碼 原發(fā)票號(hào)碼 作廢日期 作廢人 簽名參數(shù) 簽名值 已開負(fù)數(shù)金額2. 增值稅普通發(fā)票（發(fā)票類型代碼： 007 ）格式同增值稅專用發(fā)票.6. 發(fā)票領(lǐng)購(gòu)信息查詢6.1 接口說(shuō)明通過(guò)發(fā)票領(lǐng)購(gòu)信息查詢接口，獲取稅控服務(wù)器指定發(fā)票類型的發(fā)票領(lǐng)購(gòu)信息。6.2 請(qǐng)求數(shù)據(jù)請(qǐng)求報(bào)文： 開票終端標(biāo)識(shí)發(fā)票類型代碼參數(shù)說(shuō)明：索ID名稱長(zhǎng)度必須說(shuō)明引1id交易編號(hào)5是100052comment交易描述8是發(fā)票領(lǐng)購(gòu)信息查詢3yylxdm應(yīng)用類型代碼1是固定為“ 1”表示國(guó)稅4k