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

获取确认单初始化数据

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

接口描述#

该接口用于初始化企业电子发票服务平台红字发票确认单所需的基础数据。
包括购销方信息、原蓝字发票信息及冲红原因等,为后续创建确认单提供数据预填充支持。

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "taskPayload": {
        "fplxDm": "A",
        "fplyDm": "10001",
        "gjbq": "进项销项标识",
        "gmfnsrsbh": "91440300MA5EXAMPLE",
        "kpfnsrsbh": "91440300MA5EXAMPLE",
        "lrfsf": "录入方身份",
        "lzfpdm": "10001",
        "lzfphm": "24442000000012345678",
        "lzfpqdhm": "蓝字发票清单号码",
        "lzkprq": "2024-12-31",
        "sflzfp": "是否蓝字发票",
        "tdyslxDm": "A",
        "xsfnsrsbh": "91440300MA5EXAMPLE"
    }
}

请求示例代码

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/init' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "taskPayload": {
        "fplxDm": "A",
        "fplyDm": "10001",
        "gjbq": "进项销项标识",
        "gmfnsrsbh": "91440300MA5EXAMPLE",
        "kpfnsrsbh": "91440300MA5EXAMPLE",
        "lrfsf": "录入方身份",
        "lzfpdm": "10001",
        "lzfphm": "24442000000012345678",
        "lzfpqdhm": "蓝字发票清单号码",
        "lzkprq": "2024-12-31",
        "sflzfp": "是否蓝字发票",
        "tdyslxDm": "A",
        "xsfnsrsbh": "91440300MA5EXAMPLE"
    }
}'

返回响应

🟢200
application/json
Success
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "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