文档介绍：发票管理系统(分类编码版)
使用说明
版本号:
航天信息广东有限公司
日期:2016年8月
总体说明
系统服务提供的是HTTP协议接口。理论上只要请求地址及参数符合要求都能成功调用本软件实现开票等操作。
系统规定参数传输格式为JSON格式。以下提供java版本的调用方式实例。如若是其他语言需要调用本系统,可以仿照java版本的调用方式组织请求参数提交请求。
HTTP接口说明
接口地址:http://localhost:9876/TaxHttpService/tax_
请先读这里:  
通过API提交参数时, 参数内容编码必须为utf-8
发送参数的key统一为inputJson,参数格式为JSON字符串格式。例如获取下张发票接口:http://localhost:9876/TaxHttpService/tax_ getInfo
参数:inputJson={“infoKind”:0}
返回参数为json字符串格式,具体键值对如下。
注意:键值表中红色字体标示必填,灰色背景的表示不用,但是要传空值.
另外,以下实例均为get请求方式,建议在实际使用时采用post请求方式发送参数, 避免参数截断的情况发生.
打开金税卡
打开金税卡是执行其他开票业务的前提,并且,每次使用程序只需要打开一次金税卡,然后调用其他接口,直到程序关闭。
参数说明:
发送参数
例如: http://localhost:9876/TaxHttpService/tax_ openCard
key
类型
描述
Value
无
接收参数
例如: {"TaxCode":"123456789012345","MachineNo":0,"RetMsg":"金税卡成功开启","RetCode":"1011","IsInvEmpty":0,"IsLockReached":0,"IsRepReached":0}
key
类型
长度
描述
Value
RetCode
String
4字节
返回码
1011:打开成功
3001:已经打开
1001:打开失败
1007:金税卡已被占用
RetMsg
String
200字节
返回描述
TaxCode
String
20字节
税号
MachineNo
Int
5字节
分机号
IsInvEmpty
Int
1字节
是否有发票
InvLimit
double
专票开票限额
IsLockReached
Int
1字节
锁死期
0未锁死,1锁死
IsRepReached
int
1字节
抄税期
0未到抄税期,已到抄税期
获取发票信息
查询下张发票的信息或者查询是否有下张发票
参数说明:
发送参数
例如:http://localhost:9876/TaxHttpService/tax_ getInfo
参数:inputJson={"infoKind":2}
key
类型
长度
描述
Value
infoKind
int
2字节
发票种类
0专用发票,2普通发票
接收参数
例如: {"InfoTypeCode":"1234567890","InfoNumber":"123456","TaxClock":"2014-05-05 09:13:44","RetMsg":"读取发票信息成功","RetCode":"3011","infoKind":"0","InvStock":983}
key
类型
长度
描述
Value
RetCode
String
4字节
返回码
3011:查询成功
3001:查询失败
RetMsg
String
200字节
返回描述
TaxClock
String
50字节
当前时间
yyyy-MM-dd HH:mm:ss格式时间
InfoTypeCode
String
20字节
开具发票的十位代码。
infoNumber
String
8字节
下次开票的八位号码。
infoKind
String
2字节
发票种类
0专用发票,2普通发票
InvStock
String
10字节
剩余发票数量
作废发票
作废发票
参数说明:
发送参数
例如:http://localhost:9876/TaxHttpService/tax_cancel
参数:inputJson={"infoKind":2 ,” typeCode”:“1234567890”,”num”:”12345678”}
key
类型
长度
描述
Value
infoKind
in