柠檬云财税能力开放平台
首页
登录服务
登录服务
  • 验证码登录
发票服务
发票服务
  • 发票同步
  • 发票开具
  • 发票查验
首页
登录服务
登录服务
  • 验证码登录
发票服务
发票服务
  • 发票同步
  • 发票开具
  • 发票查验
  1. 红字发票开具
  • 基本介绍
  • 快速开始
    • 开发必读
    • 认证鉴权
    • 调用模式
    • 接口调用
    • 对接地址
    • 错误码说明
    • 回调通知配置
  • 接口调用鉴权
    • 获取 access_token
      POST
    • 刷新访问令牌
      POST
  • 公共参数
    • 地区编码
  • 登录
    • 验证码登录
      • 创建企业登录任务
      • 创建代理企业登录任务
      • 登录任务状态查询
      • 提交短信验证码
  • 发票查验
    • 全国增值税查验平台查验
      POST
    • 电子税局电票平台查验
      POST
  • 发票同步
    • 发票数据同步
      • 发起发票数据同步
      • 发票数据同步状态查询
      • 发票数据同步结果查询
    • 勾选数据同步
      • 发起勾选数据同步
      • 勾选数据同步状态查询
      • 勾选数据同步结果查询
    • 附件下载
      • 创建发票附件下载任务
      • 发票附件下载任务状态查询
      • 发票附件下载结果查询
  • 发票开具
    • 人脸认证
      • 获取二维码
      • 人脸认证状态查询
      • 二维码状态查询
    • 基础信息
      • 获取用户信息
      • 授信额度查询
      • 本月开票统计查询
    • 字典数据
      • 获取指定类型字典数据
    • 开票信息维护
      • 项目信息维护
        • 商品分类查询
        • 商品分类新增
        • 商品分类编辑
        • 商品分类删除
        • 商品查询
        • 商品新增
        • 商品编辑
        • 商品删除
      • 客户信息维护
        • 客户分类查询
        • 客户分类新增
        • 客户分类编辑
        • 客户分类删除
        • 客户查询
        • 客户新增
        • 客户编辑
        • 客户删除
      • 附加信息维护
        • 模板查询
        • 模板新增
        • 模板编辑
        • 模板删除
        • 字段查询
        • 字段新增
        • 字段编辑
        • 字段删除
    • 红字发票开具
      • 确认单处理-异步任务
        • 确认单创建
        • 确认单创建任务状态查询
        • 确认单拒绝任务创建
        • 确认单拒绝任务状态查询
        • 确认单撤销任务创建
        • 确认单撤销任务状态查询
        • 确认单确认任务创建
        • 确认单确认任务状态查询
      • 确认单列表同步-异步任务
        • 发起确认单列表数据同步
        • 确认单列表数据同步状态查询
        • 已同步确认单列表查询
        • 已同步确认单文件下载
      • 获取确认单初始化数据
        POST
      • 发票列表数据查询
        POST
      • 确认单详情数据查询
        POST
      • 确认单列表数据查询
        POST
    • 蓝字发票开具
      • 相关前置查询
        • 成品油
          • 成品油库存查询
          • 成品油换算标准查询(税收商品)
          • 成品油换算标准查询(海关商品)
          • 成品油商品税收分类编码查询
          • 查询成品油税目编码
        • 建筑服务
          • 跨区域涉税事项报验管理编号信息查询
        • 金银首饰
          • 查询是否金银首饰企业试点企业
        • 涉税专业服务
          • 涉税专业服务协议要素采集信息表
      • 创建蓝字发票开具任务
      • 蓝字发票开具任务状态查询
      • 蓝字发票开具结果查询
      • 创建发票开具数据补齐任务
      • 发票开具数据补齐任务状态查询
  1. 红字发票开具

确认单列表数据查询

POST
openapi.nmy.cn/api/v1/open/red-invoice/confirmation/list

接口描述#

该接口用于从企业电子发票服务平台实时查询红字发票确认单列表。
支持按状态、日期等条件筛选,用于展示待处理及已处理的确认单汇总信息。

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "taskPayload": {
        "gxfxz": "购销方识别 0为我是销售方 1为我是购买方 ,该字段只能传'0'或者'1'",
        "qrdzt": 1,
        "dfnsrmc": "示例名称",
        "qrjkpbz": "Y",
        "kprqq": "2024-12-31",
        "kprqz": "2024-12-31",
        "kpzt": 1,
        "lrfsf": "录入方身份 0为销售方 1为购买方",
        "hzfpxxqrdbh": "红字发票信息确认单编号",
        "pageNumber": 1,
        "pageSize": 20
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'openapi.nmy.cn/api/v1/open/red-invoice/confirmation/list' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "taskPayload": {
        "gxfxz": "购销方识别 0为我是销售方 1为我是购买方 ,该字段只能传'\''0'\''或者'\''1'\''",
        "qrdzt": 1,
        "dfnsrmc": "示例名称",
        "qrjkpbz": "Y",
        "kprqq": "2024-12-31",
        "kprqz": "2024-12-31",
        "kpzt": 1,
        "lrfsf": "录入方身份 0为销售方 1为购买方",
        "hzfpxxqrdbh": "红字发票信息确认单编号",
        "pageNumber": 1,
        "pageSize": 20
    }
}'

