税务数字化管理平台
  1. 乐企
税务数字化管理平台
  • 对外接口
    • 文档概览
    • 如何调用接口
    • 销项
      • 数电
        • 全电交付
        • 获取数电发票下载地址
      • 乐企
        • 获取批量预赋码信息
          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、接口及场景描述#

接口描述:给企业提供快捷全额红冲功能,只支持销方申请红字确认单、销方开具红票并且为全额红冲,不支持购方申请红字确认单销方开具红票、购方申请购方开具红票
场景一:传发票代码、发票号码为红冲税控发票、传发票号码为红冲数电发票
场景二:返回code码为0并且红字确认单状态代码为:01-无需确认、04-购销双方已确认,并且根据系统管理中参数配置:lqhpbz-乐企自动开红票标志为0(0-自动开,1-手动开)时自动开具红字发票,红字发票号码、红字发票开票日期对应字段:hzfphm、hzkprq
场景三:当返回数据中红字确认单状态代码为02-销方录入待购方确认时,需用户联系购方进行红字确认单确认动作后在调用该接口进行开具红票动作
场景四:返回code代码为90001,msg消息为交互异常请重新调用时候,再次调用该接口

2、请求参数#

名称必选类型描述
method是String固定值kjqehc
object是object
fpdm否string蓝字发票代码:当蓝票为数电票时候可以为空,蓝票为税控票时候需要传值
fphm是string蓝字发票号码
chyyDm否string冲红原因代码:01-开票有误、02-销货退回、03-服务中止、04-销售折让、不填默认01-开票有误

3、返回参数#

名称必选类型描述
code是integer返回代码 0:成功,非零:失败
msg是string返回消息
data否object返回数据
hzfpxxqrdbh是string红字确认单编号
uuid是string红字确认单UUID
hzqrxxztDm是string红字确认单状态:01:无需确认
02:销方录入待购方确认03:购方录入待销方确认
04:购销双方已确认05:作废(销方录入购方否认)
06:作废(购方录入销方否认)
07:作废(超72 小 时 未 确认)
08:作废(发起方撤销)09:作废(确认后撤销)
10 作废(异常凭证)
lrfsf是string录入方身份:0:销方 1:购方
xsfnsrsbh否string销售方纳税人识别号
xsfmc是string销售方名称
gmfnsrsbh否string购买方纳税人识别号
gmfmc是string购买方名称
lzfpdm否string蓝字发票代码
lzfphm否string蓝字发票号码
sfzzfpbz是string是否纸质发票标志:Y:纸质发票 N:电子发票
lzkprq否string蓝字发票开票日期:格式:yyyy-MM-dd HH:mm:ss
lzhjje否string蓝字发票合计金额
lzhjse否string蓝字发票合计税额
lzfppzDm否string蓝字发票票种代码:01: 增值税专用发票02: 普通发票
lzfpTdyslxDm是string蓝字发票特定要素类型代码
hzcxje是string红字冲销金额
hzcxse是string红字冲销税额
chyyDm是string红字发票冲红原因代码:01:开票有误02:销货退回
03:服务中止04:销售折让
qrrq否string确认日期:格式:yyyy-MM-dd HH:mm:ss
ykjhzfpbz否string已开具红字发票标志:Y:已开具 N:未开具
hzfphm否string红字发票号码
hzkprq是string红字开票日期:格式:yyyy-MM-dd HH:mm:ss
yxbz是string有效标志:Y:有效 N:无效
hzqrxxmxList是string[]红字确认的明细集合
lzmxxh否string蓝字发票明细序号
xh是string序号
sphfwssflhbbm是string商品和服务税收分类合并编码
hwhyslwfwmc是string货物或应税劳务、服务名称
spfwjc是string商品服务简称
xmmc是string项目名称
ggxh否string规格型号
dw否string单位:如数量、单价栏次非空,则本栏次必须非空
fpspdj否string单价:如数量、单位栏次非空则本栏次必须非空
fpspsl否string数量:如单位、单价栏次非空则本栏次必须非空
je是string金额
sl1是string税率
se是string税额

4、返回code码表#

