全电发票接口文档v0

全电发票接口文档(V2.3.0)2023年1月返回示例("Reulst":"1","Message11:二"SucessList":[{"xtlsh":"OOI","fpdm":2,"fphmn:"kprq'1:"2019-01-12Tll:20:33”,"skm":“税控码”,”jym“：”校验码”，"ewm":"二维码”，"url":I"kpjg"："kpfk":""}],"ErrList":[{"XTLSH":""，“ErrMsg"：""}]字段说明字段描述SucessList成功列表Xtlsh单据号Fpdm发票代码Fphm发票号码Kprq开票日期Skm密文Jym校验码Jqbh机器编号Ewm二维码url电子发票下载网址Kpjg开票结果1开票成功0开票失败Kpfk开票反馈信息ErrList失败列表XTLSH系统流水号ErrMsg错误信息注意:Result=O时，说明数据肯定是有异常或流程有异常，此时需要关注下Message这个值。Result=l时，不代表一定是开票成功，当离线开票或税盘不在线时可能代表接收成功，如果是批量开票时，还需要关注下ErrList这个值，此时有可能是部份成功，部份不成功。唯一能确定开票成功开票的情况：SucessList列表并且发票号不是为空的情况，如果Result：1并且SucessList列表中返回的发票号码是空的，需要用异步获取开票结果进行获取开票状态。返回报文参考例子：数据错误报文：{“ResultTO/Message…折扣行的产品单位必需是空。7后山5之[{联71^^:"〈日加59":"折扣行的产品单位必需是空。”}],“SucessList”:口}发票库存不足：{”1^511廿”071\/^$39的”发票已经用完,请申领发票“JErrList”:[{“XTLSH“:"","ErrMsg":"发票已经用完,请申领发票力"SucessList":口}异步或税盘不在线时：{“Resue：ir,「,Message”:"成功"JErrList”:[VSucessList":[{“xtlsh":""Jfpzl":"026”,“fpdm”:“"Jfphm”:“"Jkprq":"“Jskm”：””「力01”：7雄附”:",,,七\根11“:“",”山”:“171^9”:“0“为:^乂“:"”,“1^£1<":"数据保存成功”}]}正常开具：{“ResultTT'/Message”:"成功”JErrList“:[],"SucessList”:[{nxtlsh":"”「fpzl":"026”Jfpdm":“”,"fphm":"",“kprq":"",“skm”："007+l-75\u003c0-42-+64847*2+5/+*11113*448/482-13\u003e\u003e+0173/*4-\uOO3c+89/28424/-\uOO3cO87AuOO3c8**AuOO3cl8313O*+l*13O7Ol+6\uOO3c+1998\uOO3c424',/"jym":,,,,/,,jqbh,,:,,n/newm,,:,,01,01z//111,63///2C4A/I,/nurr,：7KPGL/PDFXZ?XYM=\u0026FPZL=026/kpjg”:T,“pdfxx”:“PDF生成成功“Jkpfk":“开具成功》}重复提交：{书0533“0","1\/|05$的—”此单据已经开过发票,FPHM=:KPRQ=2021-10-2500:00:00.000o；,TrrList,,:[{nXTLSHn:,,^nFPHM,,:,M,f,,KPRQH:n2021-10-2500:00:00.000"z"MW":"[MDAqOTMlLTUyPjM8PjI4KzI8LTM5KzQxLy8wODwlMS0qKjM0OTkyMjUzMjE2PCs5ODw+NjcwODAzMjgriqclNy0rMTclNTYyPDkyLzY5Ny80Kz4qLTkwPjMxKzc20TwyNDcwMTgOMCoxOSO+MTgOPg==],,/nXYMn:,,,,/,,JQBHn:,,,,/,,FPZLT'026"JErrMsg":”此单据已经开过发票，FPHM二:KPRQ=2021-10-2500:00:00.000o”,xtlsh":"","fpzl“:"026“Jfpdm”:“",“fphm”:““Jkprq":/sl<m”:“007+l-75\u003c0-42-+64847*2+5/+*im3*448/482-13\u003e\u003e+0173/*4-\u003c+89/28424/-\u003c087/\u003c8**/\u003cl83130*+l*130701+6\u003c+1998\u003cdZd/ym”:,,,,/',jqbh,,:,,，7，ewm',:',01/01z//111.63z/z2C4A,,,/"urr,：7KPGL/PDFXZ?XYM=\u0026FPZL=026;nkpjg,,:,,l；,,pdfxxn:,TDF^^,,；,kpfk,,:n5:FM^6Wn]/SucessList,,:[]}1.通信约定1、所有的调用都采用POST方式。2、除了获取token接口外，都需要参数token(小写)3、路径中不含127.001的参数不是以JSON进行传送，表单方式提交值：参数1=值1&参数2=值……方式传送，含有127001的，都是以JSON进行传送。4、Content-Type:application/x-www-form-urlencoded;charset=UTF-8o5、返回值是以JSON形式返回，返回值中都有Result和Message节点，Result=l时，表示调用成功，0表示失败，Message,为调用信息。6、参数都是用小写，如果文档自动转换成大写，请忽略大写。7、参数字段说明中，如果没有"是否必需"这一列，说明是必需要有的。8、POSTMAN的具体调用如下：AuthorHeaders(1) • 」q.I- <©Content-Type application/x-www-fomi-urlen<oded;charset«utf-€=XBulkEdHeaders(1)Body•Pre-requestScriptform-data•x-www-form-urlencodedrawbinaryO UserName test。Password1 testkey valueBodyCookiesHeaders(8)TestsPrettyRawPreviewJSONv,•Result'-：T,“TEXT"："系统:电或助I，“ID"：“f37c3Ca41ab04767954"9283fbi3806“9、在接入新税盘之前，必需将税盘密码进行修改（务必进行密码修改，否则锁盘）:航天金税盘密码：百旺税控盘密码：，证书密码：123456Ukey税盘密码：证书密码：10、所有用到Base64的地方，都采用utf-8字符集加密。2.获取token说明：获取平台token,有效期为一年，每次新的登陆会停止原有的Token,在调用业务api时，如果code返回2001-2009,那么需要重新获取一次tokeno路径：/NEWKP/LOGIN/GetToken参数：UserName=［用户名］&Passwordl=［密码］请求示例：UserName=FANSHI84Passwordl=Aal23456返回值：("Result":"1；“Message”：”系统登陆成功。"ID":n［mOqngQUp9/IS5qvk5VuiUZoViBuHCN787eXOHcopVCdw43ZKyS8uzlOIRwlsu7STs4ckgbKvaqZfvi5IRdYT5MvswRBUuWhijy0MtCyDZ/GLsg0wTSh//JhKt/6w9/n7FKCmhTFtlFRff4ESG8BgdEYVxGq/hg3PssuWoIE=-1064deb4dcfa8237e4d5d84-190ACA1704AF55AA9FElE8DE908CAlB6C0E56F1E］"返回值说明：L获取到的ID,用于以下接口的token参数。2、获取到的ID,前后是有口括起来的，请不要去掉中括号。3、以下方法除了第一个和第二个文档中会写完整参数外，其它接口不再写token参数，请调用时自行带上。3、发票开具路径/NEWKP/KPGL/FPKJ参数token=&data=［发票报文json的base64］&spid=说明：（注意：data有个口），发票内容见下面内容字段描述data发票报文json的base64,同时需要对base64用口括号起来spid税盘id发票报文JSON如下（注意：报文节点全大写）：［（“XTLSH":“单据号”，“KHMC”："客户名称、"KHSH":"税号”,"KHDZ":"地址”，“KHKHYHZH”：“客户银行账号”，"FPZL":"发票种类"，nBZH:"备注”,“KPR”:"开票人“，“SKR“：“收款人”，吓HR“：“复核人”，"QYKHYHZH":"企业开户银行账号”,"QYDZDH":"企业地址电话二“YFPHM”：“红冲原发票号”，11VVDPLJ11•11/士白*4白口“"QDBZ":"清单标志"，"KHYJ”：“客户邮件:"KHSJ":“客户手机号”，"JDC":"机动车标识"，"DBTS"："代办退税标识"，“ITEM”：[{"CPMC":"产品名称1；"CPXH":"产品型号二"CPDW"：“产品单位”，"SLH:'税率”，"CPSL":"数量”,"BHSJE":"不含税金额”,“SE”:“税额”，"FLBM":n分类编码”,"XSYH":“税率优惠二"LSLBZ":"零税率标识”,"YHSM":"优惠说明”，“KCJETO”"CPMC"：”产品名称2","CPXH":"产品型号、"CPDW":"产品单位、"SLH:“税率”,"CPSL":“数量”，"BHSJE":"不含税金额","SE":"税额"，“FLBM"："分类编码”,"XSYH":“税率优惠”，"LSLBZ":"零税率标识”,"YHSM":“优惠说明”，"KCJE":nO"}]}]字段是否必需（否的节点，可以不带此节点）描述说明XTLSH是单据号（相当于订单号）唯一字段KHMC是客户名称KHSH否客户税号KHDZ否客户地址KHKHYHZH否开户银行账号FPZL是发票种类020全电专票021全电普票BZ否备注KPR否开票人SKR否收款人FHR否复核人QYKHYHZH否销方银行账号QYDZDH否销方地址电话YFPHM条件是原发票号（原发票代码+原发票号码）红字发票必传，普票和电票必有，注意：含（代码）总共18位或20位。XXBBH条件是信息表编号红字专票必传，普票电票不需要传。QDBZ否清单标志默认为0KHYJ否客户邮件自动发牛KHSJ否客户手机JDC否机动车标识1为开具机动车专票DBTS否代办退税标识1为开具代办退税发票ITEM信息CPMC是产品名称如果是