数电快捷全额红冲

1、接口及场景描述

接口描述：给企业提供快捷全额红冲功能

场景1：当返回状态码为11051代表红字确认单申请时与局端交互异常，异常原因请看返回信息，当返回状态码为11051时，请稍后重新申请
场景2：当返回状态码为11001，请看返回信息了解原因，返回数据中data值为taskId代表未获取到红字确认单申请结果，请根据返回的taskId（任务id）调用获取红字确认单申请结果接口
场景3：当返回状态码为11002代表红字确认单申请成功，未获取红字确认单全部信息请根据返回的hzfpxxqrdid（红字确认单id）字段调用红字确认单详细信息查询接口获取详细信息
场景4：当返回状态码为11018代表获取红字发票失败，请根据返回的数据中的hzfphm（红字发票号码）字段和hzkprq（红字开票日期）字段调用获取全电全票面接口

2、请求参数

名称	必选	类型	长度	描述
method	是	String
object	是	object
tdyslxdm	否	string	2	特定要素类型代码（传空即可）当蓝票为特定业务时必传
yfphm	否	string	20	原发票号码
ykprq	是	string		原开票日期格式：yyyy-MM-dd HH:mm:ss
chyydm	是	string	2	冲红原因代码01：开票有误02：销货退回03：服务中止04：销售折让

yzzfpdm	否	string	12	原纸质发票代码：原发票为纸质发票时，必填
yzzfphm	否	string	20	原纸质发票号码：原发票为纸质发票时，必填

3、返回参数

名称	必选	类型	长度	描述
code	是	integer		返回代码
msg	是	string		返回消息
data	是	object		返回数据
sqly	是	string	1	申请来源0：销方申请、1：购方申请
tdyslxdm	否	string	2	特定要素类型代码（传空即可）
hzcxje	是	string	16	红字冲销金额
hzcxse	是	string	16	红字冲销税额
chyydm	是	string	2	冲红原因代码01：开票有误 02：销货退回 03：服务中止 04：销售折让
hzfpxxqrdbh	是	string	20	红字确认单编号
hzfpxxqrdid	是	string	32	红字确认单ID
lrrq	是	string		录入日期格式: yyyy-MM-dd HH:mm:ss
hzfphm	否	string	20	红字发票号码
hzqrxxztdm	是	string	2	红字确认单状态01：无需确认 02：销方录入待购方确认 03：购方录入待销方确认 04：购销双方已确认 05：作废（销方录入购方否认） 06：作废（购方录入销方否认） 07：作废（超72小时未确认） 08：（发起方撤销）
hzhjje	否	string	16	红字合计金额
hzhjse	否	string	16	红字合计税额
hzkprq	否	string		红字开票日期格式：yyyy-MM-dd HH:mm:ss
gmfmc	是	string	300	购买方名称
xsfmc	是	string	300	销售方名称
gmfnsrsbh	是	string	26	购买方纳税人识别号
xsfnsrsbh	是	string	26	销售方纳税人识别号
lzfplxdm	是	string	2	蓝字发票类型代码
lzhjje	是	string	16	蓝字合计金额
lzhjse	是	string	16	蓝字合计税额
lzfphm	是	string	20	蓝字发票号码
lzkprq	是	string		蓝字开票日期格式：yyyy-MM-dd HH:mm:ss
qqrq	否	string		确认日期格式：yyyy-MM-dd HH:mm:ss
xfsytdm	否	string	100	消费税用途代码
fprzztdm	否	string	100	发票入账状态代码
zzsytdm	否	string	100	增值税用途代码
gxfsf	否	string	1	购销方身份
hzqrxxmxList	是	object[]		红字确认单明细
lzmxxh	否	string	8	蓝字发票明细序号
xh	是	string	8	序号
spbm	是	string	19	商品编码
spmc	是	string	600	商品名称
spsl	否	string	25	数量
ggxh	否	string	150	规格型号
dw	否	string	300	单位
spdj	否	string	25	单价
je	是	string	16	金额
slv	是	string	8	税率
se	是	string	16	税额
tdzsfsdm	否	string	2	特定征税方式代码

请求参数

Body 参数application/json

method

string

必需

固定值hzqrdsq

object

必需

tdyslxdm

string

特定要素类型代码

可选

特定要素类型代码（传空即可）

yfphm

string

原发票号码

必需

原发票号码

ykprq

string

原开票日期

必需

原开票日期格式：yyyy-MM-dd HH:mm:ss

chyydm

string

冲红原因代码

必需

冲红原因代码
01：开票有误
02：销货退回
03：服务中止
04：销售折让

yzzfpdm

string

原纸质发票代码

可选

原发票为纸质发票时，必填

yzzfphm

string

原纸质发票号码

可选

