3.3.3.数电红冲申请

接口描述	支持全电专普票红冲申请
请求路径	/cloud/applyElecRedInvoice
开放权限	所有企业
调用方式	POST
参数方式	Base64（JSON格式）
重要说明	红冲申请分为两种情况： 1、无需确认红冲申请-返回红冲开具结果 2、需要对方确认红冲申请-红字确认单查询-（对方确认系统外）-红字开具-返回红冲开具结果
业务范围	数电
接口类型	异步

3.1电子税务局通道返回数据

3.1.1示例报文

{
        "code":"0",
	"message":"成功",
	"renson":""
}

3.1.2参数说明

参数名称	名称	长度	必须	说明
code	返回代码	4	是	0成功，其它失败
message	返回信息	100	是	成功/失败
reason	描述	100	是	失败原因具体描述

3.2乐企通道返回数据

3.2.1示例报文

{
        "code":"0",
	"message":"成功",
	"renson":"",
        "Data": {
               "hzqrxxztDm": "02" ,
               "hzfpxxqrdbh": "34010524071001103631",
               "uuid": "66164994b1ff4d1892f0351397ba8e94"
         }
}

3.2.2参数说明

参数名称	名称	长度	必须	说明
code	返回代码	4	是	0成功，其它失败
message	返回信息	100	是	成功/失败
reason	描述	100	是	失败原因具体描述
hzqrxxztDm	红字确认单状态	2	否	01：无需确认 02：销方录入待购方确认 03：购方录入待销方确认 04：购销双方已确认 05：作废（销方录入购方否认） 06：作废（购方录入销方否认） 07：作废（超72小时未确认） 08：（发起方撤销） 09：作废（确认后撤销） 10：作废（异常凭证）
hzfpxxqrdbh	红字确认单编号	20	否
uuid	红字确认单 UUID	32	否

3.3异步返回数据

3.3.1电子税务局通道红字申请单异步返回

3.3.1.1示例报文

{
        "ywlxdm":"qdhzsq",
	"status":"申请状态",
	"ddlsh":"红字申请订单流水号",
	"hzfpxxqrdbh":"红字申请单编号",
	"uuid":"红字申请成功UUID",
	"ycyy":"异常原因"
}

3.3.1.2参数说明

参数名称	名称	长度	必须	说明
ywlxdm	业务类型	30	是	qdhzsq红字申请
status	发票状态	10	是	1申请成功 2申请失败 1004 需要登录 1003 需要认证
ddlsh	红字申请订单流水号	40	是
hzfpxxqrdbh	红字申请单编号	40	否
uuid	红字申请成功UUID		否
ycyy	异常原因	200	否

3.3.2红字开具结果异步返回（发票信息）

3.3.2.1示例报文

{
	"ddlsh": "订单流水号",
	"ewm": "",
	"fplxdm": "02",
	"hjje": "-897.25",
	"kprq": "20240111172400",
	"qdfphm": "全电发票号码",
	"status": 1,
	"ycyy": "",
	"yqdfphm": "原发票号码",
	"ywlxdm": "fpkj"
}

3.3.2.2参数说明

参数名称	名称	长度	必须	说明
ywlxdm	业务类型代码	4	是	fpkj
ddlsh	订单流水号	40	是	入参的ddlsh
status	请求状态	5	是	1开具成功 2 开具失败 3 已开具未生成PDF（税控电票） 1004 需要登录 1003 需要认证
qdfphm	全电发票号码	20	否
kprq	开票日期	20	否	yyyymmddhhmmsssss
jshj	价税合计	10	否
hjje	不含税金额	12	否
hjse	不含税税额	12	否
yqdfphm	单据原发票号码	20	否
ycyy	异常原因	200	否

3.3.3红字开具结果异步返回（发票版式信息）

3.3.3.1示例报文

{
	"ddlsh": "订单流水号",
	"ofdurl": "ofd地址",
	"pdf": "pdf地址",
	"status": "1",
	"xmlurl": "xml地址",
        "jfdz":"局端交付地址",
	"ycyy": "执行成功",
	"ywlxdm": "qdbswj"
}

