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

发票列表数据查询

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

接口描述#

该接口用于查询企业电子发票服务平台可用于红字冲销的蓝字发票列表。
仅返回满足冲红条件(已认证、未作废、未完全冲销)的有效发票,供操作员选择需要冲红的原始发票。

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "taskPayload": {
        "dfnsrmc": "示例名称",
        "dfnsrsbh": "91440300MA5EXAMPLE",
        "fphm": "12345678",
        "gxfxz": "购销方识别 0为我是销售方 1为我是购买方 ,该字段只能传'0'或者'1'",
        "kprqq": "2024-12-31",
        "kprqz": "2024-12-31",
        "pageNumber": 1,
        "pageSize": 20,
        "zzfpDm": "10001",
        "zzfphm": "24442000000012345678"
    }
}

请求示例代码

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/invoice/list' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "taskPayload": {
        "dfnsrmc": "示例名称",
        "dfnsrsbh": "91440300MA5EXAMPLE",
        "fphm": "12345678",
        "gxfxz": "购销方识别 0为我是销售方 1为我是购买方 ,该字段只能传'\''0'\''或者'\''1'\''",
        "kprqq": "2024-12-31",
        "kprqz": "2024-12-31",
        "pageNumber": 1,
        "pageSize": 20,
        "zzfpDm": "10001",
        "zzfphm": "24442000000012345678"
    }
}'

返回响应

🟢200
application/json
Success
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "pageNumber": 1,
        "pageSize": 20,
        "total": 1130,
        "list": [
            {
                "gjbq": "进项销项标识",
                "fphm": "12345678",
                "zzfphm": "24442000000012345678",
                "zzfpDm": "10001",
                "fplyDm": "10001",
                "fplxDm": "A",
                "fppzDm": "10001",
                "fpkjfxlxDm": "A",
                "tdyslxDm": "A",
                "fpztDm": 1,
                "cezslxDm": "A",
                "sflzfp": "是否蓝字发票 \"Y\"是\"N\"否",
                "kjhzfpdydlzfphm": "24442000000012345678",
                "kpfnsrsbh": "91440300MA5EXAMPLE",
                "xsfnsrsbh": "91440300MA5EXAMPLE",
                "xsfmc": "示例名称",
                "gmfnsrsbh": "91440300MA5EXAMPLE",
                "gmfmc": "示例名称",
                "kprq": "2024-01-01",
                "hjje": 1000,
                "hjse": 130,
                "bz": "备注信息",
                "xsfssjswjgDm": "10001",
                "xsfdsjswjgDm": "10001",
                "xsfzgswjDm": "10001",
                "gmfssjswjgDm": "10001",
                "gmfdsjswjgDm": "10001",
                "gmfzgswjDm": "10001",
                "gmfssjswjgmc": "示例名称",
                "fpkjfsDm": "10001",
                "kpr": "开票人",
                "jazslxDm": "A",
                "sfzzfpbz": "Y",
                "tspzDm": "10001",
                "xhqdBz": "型号清单标识",
                "jshj": 1130,
                "xsfzgswskfjDm": "10001",
                "gmfzgswskfjDm": "10001",
                "gmfjbr": "购方经办人",
                "xhfdjxh": "销售方登记序号",
                "gmfdjxh": "购方方登记序号",
                "xsfzrrbz": "Y",
                "gmfzrrbz": "Y",
                "dbbkpbz": "Y",
                "tdyslxmc": "A",
                "sfxscxsq": "是否销售出项申请",
                "hzqrxxuuid": "红字确认信息UUID",
                "xsfssjswjgmc": "示例名称",
                "gmfzjhm": "购买方证件号码",
                "tdysmxList": "特定业务明细列表",
                "hzsq": "红字申请",
                "kjhzfpdyzzfpDm": "10001",
                "kjhzfpdyzzfphm": "24442000000012345678",
                "xhfdz": "广东省深圳市南山区科技园",
                "xhflxdh": "13800138000",
                "gmfdz": "广东省深圳市南山区科技园",
                "gmflxdh": "13800138000"
            }
        ]
    },
    "traceId": "xxxx-xxxx-xxxx-xxxx"
}
🟠400
🟠401
🔴500
修改于 2026-09-29 07:58:32
上一页
获取确认单初始化数据
下一页
确认单详情数据查询
Built with