数电快捷全额红冲

1、接口及场景描述

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

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

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	销售方纳税人识别号
ykjhzfpbz	是	string	1	是否开具红字发票Y-已开具N-未开具
lzfplxdm	是	string	2	蓝字发票类型代码
lzhjje	是	string	16	蓝字合计金额
lzhjse	是	string	16	蓝字合计税额
lzfpdm	否	string	12	蓝字发票代码
lzfphm	是	string	20	蓝字发票号码
lzkprq	是	string		蓝字开票日期格式：yyyy-MM-dd HH:mm:ss
qqrq	否	string		确认日期格式：yyyy-MM-dd HH:mm:ss
hzqrdmxsl	否	string	100	红字确认单明细数量
yxbz	否	string	1	有效标志
jshj	否	string	100	价税合计
sfzzfpbz	否	string	1	是否纸质发票 Y-是，N-否
hzfplxdm	否	string	100	红字发票类型代码
lzfptdyslxdm	否	string	100	蓝字发票特定类型代码
xfsytdm	否	string	100	消费税用途代码
fprzztdm	否	string	100	发票入账状态代码
zzsytdm	否	string	100	增值税用途代码
gxfsf	否	string	1	购销方身份
qrjkpbz	否	string	1	确认既开票标志Y-是，N-否
hpqqlsh	否	string	32	红字发票请求流水号
qdzzfpzldm	否	string	20	全电发票种类代码
applyStatus	是	string	1	申请标志：0-申请成功，1-申请失败，2-申请中
yzzfpdm	否	string	20	原纸质发票代码
yzzfphm	否	string	20	原纸质发票号码
createTime	是	date		创建时间格式 yyyy-MM-dd HH:mm:ss
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	特定征税方式代码
xmmc	否	string	600	项目名称
dj	否	string	25	单价
sl	否	string	25	数量

请求参数

Body 参数application/json

示例

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

返回响应

🟢200成功

application/json

Body

示例

{
    "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": "购销方身份",
        "ykjhzfpbz": "是否开具红字发票",
        "lzfpdm": "蓝字发票代码",
        "hzqrdmxsl": "红字确认单明细数量",
        "yxbz": "有效标志",
        "jshj": "价税合计",
        "sfzzfpbz": "是否纸质发票",
        "hzfplxdm": "红字发票类型代码",
        "lzfptdyslxdm": "蓝字发票特定类型代码",
        "qrjkpbz": "确认即开票标志",
        "hpqqlsh": "红字发票请求流水号",
        "qdzzfpzldm": "全电发票种类代码",
        "applyStatus": "申请标志",
        "yzzfpdm": "原纸质发票代码",
        "yzzfphm": "原纸质发票号码",
        "createTime": "创建时间",
        "hzqrxxmxList": [
            {
                "lzmxxh": "蓝字发票明细序号",
                "xh": "序号",
                "spbm": "商品编码",
                "spmc": "商品名称",
                "spsl": "数量",
                "ggxh": "规格型号",
                "dw": "单位",
                "spdj": "单价",
                "je": "金额",
                "slv": "税率",
                "se": "税额",
                "tdzsfsdm": "特定征税方式代码",
                "xmmc": "项目名称",
                "dj": "单价",
                "sl": "数量"
            }
        ]
    }
}

1、接口及场景描述#

2、请求参数#

请求参数

返回响应

1、接口及场景描述

2、请求参数