3.3.3.2参数说明

参数	名称	长度	必须	说明
ywlxdm	业务类型	30	是	qdbswj发票开具
ddlsh	已开具发票请求流水号	40	是
status	请求状态	10	是	1成功 2失败 1004 需要登录 1003 需要认证
ofdurl	ofd地址	10	否	地址时效：永久
pdf	pdf地址	10	否	地址时效：永久
xmlurl	xml地址	10	否	地址时效：永久
jfdz	局端交付地址	200	否	局端交付地址，打开为局端发票下载页面
ycyy	异常原因	200	否

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Date

string

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

qyId

string

企业唯一标识

必需

dlzh

string

登陆账号

必需

ddlsh

string

订单流水号

必需

sksbh

string

税控设备号

必需

销方税号

fplxdm

string

发票类型代码

必需

【数电】 01：数电专票 02：数电普票 03：机动车纸票 04：二手车纸票

tspz

string

特殊票种

可选

zsfs

string

征收方式

必需

0 ：普通征税 2：差额征税-差额开票 3：差额征税-全额开票

qdbz

string

清单标识

必需

0 非清单

xsfMc

string

销售方名称

必需

xsfNsrsbh

string

销售方纳税人识别号

必需

xsfDz

string

销售方地址

必需

xsfDh

string

销售方电话

必需

xsfYh

string

销售方银行名称

必需

xsfZh

string

销售方银行账户

必需

gmfMc

string

购买方名称

必需

gmfNsrsbh

string

购买方纳税人识别号

可选

gmfDz

string

购买方地址

可选

gmfDh

string

购买方电话

可选

gmfYh

string

购买方银行名称

可选

gmfZh

string

购买方银行账号

可选

gmfMobile

string

购买方手机号

可选

用于短信交付发票版式地址

gmfEmail

string

购买方邮箱

可选

用于邮件交付发票版式地址

jshj

string

价税合计

可选

小数点2位（负数）

hjje

string

不含税金额

可选

小数点2位（负数）

hjse

string

不含税税额

可选

小数点2位（负数）

string

备注

可选

kce

string

扣除额

可选

小数点2位（zsfs为2时，必填）

sqr

string

申请人

必需

sslkjly

string

小规模开具1%，3%发票理由

可选

小规模开具1%，3%税率必填 1、2022年3月31日前发生纳税义务。 2、前期已开具相应征收率发票，因发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具。 3、因实际经营业务需要，放弃享受免征增值税政策。。

sfwzzfp

string

是否为纸质发票

必需

当前新开的负数票是否为纸票 Y是 N不是

yfpDm

string

原发票代码

可选

红冲税控票必填

yfpHm

string

原发票号码

必需

ykprq

string

原开票日期

必需

局端返回的开票时间，数电格式： 2022-06-06 18:31:52

yfplxdm

string

原发票类型

必需

【数电】 01：数电专票 02：数电普票 03：机动车纸票 04：二手车纸票【税控】 004：增值税专用发票 007：增值税普通发票 026：增值税电子普通发票 028 ：增值税电子专用发票

chyydm

string

冲红原因代码

必需

1 开票有误（全额红冲使用） 2 销货退回（部分红冲使用） 3 服务终止（部分红冲使用） 4 销售折让（部分红冲使用）

jshjdx

string

价税合计中文

可选

否例如 (负数)壹佰零捌圆贰角伍分

cloudData

string

是否使用云票数据 0否 1是

可选

（只适用于全额红冲）传1时可不传明细，平台会根据yfpHm查找系统中已开具过的蓝票数据，自动进行全额红冲

ywdjDm

string

业务单据代码

可选

第三方回调

djbh

string

单据编号

可选

第三方自定义单据编号

ncpsgzjlx

string

农产品证件类型

可选

