增值税纸质票调用说明税收分类版V13.docx
《增值税纸质票调用说明税收分类版V13.docx》由会员分享,可在线阅读,更多相关《增值税纸质票调用说明税收分类版V13.docx(14页珍藏版)》请在冰豆网上搜索。
增值税纸质票调用说明税收分类版V13
发票管理系统(分类编码版)
使用说明
版本号:
V3.5
航天信息广东有限公司
日期:
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={“hfoKind":
0}
返回参数为json字符串格式,具体键值对如下。
注意:
键值表中红色字体标示必填,灰色背景的表示不用,但是要传空值•
另外,以下实例均为get请求方式,建议在实际使用时采用post请求方式发送参数,避免参数
截断的情况发生.
1.打开金税卡
打开金税卡是执行其他开票业务的前提,并且,每次使用程序只需要打开一次金税卡,然后
调用其他接口,直到程序关闭。
参数说明:
发送参数
例如:
http:
〃localhost:
9876/TaxHttpService/taxopenCard
key
类型
描述
Value
无
接收参数
例如:
{"TaxCode":
"123456789012345","MachineNo":
0,"RetMsg":
"金税卡成功开启
",”RetCode":
"1011","lslnvEmpty":
0,"lsLockReached":
0,"lsRepReached":
0}
key
类型
长度
描述
Value
RetCode
String
4字节
返回码
1011:
打开成功
3001:
已经打开
1001:
打开失败
1007:
金税卡已被占用
RetMsg
String
200字节
返回描述
TaxCode
String
20字节
税号
MachineNo
Int
5字节
分机号
IslnvEmpty
Int
1字节
是否有发
票
InvLimit
double
专票开票限额
IsLockReached
Int
1字节
锁死期
0未锁死,1锁死
IsRepReached
int
1字节
抄税期
0未到抄税期,已到抄税期
2.获取发票信息
查询下张发票的信息或者查询是否有下张发票
参数说明:
发送参数
例如:
http:
〃localhost:
9876/TaxHttpService/tax_getlnfo参数:
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-ddHH:
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”ypeCode”1234567890”'num””2345678”
key
类型
长度
描述
Value
infoKind
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","lnvStock":
983}
key
类型
长度
描述
Value
RetCode
String
4字节
返回码
6001:
当月发票库未找到该发票。
6002:
该发票已作废。
6011:
作废成功。
6012:
未作废。
6013:
作废失败。
RetMsg
String
200字节
返回描述
4.打印发票
作废发票
参数说明:
发送参数
例如:
http:
〃localhost:
9876/TaxHttpService/taxprint
参
数:
inputJson={"infoKind":
2”'typeCode1234567890”'num””2345678”'printType”:
0,”confirmWin”””
key
类型
长度
描述
Value
infoKind
Int
2字节
发票种类
0专用发票,2普通发票
typeCode
String
20字节
要打印的发票代码
num
String
8字节
要打印的发票号码
printType
Int
1字节
打印类型
0打印发票,1打印清单
confirmWin
Int
1字节
预览
0不预览,1预览
接收参数
key
类型
长度
描述
Value
RetCode
String
4字节
返回码
5001:
未找到发票或清单。
5011:
打印成功。
5012:
未打印。
5013:
打印失败。
RetMsg
String
200字节
返回描述
5.开具增值税发票信息
开具发票接口
参数说明:
税局相关政策要求,发票开具的明细行需要指定分类编码,所以接口需要进行调整,新增下列红色部分字段
发送参数
例如:
http:
〃localhost:
9876/TaxHttpService/tax_invoice
参数:
inputJson:
'{"billCode":
"12345689","cAddress":
东风南方广大",”cBank":
'工商银行
",”cName":
"c","cTaxCode":
"111111111111111","cancelFlag":
0,"cashier":
张三",”checker":
"李
四,"correspondingNumber":
"","correspondingTypeCode":
"","details":
[{zeroTax":
"","taxDeduction":
"","goodsNoVer":
"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,"taxltem":
"","taxRate":
17,"unit":
"-"}],"discountFlag":
0,"infoKind":
2,"infoNumber":
"","infoTypeCode":
"","invoicer":
"1","listName":
"销货清单
”,"negNoticeNo":
"","negativeFlag":
O,"notes":
"","sAddress":
"sAddress","sBank":
"sBank","taxRate":
17,"totalAmount":
2000,"totalTaxAmount":
234}'
发票主体键值
key
类型
长度
描述
Value
IsRequire
billCode
String
20字节
单据号
否,若传入则会判断唯一。
infoKind
Int
2字节
发票类型
0专用发票,2普通发票
是
cName
String
100字节
购方名称
是
cAddress
String
100字节
购方地址电话
专用发票必选,普通发票可选
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字节
销方地址电话
专用发票必选,普通发票可选
sBank
String
100字节
销方银行账号
专用发票必选,普通发票可选
notes
String
240字节
备注
若需开具红字发票专票的需要添加“开具红字增值税专用发票信息表编号xxxxxxxxxxxxxXx普票的需要添加“对应正数发票代码:
XXXX号码:
XXXX'且需顶格,譬如有自定义的备注信息,需设置为:
“对应正数发票代码:
XXXX号码:
XXXX订单号:
XXX”
details
Array
发票明细
多条明细,每条明细参见明细键值表格
必选
cancelFlag
作废标
记
可选
totalAmount
总金额
可选
totalTaxAmount
总税额
可选
correspondingNumber
对应蓝
票号码
负数票时需要填入
可选
correspondingTypeCode
对应蓝票代码
负数票时需要填入
可选
discountFlag
折扣标
记
可选
negativeFlag
负数标志
可选
negNoticeNo
通知单号
专用发票且是负数票时需要输入
可选
infoNumber
发票号
码
可选
infoTypeCode
发票代码
可选
发票明细键值
key
类型
长度
描述
Value
IsRequire
amount
Double
金额
最多精确到小
数点后2位
必选
goodsName
String
100字节
商品名称
必选
目前折扣行是,譬如只往上折扣一行时goodsname写成折扣(00.000%);往上折扣多行譬如
4时goodsname写成折扣行数
4(00.000%)括号都用半角百分比就是折扣金额除以往上折扣行数的总正数金额的绝对值
number
Double
商品数量
最多精确到小
数点后8位
可选
price
double
单价
最多精确到小
数点后8位
可选
unit
String
32字节
单位
可选
priceKind
Int
1字节
含税标记
0不含税,1含税
必选
standard
String
40字节
商品规格
可选
taxRate
Int
2字节
税率
17,6,11等等
必选
taxitem
String
4字节
税目
4位数字
可选
新增字段
goodsNoVer;//编
码版本固定1.0(必填)
goodsTaxNo;//税收分类编码长度19字节(必填可选30101010102做测试)
taxPre;//优惠政策0不享受,1享受长度1字节(必填默认为0不享受)taxPreCon;//-优惠政策内容:
免税长度20字节(选填)zeroTax;//零税率标志为空:
非零税率,0出口退税,1免税,2不征收,3普通零税率长度2字节
(选填)cropGoodsNo;//自编码长度100字节taxDeduction;//差额扣除额数字(选填)
taxAmount
String
税额
可选
discountFlag
String
折扣标记
可选
discountRate
String
折扣率
可选
sequence
String
行号
可选
接收参数
key
类型
长度
描述
Value
RetCode
String
4字节
返回码
4001:
传入数据不合法。
4002:
开票前金税卡状态错。
4003:
金税卡开票调用错误。
4004:
开票后取金税卡状态错。
4011:
开票成功。
4012:
开票失败。
RetMsg
String
200字节
返回描述
InfoTypeCode
String
20字节
发票代码
InfoNumber
String
8字节
发票号码
InfoDate
String
开票日期
格式2014-01-0100:
00:
00
InfoMonth
String
2字节
开票月份
InfoAmount
String
发票开具的金额
InfoTaxAmount
String
发票开具的税额
InfoBillNumber
String
销售单据号
GoodsListFlag
String
1字节
销货清单标记
0不带清单,1表示带清单
infoKind
String
2字节
发票开具的种类
0专用发票,2普通发票