税务数字化管理平台
  1. 乐企
税务数字化管理平台
  • 对外接口
    • 文档概览
    • 如何调用接口
    • 更新记录
    • 常见问题
    • 接口码表
    • 销项
      • 税控
        • 发票领购查询
        • 发票作废
        • 空白发票作废
        • 红字信息表申请
        • 红字信息表查询
        • 红字信息表撤销
        • 红字信息表准备信息查询
        • 发票开具(专、普、电)
      • 数电
        • 红字确认单申请准备信息查询
        • 红字确认单申请
        • 查询红字确认单详细信息
        • 红字确认单撤销
        • 红字确认单查询
        • 红字确认单确认
        • 异常红字确认单下载
        • 全电发票开具
        • 人脸识别二维码
        • 获取全电开票结果
        • 获取全电全票面数据
        • 全电认证
        • 短信认证
        • 全电交付
        • 成品油库存台账查询
        • 全电纸质发票作废
        • 获取人脸识别结果
        • 获取红字确认单申请结果
        • 获取数电发票下载地址
        • 红字全电发票开具
        • 获取纸质发票打印XML
        • 发送发票数据到控件
        • 开启打印窗口
        • 蓝字发票数据统计
        • 版式文件下载
        • 批量红字确认单下载
        • 获取当前发票代码号码(数电纸票)
        • 查询跨区域涉税事项报验管理编码
        • 检查账号在线状态
        • 查询身份授权(用户是否需要人脸认证)状态
      • 乐企
        • 获取批量预赋码信息
          POST
        • 查询授信额度
          POST
        • 下载/退回授信额度
          POST
        • 调整授信额度有效期
          POST
        • 查询纳税人风险信息
          POST
        • 查询纳税人基本信息
          POST
        • 查询可用税率信息
          POST
        • 查询数字化电子红字确认单列表信息
          POST
        • 数字化电子红字确认单确认
          POST
        • 查询数字化电子红字确认单明细信息
          POST
        • 再次上传数电发票
          POST
        • 废弃乐企异常发票
          POST
        • 数电发票开具
          POST
        • 数电发票开具(实时开票)
          POST
        • 数字化电子红字确认单申请
          POST
      • 扫码开票
        • 二维码生成规则
        • 扫码开票订单导入
        • 扫码开票订单查询
        • 扫码开票订单作废
      • 发票查询
        POST
      • 单张发票查询
        POST
      • 商品导入
        POST
      • 客户导入
        POST
      • 批量待开导入
        POST
      • 待开分页查询
        POST
      • 批量单据导入
        POST
      • 单据分页查询
        POST
      • 账号注册
        POST
      • 全票种开具
        POST
      • 抬头联想
        POST
      • 单张发票修复
        POST
  1. 乐企

数电发票开具(实时开票)

POST

1、接口及场景描述#

接口描述: 实时开具数电发票,乐企平台的上传结果实时返回。

2、请求参数#

