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 参数

Body 参数application/json

示例

{
    "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参数说明