代码(code)描述
0成功
31022本地未能查询到纳税人风险信息,请先将纳税人风险信息查询到本地
31023纳税人风险信息为高风险,禁止申请全电红字确认单
31024纳税人预警级别为红色预警,禁止申请全电红字确认单
31025风险纳税人标志为风险纳税人,禁止申请全电红字确认单
31026本地未能查询到纳税人基本信息,请将纳税人基本信息查询到本地
31027本地纳税人基本信息中纳税人状态应为正常或报验才可申请全电红字确认单
31028企业业务系统中无蓝字发票信息
31029当前蓝字发票状态为作废,不可申请红字确认单
31030当前蓝字发票异常凭证状态为异常凭证,不可申请红字确认单
31031当前蓝字发票红字锁定标识为锁定,不可申请红字确认单
31032录入方身份不能为空
31033录入方身份取值应为0或1
31034销售方纳税人识别号不能为空
31035销售方纳税人识别号最大长度为26位,由数字和大写字母组成
31036销售方名称不能为空
31037销售方名称长度位300位
31038购买方纳税人识别号最大长度为26位
31039购买方名称不能为空
31040购买方名称最大长度为300位
31041蓝字发票代码选填最大长度为12位
31042蓝字发票号码不能为空
31043蓝字发票号码最大长度为20位
31044是否纸质发票不能为空
31045是否纸质发票取值范围为Y、N
31046蓝字开票日期不能为空
31047蓝字发票开票日期格式为yyyy-MM-dd HH:mm:ss
31048蓝字发票合计金额不能为空
31049蓝字发票合计金额最大长度为18位
31050蓝字发票合计金额最多2位小数
31051蓝字发票合计税额不能为空
31052蓝字发票合计税额最大长度为18位
31053蓝字发票合计税额最多2位小数
30154蓝字发票票种代码不能为空
31055蓝字发票票种代码取值范围为01、02、03、04
31056蓝字发票特定要素类型代码取值范围为
01、02、03、04、05、06、07、08、09、10、11、12、13、14、15、16、17、18
31057红字冲销金额不能为空
31058红字冲销最大长度为18位
31059红字冲销金额最多2位小数
31060红字冲销税额不能为空
31061红字冲销税额最大长度为18位
31062红字冲销税额最多2位小数
31063冲红原因代码不能为空
31064冲红原因代码取值范围为01、02、03、04
31065序号不能为空
31066序号最大长度为8位
31067序号从1开始
31068蓝字发票明细序号不能为空
31069蓝字发票明细序号最大长度为8
31070商品和服务税收分类合并编码不能为空
31071商品和服务税收分类合并编码最大长度19 位。
31072商品和服务税收分类合并编码未在商品编码信息中存在
31073货物或应税劳务、服务名称不能为空
31074货物或应税劳务、服务名称最大长度为300位
31075商品服务简称不能为空
31076商品服务简称最大长度为120位
31077项目名称不能为空
31078项目名称最大长度为600位
31079规格型号最大长度为150位
31080单位最大长度为300位非选填
31082单位最大长度为25位
31083如果单位非空则数量不能为空
31084数量最大长度为25位
31085金额不能为空
31086金额最大长度为18位
31087金额最多2位小数
31088税率不能为空
31089税率最大长度为16位
31090税率最多6位小数
31091税率必须在可用税率信息中存在
31092税额不能为空
31093税额最大长度为18位
31094税额最多2位小数
31095红票开具金额应该小于等于对应蓝字发票开具金额
31096明细信息中金额不能为正数
31097明细信息中税额不能为正数
31098蓝字增值税专用发票只能用于增值税专用发票冲红
31099蓝字普通发票只能用于普通发票冲红
31100蓝字发票中带有折扣行经计算红冲金额应为?,与传入值不符
31101蓝字发票中带有折扣行经计算红冲金税额应为?,与传入值不符
310102蓝票没有红冲金额和税额,不可再次红冲
310103蓝字发票入账标签为未入账或已入账撤销时,
红字确认单只允许销售方发起且只能进行全额冲红
310104当冲红原因为开票有误时,必须全额冲红,
并且明细单价、金额、数量必须和蓝字发票保持一致
310105该商品冲红原因不允许选择服务中止
310106该商品冲红原因不允许选择销售退回
310107红冲原因为销售折让时,不能修改单价和数量
310108红冲原因为服务中止时,不能修改单价
310109红冲原因为销货退回时,不能修改单价
-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
object 
必需
fpdm
string 
发票代码
可选
蓝字发票代码
fphm
string 
发票号码
必需
蓝字发票号码
chyyDm
string 
冲红原因代码
可选
冲红原因代码
示例
{
	"method": "kjqehc",
	"object": {
		"fpdm":"蓝字发票代码",
        "fphm":"蓝字发票号码",
		"chyyDm":"冲红原因代码"
	}
}

