《增值税纸质票调用说明(税收分类版)V1.3》由会员分享，可在线阅读，更多相关《增值税纸质票调用说明(税收分类版)V1.3（9页珍藏版）》请在金锄头文库上搜索。
1、 广东航天信息税控组件接口系统方案发票管理系统（分类编码版）使用说明版本号：V3.5航天信息广东有限公司日期：2016 年 8 月 广东航天信息税控组件接口系统方案一、 总体说明系统服务提供的是 HTTP 协议接口。理论上只要请求地址及参数符合要求都能成功调用本软件实现开票等操作。系统规定参数传输格式为 JSON 格式。以下提供 java 版本的调用方式实例。如若是其他语言需要调用本系统，可以仿照 java 版本的调用方式组织请求参数提交请求。二、 HTTP接口说明接口地址：http:/localhost:9876/TaxHttpService/tax_请先读这里: 通过 API 提交参数时
2、, 参数内容编码必须为 utf-8发送参数的 key 统一为 inputJson，参数格式为 JSON 字符串格式。例如获取下张发票接口：http:/localhost:9876/TaxHttpService/tax_ getInfo参数:inputJson=“infoKind”:0返回参数为 json 字符串格式,具体键值对如下。注意:键值表中红色字体标示必填,灰色背景的表示不用,但是要传空值.另外, 以下实例均为 get 请求方式,建议在实际使用时采用 post 请求方式发送参数, 避免参数截断的情况发生. 1. 打开金税卡打开金税卡是执行其他开票业务的前提，并且，每次使用程序只需要打开一
3、次金税卡，然后调用其他接口，直到程序关闭。参数说明：发送参数例如: http:/localhost:9876/TaxHttpService/tax_ openCardkey 类型 描述 Value无接收参数例如: TaxCode:123456789012345,MachineNo:0,RetMsg:金税卡成功开启,RetCode:1011,IsInvEmpty:0,IsLockReached:0,IsRepReached:0key 类型 长度 描述 ValueRetCode String 4 字节 返回码 1011：打开成功3001：已经打开1001：打开失败1007：金税卡已被占用RetMs
4、g String 200 字节 返回描述 广东航天信息税控组件接口系统方案TaxCode String 20 字节 税号MachineNo Int 5 字节 分机号IsInvEmpty Int 1 字节 是否有发票InvLimit double 专票开票限额IsLockReached Int 1 字节 锁死期 0 未锁死,1 锁死IsRepReached int 1 字节 抄税期 0 未到抄税期, 已到抄税期2. 获取发票信息查询下张发票的信息或者查询是否有下张发票参数说明：发送参数例如：http:/localhost:9876/TaxHttpService/tax_ getInfo参数:in
5、putJson=infoKind:2key 类型 长度 描述 ValueinfoKind int 2 字节 发票种类 0 专用发票,2 普通发票接收参数例如: InfoTypeCode:1234567890,InfoNumber:123456,TaxClock:2014-05-05 09:13:44,RetMsg:读取发票信息成功,RetCode:3011,infoKind:0,InvStock:983key 类型 长度 描述 ValueRetCode String 4 字节 返回码 3011：查询成功3001：查询失败RetMsg String 200 字节 返回描述TaxClock Str
6、ing 50 字节 当前时间 yyyy-MM-dd HH:mm:ss 格式时间InfoTypeCode String 20 字节 开具发票的十位代码。infoNumber String 8 字节 下次开票的八位号码。infoKind String 2 字节 发票种类 0 专用发票,2 普通发票InvStock String 10 字节 剩余发票数量 广东航天信息税控组件接口系统方案3. 作废发票作废发票参数说明：发送参数例如：http:/localhost:9876/TaxHttpService/tax_cancel参数:inputJson=infoKind:2 ,” typeCode”:“1
7、234567890”,”num”:”12345678”key 类型 长度 描述 ValueinfoKind int 2 字节 发票种类 0 专用发票,2 普通发票typeCode String 20 字节 要作废的发票代码num String 8 字节 要作废的发票号码接收参数例如: InfoTypeCode:1234567890,InfoNumber:123456,TaxClock:2014-05-05 09:13:44,RetMsg:读取发票信息成功,RetCode:3011,infoKind:0,InvStock:983key 类型 长度 描述 ValueRetCode String 4
8、 字节 返回码 6001：当月发票库未找到该发票。6002：该发票已作废。6011：作废成功。6012：未作废。6013：作废失败。RetMsg String 200 字节 返回描述4. 打印发票作废发票参数说明：发送参数例如：http:/localhost:9876/TaxHttpService/tax_print参数:inputJson=infoKind:2 ,” typeCode”:“1234567890”,”num”:”12345678”,” printType”:0,” confirmWin”:”0”key 类型 长度 描述 ValueinfoKind Int 2 字节 发票种类 0
9、 专用发票,2 普通发票typeCode String 20 字节 要打印的发票代码num String 8 字节 要打印的发票号码 广东航天信息税控组件接口系统方案printType Int 1 字节 打印类型 0 打印发票,1 打印清单confirmWin Int 1 字节 预览 0 不预览,1 预览接收参数key 类型 长度 描述 ValueRetCode String 4 字节 返回码 5001：未找到发票或清单。5011：打印成功。5012：未打印。5013：打印失败。RetMsg String 200 字节 返回描述5. 开具增值税发票信息开具发票接口参数说明： 税局相关政策要求,
10、发票开具的明细行需要指定分类编码,所以接口需要进行调整,新增下列红色部分字段发送参数例如：http:/localhost:9876/TaxHttpService/tax_ invoice参数: inputJson: billCode:12345689,cAddress:东风南方广大,cBank:工商银行,cName:c,cTaxCode:111111111111111,cancelFlag:0,cashier:张三,checker:李四,correspondingNumber:,correspondingTypeCode:,details:zeroTax:,taxDeduction:,good
11、sNoVer:1.0,goodsTaxNo:10101013301,taxPre:0,taxPreCon:免税,amount:100,discountAmount:0,discountFlag:0,discountRate:0,goodsName:备件,number:1,price:100,priceKind:1,sequence:0,standard:,taxAmount:14.53,taxItem:,taxRate:17,unit:-,discountFlag:0,infoKind:2,infoNumber:,infoTypeCode:,invoicer:1,listName:销货清单,n
12、egNoticeNo:,negativeFlag:0,notes:,sAddress:sAddress,sBank:sBank,taxRate:17,totalAmount:2000,totalTaxAmount:234发票主体键值key 类型 长度 描述 Value IsRequirebillCode String 20 字节 单据号 否，若传入则会判断唯一。infoKind Int 2 字节 发票类型0 专用发票,2 普通发票是 广东航天信息税控组件接口系统方案cName String 100 字节 购方名称是cAddress String 100 字节 购方地址电话专用发票必选，普通发票
13、可选cBank String 100 字节 购方银行账号专用发票必选，普通发票可选cTaxCode String 20 字节 购方税号专用发票必选，普通发票可选taxRate Int 2 字节 税率 17,6,11 等等必选cashier String 8 字节 最长 4个中文字收款人 可选checker String 8 字节 最长 4个中文字复核人 可选invoicer String 8 字节 最长 4个中文字开票人 必选listName String 10 字节 是否开具清单1 表示开清单,空表示不开清单可选sAddress String 100 字节 销方地址电话专用发票必选，普通发票
14、可选sBank String 100 字节 销方银行账号专用发票必选，普通发票可选notes String 240 字节 备注 若需开具红字发票专票的 需要添加 “开具红字增值税专用发票信息表编号XXXXXXXXXXXXXXX”普票的 需要添加 “对应正数发票代码:XXXX 号码:XXXX”且需顶格，譬如有自定义的备注信息，需设置为：“对应正数发票代码:XXXX 号码:XXXX 订单号: 广东航天信息税控组件接口系统方案XXX”details Array 发票明细多条明细,每条明细参见明细键值表格必选cancelFlag 作废标记可选totalAmount 总金额 可选totalTaxAmou
15、nt 总税额 可选correspondingNumber 对应蓝票号码负数票时需要填入可选correspondingTypeCode对应蓝票代码负数票时需要填入可选discountFlag 折扣标记可选negativeFlag 负数标志可选negNoticeNo 通知单号专用发票且是负数票时需要输入可选infoNumber 发票号码可选infoTypeCode 发票代码可选发票明细键值key 类型 长度 描述 Value IsRequireamount Double 金额 最多精确到小数点后 2 位必选goodsName String 100 字节 商品名称 必选目前折扣行是，譬如 只往上折扣一行时 goodsname 写成 折扣(00.000%) ；往上折扣多行譬如4 时 goodsname 写成 折扣行数4(00.000%) 括号都用半角 百分比就是折扣金额除以 广东航天信息税控组件接口系统方案往上