名称必选类型长度描述
method是string100固定值sdfpsskj
object是Object[]1请求参数,长度为1
fpqqlsh否string100发票请求流水号 用于查询开票结果 未传自动生成
lzfpbz是string1蓝字发票标志 0:蓝字发票 1:红字发票
当传0时表示开具蓝字发票当传1时表现开具红字发票
ptbh否string20平台编号
fppz是string2发票票种 01:数电专 02:数电普
gmfzrrbz否string1购买方自然人标志
Y:购买方是自然人 N:购买方非自然人
tdys否string2特定要素 空:非特定要素
01:成品油发票
03:建筑服务发票
04:货物运输服务发票
05:不动产销售服务发票
06:不动产经营租赁服务发票
09:旅客运输服务发票
18:卷烟发票
32:电子烟发票
qydm否string20区域代码
cezslxDm否string2差额征税类型代码
空:非差额发票
01:全额开票
02:差额开票
sgfplxDm否string2收购发票类型代码
空:非收购发票
01:农产品收购发票
02:光伏收购发票
03:二手车收购发票
ckywsyzcDm否string2出口业务适用政策代码
空:非出口业务
01:退税政策
02:免税政策
03:征税政策
zzsjzjtDm否string2增值税即征即退代码
空:非增值税即征即退
01:软件产品发票
02:资源综合利用产品发票
03:管道运输服务发票
04:有形动产融资租赁服务
05:有形动产融资性售后回租服务发票
06:新型墙体材料发票
07:风力发电产品发票
08:光伏发电产品发票
09:动漫软件产品发票
10:飞机维修劳务发票
11:黄金发票
12:铂金发票
xsfdz否string300销售方地址
xsfdh否string60销售方电话
xsfkhh否string120销售方开户行
xsfzh否string50销售方账号
gmfnsrsbh否string20(购买方)统一社会信用代码/纳税人识别号/身份证件号码
gmfmc是string300(购买方)名称
gmfdz否string300购买方地址
gmfdh否string60购买方电话
gmfkhh否string120购买方开户行
gmfzh否string50购买方账号
gmfjbr否string150购买方经办人姓名
jbrsfzjhm否string30经办人身份证件号码
gmfjbrlxdh否string60经办人联系电话
hjje是string18,2合计金额
hjse是string18,2合计税额
jshj是string18,2价税合计
skyhmc否string120收款银行名称
skyhzh否string100收款银行账号
jsfs否string2结算方式 01:现金 02:银行转账 03:票据
04:第三方支付 05:预付卡 99:其他
ysxwfsd否string11应税行为发生地
kpr是string300开票人
kprzjhm否string30开票人证件号码
kprzjlx否string4开票人证件类型
dylzfphm否string20对应蓝字发票号码:当lzfpbz-蓝字发票标志为0时,必须为空,
当lzfpbz-蓝字发票标志为1时,代表要开具红字发票需要填写与之对应的蓝字发票号码
hzqrxxdbh否string20红字确认信息单编号:当lzfpbz-蓝字发票标志为0时,必须为空,
当lzfpbz-蓝字发票标志为1时,代表要开具红字发票需要填写该蓝字发票对应申请的红字确认单编号
hzqrduuid否string32红字确认单 uuid:当lzfpbz-蓝字发票标志为0时,必须为空,
当lzfpbz-蓝字发票标志为1时,代表要开具红字发票需要填写该蓝字发票对应申请的红字确认单UUID
bz否string450备注
ip否string20服务器地址
macdz否string20mac地址
cpuid否string20CPU 序列号
zbxlh否string20主板序列号
sfzsxsfyhzhbq否string1是否展示销售方银行账号标签 Y:展示 N:不展示
sfzsgmfyhzhbq否string1是否展示购买方银行账号标签 Y:展示 N:不展示
skrxm否string150收款人姓名
fhrxm否string75复核人姓名
fpmxList是Object[]商品明细数组
dylzfpmxxh否string8对应蓝字发票明细序号:当lzfpbz-蓝字发票标志为0时,必须为空,
当lzfpbz-蓝字发票标志为1时,代表要开具红字发票需要填写蓝字发票的明细序号
mxxh是string8明细序号
xmmc是string600项目名称
spfwjc是string120商品服务简称
hwhyslwfwmc是string300货物或应税劳务、服务名称 格式必须是*商品服务简称*项目名称
ggxh否string150规格型号
dw否string300单位
sl否string25数量,选填;如单价为空,则必填
dj否string25单价,选填;如数量为空,则必填
je是string18,2金额
slv是string16,6增值税税率/征收率
se是string18,2税额
hsje是string18,2含税金额
kce否string18,2差额征税扣除额
sphfwssflhbbm是string19商品和服务税收分类合并编码
fphxz是string2发票行性质 00:正常行 01:折扣行 02:被折扣行
yhzcbs否string2优惠政策标识01:简易征收 02:稀土产品
03:免税 04:不征税 05:先征后退 06:100%先征后退
07:50%先征后退 08:按 3%简易征收 09:按 5%简易征收
10:按 5%简易征收减按1.5%计征 11:即征即退30% 12:即征即退 50%
13:即征即退70% 14:即征即退100% 15:超税负3%即征即退
16:超税负8%即征即退 17:超税负12%即征即退 18:超税负6%即征即退
(旅客运输特定业务参数,类型均为string)
字段名称必须长度说明
cxrxh出行人序号否8
cxr出行人否20
cxrzjlxDm出行人证件类型否20100:单位
101:组织机构代码证
102:营业执照
103:税务登记证
199:其他单位证件
200:个人
201:居民身份证
202:军官证
203:武警警官证
204:士兵证
205:军队离退休干部证
206:残疾人证
207:残疾军人证(1-8级)
208:外国护照
209:港澳同胞回乡证
210:港澳居民来往内地通行证
211:台胞证
212:中华人民共和国往来港澳通行证
213:台湾居民来往大陆通行证
214:大陆居民往来台湾通行证
215:外国人居留证
216:外交官证
217:使(领事)馆证
218:海员证
219:香港永久性居民身份证
220:台湾身份证
221:澳门特别行政区永久性居民身份证
222:外国人身份证件
223:高校毕业生自主创业证
224:就业失业登记证
225:退休证
226:离休证
227:中国护照
228:城镇退役士兵自谋职业证
229:随军家属身份证明
230:中国人民解放军军官转业证书
231:中国人民解放军义务兵退出现役证
232:中国人民解放军士官退出现役证
233:外国人永久居留身份证(外国人永久居留证)
234:就业创业证
235:香港特别行政区护照
236:澳门特别行政区护照
237:中华人民共和国港澳居民居住证
238:中华人民共和国台湾居民居住证
239:《中华人民共和国外国人工作许可证》(A类)
240:《中华人民共和国外国人工作许可证》(B类)
241:《中华人民共和国外国人工作许可证》(C类)
291:出生医学证明299:其他个人证件
sfzjhm有效身份证件号否20
chuxrq出行日期否格式:yyyy-MM-dd
cfd旅客出发地否80
ddd旅客到达地否80
zwdj等级否20交通工具为火车时:
一等座
二等座
软席(软座、软卧)
硬席(硬座、硬卧)