如果选择了农产品证件类型，gmfNsrsbh需要传该证件号码 201 居民身份证 103 税务登记证 208 外国护照 210 港澳居民来往内地通行证 213 台湾居民来往大陆通行证 215 外国人居留证 219 香港永久性居民身份证 220 台湾身份证 221 澳门特别行政区永久性居民身份证 233 外国人永久居留身份证（外国人永久居留证） 299 其他个人证件

detailParam

array [object {17}]

明细参数(多条明细)

必需

string

序号

必需

从1开始，注意：蓝票如果是折扣票：明细序号如果是 1(被折扣行) 2(折扣行) 3(被折扣行) 4(折扣行) 红冲申请，只传被折扣行(注意金额正常行、折扣行相加)，序号为1、3

lzmxxh

string

蓝字明细序号

必需

同xh

fphxz

string

发票行性质

必需

0 正常行 1 折扣行 (折扣票金额负) 2 被折扣行'(折扣票金额正)

hsbz

string

含税标识

必需

0:不含税 1:含税 (默认) 如果差额票，含税必须是含税

spmc

string

商品名称

可选

spbm

string

商品编码

必需

ggxh

string

规格型号

可选

卷票必须为空

string

单位

可选

卷票必须为空

string

单价

可选

最长12位小数

string

数量

可选

最长12位小数（负数）

string

金额

必需

保留2位小数（负数）

string

税额

可选

保留2位小数（负数）

slv

string

税率

必需

最多3位小数

lslbs

string

零税率标识

必需

0 是正常税率 1是免税 2是不征税 3普通零税率

yhzcbs

string

优惠政策标识

可选

0不使用 1使用

zxbm

string

自行编码

可选

zzstsgl

string

增值税特殊管理

可选

优惠政策标识为1时，必须填写内容：免税 100%先征后退 50%先征后退不征税先征后退即征即退100% 即征即退30% 即征即退50% 即征即退70% 按3%简易征收按5%简易征收按5%简易征收减按1.5%计征稀土产品简易征收超税负12%即征即退超税负3%即征即退超税负8%即征即退

示例

