增值税纸质票调用说明(税收分类版)V1.3

1、发票管理系统（分类编码版）使用说明版本号：V3.5航天信息广东有限公司日期：2016年8月总体说明系统服务提供的是HTTP协议接口。理论上只要请求地址及参数符合要求都能成功调用本软件实现 开票等操作。系统规定参数传输格式为JSON格式。以下提供java版本的调用方式实例。如若是其他 语言需要调 用本系统，可以仿照走辺版本的调用方式组织请求参数提交请求。二、HTTP接口说明接口地址：http: n localhost:9876/TaxHttpService/tax_请先读这里：通过API提交参数时，参数内容编码必须为utf-8发送参数的key统一为inputjson,参数格式为JSON字符串格式

2、。例如获取下张发票接口：http:/localhost:9876/TaxHttpService/tax_getI nfo参数:input Json= “hfoKind :0返回参数为json字符串格式，具体键值对如下。注意:键值表中红色字体标示必填，灰色背景的表示不用，但是要传空值另外，以下实例均为get请求方式，建议在实际使用时采用post请求方式发送参数，避免参数截断的情况发生.1.打开金税卡打开金税卡是执行其他开票业务的前提，并且，每次使用程序只需要打开一次金税卡，然后调用其他接口，直到程序关闭。参数说明：发送参数例如：http: localhost:9876/TaxHttpServic

3、e/tax openCardkey类型描述Value无接收参数例如:TaxCode:123456789012345, MachineNo:0, RetMsg:金税卡成功开启” RetCode:1011, lslnvEmpty:0, IsLockReached:。，1sRepReached:0key类型长度描述ValueRetCodeStri ng4字节返回码1011：300110011007：打开成功已经打开 打开失败金税卡已被占用RetMsgStri ng200字节返回描述TaxCodeStri ng20字节税号Machi neNoInt5字节分机号Isl nvEmptyInt1字节是否有发

4、票In vLimitdouble专票开票限 额IsLockReachedInt1字节锁死期0未锁死,1锁死IsRepReachedint1字节抄税期0未到抄税期，已到抄税期2.获取发票信息查询下张发票的信息或者查询是否有下张发票参数说明：发送参数例如：http: localhost:9876/TaxHttpService/tax_ getlnfo 参数：inputJson=infoKind：2key类型长度描述Valuein foKi ndint2字节发票种类0专用发票,2普通发票接收参数例 如：InfoTypeCode:1234567890, InfoNumber:*123456*, Tax

5、Clock:2014-05-0509:13:44, RetMsg:读取发票信息成功 ”，” RetCode:3011, infoKind:。，TnvStock:983key类型长度描述ValueRetCodeStri ng4字节返回码3011 :查询成功3001 :查询失败RetMsgStri ng200字节返回描述TaxClockStri ng50字节当前时间yyyy-MM-ddHH:mm: ss 格式时间In foTypeCodeStri ng20字节开具发票的 十位代码。infoN umberStri ng8字节下次开票的 八位号码。in foKi ndStri ng2字节发票种类0专用

6、发票,2普通发票In vStockStri ng10字节剩余发票数il3作废发票作废发票参数说明：发送参数例女口: http: localhost:9876/TaxHttpService/tax cancel参数：inputjson二infoKind:2 ” ypeCode” 1234567890 ” num” ” 2345678key类型长度描述Valuein foKi ndint2字节发票种类0专用发票,2普通发票typeCodeStri ng20字节要作废的发票代码numStri ng8字节要作废的发票接收参数例 如：InfoTypeCode:1234567890, InfoNumber

7、:123456, TaxClock2014-05-0509:13:44, RetMsg：读取发票信息成功 ”,” RetCode:3011, infoKind:0, lnvStock:983key类型长度描述ValueRetCodeStri ng4字节返回码6001 :当月发票库未找到该发票。6002 :该发票已作废。6011：作废成功。6012 :未作废。6013 :作废失败。RetMsgStri ng200字节返回描述4.打印发票作废发票参数说明：发送参数例女口: http: localhost：9876/TaxHttpService/tax print参数:inputJson=*info

8、Kind*:2 typeCode 1234567890 num” ” 2345678” printType :0, confirE ”mWmkey类型长度描述Valuein foKi ndInt2字节发票种类0专用发票,2普通发票typeCodeStri ng20字节要打印的发票 代码numStri ng8字节要打印的发票prin tTypeInt1字节打印类型0打印发票,1打印清单con firmWi nInt1字节预览0不预览,1预览接收参数key类型长度描述ValueRetCodeStri ng4字节返回码500150115012：5013未找到发票或清单。 打印成功。未打印。打印失败。

