红字信息表查询

1、接口及场景描述

接口描述：用于查询已经申请的红字信息表
是否支持数电及税控发票：仅支持税控发票

2、请求参数

名称	必选	类型	长度	描述
method	是	string
object	是	object
pageNum	否	integer		页码 [大小： 1~] 默认为1
pageSize	否	integer		每页显示数量 [大小： 1~5000] 默认为10
request	是	object		请求对象
sqlsh	否	string	40	申请流水号
createTime	否	object[]	20	创建日期格式：YYYY-MM-DD
sqdh	否	string	16	申请单号
xxbzt	否	object[]	7
hzxxbbh	否	string	16	红字信息表编号
fpdm	否	string	10	发票代码
fphm	否	string	8	发票号码
gfmc	否	string	100	购方名称
gfsh	否	string	20	购方税号
xfmc	否	string	100	销方名称
xfsh	否	string	20	销方税号
hjjeq	否	string	13	合计金额起
hjjez	否	string	13	合计金额止
hjseq	否	string	13	合计税额起
hjsez	否	string	13	合计税额止
ids	否	object[]	100	id数组

3、返回参数

名称	必选	类型	长度	描述
code	是	integer		返回代码
msg	是	string		返回消息
fplxdm	是	string	3	发票类型代码（固定为004，028）
sqlsh	是	string	40	申请流水号
createTime	是	string	10	填开日期格式：YYYY-MM-DD
xhdwsbh	否	string	20	销货单位识别号
xhdwmc	否	string	100	销货单位名称
ghdwsbh	否	string	20	购货单位识别号
ghdwmc	否	string	100	购货单位名称
sqly	是	string	1	申请理由：购方申请：'0'已抵扣 '1'未抵扣销方申请： '2'销方申请
sqfs	是	string	1	申请方式0：全部冲红1：部分冲红
zsfs	是	string	1	征税方式0：普通征税1：减按计征2：差额征税
zdbz	是	string	1	自动标志0：手动审批、手动上传； 1：手动审批、自动上传；2：自动审批、自动上传；默认为2
xxblx	否	string	1	信息表类型2：机动车销售退回3：机动车销售折让
hjje	是	string	13	合计金额
hjse	是	string	13	合计税额
fymx	否	string	255	费用明细
yfpdm	否	string	10	原发票代码
yfphm	否	string	8	原发票号码
yfplx	否	string	1	原发票类型
xxbbh	否	string	16	红字信息表编号
sqdh	否	string	16	申请单号-未申请不返回
clzt	否	string	1	处理状态-未申请不返回(0：未处理， 1：已提交，2：审核通过，3：审核不通过)
cwxx	否	string	255	错误信息-无错误信息不返回
jqbh	是	string	12	机器编号
hzxxbzt	是	string	1	红字信息表状态0：审核中1：审核通过 2：审核失败3：待上传4：已核销5：已撤销6：其他
xxbzt	是	string	20	信息表状态（红字信息表同步返回字段）， TZD0000，TZD1000可以开红票
ztms	否	string	100	状态描述-未申请不返回
szlb	否	string	1	税种类别0：营业税1：增值税（目前为1）
dslbz	否	string	1	多税率标志0：1票1税率,1：1票多税率
tkrq	否	string	10	税控返回填开日期格式：YYYY-MM-DD
zhsl	否	string	12	综合税率多税率时为空
sqsm	否	string	20	申请说明
kpzdbs	是	string	30	开票终端标识

请求参数

Body 参数application/json

method

string

必需

固定值hzxxbcx

object

必需

pageNum

integer

页码

可选

页码 [大小： 1~] 默认为1

pageSize

integer

每页显示数量

可选

每页显示数量 [大小： 1~5000] 默认为10

request

object

请求对象

必需

请求对象

示例

{
  "method": "hzxxbcx",
  "object": {
    "pageNum": 1,
    "pageSize": 10,
    "request": {
      "sqlsh": "申请流水号",
      "createTime ": [
        "创建日期"
      ],
      "sqdh": "申请单号",
      "xxbzt": [
        "红字信息表状态"
      ],
      "hzxxbbh": "红字信息表编号",
      "fpdm": "发票代码",
      "fphm": "发票号码",
      "gfmc": "购方名称",
      "gfsh": "购方税号",
      "xfmc": "销方名称",
      "xfsh": "销方税号",
      "hjjeq": "合计金额起",
      "hjjez": "合计金额止",
      "hjseq": "合计税额起",
      "hjsez": "合计税额止",
      "ids": [
        "id数组"
      ]
    }
  }
}

返回响应

🟢200成功

application/json

Body

code

integer

返回代码

必需

返回代码

msg

string

返回消息

必需

返回消息

data

object

返回数据

必需

返回数据

count

integer

个数

必需

个数

pageNum

integer

页码

必需

页码

dataList

array [object {31}]

返回集合

必需

返回集合

示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "count": 1,
    "pageNum": 1,
    "dataList": [
      {
        "fplxdm": "发票类型代码",
        "sqlsh": "申请流水号",
        "xhdwsbh": "销货单位识别号",
        "xhdwmc": "销货单位名称",
        "ghdwsbh": "购货单位识别号",
        "ghdwmc": "购货单位名称",
        "sqly": "申请理由",
        "sqfs": "申请方式",
        "zsfs": "征税方式",
        "zdbz": "自动标志",
        "xxblx": "信息表类型",
        "hjje": "合计金额",
        "hjse": "合计税额",
        "fymx": "费用明细",
        "yfpdm": "原发票代码",
        "yfphm": "原发票号码",
        "yfplx": "原发票类型",
        "xxbbh": "红字信息表编号",
        "sqdh": "申请单号",
        "clzt": "处理状态",
        "cwxx": "错误信息",
        "jqbh": "机器编号",
        "hzxxbzt": "红字信息表状态",
        "xxbzt": "信息表状态",
        "ztms": "状态描述",
        "szlb": "税种类别",
        "dslbz": "多税率标志",
        "tkrq": "填开日期",
        "zhsl": "综合税率",
        "sqsm": "申请说明",
        "kpzdbs": "开票终端标识"
      }
    ]
  }
}

1、接口及场景描述#

2、请求参数#

请求参数

返回响应

1、接口及场景描述

2、请求参数