浅谈航天防伪开票文本接口文件的解析_航天信息发票接口文档

航天信息防伪税控开票系统开票文本接口文件格式对外是公开的，只要你安装了防伪税控开票系统，就可以在其安装的目录如："C:/Program Files/航天信息/防伪开票/DOC/接口文件示例"的目录下中就可以找到这几个文本文件，而这几个文本文件的作用在文本文件中都有说明，包括需要导入数据的格式说明，如果你做航天防伪开票接口就必须熟悉这个几个文件，目录中这两个文件BILL.TXT和bill_new.txt是必须了解的，都是"销售单据传入文件"只不过一个是旧的格式，一个是新的格式。
1． BILL.TXT文件内容如下：
//适用于功能【 数据接口/开票数据传入】。

//        销售单据传入文件（BILL.TXT）
//  单据号(20) 商品行数(4) 客户名称(50) 税号(15) 地址(50) 银行帐号(50) 备注(160) 复核人(8) 收款人(8)  销方银行帐号(50)
//    货物名称(30) 计量单位(6) 规格(16) 数量(16.6) 金额(14.2) 税率(4.2) 商品类别(20)
//    折扣金额(14.2) 税额(14.2) 折扣税额(14.2) 折扣率(6.3)
// ...
// ...

//单据一：
96110001 3 远方公司1 321000789010001 湖北省武汉市 工行珞珈山办事处 软件价格不包含有偿服务费 张三 李四 保定建行河口办事处
  "财务软件" ,,"四模块" "1", "10300.00",0.17 1510 0
  软磁盘 盒 5" -1 -30.00 0.17 1510 0 -5.12
  软磁盘 盒 3" 1.115 60.00 0.17 1510 10 10.2
 
//单据二：
96110002 5 远方公司2 321000789010005 湖北省武汉市 工行珞珈山办事处
  财务软件 套 四模块 2 20000.00 0.17 1510 3000.1 3400.03 510.02 15.2
  财务软件 套 八模块 2 41000.00 0.17 1510 543.21
  软磁盘 盒 5" 10  400.00  0.17 1510 0
  软磁盘 盒 3.5" 100 6000.00  0.17 1510 0
  硬磁盘 块 1G 1  1300.00 0.17 1510 0

//单据三：
96110003 4 远方公司3 321000789010006 湖北省武汉市 工行珞珈山办事处 软件价格不包含有偿服务费
  财务软件 套 四模块 -1 -10000.00 0.17 1510 0
  财务软件 套 八模块 -1 -20500.00 0.17 1510 0
  硬磁盘 块 3G -2 -4000.00 0.17  1510  0
  精制油 公斤 一级 -10 -600.00 0.17  0302 0

//单据四：
96110004 2 远方公司4 321000789010007 湖北省武汉市 工行珞珈山办事处 软件价格不包含有偿服务费
  财务软件网络版 套 八模块 1 35500.00 0.17 1510 25500.00
  软磁盘 盒 3.5" 10 600.00 0.17  1510 0

//单据五：
96110005 4 远方公司4 321000789010007 湖北省武汉市 工行珞珈山办事处 软件价格不包含有偿服务费
  软磁盘 盒 3.5" 10 600.10 0.17  1510 0
  软磁盘 盒 3.5" 10 600.10 0.17  1510 0
  软磁盘 盒 3.5" 10 600.10 0.17  1510 0
  软磁盘 盒 3.5" 10 600000.10 0.17  1510 0

//单据六：
9611000612qqq678 3 远方公司4 321000789010002 湖北省武汉市 工行珞珈山办事处 软件价格不包含有偿服务费
  软磁盘 盒 3.5" 50 1201.71 0.17  1510 0 204.29
  软磁盘 盒 3.5" 50 909.4 0.17  1510 0 154.6
  软磁盘 盒 3.5" 50 779.49 0.17  1510 0 132.51

//单据七：
96110007 1 远方公司4 321000789010002 湖北省武汉市 工行珞珈山办事处
  软磁盘 盒 3.5" 50 2340 0.17  1510 0 340

//单据八：
96110008 1 远方公司4 321000789010002 湖北省武汉市 工行珞珈山办事处
  软磁盘 盒 3.5" 10 2340 0.17  1510 1170 340