9、RetMsgStri ng200字节返回描述5开具增值税发票信息开具发票接口参数说明：税局相关政策要求，发票开具的明细行需要指定分类编码，所以接口需要进 行调整，新增下列红色部分字段发送参数例如：http： “ localhost:9876/TaxHttpServi.ce/tax_invoice参数:inputJson： billCode:12345689, cAddress：东风南方广人”，” cBank：工商银行,” cName:c,cancelFlag：O, cashier:张三，checkei:李四，*correspondingNumber*:correspondingTypeCode

10、*:deta订s:zeroTax:taxDeduction:”, goodsNoVer:T. 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, taxlt em：,taxRate：17, unit：-,discountF

11、lag*:0, infoKind：2, infoNumber：infoTypeCod e:, invoicer：l, listName：销货清单,negNoticeNo:, *negativeFlag:0, notes:, sAddress:sAdtiress, sBank:sBank, taxR ate:17, *totalAmount*:2000, *totalTaxAmount*:234发票主体键值key类型长度描述ValueIsRequirebillCodeStri ng20字节单据号否，若传入则会判断 唯一。in foKi ndInt2字节发票类型0专用发票,2 普通发票是cName

12、Stri ng100字节购方名称是cAddressStri ng100字节购方地址 电话专用发票必选，普通发票可选cBa nkStri ng100字节购方银行账号专用发票必选，普通 发票可选cTaxCodeStri ng20字节购方税号专用发票必选，普通发票可选taxRateInt2字节税率17,6, 11 等等必选cashierStri ng8字节最 长4个中 文字收款人可选checkerStri ng8字节最 长4个中 文字复核人可选invoicerStri ng8字节最 长4个中 文字开票人必选listNameStri ng10字节是否开具清单1表示开清 单,空表示不 开清单可选sAdd

13、ressStri ng100字节销方地址 电话专用发票必选，普通 发票可选sBankStri ng100字节销方银行 账号专用发票必选，普通 发票可选notesStri ng240字节备注若需开具红字发票专 票的需要添加“开具 红字增值税专用发票 信息表编号 xra加加加光r普 票的需要添加“对应 正数发票代 码:xxxx号 码:XXXX且需顶格，譬 如有自定义的备注信 息，需设置为：“对 应正数发票代码:xxxx 号码：xxxx订单 号:XXX”detailsArray发票明细多条明细， 每条明细参 见明细键值 表格必选can celFlag作废标记可选totalAmount总金额可选tot

14、alTaxAmount总税额可选correspondingNumber对应蓝票号码负数票时需要填入可选correspondingTypeCode对应蓝票代码负数票时需要填入可选discountFlag折扣标 记可选negativeFlag负数标志可选negNoticeNo通知单号专用发票且 是负数票时 需要输入可选infoNumber发票号码可选infoTypeCode发票代码可选发票明细键值key类型长度描述ValueIsRequireamountDouble金额最多精确到小数点后2位必选goodsNameStri ng100字节商品名称必选目前折扣行是，譬如 只往上折扣一行时 goods

15、name写成折扣 (00. 000%);往卜，折扣 多行譬如4 时 goods name 写成 折扣行数4(00.000%)括号 都用 半角百分比就是折扣 金额除以往上折扣行 数的总正数金额的绝 对值numberDouble商品数量最多精确到小数点后8位可选pricedouble单价最多精确到小数点后8位可选unitStri ng32字节单位可选priceKindInt17节含税标记0不含税,1倉税必选standardStri ng40字节商品规格可选taxRateInt2字节税率17, 6, 11 等等必选taxitemStri ng4字节税目4位数字可选新增字段goodsNoVer;/编码

16、版本固定1.0 （必 填） goodsTaxNo;/ 税 收 分类编码长度19字节（必填可选 30101010102 做测 试） taxPre;/优惠政策0 不享受,1享受长度1 字节（必填默认为0 不享受） taxPreCon;/ -优惠 政策内容：免税长度 20字节（选填） zeroTax;/零税率标 志为空:非零税率,0 出口退税,1免税,2不 征收,3普通 零税率长 度2字节（选填） cropGoodsNo;/ 自 编 码长度100字节 taxDeduct ion;/ 差 额扣除额数字（选 填）taxAmountStri ng税额可选discountFlagStri ng折扣标记可选discountRateStri ng折扣率可选sequenceStri ng行号可选接收参数key类型长度描述ValueRetCodeStri ng4字节返回码4001 :传入数据不合法。4002 :开票前金税卡状态错。4003 :金税卡开票调用错误。4004 :开票后取金税卡状态错。4011 ：开票成功。4012 :开票失败。RetMsgStri ng200字节返回描述In foTypeCodeStri ng