红字确认单申请

1、接口及场景描述

接口描述：用于申请全电发票的红字确认单，可以先调用“红字确认单准备信息查询”接口后使用返回参数再调用申请接口，
如果单独调用需要自己拼装所有的请求参数

场景1：可先调用红字确认单准备信息查询接口获取红字确认单申请的请求数据。
场景2：也可单独调用，需要自己拼装所有请求参数
场景3：当返回状态码为11051代表红字确认单申请时与局端交互异常，异常原因请看返回信息，当返回状态码为11051时，请稍后重新申请
场景4：当返回状态码为11001，请看返回信息了解原因，返回数据中data值为taskId代表未获取到红字确认单申请结果，请根据返回的taskId（任务id）调用获取红字确认单申请结果接口
场景5：当返回状态码为11002代表红字确认单申请成功，未获取红字确认单全部信息请根据返回的hzfpxxqrdid（红字确认单id）字段调用红字确认单详细信息查询接口获取详细信息
场景6：当返回状态码为11018代表获取红字发票失败，请根据返回的数据中的hzfphm（红字发票号码）字段和hzkprq（红字开票日期）字段调用获取全电全票面接口
场景7：当蓝票入账时，可以进行购方申请红字确认单

2、请求参数

名称	必选	类型	长度	描述
method	是	String
object	是	object
tdyslxdm	否	string	2	特定要素类型代码（传空即可）当蓝票为特定业务时必传
sqly	否	string	1	申请来源（0-销方申请，1-购方申请）默认不填时候为销方申请
gmfnsrsbh	否	string	26	购买方纳税人识别号
gfmc	是	string	200	购买方名称
xsfnsrsbh	否	string	26	销售方纳税人识别号
xfmc	是	string	200	销售方名称
yfphm	否	string	20	原发票号码
qqlsh	否	string	32	请求流水号（当用户不传值时，系统自动生成，用户传值时以用户传值为准，当用户首次申请红字确认单传递qqlsh参数时，没有查询到结果，再次申请红字确认单时qqlsh参数传递首次申请的参数，可以查询到第一次申请的结果，有效性为俩小时内有效）
ykprq	是	string		原开票日期格式：yyyy-MM-dd HH:mm:ss
hzcxje	是	string	16	红字冲销金额
hzcxse	是	string	16	红字冲销税额
chyydm	是	string	2	冲红原因代码01：开票有误02：销货退回03：服务中止04：销售折让
zsfs	否	string	1	征税方式0：普通征税1：减按计征2：差额征税
yzzfpdm	否	string	12	原纸质发票代码：原发票为纸质发票时，必填
yzzfphm	否	string	20	原纸质发票号码：原发票为纸质发票时，必填
qrjkpbz	否	string	1	确认即开票标志
gwmc	否	string	100	岗位名称不填默认为当前调用者默认岗位，否则使用当前填入的岗位名称
hzqrdmxList	是	object[]		红字确认单明细
lzmxxh	是	string	8	蓝字发票明细序号
xh	是	string	8	序号
spbm	是	string	19	商品编码
xmmc	是	string	600	商品名称
spjc	是	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	特定征税方式（传空即可）

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	特定征税方式代码

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": "购销方身份",
        "hzqrxxmxList": [
            {
                "lzmxxh": "蓝字发票明细序号",
                "xh": "序号",
                "spbm": "商品编码",
                "spmc": "商品名称",
                "spsl": "数量",
                "ggxh": "规格型号",
                "dw": "单位",
                "spdj": "单价",
                "je": "金额",
                "slv": "税率",
                "se": "税额",
                "tdzsfsdm": "特定征税方式代码"
            }
        ]
    }
}

1、接口及场景描述#

2、请求参数#

请求参数

返回响应

1、接口及场景描述

2、请求参数