公告

开票方申请开具发票，返回二维码路径。

请求格式

URL:http://ek.caikaixin.cn/sendRequest

请求方法:POST

协议：HTTP

请求参数

数据格式：JSON

参数	类型	是否必填	描述
invoice	string	是	开票方税号（必须与开票机开票软件一致）
kpjh	string	是	开票机号（必须与开票机开票软件一致）
token	string	是	对接凭证
spxx	string	是	Xml加密字符
orderId	string	是	开票方业务系统单据编号
os_type	string	是	系统类型 Windows或者Linux

注意spxx封装成xml格式：

1、以下XML封装的字段名称不可更改，必须保持一致！！

2、<business id="zzsfp" comment="订单编号"> 为传输的数据类型标识，不可更改！！

3、<body yylxdm="1"> yylxdm-应用类型代码，默认1 表示国税

4、XML数据封装格式严格按照以下节点定义（同级节点顺序不要求），其它不可更改！！

主要解释说明如下：

(1)、“<business >”节点下为发票主信息

(2)、”< fpmx count="1"> ”节点下定义的为发票明细信息count="1"属性标识商品数量。每个<group xh="1">节点为一条商品信息，可包含多条，其中xh="1" 属性标识发票明细序号，必须含有切不可重复；

协议定义为XML格式（含多条明细）：

<business id="zzsfp" comment="订单编号">

<body yylxdm="1">

<input>

<bz>备注</bz> --非必填

<fpmx count="1"> --商品明细条数

<group xh="1"> --明细序号

<spmc>商品名称</spmc> --必填

<ggxh>规格型号</ggxh> --非必填

<jldw>单位</jldw> --非必填

<spsl>1商品数量</spsl> --非必填

<spdj>10.00单价</spdj>[1] --非必填

<je>10.00金额</je> --必填

<slv>0.06税率</slv> --必填

<se>0.60税额</se> --非必填

<hsbz>0含税标志 0-否 1是</hsbz> --必填，默认0

<spbm>商品税收编码19位(必填)</ spbm> --必填

<syyhzcbz>0优惠政策标志(0否1是)</syyhzcbz>--必填，默认0

<yhzcsm>优惠政策内容</yhzcsm> --非必填

<cezsje>0</cezsje>[2] --必填，默认0

<lslbz>0零税率标志(0否，1是)</lslbz> --必填，默认0

<fphxz>0发票行性质2被折扣行，1折扣行，0正常(无折扣)</fphxz>[3] --必填，默认0

</group>

</fpmx>

</input>

</body>

</business>

对以上xml格式数据加密传输,加密详细说明见附属文件 “AESUtils.java”“AESUtilsForLinux.java”

注：加解密区分操作系统，请根据服务器类型选择。

返回参数

数据格式：JSON

参数	类型	描述
errcode	string	错误码
errmsg	string	错误信息
info	string	信息 — code: 单据编号， url: 二维码明文

请求参数：

{

"invoice": "000000000000000000",

"kpjh": "0",

"token": " xBaeexIilmIFsXSLkhsIvS1yMPm82cF+F6jeG+YzvBLMOVyA/ylTI6ablgWH5L3C ",

"spxx": "Xml加密字符",

"orderId": "开票方业务系统单据编号."

}

返回数据：

{

"errcode": "200",

"errmsg": "提交发票信息成功!",

"info": [{

"code": "201911041722102214000",

"url": "http://ek.caikaixin.cn/fp/scanURl....."

}]

}

数量和单价必须一致，为空或不为空，只要一项为空，默认会将另一项置空

差额征收金额(默认0，大于0为差额征收金额)

发票行性质

0——正常明细行，不带折扣

1——折扣行

2——被折扣行，分为两种：

单行折扣，只对前一行折扣，如：spmc=折扣（10.000%）

多行折扣，对前几行折扣，如spmc=折扣行数3（10.000%）

纸质发票作废处理

1 药械当月发票本地记录直接删除，财务人员税盘作废同步（2.0版支持直接作废当月发票纸质，不再需要财务人员同步操作）

2 上月发票打标记已作废，插入一条红冲发票记录，财务人员申请的红票票号再写入发票号码相应字段

电子专票红冲需要提交冲红单

何淼:
下午测试税盘版的，有两个问题想咨询一下，第一，发票余量为什么不自动获取，上午测试Ukey版是自动获取的发票余量，这个不自动获取，点子普票是我手动录入进去的，第二个问题，只有点子普票开出来了，其他两种纸质普票和纸质专票都没开出来，不知道原因@文小林 @登优秀💯

登优秀💯:
第一个金税盘暂时没有对接底层还是已开票软件实际情况为准手动输入

第二个问题看他盘里面有没有纸质普票和纸质专票的发票

登优秀💯:
第二问题说错金税盘只支持电票不支持开纸票

登优秀💯:
税控盘和 uk 是所有的票种都支持开具

新版mAPI 税控盘和 uk 不支持界面的开票只能底层开票，用户同时打开的得装旧版

何淼:
我还想问一下，如果是新版API开纸质专票的话，能直接打印出纸质发票吗？

张兴:
金税盘，暂不支持；
税控盘、税务uk可以

何淼:
需要设置吗？

登优秀💯:
需要设置，打印纸票的边距，其他的不用设置

ukey、金税盘、税控盘的区别
事实上，这3个盘都是开票用的，并且每个月1-15号需要对上一个月抄报税和清卡才能保证下个月正常使用。
所以企业要想正常经营，想有收入，想能开发票，就必须购买金税盘和税控盘。而税务ukey可以说是金税盘和税控盘的合并与升级。
1、税务Ukey是免费的（服务商是中得兴盛），而金税盘和税控盘是每年需要付费280元%2F年，才能正常使用（服务商是航天）；
2、电脑是windows系统的，都可以支持安装税务ukey和金税盘的开票软件，而苹果系统的电脑是不支持安装金税盘和税务Ukey的开票软件，
如果苹果系统的电脑想要用金税盘开票，是可以把金税盘把税盘交给航天托管，用网页版，登录51云发票，就可以随时开具电子专票或电子普票，税务Ukey就没有此功能；
3、税务Ukey和金税盘的领完空白发票后，把空白发票读取到税盘的区别：税务Ukey是点发票申领确认-发票分发，分发完成后，就可以直接开发票了，而金税盘是票源管理-网上领票管理-发票下载-发票分配-发票读入，就可以直接发开票了；+4、税务Ukey抄税是点上报汇总，清卡是点反写监控+金税盘抄税是点汇总上传，清卡是点远程清卡。