【数电发票】数电发票财务对接开票接口

数电发票出来很久了，我们的系统也运行了很久，在客户中运行良好，在此公布一下对接接口

接口文档
（v2.4.0）

2023年2月

4.1、全电发票开具（含蓝字和红字发票）
路径
Https://SH-GZ.CN/NEWKP/KPGL/FPKJ
参数(注意用POST方式，不要用GET方式)
data=[发票报文json的base64]&spid=
说明：(注意：data有个[])，发票内容见下面内容
字段描述
data 发票报文json的base64，同时需要对base64用[]括号起来
spid 税盘id
发票报文JSON如下（注意：报文节点全大写）：
[{
“XTLSH”: “单据号”,
“KHMC”: “客户名称”,
“KHSH”: “税号”,
“KHDZ”: “地址”,
“KHKHYHZH”: “客户银行账号”,
“FPZL”: “发票种类”,
“BZ”: “备注”,
“KPR”: “开票人”,
“SKR”: “收款人”,
“FHR”: “复核人”,
“QYKHYHZH”: “企业开户银行账号”,
“QYDZDH”: “企业地址电话”,
“YFPHM”: “红冲原发票号”,
“XXBBH”: “信息表编号”,
“QDBZ”: “清单标志”,
“KHYJ”: “客户邮件”,
“KHSJ”: “客户手机号”,
“JDC”: “机动车标识”,
“DBTS”: “代办退税标识”,
“ITEM”: [{
“CPMC”: “产品名称1”,
“CPXH”: “产品型号”,
“CPDW”: “产品单位”,
“SL”: “税率”,
“CPSL”: “数量”,
“BHSJE”: “不含税金额”,
“SE”: “税额”,
“FLBM”: “分类编码”,
“XSYH”: “税率优惠”,
“LSLBZ”: “零税率标识”,
“YHSM”: “优惠说明”,
“KCJE”:“0”
}, {
“CPMC”: “产品名称2”,
“CPXH”: “产品型号”,
“CPDW”: “产品单位”,
“SL”: “税率”,
“CPSL”: “数量”,
“BHSJE”: “不含税金额”,
“SE”: “税额”,
“FLBM”: “分类编码”,
“XSYH”: “税率优惠”,
“LSLBZ”: “零税率标识”,
“YHSM”: “优惠说明”,
“KCJE”:“0”
}]
}]
字段是否必需（否的节点，可以不带此节点）描述说明
XTLSH 是单据号（相当于订单号）唯一字段
KHMC 是客户名称
KHSH 否客户税号专票（纸专、电专和全电专票）必传
KHDZ 否客户地址
KHKHYHZH 否开户银行账号
FPZL 是发票种类 004专票 007 普票 026 电票 028 电专 020 全电专票 021 全电普票
BZ 否备注
KPR 否开票人
SKR 否收款人
FHR 否复核人
QYKHYHZH 否销方银行账号
QYDZDH 否销方地址电话
YFPHM 条件是原发票号(原发票代码+原发票号码) 红字发票必传，普票和电票必有，注意：含（代码）总共18位或20位。
XXBBH 条件是信息表编号红字专票必传，普票电票不需要传。
QDBZ 否清单标志默认为0
KHYJ 否客户邮件自动发邮件
KHSJ 否客户手机
JDC 否机动车标识 1为开具机动车专票
DBTS 否代办退税标识 1为开具代办退税发票
ITEM信息
CPMC 是产品名称如果是折扣行，必需与正数行一致的名称
CPXH 否产品型号如果是折扣行，此值为空
CPDW 否产品单位如果是折扣行，此值为空
SL 是税率
CPSL 否产品数量红冲时为负，红冲时，不能有正数金额。
BHSJE 是不含税金额红冲时为负
SE 是税额红冲时为负
FLBM 是分类编码必需到未级编码
XSYH 否税收优惠有优惠1 无优惠0
LSLBZ 否零税率标识 SL=0时需要设置
1、免税（同时XSYH需设置成1），2、不征税（同时XSYH需设置成1），3、其它或0税率
Sl<>0时，值为空
YHSM 否优惠政策说明
KCJE 否扣除金额差额开票时有用

