税务数字化管理平台
  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是String固定值szhdzhzqrdsq
object是object
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：普通发票03: 机动车统一销售发票04: 二手车统一销售发票
lzfpTdyslxDm否string蓝字发票特定要素类型代码 空：非特定要素
03：建筑服务发票
04：货物运输服务发票
05：不动产销售服务发票
06：不动产经营租赁服务发票
09：旅客运输服务发票
18：卷烟发票
32：电子烟发票
hzcxje是string红字冲销金额
hzcxse是string红字冲销税额
chyyDm是string红字发票冲红原因代码01：开票有误 02：销货退回
03：服务中止 04：销售折让
hzqrdmxList是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税额

3、返回参数#

名称必选类型描述
code是integer返回代码 0:成功 3001:失败
msg是string返回消息
data否object返回数据
hzfpxxqrdbh否string红字确认单编号
uuid否string红字确认单UUID
hzqrxxztDm否string红字确认单状态：01：无需确认
02：销方录入待购方确认03：购方录入待销方确认
04：购销双方已确认05：作废（销方录入购方否认）
06：作废（购方录入销方否认）
07：作废（超72 小 时 未 确认）
08：作废（发起方撤销）09：作废（确认后撤销）
10 作废（异常凭证）

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红冲原因为销货退回时，不能修改单价

请求参数

Body 参数application/json
method
string 
必需
object
object 
必需
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 
必需
hzqrdmxList
array [object {13}] 
必需
示例
{
  "method": "szhdzhzqrdsq",
  "object": {
    "lrfsf": "录入方身份",
    "xsfnsrsbh": "销售方纳税人识别号",
    "xsfmc": "销售方名称",
    "gmfnsrsbh": "购买方纳税人识别号",
    "gmfmc": "购买方名称",
    "lzfpdm": "蓝字发票代码",
    "lzfphm": "蓝字发票号码",
    "sfzzfpbz": "是否纸质发票标志",
    "lzkprq": "蓝字发票开票日期",
    "lzhjje": "蓝字发票合计金额",
    "lzhjse": "蓝字发票合计税额",
    "lzfppzDm": "蓝字发票票种代码",
    "lzfpTdyslxDm": "蓝字发票特定要素类型代码",
    "hzcxje": "红字冲销金额",
    "hzcxse": "红字冲销税额",
    "chyyDm": "红字发票冲红原因代码",
    "hzqrdmxList": [
      {
        "lzmxxh": "蓝字发票明细序号",
        "xh": "序号",
        "sphfwssflhbbm": "商品和服务税收分类合并编码",
        "hwhyslwfwmc": "货物或应税劳务、服务名称",
        "spfwjc": "商品服务简称",
        "xmmc": "项目名称",
        "ggxh": "规格型号",
        "dw": "单位",
        "fpspdj": "单价",
        "fpspsl": "数量",
        "je": "金额",
        "sl1": "税率",
        "se": "税额"
      }
    ]
  }
}

返回响应

🟢200成功
application/json
Body
code
integer 
必需
msg
string 
必需
data
object 
必需
hzfpxxqrdbh
string 
必需
uuid
string 
必需
hzqrxxztDm
string 
必需
示例
{
  "code": 0,
  "msg": "成功",
  "data": {
    "hzfpxxqrdbh": "红字确认单编号",
    "uuid": "红字确认单 UUID",
    "hzqrxxztDm": "红字确认单状态"
  }
}
上一页
数电发票开具（实时开票）
下一页
二维码生成规则
Built with