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