返回示例
{
“Reulst”: “1”,
“Message”: “”,
“SucessList”: [{
“xtlsh”: “001”,
“fpzl”: “”,
“fpdm”: “1233456789012”,
“fphm”: “12345678”,
“kprq”: “2019-01-12T11:20:33”,
“skm”: “税控码”,
“jym”: “校验码”,
“ewm”: “二维码”,
“url”: “”,
“kpjg”: “”,
“kpfk”: “”
}],
“ErrList”: [{
“XTLSH”: “”,
“ErrMsg”: “”
}]
}

字段说明
字段描述
SucessList 成功列表
xtlsh 单据号
fpdm 发票代码
fphm 发票号码
kprq 开票日期
skm 密文
jym 校验码
jqbh 机器编号
ewm 二维码
url 电子发票下载网址
kpjg 开票结果1开票成功 0开票失败
kpfk 开票反馈信息
ErrList 失败列表
XTLSH 系统流水号
ErrMsg 错误信息
注意：
Result=0时，说明数据肯定是有异常或流程有异常，此时需要关注下Message这个值。
Result=1时，不代表一定是开票成功，当离线开票或税盘不在线时可能代表接收成功，如果是批量开票时，还需要关注下ErrList这个值，此时有可能是部份成功，部份不成功。
唯一能确定开票成功开票的情况： SucessList列表并且发票号不是为空的情况，如果Result=1并且SucessList列表中返回的发票号码是空的，需要用异步获取开票结果进行获取开票状态。

返回报文参考例子：
数据错误报文：
{“Result”:“0”,“Message”:“折扣行的产品单位必需是空。”,“ErrList”:[{“XTLSH”:“144115188078156755”,“ErrMsg”:"折扣行的产品单位必需是空。 "}],“SucessList”:[]}
发票库存不足：
{“Result”:“0”,“Message”:“发票已经用完，请申领发票”,“ErrList”:[{“XTLSH”:“144115188078708534”,“ErrMsg”:“发票已经用完，请申领发票”}],“SucessList”:[]}