原发票为纸质发票时，必填

示例

{
    "method": "sdkjqehc",
    "object": {
        "tdyslxdm": "特定要素类型代码",
        "yfphm": "原发票号码",
        "ykprq": "原开票日期",
        "chyydm": "冲红原因代码",
        "yzzfpdm": "原纸质发票代码",
        "yzzfphm": "原纸质发票号码"
    }
}

返回响应

🟢200成功

application/json

Body

code

integer

返回代码

必需

返回代码

msg

string

返回消息

必需

返回消息

data

object

返回数据

必需

返回数据

tdyslxdm

string

特定要素类型代码

可选

特定要素类型代码（传空即可）

chyy

string

冲红原因代码

必需

冲红原因代码01：开票有误 02：销货退回 03：服务中止 04：销售折让

hzfpxxqrdbh

string

红字确认单编号

必需

红字确认单编号

hzfpxxqrdid

string

红字确认单ID

必需

红字确认单ID

lrrq

string

录入日期

必需

录入日期
格式: yyyy-MM-dd HH:mm:ss

hzfphm

string

红字发票号码

可选

红字发票号码

hzqrxxztdm

string

红字确认单状态

必需

红字确认单状态
01：无需确认
02：销方录入待购方确认
03：购方录入待销方确认
04：购销双方已确认
05：作废（销方录入购方否认）
06：作废（购方录入销方否认）
07：作废（超72小时未确认）08：（发起方撤销）

hzhjje

string

红字合计金额

可选

红字合计金额

hzhjse

string

红字合计税额

可选

红字合计税额

hzkprq

string

红字开票日期

可选

红字开票日期
格式：yyyy-MM-dd HH:mm:ss

gmfmc

string

购买方名称

必需

购买方名称

xsfmc

string

销售方名称

必需

销售方名称

gmfnsrsbh

string

购买方纳税人识别号

必需

购买方纳税人识别号

xsfnsrsbh

string

销售方纳税人识别号

必需

销售方纳税人识别号

lzfplxdm

string

蓝字发票类型代码

必需

蓝字发票类型代码

lzhjje

string

蓝字合计金额

必需

蓝字合计金额

lzhjse

string

蓝字合计税额

必需

蓝字合计税额

lzfphm

string

蓝字发票号码

必需

蓝字发票号码

lzkprq

string

蓝字开票日期

必需

蓝字开票日期
格式：yyyy-MM-dd HH:mm:ss

qqrq

string

确认日期格式

可选

确认日期格式：
yyyy-MM-dd HH:mm:ss

xfsytdm

string

消费税用途代码

可选

消费税用途代码

fprzztdm

string

发票入账状态代码

可选

发票入账状态代码

zzsytdm

string

增值税用途代码

可选

增值税用途代码

gxfsf

string

购销方身份

可选

购销方身份

hzqrxxmxList

array [object {12}]

红字确认单明细

必需

红字确认单明细

示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "sqly": "申请来源",
        "tdyslxdm": "特定要素类型代码",
        "hzcxje": "红字冲销金额",
        "hzcxse": "红字冲销税额",
        "chyydm": "冲红原因代码",
        "hzfpxxqrdbh": "红字确认单编号",
        "hzfpxxqrdid": "红字确认单ID",
        "lrrq": "录入日期",
        "hzfphm": "红字发票号码",
        "hzqrxxztdm": "红字确认单状态",
        "hzhjje": "红字合计金额",
        "hzhjse": "红字合计税额",
        "hzkprq": "红字开票日期",
        "gmfmc": "购买方名称",
        "xsfmc": "销售方名称",
        "gmfnsrsbh": "购买方纳税人识别号",
        "xsfnsrsbh": "销售方纳税人识别号",
        "lzfplxdm": "蓝字发票类型代码",
        "lzhjje": "蓝字合计金额",
        "lzhjse": "蓝字合计税额",
        "lzfphm": "蓝字发票号码",
        "lzkprq": "蓝字开票日期",
        "qqrq": "确认日期",
        "xfsytdm": "销方税用途代码",
        "fprzztdm": "发票入账状态代码",
        "zzsytdm": "增值税用途代码",
        "gxfsf": "购销方身份",
        "hzqrxxmxList": [
            {
                "lzmxxh": "蓝字发票明细序号",
                "xh": "序号",
                "spbm": "商品编码",
                "spmc": "商品名称",
                "spsl": "数量",
                "ggxh": "规格型号",
                "dw": "单位",
                "spdj": "单价",
                "je": "金额",
                "slv": "税率",
                "se": "税额",
                "tdzsfsdm": "特定征税方式代码"
            }
        ]
    }
}

1、接口及场景描述#

2、请求参数#

请求参数

返回响应

1、接口及场景描述

2、请求参数