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