返回响应

🟢200成功
application/json
Body
code
integer 
状态码
必需
状态码
msg
string 
返回信息
必需
返回信息
data
object 
返回数据
必需
返回数据
hzfpxxqrdbh
string 
红字确认单编号
必需
红字确认单编号
uuid
string 
红字确认单uuid
必需
红字确认单uuid
hzqrxxztDm
string 
红字确认单状态代码
必需
红字确认单状态代码
lrfsf
string 
录入方身份
必需
录入方身份
xsfnsrsbh
string 
销售方纳税人识别号
必需
销方纳税人识别号
xsfmc 
string 
销售方名称
必需
销售方名称
gmfnsrsbh 
string 
购买方纳税人识别号
可选
购买方纳税人识别号
gmfmc 
string 
购买方名称
必需
购买方名称
lzfpdm 
string 
蓝字发票代码
可选
蓝字发票代码
lzfphm 
string 
蓝字发票号码
必需
蓝字发票号码
sfzzfpbz 
string 
是否纸质发票标志
必需
是否纸质发票标志
lzkprq 
string 
蓝字发票开票日期
可选
蓝字发票开票日期
lzhjje 
string 
蓝字发票合计金额
必需
蓝字发票合计金额
lzhjse
string 
蓝字发票合计税额
必需
蓝字发票合计税额
lzfppzDm
string 
蓝字发票票种代码
可选
蓝字发票票种代码
lzfpTdyslxDm
string 
蓝字发票特定要素类型代码
可选
蓝字发票特定要素类型代码
hzcxje
string 
红字冲销金额
必需
红字冲销金额
hzcxse
string 
红字冲销税额
必需
红字冲销税额
chyyDm
string 
红字发票冲红原因代码
必需
红字发票冲红原因代码
qrrq
string 
确认日期
必需
确认日期
ykjhzfpbz
string 
已开具红字发票标志
必需
已开具红字发票标志
hzfphm
string 
红字发票号码
可选
红字发票号码
hzkprq
string 
红字开票日期
可选
红字开票日期
yxbz
string 
有效标志
必需
有效标志
hzqrxxmxList
array [object {13}] 
必需
示例
{
    "code": 0,
    "msg": "成功",
    "data": {
        "hzfpxxqrdbh": "红字发票信息确认单编号",
        "uuid": "红字确认单 UUID",
        "hzqrxxztDm": "红字确认信息状态代码",
        "lrfsf": "录入方身份",
        "xsfnsrsbh": "(销售方)统一社会信用代码/纳税人识别号/身份证件号码",
        "xsfmc": "销售方名称",
        "gmfnsrsbh": "(购买方) 统一社会信用代码 / 纳税人识别号 / 身份证件号码",
        "gmfmc": "购买方名称",
        "lzfpdm": "蓝字发票代码",
        "lzfphm": "蓝字发票号码",
        "sfzzfpbz": "是否纸质发票标志",
        "lzkprq": "蓝字发票开票日期",
        "lzhjje": "蓝字发票合计金额",
        "lzhjse": "蓝字发票合计税额",
        "lzfppzDm": "蓝字发票票种代码",
        "lzfpTdyslxDm": "蓝字发票特定要素类型代码",
        "hzcxje": "红字冲销金额",
        "hzcxse": "红字冲销税额",
        "chyyDm": "红字发票冲红原因代码",
        "qrrq": "确认日期",
        "ykjhzfpbz": "已开具红字发票标志",
        "hzfphm": "红字发票号码",
        "hzkprq": "红字开票日期",
        "yxbz": "有效标志",
        "hzqrxxmxList": [
            {
                "xh": "序号",
                "lzmxxh": "蓝字发票明细序号",
                "sphfwssflhbbm": "商品和服务税收分类合并编码",
                "hwhyslwfwmc": "货物或应税劳务、服务名称",
                "spfwjc": "商品服务简称",
                "xmmc": "项目名称",
                "ggxh": "规格型号",
                "dw": "单位",
                "fpspdj": "单价",
                "fpspsl": "数量",
                "je": "金额",
                "sl1": "税率",
                "se": "税额"
            }
        ]
    }
}
上一页
数字化电子红字确认单申请
下一页
数电发票开具结果查询
Built with