全电发票开票API接口文档-Toy模板网

这篇具有很好参考价值的文章主要介绍了全电发票开票API接口文档。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

什么是数电票、全电发票？

全面数字化的电子发票（简称全电发票、数电票）是与纸质发票具有同等法律效力的全新发票，不以纸质形式存在、不用介质支撑、无须申请领用、发票验旧及申请增版增量。纸质发票的票面信息全面数字化，多个票种集成归并为电子发票单一票种，全国统一赋码、开具金额总额度管理、自动流转交付。以下简称为全电发票。

所有接口通用的请求格式

HTTP请求URL	https://fpkj.market.alicloudapi.com/kpgl/fpkj
请求方式	POST
接口请求头部信息ContentType	application/x-www-form-urlencoded;charset=UTF-8
HTTP请求参数格式	DATA
HTTP返回参数格式	JSON

2、全电发票开具接口

接口地址:

https://fpkj.market.alicloudapi.com/kpgl/fpkj

参数

token=&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	是	发票种类	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": "2023-01-12T11:20:33",

"skm": "税控码",

"jym": "校验码",

"ewm": "二维码",

"url": "",

"kpjg": "",

"kpfk": ""

}],

"ErrList": [{

"XTLSH": "",

"ErrMsg": ""

}]

}

注意：

Result=0时，说明数据肯定是有异常或流程有异常，此时需要关注下Message这个值。

Result=1时，不代表一定是开票成功，当离线开票或税盘不在线时可能代表接收成功，如果是批量开票时，还需要关注下ErrList这个值，此时有可能是部份成功，部份不成功。

唯一能确定开票成功开票的情况： SucessList列表并且发票号不是为空的情况，如果Result=1并且SucessList列表中返回的发票号码是空的，需要用异步获取开票结果进行获取开票状态。文章来源地址https://www.toymoban.com/news/detail-442663.html

到了这里，关于全电发票开票API接口文档的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！