交通工作为飞机时:
公务舱
头等舱
经济舱

交通工具为船舶(不包括旅游船)时:
一等舱
二等舱
三等舱
jtgjlxDm交通工具类型否801:飞机
2:火车
3:长途汽车
4:公共交通
5:出租车
6:汽车
7:船舶
9:其他

3、返回参数#

名称是否必返回类型描述
code是integer返回代码
msg是string返回消息
data否object返回数据
fpqqlsh否string发票请求流水号
fphm否string发票号码
kprq否string开票日期

4、返回code码表#

代码(code)描述
0开具成功
1开具中 (此时发票的验签结果为“乐企上传中”,支持 再次上传)
2开具失败
3重复开具
-1000蓝字发票标志,必填,取值范围为"0"、"1",传0时为蓝字发票,传1时为红字发票
-1001服务器地址,必填,长度 20 位
-1002mac 地址,必填,长度 20 位
-1003CPU 序列号,选填,长度 20 位
-1004主板序列号,选填,长度 20 位
-1005发票票种,必填,取值范围为"81"、"82"
-1006特定要素,选填,取值范围为"空"、"01"、"02"、"03"、"04"、"05"、"06"、"07"、"08"、"09"、"10"、"11"、"12""05"、"06"、"07"、"08"、"09"、"10"、"11"、"12"
-1008收购发票类型代码,选填,取值范围为"空"、"01"、"02"、"03"
-1009差额征税类型代码,选填,取值范围为"空"、"01"、"02"
-1010出口业务适用政策代码,选填,取值范围为"空"、"01"、"02"、"03"
-1011增值税即征即退代码,选填,取值范围为"空"、"01"、"02"、"03"、"04"、"05"、"06"、"07"、"08"、"09"、"10"、"11"、"12"
-1012销售方地址,选填,最大长度 300 位
-1013销售方电话,选填,最大长度 60 位
-1014销售方开户行,选填,最大长度 120 位
-1015销售方账号,选填,最大长度 100 位
-1016购买方纳税人识别号,选填,最大长度 26 位
-1017购买方名称,必填,最大长度 300 位
-1018购买方地址,选填,最大长度 300 位
-1019购买方电话,选填,最大长度 60 位
-1020购买方开户行名称,选填,最大长度 120 位
-1021购买方开户行银行账号,选填,最大长度 100 位
-1022经办人,选填,最大长度 150 位
-1023经办人身份证件号码,选填,最大长度 30 位
-1024经办人联系电话,选填,最大长度 60 位
-1025合计金额,必填,最大长度 18 位,最多 2 位小数
-1026合计税额,必填,最大长度 18 位,最多 2 位小数
-1027价税合计,必填,最大长度 18 位,最多 2 位小数
-1028收款银行名称,选填,最大长度 120 位
-1029收款银行账号,选填,最大长度 100 位
-1030结算方式,选填,取值范围为"01"、"02"、"03"、"04"、"05"、"99"
-1031应税行为发生地,选填,最大长度 11 位
-1032开票人,必填,最大长度 300 位
-1033开票人证件号码,选填,最大长度 30 位
-1034开票人证件类型,选填,最大长度 4 位
-1035对应蓝字发票号码,选填,长度 20 位,当lzfpbz:蓝字发票标志为0时可不填,为1时需要填写对应的蓝字发票号码
-1036红字确认信息单编号,选填,最大长度 20 位,当lzfpbz:蓝字发票标志为0时可不填,为1时需要填写对应的红字确认单编号
-1037红字确认单 uuid,选填,最大长度 32 位,当lzfpbz:蓝字发票标志为0时可不填,为1时需要填写对应的红字确认单UUID
-1038备注,选填,最大长度 460 位
-1039对应蓝字发票明细序号,选填,最大长度 8 位,当lzfpbz:蓝字发票标志为0时可不填,为1时需要填写对应的蓝字发票明细序号
-1040项目名称,必填,最大长度 600 位。
-1041规格型号,选填,最大长度 150 位
-1042单位,选填,最大长度 300 位
-1043数量,数量、单价应同时为空,或同时不为空。请核实数量与单价,最大长度 25 位
-1045金额,必填,最大长度 18 位,最多 2 位小数
-1046增值税税率/征收率,必填,最大长度 16 位,最多 6 位小数。必须在可用税率信息中存在
-1047税额,必填,最大长度 18 位,最多 2 位小数
-1048含税金额,必填,最大长度 18 位,最多 2 位小数
-1049扣除额,选填,最大长度 18 位,最多 2 位小数
-1050商品和服务税收分类合并编码,必填,最大长度 19 位。必须在商品编码信息中存在
-1051发票行性质,必填,取值范围为"0"、"1"、"2"
-1052优惠政策标识,选填,不为空时取值范围为"01"、"02"、"03"、"04"、"05"、"06"、"07"、"08"、"09"、"10"、"11"、"12"、"13"、"14"、"15"、"16"、"17"、"18"
-1053附加要素名称,选填,最大长度 200 位
-1054附加要素类型,选填,最大长度 200 位
-1055附加要素值,选填,最大长度 200 位
-1056没有查询到可用的预赋码段信息,请通过预赋码段管理模块下载或者通过接口下载
-1057授信额度不足或超过有效期,请通过授权额度管理功能或者接口更新授信额度信息
-1058企业为风险纳税人及风险等级高的纳税人禁止开票
-1059税率信息不在可用税率的范围内,请在页面进行同步
-1060单价乘数量与金额误差应小于等于1分钱
-1061所有商品行金额之和与合计金额误差应小于等于1分钱
-1062金额乘税率与税额误差应小于等于6分钱
-1063所有商品行的金额乘税率之和与合计税额的差额应小于1.27
-1064折扣行的商品名称应与原发票行一致
-1065区域代码不能为空,必填,最大长度为200位
-1066hwhyslwfwmc 格式必须是*商品简称*项目名称,必填"
-1067商品简称,必填,商品简称不能为空
-1068货物或应税劳务服务名称拼装规则应为*商品服务简称*+项目名称
-1069开具数电专票时,购方纳税人识别号不能为空
-1070明细序号,必填,最大长度8位
-1071购买方自然人标志,选填,取值范围为“Y”、“N”
-1081本地无该红字确认单明细信息

