最近参与开发了一款收费系统,涉及到对接税务开增值税发票的功能,所以有了这篇文章。

参数设置

请求体

<?xmlversion="1.0"encoding="gbk"?>
<businessid="20001"comment="参数设置">
<bodyyylxdm="1">
	<servletip>服务器IP地址</servletip>开票请求的IP地址
	<servletport>服务器端口号</servletport>服务器端口号
	<keypwd>税控钥匙口令</keypwd>
	<servlettype>通信类型</servlettype>//1为https请求,其他为http
</body>
</business>

响应体

<?xmlversion="1.0"encoding="gbk"?>
<businessid="20001"comment="参数设置">
<bodyyylxdm="1">
	<returncode>返回代码</returncode>
	<returnmsg>返回信息</returnmsg>
</body>
</business>

当返回代码为0时,说明成功。

获取税控UKey信息

请求体:

<?xml version="1.0" encoding="gbk"?>
<business id="20002" comment="税控钥匙信息查询">
<body yylxdm="1">
	<keypwd>税控钥匙口令</keypwd>
</body>
</business>

响应体:

<?xml version="1.0" encoding="gbk"?>
<business id="20002" comment="税控钥匙信息查询">
<body yylxdm="1">
	<returncode>返回代码</returncode>
	<returnmsg>返回信息</returnmsg>
	<returndata>
	<nsrsbh>纳税人识别号</nsrsbh>
	<keyno>税控钥匙编号</keyno>
	</returndata>
</body>
</business>

开票

请求体:

<?xml version="1.0" encoding="gbk"?>
<business id="10008" comment="发票开具">
<body yylxdm="1">
	<kpzdbs>开票终端标识</kpzdbs>
	<fplxdm>发票类型代码</fplxdm>
	<fpqqlsh>发票请求流水号</fpqqlsh>
	<kplx>开票类型</kplx>
	<tspz>特殊票种标识</tspz>
	<xhdwsbh>销货单位识别号</xhdwsbh>
	<xhdwmc>销货单位名称</xhdwmc>
	<xhdwdzdh>销货单位地址电话</xhdwdzdh>
	<xhdwyhzh>销货单位银行帐号</xhdwyhzh>
	<ghdwsbh>购货单位识别号</ghdwsbh>
	<ghdwmc>购货单位名称</ghdwmc>
	<ghdwdzdh>购货单位地址电话</ghdwdzdh>
	<ghdwyhzh>购货单位银行帐号</ghdwyhzh>
	<qdbz>清单标志</qdbz>
	<zsfs>征税方式</zsfs>
	<fyxm count="1">
	<group xh="1">
		<fphxz>发票行性质</fphxz>
		<spmc>商品名称</spmc>
		<spsm>商品税目</spsm>
		<ggxh>规格型号</ggxh>
		<dw>单位</dw>
		<spsl>商品数量</spsl>
		<dj>单价</dj>
		<je>金额</je>
		<sl>税率</sl>
		<se>税额</se>
		<hsbz>含税标志</hsbz>
		<spbm>商品编码</spbm>
		<zxbm>纳税人自行编码</zxbm>
		<yhzcbs>优惠政策标识</yhzcbs>
		<lslbs>零税率标识</lslbs>
		<zzstsgl>增值税特殊管理</zzstsgl>
	</group>
	</fyxm>
	<hjje>合计金额</hjje>
	<hjse>合计税额</hjse>
	<jshj>价税合计</jshj>
	<kce>差额征税扣除额</kce>
	<bz>备注</bz>
	<skr>收款人</skr>
	<fhr>复核人</fhr>
	<kpr>开票人</kpr>
	<tzdbh>信息表编号</tzdbh>
	<yfplx>原发票类型</yfplx>
	<yfpdm>原发票代码</yfpdm>
	<yfphm>原发票号码</yfphm>
	<ykprq>原开票日期</ykprq>
</body>
</business>

响应体:

<?xml version="1.0" encoding="gbk"?>
<business id="10008" comment="发票开具">
<body yylxdm="1">
	<returncode>返回代码</returncode>
	<returnmsg>返回信息</returnmsg>
	<returndata>
		<fpdm>发票代码</fpdm>
		<fphm>发票号码</fphm>
		<kprq>开票日期</kprq>
		<skm>税控码</skm>
		<jym>校验码</jym>
		<qmz>签名值</qmz>
		<ewm>二维码</ewm>
		<bsreturncode>版式返回代码<bsreturncode>
		<bsreturnmsg>版式返回信息</bsreturnmsg>
		<url>版式文件地址</url>
	</returndata>
</body>
</business>

打印发票

设置票据的页边距

请求体:

<?xml version="1.0" encoding="gbk"?>
<business id="20003" comment="页边距设置">
<body yylxdm="1">
	<fplxdm>发票类型代码</fplxdm>
	<top>打印上边距</top>
	<left>打印左边距</left>
</body>
</business>

响应体:

<?xml version="1.0" encoding="gbk"?>
<business id="20003" comment="页边距设置">
<body yylxdm="1">
	<returncode>返回代码</returncode>
	<returnmsg>返回信息</returnmsg>
</body>
</business>
打印发票

请求体:

<?xml version="1.0" encoding="gbk"?>
<business id="20004"comment="发票打印">
<body yylxdm="1">
	<kpzdbs>开票终端标识</kpzdbs>
	<fplxdm>发票类型代码</fplxdm>
	<fpdm>发票代码</fpdm>
	<fphm>发票号码</fphm>
	<dylx>打印类型</dylx>
	<dyfs>打印方式</dyfs>
	<printername>打印机名称</printername>
</body>
</business>

响应体:

<?xml version="1.0" encoding="gbk"?>
<business id="20004" comment="发票打印">
<body yylxdm="1">
	<returncode>返回代码</returncode>
	<returnmsg>返回信息</returnmsg>
</body>
</business>

以上就是整个开具增值税发票的完整的流程,涉及到作废冲红,需要单独再去写逻辑,但是请求都是不变的。