1. 概述
為進(jìn)一步優(yōu)化納稅服務(wù)，國(guó)家稅務(wù)總局對(duì)本接口規(guī)范予以發(fā)布，以滿足納稅人內(nèi)部管理信息系統(tǒng)與增值稅防偽稅控系統(tǒng)開(kāi)票子系統(tǒng)的銜接需要。
本接口規(guī)范適用于增值稅防偽稅控系統(tǒng)開(kāi)票子系統(tǒng)V7.23.10及以上版本，配合手工導(dǎo)入、批量自動(dòng)導(dǎo)入和開(kāi)票數(shù)據(jù)導(dǎo)出功能使用。具體操作參見(jiàn)新增改進(jìn)功能操作說(shuō)明。
2. 接口說(shuō)明
（1）待開(kāi)票信息導(dǎo)入接口
通過(guò)增值稅防偽稅控系統(tǒng)開(kāi)票子系統(tǒng)中的手工導(dǎo)入和批量自動(dòng)導(dǎo)入功能，將待開(kāi)票的信息批量導(dǎo)入到增值稅防偽稅控系統(tǒng)開(kāi)票子系統(tǒng)，完成開(kāi)票。
選擇手工導(dǎo)入時(shí)，首先選擇要導(dǎo)入的XML文件，再對(duì)導(dǎo)入開(kāi)票信息逐張保存并打印。
選擇批量自動(dòng)導(dǎo)入時(shí)，首先設(shè)置文件存儲(chǔ)路徑和輪詢時(shí)間。批量自動(dòng)導(dǎo)入開(kāi)啟后，系統(tǒng)自動(dòng)輪詢指定路徑下的XML文件，自動(dòng)完成開(kāi)票，并將開(kāi)具結(jié)果寫(xiě)入指定文件目錄。
（2）已開(kāi)票信息導(dǎo)出接口
通過(guò)增值稅防偽稅控系統(tǒng)開(kāi)票子系統(tǒng)中的開(kāi)票數(shù)據(jù)導(dǎo)出功能，實(shí)現(xiàn)已開(kāi)票信息的批量導(dǎo)出，提供EXCEL文件和XML文件兩種格式選擇。
3. 接口定義
本接口規(guī)范內(nèi)容包括待開(kāi)票信息導(dǎo)入接口和已開(kāi)票信息導(dǎo)出接口。類型為增值稅專用票和增值稅普通票。
(1) 待開(kāi)票信息導(dǎo)入接口規(guī)范
1）導(dǎo)入文件XML格式如下(每個(gè)XML節(jié)點(diǎn)首字母大寫(xiě)):
2 //此文件含有的單據(jù)信息數(shù)量
1 //單據(jù)號(hào)（20字節(jié)）
購(gòu)方名稱 //購(gòu)方名稱（100字節(jié)）
110000000000000//購(gòu)方稅號(hào)
購(gòu)方銀行賬號(hào) //購(gòu)方銀行賬號(hào)（100字節(jié)）
購(gòu)方地址電話 //購(gòu)方地址電話（100字節(jié)）
備注 //備注（240字節(jié)）
fhr //復(fù)核人（8字節(jié)）
skr //收款人（8字節(jié)）
1 //序號(hào)
商品名稱//商品名稱，金額為負(fù)數(shù)時(shí)此項(xiàng)為折扣行數(shù)（100字節(jié)）
規(guī)格型號(hào)//規(guī)格型號(hào)（40字節(jié)）
計(jì)量單位 //計(jì)量單位（32字節(jié)）
100 //單價(jià)
10 //數(shù)量
1000.00 //金額，當(dāng)金額為負(fù)數(shù)時(shí)為折扣行
0.17 //稅率
2 //單據(jù)號(hào)（20字節(jié)）
購(gòu)方名稱1 //購(gòu)方名稱（100字節(jié)）
110000000000000//購(gòu)方稅號(hào)
購(gòu)方銀行賬號(hào)1//購(gòu)方銀行賬號(hào)（100字節(jié)）
購(gòu)方地址電話1//購(gòu)方地址電話（100字節(jié)）
備注1 //備注（240字節(jié)）
fhr1 //復(fù)核人（8字節(jié)）
skr1 //收款人（8字節(jié)）
1 //序號(hào)
商品名稱1//商品名稱，金額為負(fù)數(shù)時(shí)此項(xiàng)為折扣行數(shù)（100字節(jié)）
規(guī)格型號(hào)1//規(guī)格型號(hào)（40字節(jié)）
計(jì)量單位1 //計(jì)量單位（32字節(jié)）
100 //單價(jià)
10 //數(shù)量
1000.00 //金額，當(dāng)金額為負(fù)數(shù)時(shí)為折扣行
0.17 //稅率
2)開(kāi)具結(jié)果回寫(xiě)文件格式
選擇批量自動(dòng)導(dǎo)入時(shí)，每個(gè)XML文件形成一個(gè)開(kāi)具結(jié)果文件，命名規(guī)則為：XML文件名_開(kāi)票結(jié)果.TXT。內(nèi)容為：
開(kāi)具成功的單據(jù)：
[YYYY-MM-DD hh:mm:ss] 單據(jù)號(hào):XXX,開(kāi)具結(jié)果:1(0 失敗，1成功),對(duì)應(yīng)開(kāi)票信息:普通(專用)票,XXXXXXXXXX(代碼),XXXXXXXX(號(hào)碼)
開(kāi)具失敗的單據(jù)：
[YYYY-MM-DD hh:mm:ss] 單據(jù)號(hào):XXX,開(kāi)具結(jié)果:0(0 失敗，1成功),開(kāi)具失敗原因:XXXXXXXXXXXXXXXXXXXX
（2）已開(kāi)票信息導(dǎo)出接口
1）導(dǎo)出文件為XML格式時(shí)，格式如下(每個(gè)XML節(jié)點(diǎn)首字母大寫(xiě)):
2 //此文件含有的開(kāi)票信息數(shù)量
1 //單據(jù)號(hào)（20字節(jié)）
專用票 //種類（專用票或普通票）
1400111560 //類別代碼（10字節(jié)）
00000001 //開(kāi)票號(hào)碼（8字節(jié)）
20140305 //開(kāi)票日期（YYYYMMDD）
購(gòu)方名稱 //購(gòu)方名稱（100字節(jié)）
110000000000000//購(gòu)方稅號(hào)
購(gòu)方銀行賬號(hào) //購(gòu)方銀行賬號(hào)（100字節(jié)）
購(gòu)方地址電話 //購(gòu)方地址電話（100字節(jié)）
銷(xiāo)方名稱 //銷(xiāo)方名稱（100字節(jié)）
110000000000001//銷(xiāo)方稅號(hào)
銷(xiāo)方銀行賬號(hào) //銷(xiāo)方銀行賬號(hào)（100字節(jié)）
銷(xiāo)方地址電話 //銷(xiāo)方地址電話（100字節(jié)）
合計(jì)金額 //合計(jì)金額
合計(jì)稅額 //合計(jì)稅額
備注 //備注（240字節(jié)）
fhr //開(kāi)票人（8字節(jié)）
fhr //復(fù)核人（8字節(jié)）
skr //收款人（8字節(jié)）
1 //序號(hào)
商品名稱//商品名稱（100字節(jié)）
規(guī)格型號(hào)//規(guī)格型號(hào)（40字節(jié)）
計(jì)量單位 //計(jì)量單位（32字節(jié)）
100 //單價(jià)
10 //數(shù)量
1000.00 //金額
0.17 //稅率
170.00 //稅額
2 //單據(jù)號(hào)（20字節(jié)）
普通票 //種類（專用票或普通票）
1400111650 //類別代碼（10字節(jié)）
00000002 //開(kāi)票號(hào)碼（8字節(jié)）
20140305 //開(kāi)票日期（YYYYMMDD）
購(gòu)方名稱 //購(gòu)方名稱（100字節(jié)）
110000000000000//購(gòu)方稅號(hào)
購(gòu)方銀行賬號(hào) //購(gòu)方銀行賬號(hào)（100字節(jié)）
購(gòu)方地址電話 //購(gòu)方地址電話（100字節(jié)）
銷(xiāo)方名稱 //銷(xiāo)方名稱（100字節(jié)）
110000000000001//銷(xiāo)方稅號(hào)
銷(xiāo)方銀行賬號(hào) //銷(xiāo)方銀行賬號(hào)（100字節(jié)）
銷(xiāo)方地址電話 //銷(xiāo)方地址電話（100字節(jié)）
合計(jì)金額 //合計(jì)金額
合計(jì)稅額 //合計(jì)稅額
備注 //備注（240字節(jié)）
fhr //開(kāi)票人（8字節(jié)）
fhr //復(fù)核人（8字節(jié)）
skr //收款人（8字節(jié)）
1 //序號(hào)
商品名稱1//商品名稱（100字節(jié)）
規(guī)格型號(hào)1//規(guī)格型號(hào)（40字節(jié)）
計(jì)量單位1 //計(jì)量單位（32字節(jié)）
100 //單價(jià)
10 //數(shù)量
1000.00 //金額
0.17 //稅率
170.00 //稅額
2）導(dǎo)出文件為EXCEL格式時(shí)，具體格式請(qǐng)參考附件：導(dǎo)出樣例.xls。
售前咨詢