数电发票开具
POST
1、接口及场景描述
2、请求参数
名称 | 必选 | 类型 | 描述 |
---|---|---|---|
method | 是 | string | 固定值sdfpkj |
object | 是 | Object[] | 请求参数,长度为1 |
fpqqlsh | 否 | string | 发票请求流水号 用于查询开票结果 未传自动生成 |
lzfpbz | 是 | string | 蓝字发票标志 0:蓝字发票 1:红字发票 当传0时表示开具蓝字发票当传1时表现开具红字发票 |
ptbh | 否 | string | 平台编号 |
fppz | 是 | string | 发票票种 01:数电专 02:数电普 |
gmfzrrbz | 否 | string | 购买方自然人标志 Y:购买方是自然人 N:购买方非自然人 |
tdys | 否 | string | 特定要素 空:非特定要素 01:成品油发票 03:建筑服务发票 04:货物运输服务发票 05:不动产销售服务发票 06:不动产经营租赁服务发票 09:旅客运输服务发票 18:卷烟发票 32:电子烟发票 |
qydm | 否 | string | 区域代码 |
cezslxDm | 否 | string | 差额征税类型代码 空:非差额发票 01:全额开票 02:差额开票 |
sgfplxDm | 否 | string | 收购发票类型代码 空:非收购发票 01:农产品收购发票 02:光伏收购发票 03:二手车收购发票 |
ckywsyzcDm | 否 | string | 出口业务适用政策代码 空:非出口业务 01:退税政策 02:免税政策 03:征税政策 |
zzsjzjtDm | 否 | string | 增值税即征即退代码 空:非增值税即征即退 01:软件产品发票 02:资源综合利用产品发票 03:管道运输服务发票 04:有形动产融资租赁服务 05:有形动产融资性售后回租服务发票 06:新型墙体材料发票 07:风力发电产品发票 08:光伏发电产品发票 09:动漫软件产品发票 10:飞机维修劳务发票 11:黄金发票 12:铂金发票 |
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 | 结算方式 01:现金 02:银行转账 03:票据 04:第三方支付 05:预付卡 99:其他 |
ysxwfsd | 否 | string | 应税行为发生地 |
kpr | 是 | string | 开票人 |
kprzjhm | 否 | string | 开票人证件号码 |
kprzjlx | 否 | string | 开票人证件类型 |
dylzfphm | 否 | string | 对应蓝字发票号码:当lzfpbz-蓝字发票标志为0时,必须为空, 当lzfpbz-蓝字发票标志为1时,代表要开具红字发票需要填写与之对应的蓝字发票号码 |
hzqrxxdbh | 否 | string | 红字确认信息单编号:当lzfpbz-蓝字发票标志为0时,必须为空, 当lzfpbz-蓝字发票标志为1时,代表要开具红字发票需要填写该蓝字发票对应申请的红字确认单编号 |
hzqrduuid | 否 | string | 红字确认单 uuid:当lzfpbz-蓝字发票标志为0时,必须为空, 当lzfpbz-蓝字发票标志为1时,代表要开具红字发票需要填写该蓝字发票对应申请的红字确认单UUID |
bz | 否 | string | 备注 |
ip | 否 | string | 服务器地址 |
macdz | 否 | string | mac地址 |
cpuid | 否 | string | CPU 序列号 |
zbxlh | 否 | string | 主板序列号 |
sfzsxsfyhzhbq | 否 | string | 是否展示销售方银行账号标签 Y:展示 N:不展示 |
sfzsgmfyhzhbq | 否 | string | 是否展示购买方银行账号标签 Y:展示 N:不展示 |
skrxm | 否 | string | 收款人姓名 |
fhrxm | 否 | string | 复核人姓名 |
fpmxList | 是 | Object[] | 商品明细数组 |
dylzfpmxxh | 否 | string | 对应蓝字发票明细序号:当lzfpbz-蓝字发票标志为0时,必须为空, 当lzfpbz-蓝字发票标志为1时,代表要开具红字发票需要填写蓝字发票的明细序号 |
mxxh | 是 | string | 明细序号 |
xmmc | 是 | string | 项目名称 |
spfwjc | 是 | string | 商品服务简称 |
hwhyslwfwmc | 是 | string | 货物或应税劳务、服务名称 格式必须是*商品服务简称*项目名称 |
ggxh | 否 | string | 规格型号 |
dw | 否 | string | 单位 |
sl | 否 | string | 数量,选填;如单价为空,则必填 |
dj | 否 | string | 单价,选填;如数量为空,则必填 |
je | 是 | string | 金额 |
slv | 是 | string | 增值税税率/征收率 |
se | 是 | string | 税额 |
hsje | 是 | string | 含税金额 |
kce | 否 | string | 差额征税扣除额 |
sphfwssflhbbm | 是 | string | 商品和服务税收分类合并编码 |
fphxz | 是 | string | 发票行性质 00:正常行 01:折扣行 02:被折扣行 |
yhzcbs | 否 | string | 优惠政策标识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%即征即退 |
字段 | 名称 | 必须 | 说明 |
---|---|---|---|
cxrxh | 出行人序号 | 否 | |
cxr | 出行人 | 否 | |
cxrzjlxDm | 出行人证件类型 | 否 | 100:单位 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 | 有效身份证件号 | 否 | |
chuxrq | 出行日期 | 否 | 格式:yyyy-MM-dd |
cfd | 旅客出发地 | 否 | |
ddd | 旅客到达地 | 否 | |
zwdj | 等级 | 否 | 交通工具 为火车时: 一等座 二等座 软席(软座、软卧) 硬席(硬座、硬卧) 交通工作为飞机时: 公务舱 头等舱 经济舱 交通工具为船舶(不包括旅游船)时: 一等舱 二等舱 三等舱 |
jtgjlxDm | 交通工具类型 | 否 | 1:飞机 2:火车 3:长途汽车 4:公共交通 5:出租车 6:汽车 7:船舶 9:其他 |
字段 | 名称 | 必须 | 说明 |
---|---|---|---|
ysmxxh | 运输明细序号 | 是 | |
qyd | 起运地 | 是 | |
ddd | 到达地 | 是 | |
ysgjzl | 运输工具种类 | 是 | 铁路运输 公路运输 水路运输 航空运输 管道运输 |
ysgjph | 运输工具牌号 | 是 | |
yshwmc | 运输货物名称 | 是 |
字段 | 名称 | 必须 | 说明 |
---|---|---|---|
jzfwfsd | 建筑服务发生地 | 是 | 建筑服务发生地 县(市、区)名称 |
jzxmmc | 建筑项目名称 | 是 | |
tdzzsxmbh | 土地增值税项目编号 | 否 | 为房地产企业建设房产需要填写 |
kdsbz | 跨地市标志 | 是 | 取值范围 “Y”,“N” |
字段 | 名称 | 必须 | 说明 |
---|---|---|---|
xh | 序号 | 是 | |
bdczldzS | 不动产坐落地址 (省) | 是 | 必须以省、自治区、特别行政区 、 北京市、天津市、上海市、重庆市任意一个关键词结尾。 当红冲不动产坐落地址未修改为三个字段的蓝票时, 如果蓝票不动产坐落地址没有填写 省(直辖市、自治区、特别行政区),该字段可不写。 |
bdczldzS1 | 不动产坐落地址(市) | 否 | 必须以市、盟、 自治州、地区、 区任意一个关键词结尾。 |
bdczldzXxdz | 不动产坐落地址(详细地址) | 是 | 必须包含街、路 、村、乡、镇、 道、巷、号任意一个关键词。 |
zlqqz | 租赁期起止 | 是 | “租赁期起 ”+“空格 ”+“租赁期止 ”,其中租赁期起、止的格式为 :yyyy-MM-dd |
kdsbz | 跨地市标志 | 是 | 取值范围 “Y”,“N” |
cqzsbh | 产权证书/不动产权 证号 | 是 | 无“产权证书 /不动产权证号 ”时,填写“无 ” |
字段 | 名称 | 必须 | 说明 |
---|---|---|---|
dfgtgmbz | 多方共同购买标志 | 否 | Y:多方共同购买 N:非多方共同购买 当为N或者空时 ,共同购买方list必须为空。 |
gtgmf | 共同购买方 | 否 | 只能填写汉字、 英文大小写 |
zjlx | 证件类型 | 否 | 100:单位 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:其他个人证件 |
zjhm | 证件号码 | 否 | |
xh | 序号 | 是 | |
bdcdwdm | 不动产单位代码 | 否 | “不动产单位代码”和“网签合同备案编号”两者只能填一个 |
wqhtbabh | 网签合同备案编号 | 否 | “不动产单位代码”和“网签合同备案编号”两者只能填一个 |
bdczldzS | 不动产坐落地址 (省) | 是 | 必须以省、自治区、特别行政区 、 北京市、天津市、上海市、重庆市任意一个关键词结尾。 当红冲不动产坐落地址未修改为三个字段的蓝票时, 如果蓝票不动产坐落地址没有填写 省(直辖市、自治区、特别行政区),该字段可不写。 |
bdczldzS1 | 不动产坐落地址(市) | 否 | 必须以市、盟、 自治州、地区、 区任意一个关键词结尾。 |
bdczldzXxdz | 不动产坐落地址(详细地址) | 是 | 必须包含街、路 、村、乡、镇、 道、巷、号任意一个关键词。 |
tdzzsxmbh | 土地增值税项目编号 | 否 | |
kdsbz | 跨地市标志 | 是 | 取值范围 “Y”,“N” |
hdjsjg | 核定计税价格 | 否 | 不属于核定计税不动产销售的可不填写 |
sjcjhsje | 实际成交含税金额 | 否 | 若按核定计税价格征税的,为必填。 |
cqzsbh | 产权证书/不动产权 证号 | 否 |
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 位 |
-1002 | mac 地址,必填,长度 20 位 |
-1003 | CPU 序列号,选填,长度 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位 |
-1066 | hwhyslwfwmc 格式必须是*商品简称*项目名称 ,必填" |
-1067 | 商品简称,必填,商品简称不能为空 |
-1068 | 货物或应税劳务服务名称拼装规则应为*商品服务简称* +项目名称 |
-1069 | 开具数电专票时,购方纳税人识别号不能为空 |
-1070 | 明细序号,必填,最大长度8位 |
-1071 | 购买方自然人标志,选填,取值范围为“Y”、“N” |
请求参数
Body 参数application/json
返回响应
修改于 2025-04-22 02:28:41