异步或税盘不在线时：
{“Result”:“1”,“Message”:“成功”,“ErrList”:[],“SucessList”:[{“xtlsh”:“144115188078732376”,“fpzl”:“026”,“fpdm”:“”,“fphm”:“”,“kprq”:“”,“skm”:“”,“jym”:“”,“jqbh”:“”,“ewm”:“”,“url”:“”,“kpjg”:“0”,“pdfxx”:“”,“kpfk”:“数据保存成功”}]}
正常开具：
{“Result”:“1”,“Message”:“成功”,“ErrList”:[],“SucessList”:[{“xtlsh”:“144115188079268993”,“fpzl”:“026”,“fpdm”:“044002100411”,“fphm”:“22338521”,“kprq”:“20211026”,“skm”:“007+1-75\u003c0-42-+648472+5/+11113448/482-13\u003e\u003e+0173/97759224-\u003c+89/28424/-\u003c087/\u003c8**/\u003c183130*+1130701+6\u003c+1998\u003c424",“jym”:“06441947523575629741”,“jqbh”:“237001069144”,“ewm”:“01,01,044002100411,22338521,111.63,20211026,06441947523575629741,2C4A,”,“url”:“/KPGL/PDFXZ?XYM=06441947523575629741\u0026FPZL=026”,“kpjg”:“1”,“pdfxx”:“PDF生成成功”,“kpfk”:“开具成功”}]}
重复提交：
{“Result”:“0”,“Message”:“此单据已经开过发票, FPHM = 03100210041182467316:KPRQ =2021-10-25 00:00:00.000。”,“ErrList”:[{“XTLSH”:“144115188079291147”,“FPHM”:“03100210041182467316”,“KPRQ”:“2021-10-25 00:00:00.000”,“MW”:“[MDAqOTM1LTUyPjM8PjI4KzI8LTM5KzQxLy8wODw1MS0qKjM0OTkyMjUzMjE2PCs5ODw+NjcwODAzMjgrKjc1Ny0rMTc1NTYyPDkyLzY5Ny80Kz4qLTkwPjMxKzc2OTwyNDcwMTg0MCoxOS0+MTg0Pg==]”,“XYM”:“06182134178896463325”,“JQBH”:“587005306549”,“FPZL”:“026”,“ErrMsg”:"此单据已经开过发票, FPHM = 03100210041182467316:KPRQ =2021-10-25 00:00:00.000。 “,xtlsh”:“144115188079291147”,“fpzl”:“026”,“fpdm”:“031002100411”,“fphm”:“82467316”,“kprq”:"20211025,“skm”:"007+1-75\u003c0-42-+648472+5/+11113448/482-13\u003e\u003e+0173/97759224-\u003c+89/28424/-\u003c087/\u003c8**/\u003c183130+1*130701+6\u003c+1998\u003c424”,“jym”:“06182134178896463325”,“jqbh”:“237001069144”,“ewm”:“01,01,044002100411, 82467316,111.63,20211025, 06182134178896463325,2C4A,”,“url”:“/KPGL/PDFXZ?XYM=06182134178896463325\u0026FPZL=026”,“kpjg”:“1”,“pdfxx”:“PDF生成成功”,“kpfk”:“开具成功”],“SucessList”:[]}
4.2、重新审核单据（将待开票的数据重新提交开票）
路径
/NEWKP/KPGL/SHKP
参数：
spid=&data=
其中data是json报文进行base64编码
Json报文如下：
[{“fpzl”:“021”,“xtlsh”:“20230301194210136866”}]
字段是否必需描述
spid 是 spid
data 是 json报文进行base64后的编码
fpzl 是发票种类
xtlsh 是单据号
注意：json是一个list，同时可以有多张单据审核。
返回值：
{“Result”:“1”,“Message”:“成功，离线开票模式！”,“ErrList”:[],“SucessList”:[]}
4.3、获取列表或信息（已开发票、未开发票、进行中的）
路径
/NEWKP/KPGL/FPLIST
参数：
fpzl=&qsrq=&jzrq=&mxbz=&qysh=&spid=&pageindex=&pagesize=&fpzt=& zfbz=&gjz=&isupload=&fphm=&xxbbh=&xtlsh=&iszsfp=&isfsfp=
字段是否必需描述
qsrq 条件必需起始日期(xtlsh 和 fphm为空时必需输入)
jzrq 条件必需截止日期(xtlsh 和 fphm为空时必需输入)
qysh 条件必需企业税号与spid其中一个不能为空
spid 条件必需税盘id 与qysh其中一个不能为空
mxbz 是 1，需要获取明细 0不需要获取明细
fpzl 否发票种类
fpzt 否发票状态0 查询批量开票数据（待开票的）1 已开票(不传时默认)，2开票中
zfbz 否作废标志0 未作废 1已作废
gjz 否关键字，搜索内容为客户名称，发票号，流水号
isupload 否是否上传税务局 0 未上传 1已上传
fphm 否发票号，查询某张发票号
xxbbh 否信息表编号
xtlsh 否单据号
iszsfp 否正数发票
isfsfp 否负数发票
pageindex 是当前页
pagesize 是每页最大数
返回示例
{
“Result”: “1”,
“Message”: “成功”,
“total”: 1,
“rows”: [
{
“xtlsh”: “527dcfdfd3cac8271e29d9461995efa5”,
“spid”: “33d325019df04c21b2e6273b2ff143a3”,
“qysh”: “91440101340088133N”,
“xfyh”: “XXXX”,
“xfdz”: “XXXX”,
“fplxdm”: “004”,
“fpdm”: “4400203130”,
“fphm”: “37839682”,
“kprq”: “2021-03-07 00:00:00”,
“ghdwsbh”: “91440101340088133N”,
“ghdwmc”: “XXXX”,
“ghdwdzdh”: “chaingz”,
“ghdwyhzh”: “6666666666666666”,
“hjje”: “369”,
“hjse”: “47.97”,
"jshj ": “416.97”,
“url”: “”,
“skr”: “XXXX”,
“fhr”: “XXXX”,
“kpr”: “XXXX”,
“bz”: “bzxx”,
“yfpdm”: “”,
“yfphm”: “”,
“tzdbh”: “”,
“chfpdm”: “”,
“chfphm”: “”,
“spr”: “qq.com”,
“fpdyzt”: “0”,
“qdbz”: “0”,
“xym”: “”,
“jqbh”: “”,
“zfbz”: “0”,
“zfrq”: “”,
“fpmx”: [
{
“spmc”: “”,
“dj”: “”,
“sl”: “”,
“spsl”: “”,
“je”: “”,
“se”: “”,
“ggxh”: “”,
“dw”: “”,
“flbm”: “”,
“xsyh”: “”,
“lslbz”: “”,
“yhsm”: “”
}
]
}
]
}
返回结果字段说明
字段描述说明
xtlsh 单据号传过来的XTLSH
spid 税盘ID
qysh 开票税号
xfyh 销方银行和账号
xfdz 销方地址电话
fplxdm 发票类型代码
fpdm 发票代码
fphm 发票号码
kprq 开票日期
ghdwsbh 购货单位识别号
ghdwmc 购货单位名称
ghdwdzdh 购货单位地址和电话
ghdwyhzh 购货单位银行账号
hjje 整张发票的合计不含税金额
hjse 整张发票的合计税额
jshj 整张发票的价税合计
url 电子发票的URL
skr 收款人
fhr 复核人
kpr 开票人
bz 备注
yfpdm 原发票代码
yfphm 原发票号码
tzdbh 信息表编号
chfpdm 红冲发票代码
chfphm 红冲发票号码
spr 收件人（电子邮箱）
fpdyzt 发票打印状态
qdbz 清单标志
xym 校验码
jqbh 机器编号
zfbz 作废标志
zfrq 作废日期
fpmx
spmc 商品名称
dj 单价
sl 税率
spsl 数量
je 金额
se 税额
ggxh 规格型号
dw 单位
flbm 分类编码
xsyh 税收优惠
lslbz 零税率标识
yhsm 优惠说明

4.4、获取开票结果（异步方式）
路径
/NEWKP/KPGL/KPJG
参数
fpzl=&xtlsh=&spid=
字段说明：
字段是否必需描述
fpzl 是发票种类
xtlsh 是单据号
spid 是税盘ID
返回：
{
“Result”: “1”,
“Message”: “”,
“XTLSH”: “001”,
“FPHM”: “123345678901212345678”,
“KPRQ”: “2019-01-12T11:20:33”,
“MW”: “税控码”,
“XYM”: “校验码”,
“JQBH”: “机器编号”,
“URL”: “”,
“SWQM”: “”
}

字段说明
字段描述
XTLSH 单据号
FPHM 发票号码（18位或20位）含代码
KPRQ 开票日期
MW 密文
XYM 校验码
JQBH 机器编号
URL 电子发票下载网址

1、FPKJ成功的接口才能来调用kpjg
Result=0 表示调用失败或开票失败，你需要注意message描述信息
Result=1 表示调用成功，并且开具成功
2、code=100，说明是调用错误，请认真看调用参数
3、Code=200 说明调用的结果是从缓存中取的数据
4、FPZT=0 表示数据当前在待审核中，FPZT=2 表示数据当前在进行中，FPZT=1表示当前数据在已开发票
5、FPZT=2可以隔一段时间再来查询一次，FPZT=0，可以将错误信息显示给用户，如果用户需要重新审核开具，调用审核接口，
6、Message中包括身份认证已超时时，需要重新扫脸了
1、按名称查税号(额外付费)
路径
/NEWKP/JCZL/ZNKHZL
参数
khmc=
字段描述
khmc 企业名称

返回{
“Result”:“1”,
“Message”:“成功”,
“KHZLList”:[
{
“AddressAndTel”:“深圳市南山区粤海街道滨海社区海天二路25号深圳湾创业投资大厦34层01B号 0755-36510101”,
“BankNameAndNo”:“招商银行深圳高新园支行 755913405210604”,
“clientName”:“深圳用友软件有限公司”,
“clientTaxNo”:“914403007954179686”,
“taxNo”:“233424ff4eaa4fc78e4edb14335e0f57”
},
{
“AddressAndTel”:“江西省南昌市红谷滩新区嘉言路668号语音服务中心(第1-8层) 0791-82220817”,
“BankNameAndNo”:“工行南昌火炬大道支行 1502007319000033101”,
“clientName”:“江西用友软件有限责任公司”,
“clientTaxNo”:“91360106674971815A”,
“taxNo”:“b7f28117bba24462afb2d9247d59e169”
}
]
}
2、智能编码(额外付费)
路径
/NEWKP/JCZL/ZNBM
参数
cpmc=
字段描述
cpmc 产品名称

返回：
{
“Result”:“1”,
“Message”:“调用成功”,
“FLBMList”:[
{“BM”:“”,“MC”:“”}
]
}
3、获取人脸二维码
路径
/NEWKP/TERM/QRCODE
参数
spid=
字段描述
spid 税盘id

返回报文：
{“Result”:“1”,“Message”:“正常”,“Qrcode”:“qrcode_id=GoxyDRLmU7tuqev4G6oAZcN7IPdfOiLVk0yDLgRmqagFAdAvmDp7i7Yobk7zzkNM\u0026areaPrefix=3502\u0026interfaceCode=0004”}

【数电发票】数电发票财务对接开票接口相关推荐

json支持utf-8_发票查重百科支持系统对接
1 你还不知道吗?电子发票查重工具可以对接! 接口用途通过电子发票查重工具数据接口,可以将已扫描登记的电子发票台账及上传的电子发票原件自动同步到企业的财务软件.OA系统或ERP系统等办公软件中,完成 ...
与公司开票接口对接的设计
为什么要对接改造? 我们公司是做增值税管理系统的,增值税系统涉及到开发票的业务,需要与不同的供应商对接开票接口,供应商提供的开票接口,包括四种:A1供应商有两种,第一种是开票服务器,第二种是税盒 A2 ...
常用电商系统优劣势对比—管易云、远丰电商、电商宝、海商、旺店通ERP、百数
如今,各大电商行业已经风生水起,京东.天猫.淘宝各大电商商城已经无人不知无人不晓,那么面对每天滔滔不绝不绝的订单,你需要如果去处理呢?毋庸置疑,面对大批量的订单和各渠道的店铺,你肯定需要一个成熟实际而 ...
数电与模电的根本区别转
要回答这个问题,首先要弄清数电与模电的根本区别到底在哪. 1).个人认为,在应用上两者之间最主要的差别是两者的工作逻辑不同.一般来说,数字电路设计做好数字逻辑就差不多了,----剩下和问题就交给模拟去 ...
立创EDA助力2021全国电赛数百万奖学金！
持续助力电赛,100年!!! 全国竞赛是全国性的大学生学科竞赛活动,竞赛按照紧密结合教学实际,着重基础.注重前沿的原则开展,目的在于促进电子信息类专业和课程的建设,引导高等学校在教学中注重培养大学生的 ...
西电高数上册期末考试题
#2021年12月(次年3月考)西电高数上册期末考试题及答案西电期末考试题由于出题比较新,每年的出题人不同,题目难度逐年提升,加上高数占的学分比较大,非常影响均分.希望大家好好利用资源复习.本资源是 ...
1000份电子技术（模电、数电、电子元件、电路视频教程）全套资料！
小编花了一周的时间精心整理了电子技术(模电.数电.电子元件.电路视频教程)全套资料!赶紧收藏吧! 里面包含的资料如下: 模电.数电及电路学习电子设计100例 800个电子设计竞赛毕业设计产品电路基 ...
电分、模电、数电总复习之爱课堂题目概念整理
本文模电数电部分转载自博客园_模电数电爱课堂概念题整理模电.数电总复习之爱课堂题目概念整理电分总复习之爱课堂题目概念整理(原创)(不定期更新) 模电总复习之爱课堂题目概念整理 Chapter 1 ...
数据仓库项目（第五节）数仓理论、电商业务数仓介绍与创建
目录数仓理论表的分类实体表维度表事务型事实表周期型事实表同步策略实体表同步策略维度表同步策略事务型事实表同步策略周期型事实表同步策略范式理论范式概念函数依赖三范式区分关 ...

【数电发票】数电发票财务对接开票接口

【数电发票】数电发票财务对接开票接口相关推荐

最新文章

热门文章