增值税纸质票调用说明[税收分类版]V1.3.docxVIP

广东航天信息——税控组件接口系统方案 发票管理系统（分类编码版） 使用说明 版本号：V3.5 航天信息广东有限公司 日期：2016年8月  总体说明 系统服务提供的是HTTP协议接口。理论上只要请求地址及参数符合要求都能成功调用本软件实现开票等操作。 系统规定参数传输格式为JSON格式。以下提供java版本的调用方式实例。如若是其他语言需要调用本系统，可以仿照java版本的调用方式组织请求参数提交请求。 H?T?T?P?接?口?说?明? 接口地址：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类型长度描述ValueRetCodeString4字节返回码1011：打开成功 3001：已经打开 1001：打开失败 1007：金税卡已被占用RetMsgString200字节返回描述TaxCodeString20字节税号MachineNoInt5字节分机号IsInvEmptyInt1字节是否有发票InvLimitdouble专票开票限额IsLockReachedInt 1字节锁死期0未锁死,1锁死IsRepReachedint1字节抄税期0未到抄税期,已到抄税期 获取发票信息 查询下张发票的信息或者查询是否有下张发票 参数说明： 发送参数 例如：http://localhost:9876/TaxHttpService/tax_ getInfo 参数:inputJson={infoKind:2} key类型长度描述ValueinfoKindint2字节发票种类0专用发票,2普通发票接收参数 例如: {InfoTypeCode:1234567890,InfoNumber:123456,TaxClock:2014-05-05 09:13:44,RetMsg:读取发票信息成功,RetCode:3011,infoKind:0,InvStock:983} key类型长度描述ValueRetCodeString4字节返回码3011：查询成功 3001：查询失败RetMsgString200字节返回描述TaxClockString50字节当前时间yyyy-MM-dd HH:mm:ss格式时间InfoTypeCodeString20字节开具发票的十位代码。 infoNumberString8字节下次开票的八位号码。infoKindString2字节发票种类0专用发票,2普通发票InvStockString10字节剩余发票数量作废发票 作废发票 参数说明： 发送参数 例如： HYPERLINK http://localhost:9876/TaxStruts/tax_cancel http://localhost:9876/TaxHttpService/tax_cancel 参数:inputJson={infoKind:2 ,” typeCode”:“1234567890”,”num”:} key类型长度描述ValueinfoKindint2字节发票种类0专用发票,2普通发票typeCodeString20字节要作废的发票代码numSt