返回响应

🟢200
application/json
Success
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "pageNumber": 1,
        "pageSize": 20,
        "total": 1130,
        "list": [
            {
                "xhqdBz": "型号清单标识",
                "sksfhcBz": "\"N\" 收款身份核查标识",
                "code": 0,
                "message": "success",
                "uuid": "********-****-****-****-************",
                "hzfpxxqrdbh": "红字发票信息",
                "lrfsf": "录入方身份",
                "xsfnsrsbh": "91440300MA5EXAMPLE",
                "xsfmc": "示例名称",
                "gmfnsrsbh": "91440300MA5EXAMPLE",
                "gmfmc": "示例名称",
                "dfnsrsbh": "91440300MA5EXAMPLE",
                "dfnsrmc": "示例名称",
                "lzfpdm": "10001",
                "lzfphm": "24442000000012345678",
                "lzkprq": "2024-12-31",
                "lzhjje": 1000,
                "lzhjse": 130,
                "lzfppzDm": "10001",
                "lzfpTdyslxDm": "A",
                "lzfplxDm2": "A",
                "zzsytDm": "10001",
                "xfsytDm": "A",
                "fprzztDm": 1,
                "hzcxje": 1000,
                "hzcxse": 130,
                "hzqrdmxsl": "99",
                "chyyDm": "10001",
                "hzqrxxztDm": 1,
                "qrrq": "2024-12-31",
                "ykjhzfpbz": "已开具红字发票标识",
                "hzfphm": "24442000000012345678",
                "hzkprq": "2024-12-31",
                "yxbz": "Y",
                "lrrsfid": "录入人身份id",
                "xgrsfid": "修改人身份id",
                "lrrq": "2024-12-31",
                "xgrq": "2024-12-31",
                "sjcsdq": 4403,
                "sjgsdq": 4403,
                "sjtbSj": "2024-12-31",
                "ywqdDm": "10001",
                "dqnsrsbh": "91440300MA5EXAMPLE",
                "gxsf": "勾选身份?",
                "mxButtonCtrlDm": "10001",
                "qrfmc": "示例名称",
                "jshj": 1130,
                "sfzzfpbz": "是否纸质发票标识",
                "xsfssjswjgDm": "10001",
                "xsfdsjswjgDm": "10001",
                "xsfzgswjDm": "10001",
                "gmfssjswjgDm": "10001",
                "gmfdsjswjgDm": "10001",
                "gmfzgswjDm": "10001",
                "cezslxDm": "A",
                "jazslxDm": "A",
                "hzqrxxmxList": [
                    {
                        "uuid": "********-****-****-****-************",
                        "hzqrxxuuid": "红字确认信息UUID",
                        "lzfpdm": "10001",
                        "lzfphm": "24442000000012345678",
                        "lzmxxh": 1,
                        "xh": 1,
                        "sphfwssflhbbm": "10001",
                        "hwhyslwfwmc": "示例名称",
                        "spfwjc": "商品服务简称",
                        "xmmc": "示例名称",
                        "ggxh": "规格型号",
                        "dw": "单位",
                        "fpspdj": "发票商品单价",
                        "fpspsl": "99",
                        "je": 1000,
                        "sl1": "0.13",
                        "se": 130,
                        "xsfssjswjgDm": "10001",
                        "xsfdsjswjgDm": "10001",
                        "xsfzgswjDm": "10001",
                        "gmfssjswjgDm": "10001",
                        "gmfdsjswjgDm": "10001",
                        "gmfzgswjDm": "10001",
                        "tdzsfsDm": "10001",
                        "xhqdBz": "型号清单标识",
                        "sptm": "商品条码"
                    }
                ],
                "fplyDm": "10001",
                "gjbq": "进项销项标识",
                "kpfnsrsbh": "91440300MA5EXAMPLE",
                "sfypsdnsrbz": "Y",
                "ybfhcbz": "已备份核查标识?",
                "hzfplxDm2": "A",
                "dsfnsrsbh": "91440300MA5EXAMPLE",
                "dsfmc": "示例名称",
                "fpkjfsDm": "10001",
                "tsbs": "特殊标识",
                "ysjdkse": 130,
                "yjjdkncpjxse": 130,
                "kpfdjxh": "开票方单据型号",
                "qrjkpbz": "Y",
                "bz": "备注信息",
                "xsxx": "销售信息",
                "kpr": "开票人",
                "qrjkpxgbz": "Y",
                "qrjkpBztxBz": "Y",
                "clgzsytDm": "A",
                "xsfdjxh": "销售方登记序号",
                "gmfdjxh": "购方方登记序号",
                "xsfzrrbz": "Y",
                "gmfzrrbz": "Y",
                "kg": "单位是否为kg?",
                "gmfzjhm": "购买方证件号码",
                "djhglxxList": [
                    "单据号管理信息列表?"
                ],
                "kpfdjxh2": "开票方单据型号",
                "zwhzyqtbs": "example",
                "zrrjsbs": "自然人结算标识",
                "sfskyhbz": "Y"
            }
        ]
    },
    "traceId": "xxxx-xxxx-xxxx-xxxx"
}
🟠400
🟠401
🔴500
修改于 2026-09-29 07:58:32
上一页
确认单详情数据查询
下一页
成品油库存查询
Built with