2． bill_new.txt文件内容如下
SJJK0101~~销售单据传入~~11月2日三厂销售业务

//单据一：
2002110001~~3~~远方公司~~321000X89010001~~湖北省武汉市~~工行珞珈山办事处~~软件价格不包含有偿服务费~~张三~~李四
  财务软件~~套~~四模块~~1~~10300.00~~0.17~~1510~~0
  软磁盘~~盒~~5"~~-1~~-30.00~~0.17~~1510~~0~~-5.12
  软磁盘~~盒~~3"~~1~~60.00~~0.17~~1510~~10~~10.2

//单据二：
2002110002~~5~~康托公司~~321000789010005~~湖北省武汉市~~工行珞珈山办事处8734122-2314~~软件价格不包含有偿服务费~~财务软件（详见清单）
  财务软件~~套~~四模块~~2~~20000.00~~0.17~~1510~~3000.1~~3400.03~~510.02~~15.2
  财务软件~~套~~八模块~~2~~41000.00~~0.17~~1510~~543.21
  软磁盘~~盒~~5"~~10~~400.00~~0.17~~1510~~0
  软磁盘~~盒~~3.5"~~100~~6000.00~~0.17~~1510~~0
  硬磁盘~~块~~1G~~1~~1300.00~~0.17~~1510

//单据三：
2002110003~~4~~武汉四通公司~~321000789010006~~湖北省武汉市~~工行珞珈山办事处31211-2134~~软件价格不包含有偿服务费
  财务软件~~套~~四模块~~0~~10000.00~~0.17~~1510~~0
  财务软件~~套~~八模块~~1~~20500.00~~0.17~~1510~~0
  硬磁盘~~块~~3G~~2~~4000.00~~0.17~~1510
  精制色拉油~~公斤~~一级~~10~~600.00~~0.04~~0302~~0

bill_new.txt，由于是新格式所以使用~~作为分隔符，文件的解析比较轻松容易。而BILL.TXT文件是旧的格式，格式定义比较复杂，解析的时候也麻烦点，这也就是航天信息为什么又定义新的格式的原因吧。但现在很多的财务软件进销存软件，如：用友、金蝶、金算盘、管家婆都提供了航天防伪开票文本文件的导出，经财务、进销存软件导出的文本文件，可以使用航天自己的"防伪开票文本接口软件"正确导入，无论你是新的格式或旧的格式。
 在文本文件BILL.TXT中，
//单据一：
96110001 3 远方公司1 321000789010001 湖北省武汉市 工行珞珈山办事处 软件价格不包含有偿服务费 张三 李四 保定建行河口办事处
  "财务软件" ,,"四模块" "1", "10300.00",0.17 1510 0
  软磁盘 盒 5" -1 -30.00 0.17 1510 0 -5.12
  软磁盘 盒 3" 1.115 60.00 0.17 1510 10 10.2
这张销售单据的格式最为复杂，如果你能顺利解析，那么航天的其他示例单据你就可以顺利解析。
笔者认为航天文本格式中双引号("")中的数据，主要是为了解决数据中有空格或其他特殊字符，而使用逗号（,），空格（ ），双波浪号（~~）也主要是起分隔符的作用。明白了这些解析航天防伪开票接口文本格式文件就不难了。其实，解析航天防伪开票接口文本格式文件难的不是格式上的理解，而是字段数据的理解，我们知道在航天自己的"防伪开票文本接口软件"在导入的时候，有个选择项，就是"金额含税"和"金额不含税"，而从字面上理解这个选择并不难，难的是你要在解析过程中理解，据笔者测试航天的文本文件解析，都是以"税额"为基准的，如果"税额"为零，则需要重新计算"税额"，只有在这个时候才使用到"金额含税"和"金额不含税"的选项。如果 "税额"不为零，则不必介意你的数据导入时是"金额含税"和"金额不含税"的选项。反正在航天防伪开票系统中，销项发票明细数据的金额都是以不含税的形式存盘的。你可以通过"税额"和"税率"返算不含税金额。

如果你在解析航天防伪文本接口文件的过程中，有什么感想，欢迎一起讨论。QQ:5733358