{
  "qyId": "企业唯一标识",
  "dlzh": "登录账号",
  "ddlsh": "订单流水号(全局唯一)",
  "sksbh": "税控设备号",
  "fplxdm": "发票类型代码",
  "tspz": "特殊票种",
  "zsfs": "征收方式",
  "qdbz": "清单标识",
  "xsfMc": "销售方名称",
  "xsfNsrsbh": "销售方纳税人识别号",
  "xsfDz": "销售方地址",
  "xsfDh": "销售方电话",
  "xsfYh": "销售方银行",
  "xsfZh": "销售方账户",
  "gmfMc": "购买方名称",
  "gmfNsrsbh": "购买方纳税人识别号",
  "gmfDz": "购买方地址",
  "gmfDh": "购买方电话",
  "gmfYh": "购买方银行",
  "gmfZh": "购买方账户",
  "gmfMobile": "购买方手机号",
  "gmfEmail": "购买方邮箱",
  "jshj": "价税合计",
  "hjje": "合计金额",
  "hjse": "合计税额",
  "bz": "备注",
  "kce": "扣除额",
  "sqr": "申请人",
  "sslkjly": "小规模开具1%、3%发票理由",
  "sfwzzfp": "是否为纸质发票 Y是 N不是",
  "yfpDm": "原发票代码",
  "yfpHm": "原发票号码",
  "ykprq": "原开票日期",
  "yfplxdm": "原发票类型",
  "chyydm": "冲红原因代码",
  "jshjdx": "价税合计中文",
  "cloudData": "是否使用云票数据 0否 1是 ",
  "ywdjDm": "业务单据代码",
  "djbh": "单据编号",
  "ncpsgzjlx": "农产品证件类型",
  "detailParam": [
    {
      "xh": "序号",
      "lzmxxh": "蓝字明细序号",
      "fphxz": "发票行性质",
      "hsbz": "含税标识",
      "spmc": "商品名称",
      "spbm": "商品编码",
      "ggxh": "规格型号",
      "dw": "单位",
      "dj": "单价",
      "sl": "数量",
      "je": "金额",
      "se": "税额",
      "slv": "税率",
      "lslbs": "零税率标识",
      "yhzcbs": "优化政策标识",
      "zxbm": "自行编码",
      "zzstsgl": "增值税特殊管理"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.baiwangjs.com/swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/cloud/applyElecRedInvoice' \
--header 'Date;' \
--header 'host;' \
--header 'x-htjs-nonce;' \
--header 'x-htjs-ua;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "qyId": "企业唯一标识",
    "dlzh": "登录账号",
    "ddlsh": "订单流水号(全局唯一)",
    "sksbh": "税控设备号",
    "fplxdm": "发票类型代码",
    "tspz": "特殊票种",
    "zsfs": "征收方式",
    "qdbz": "清单标识",
    "xsfMc": "销售方名称",
    "xsfNsrsbh": "销售方纳税人识别号",
    "xsfDz": "销售方地址",
    "xsfDh": "销售方电话",
    "xsfYh": "销售方银行",
    "xsfZh": "销售方账户",
    "gmfMc": "购买方名称",
    "gmfNsrsbh": "购买方纳税人识别号",
    "gmfDz": "购买方地址",
    "gmfDh": "购买方电话",
    "gmfYh": "购买方银行",
    "gmfZh": "购买方账户",
    "gmfMobile": "购买方手机号",
    "gmfEmail": "购买方邮箱",
    "jshj": "价税合计",
    "hjje": "合计金额",
    "hjse": "合计税额",
    "bz": "备注",
    "kce": "扣除额",
    "sqr": "申请人",
    "sslkjly": "小规模开具1%、3%发票理由",
    "sfwzzfp": "是否为纸质发票 Y是 N不是",
    "yfpDm": "原发票代码",
    "yfpHm": "原发票号码",
    "ykprq": "原开票日期",
    "yfplxdm": "原发票类型",
    "chyydm": "冲红原因代码",
    "jshjdx": "价税合计中文",
    "cloudData": "是否使用云票数据 0否 1是 ",
    "ywdjDm": "业务单据代码",
    "djbh": "单据编号",
    "ncpsgzjlx": "农产品证件类型",
    "detailParam": [
        {
            "xh": "序号",
            "lzmxxh": "蓝字明细序号",
            "fphxz": "发票行性质",
            "hsbz": "含税标识",
            "spmc": "商品名称",
            "spbm": "商品编码",
            "ggxh": "规格型号",
            "dw": "单位",
            "dj": "单价",
            "sl": "数量",
            "je": "金额",
            "se": "税额",
            "slv": "税率",
            "lslbs": "零税率标识",
            "yhzcbs": "优化政策标识",
            "zxbm": "自行编码",
            "zzstsgl": "增值税特殊管理"
        }
    ]
}'

3.1电子税务局通道返回数据#

3.1.1示例报文#

3.1.2参数说明#

3.2乐企通道返回数据#

3.2.1示例报文#

3.2.2参数说明#

3.3异步返回数据#

3.3.1电子税务局通道红字申请单异步返回#

3.3.1.1示例报文#

3.3.1.2参数说明#

3.3.2红字开具结果异步返回（发票信息）#

3.3.2.1示例报文#

3.3.2.2参数说明#

3.3.3红字开具结果异步返回（发票版式信息）#

3.3.3.1示例报文#

3.3.3.2参数说明#

请求参数

示例代码

返回响应

3.1电子税务局通道返回数据

3.1.1示例报文

3.1.2参数说明

3.2乐企通道返回数据

3.2.1示例报文

3.2.2参数说明

3.3异步返回数据

3.3.1电子税务局通道红字申请单异步返回

3.3.1.1示例报文

3.3.1.2参数说明

3.3.2红字开具结果异步返回（发票信息）

3.3.2.1示例报文

3.3.2.2参数说明

3.3.3红字开具结果异步返回（发票版式信息）

3.3.3.1示例报文

3.3.3.2参数说明