请求参数

Body 参数application/json
method
string 
必需
object
array [object {47}] 
必需
fpqqlsh
string 
可选
lzfpbz
string 
必需
ptbh
string 
可选
fppz
string 
必需
gmfzrrbz
string 
可选
tdys
string 
可选
cezslxDm
string 
可选
sgfplxDm
string 
可选
ckywsyzcDm
string 
可选
zzsjzjtDm
string 
可选
xsfdz
string 
可选
xsfdh
string 
可选
xsfkhh
string 
可选
xsfzh
string 
可选
gmfnsrsbh
string 
可选
gmfmc
string 
必需
gmfdz
string 
可选
gmfdh
string 
可选
gmfkhh
string 
可选
gmfzh
string 
可选
gmfjbr
string 
可选
jbrsfzjhm
string 
可选
gmfjbrlxdh
string 
可选
hjje
string 
必需
hjse
string 
必需
jshj
string 
必需
skyhmc
string 
可选
skyhzh
string 
可选
jsfs
string 
可选
ysxwfsd
string 
可选
kpr
string 
必需
kprzjhm
string 
可选
kprzjlx
string 
可选
dylzfphm
string 
可选
hzqrxxdbh
string 
可选
hzqrduuid
string 
可选
bz
string 
可选
ip
string 
可选
macdz
string 
可选
cpuid
string 
可选
zbxlh
string 
可选
sfzsxsfyhzhbq
string 
必需
sfzsgmfyhzhbq
string 
必需
skrxm
string 
必需
fhrxm
string 
必需
fpmxList
array [object {17}] 
可选
cxrxxList
array [object {9}] 
可选
示例
{
  "method": "sdfpkj",
  "object": [
    {
      "fpqqlsh": "发票请求流水号",
      "lzfpbz": "蓝字发票标志",
      "ptbh": "平台编号",
      "fppz": "发票票种",
      "gmfzrrbz": "自然人标识",
      "tdys": "特定要素",
      "qydm": "区域代码",
      "cezslxDm": "差额征税类型代码",
      "sgfplxDm": "收购发票类型代码",
      "ckywsyzcDm": "出口业务适用政策代码",
      "zzsjzjtDm": "增值税即征即退代码",
      "xsfdz": "销售方地址",
      "xsfdh": "销售方电话",
      "xsfkhh": "销售方开户行",
      "xsfzh": "销售方账号",
      "gmfnsrsbh": "(购买方)统一社会信用代码/纳税人识别号/身份证件号码",
      "gmfmc": "(购买方)名称",
      "gmfdz": "购买方地址",
      "gmfdh": "购买方电话",
      "gmfkhh": "购买方开户行",
      "gmfzh": "购买方账号",
      "gmfjbr": "经办人",
      "jbrsfzjhm": "经办人身份证件号码",
      "gmfjbrlxdh": "经办人联系电话",
      "hjje": "合计金额",
      "hjse": "合计税额",
      "jshj": "价税合计",
      "skyhmc": "收款银行名称",
      "skyhzh": "收款银行账号",
      "jsfs": "结算方式",
      "ysxwfsd": "应税行为发生地",
      "kpr": "开票人",
      "kprzjhm": "开票人证件号码",
      "kprzjlx": "开票人证件类型",
      "dylzfphm": "对应蓝字发票号码",
      "hzqrxxdbh": "红字确认信息单编号",
      "hzqrduuid": "红字确认单 uuid",
      "bz": "备注",
      "ip": "服务器地址",
      "macdz": "mac地址",
      "cpuid": "CPU 序列号",
      "zbxlh": "主板序列号",
      "sfzsxsfyhzhbq": "是否展示销售方银行账号标签",
      "sfzsgmfyhzhbq": "是否展示购买方银行账号标签",
      "skrxm": "收款人姓名",
      "fhrxm": "复核人姓名",
      "fpmxList": [
        {
          "dylzfpmxxh": "对应蓝字发票明细序号",
          "mxxh": "明细序号",
          "spfwjc": "商品简称",
          "xmmc": "项目名称",
          "hwhyslwfwmc": "*商品简称*项目名称",
          "ggxh": "规格型号",
          "dw": "单位",
          "sl": "数量",
          "dj": "单价",
          "je": "金额",
          "slv": "增值税税率/征收率",
          "se": "税额",
          "hsje": "含税金额",
          "kce": "扣除额",
          "sphfwssflhbbm": "商品和服务税收分类合并编码",
          "fphxz": "发票行性质",
          "yhzcbs": "优惠政策标识"
        }
      ],
      "cxrxxList": [
        {
          "cxrxh": "出行人序号",
          "cxr": "出行人",
          "cxrzjlxDm": "出行人证件类型",
          "sfzjhm": "有效身份证件号",
          "chuxrq": "出行日期",
          "cfd": "旅客出发地",
          "ddd": "旅客到达地",
          "zwdj": "等级",
          "jtgjlxDm": "交通工具类型"
        }
      ]
    }
  ]
}

返回响应

🟢200成功
application/json
Body
code
integer 
必需
msg
string 
必需
data
object 
必需
fpqqlsh
string 
可选
fphm
string 
可选
kprq
string 
可选
示例
{
  "code": 0,
  "msg": "成功",
  "data": {
    "fpqqlsh": "发票请求流水号",
    "fphm": "发票号码",
    "kprq": "开票日期"
  }
}
上一页
数电发票开具
下一页
数字化电子红字确认单申请
Built with