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

创建蓝字发票开具任务

POST
openapi.nmy.cn/api/v1/open/invoice-issue/issue

接口描述#

该接口用于创建企业电子发票服务平台蓝字发票异步开具任务,支持批量开具多张发票。

调用流程#

1.
调用「创建蓝字发票开具任务」接口,调用成功后获取任务 ID(taskId)
2.
调用「蓝字发票开具任务状态查询」接口,通过 taskId 轮询任务状态;当 status=1(成功)或 status=-1(失败)时任务终止,可进一步调用「蓝字发票开具结果查询」接口获取发票数据

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "info": [
        {
            "basicInfo": {
                "invoiceType": "全电普通发票",
                "specialBusiness": "特殊业务;如需设置,传对应文本值:[建筑服务,货物运输服务,不动产经营租赁服务,不动产销售,旅...",
                "variableLevy": "差额征税;如需设置,传对应文本值:[差额征税-全额开票,差额征税-差额开票]",
                "reducedTax": "减按征税;如需设置,传对应文本值:[减按征税-销售自己使用过的固定资产,减按征税-住房租赁,减...",
                "giveUpReason": "放弃减税优惠原因;如需设置,传'1'或'2';'1'= 前期已开具3%征收率的发票,发生销售折..."
            },
            "sellerInfo": {
                "address": "**省**市**区**路**号",
                "phone": "13212345678",
                "bank": "XX银行XX分行",
                "bankAccount": "1234567890123456789",
                "showBankInfo": true,
                "showPersonInfo": true
            },
            "purchaserInfo": {
                "isNaturePerson": true,
                "name": "***公司",
                "uscc": "{{uscc}}",
                "address": "**省**市**区**路**号",
                "phone": "13212345678",
                "showBankInfo": true,
                "bank": "XX银行XX分行",
                "bankAccount": "1234567890123456789",
                "showPersonInfo": true,
                "identificationTypeCode": "A",
                "identificationNumber": "自然人购买方补充信息-证件号码",
                "nationCode": 4403
            },
            "isIncludeTax": true,
            "invoiceDetail": {
                "data": [
                    {
                        "spbm": "101****************",
                        "size": "型号",
                        "unit": "单位",
                        "price": 100,
                        "quantity": "10",
                        "amount": 1000,
                        "taxRate": "0.13",
                        "tax": 130,
                        "discountInfo": {
                            "discount": 1000,
                            "discountMode": 0,
                            "discountAmount": 1000,
                            "discountTax": 130
                        },
                        "variableLevyInfo": [
                            {
                                "voucherType": "A",
                                "voucherNumber": "凭证号",
                                "sdphm": "2*******************",
                                "fpdm": "0***********",
                                "fphm": "12345678",
                                "voucherAmount": "总额",
                                "deduction": "扣除额",
                                "date": "2024-01-01",
                                "note": "备注信息"
                            }
                        ],
                        "projectName": "***名称",
                        "xsyhzcbz": "Y",
                        "zzstsgl": "A",
                        "slqdbz": "若商品在项目信息列表内有记录,传\"Y\";否则传\"N\";默认为\"N\"",
                        "mtzlDm": "10001",
                        "sptm": "商品条码,13位",
                        "jzjtlxDm": "A"
                    }
                ],
                "amount": 1000,
                "tax": 130,
                "total": 1130,
                "sbxmdm": "10001"
            },
            "freightageInfo": {
                "data": [
                    {
                        "shippingType": "运输方式",
                        "shippingNumber": "号码",
                        "from": "出发地",
                        "to": "目的地",
                        "goods": "货物"
                    }
                ]
            },
            "noteInfo": {
                "note": "备注信息",
                "payee": "收款人",
                "reviewer": "复核人",
                "additionalInfo": [
                    {
                        "field": "example",
                        "type": "example",
                        "value": "example"
                    }
                ]
            },
            "personInfo": {
                "name": "***公司",
                "nation": "国籍",
                "certificateType": "A",
                "certificateCode": "证件号码",
                "uscc": "{{uscc}}"
            },
            "buildingServiceInfo": {
                "projectCode": "10001",
                "projectName": "***名称",
                "projectAddress": "**省**市**区**路**号",
                "addressDetail": "广东省深圳市南山区科技园",
                "crossArea": true,
                "crossRegionalTaxRegistrationNumber": 4403,
                "regionCode": "行政区划号码"
            },
            "immovablePropertyInfo": [
                {
                    "immovablePropertyCode": "10001",
                    "immovablePropertyAddress": "**省**市**区**路**号",
                    "addressDetail": "广东省深圳市南山区科技园",
                    "crossArea": true,
                    "landIncrementTaxProjectCode": "10001",
                    "priceIncludeTax": "核定计税价格",
                    "priceIncludeTaxTransaction": 1000,
                    "certificateOfTitle": "不动产权证号",
                    "areaUnit": "面积单位",
                    "regionCode": "行政区划号码"
                }
            ],
            "tractorInfo": {
                "engineNumber": "发动机号码",
                "chassisNumber": "底盘号/机架号"
            },
            "immovablePropertyRentInfo": [
                {
                    "immovablePropertyAddress": "**省**市**区**路**号",
                    "addressDetail": "广东省深圳市南山区科技园",
                    "startTime": "2024-01-01",
                    "endTime": "2024-12-31",
                    "crossArea": true,
                    "certificateOfTitle": "不动产权证号",
                    "areaUnit": "面积单位",
                    "cph": "车牌号",
                    "regionCode": "行政区划号码"
                }
            ],
            "passengerTransportationInfo": {
                "data": [
                    {
                        "name": "***公司",
                        "date": "2024-01-01",
                        "certificateType": "A",
                        "certificateCode": "证件号码",
                        "from": "出发地",
                        "to": "目的地",
                        "vehicle": "A",
                        "rank": "示例名称"
                    }
                ]
            },
            "paymentInfo": [
                {
                    "payChannelCode": "10001",
                    "transactionOrderNo": "交易单号"
                }
            ],
            "fplsh": "发票流水号",
            "isPurchaseByMultipleParties": true,
            "coPurchaserInfo": [
                {
                    "purchaserName": "***名称",
                    "documentTypeCode": "A",
                    "documentNumber": "证件号码"
                }
            ],
            "usedToRegisterTractor": true,
            "taxRelatedServiceInfo": {
                "sfkjsszyfwfppm": "是否开具涉税专业服务发票品目;\"Y\"表示是,\"N\"表示否;默认为\"N\"",
                "sszyfwxybh": "涉税专业服务协议编号; 当sfkjsszyfwfppm为\"Y\"时必填,可通过获取涉税专业服务协...",
                "sszyfwxm": "涉税专业服务项目;可不传",
                "sszyfwxmSp": [
                    "涉税专业服务项目商品;可不传"
                ]
            }
        }
    ]
}

请求示例代码

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/invoice-issue/issue' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "info": [
        {
            "basicInfo": {
                "invoiceType": "全电普通发票",
                "specialBusiness": "特殊业务;如需设置,传对应文本值:[建筑服务,货物运输服务,不动产经营租赁服务,不动产销售,旅...",
                "variableLevy": "差额征税;如需设置,传对应文本值:[差额征税-全额开票,差额征税-差额开票]",
                "reducedTax": "减按征税;如需设置,传对应文本值:[减按征税-销售自己使用过的固定资产,减按征税-住房租赁,减...",
                "giveUpReason": "放弃减税优惠原因;如需设置,传'\''1'\''或'\''2'\'';'\''1'\''= 前期已开具3%征收率的发票,发生销售折..."
            },
            "sellerInfo": {
                "address": "**省**市**区**路**号",
                "phone": "13212345678",
                "bank": "XX银行XX分行",
                "bankAccount": "1234567890123456789",
                "showBankInfo": true,
                "showPersonInfo": true
            },
            "purchaserInfo": {
                "isNaturePerson": true,
                "name": "***公司",
                "uscc": "{{uscc}}",
                "address": "**省**市**区**路**号",
                "phone": "13212345678",
                "showBankInfo": true,
                "bank": "XX银行XX分行",
                "bankAccount": "1234567890123456789",
                "showPersonInfo": true,
                "identificationTypeCode": "A",
                "identificationNumber": "自然人购买方补充信息-证件号码",
                "nationCode": 4403
            },
            "isIncludeTax": true,
            "invoiceDetail": {
                "data": [
                    {
                        "spbm": "101****************",
                        "size": "型号",
                        "unit": "单位",
                        "price": 100,
                        "quantity": "10",
                        "amount": 1000,
                        "taxRate": "0.13",
                        "tax": 130,
                        "discountInfo": {
                            "discount": 1000,
                            "discountMode": 0,
                            "discountAmount": 1000,
                            "discountTax": 130
                        },
                        "variableLevyInfo": [
                            {
                                "voucherType": "A",
                                "voucherNumber": "凭证号",
                                "sdphm": "2*******************",
                                "fpdm": "0***********",
                                "fphm": "12345678",
                                "voucherAmount": "总额",
                                "deduction": "扣除额",
                                "date": "2024-01-01",
                                "note": "备注信息"
                            }
                        ],
                        "projectName": "***名称",
                        "xsyhzcbz": "Y",
                        "zzstsgl": "A",
                        "slqdbz": "若商品在项目信息列表内有记录,传\"Y\";否则传\"N\";默认为\"N\"",
                        "mtzlDm": "10001",
                        "sptm": "商品条码,13位",
                        "jzjtlxDm": "A"
                    }
                ],
                "amount": 1000,
                "tax": 130,
                "total": 1130,
                "sbxmdm": "10001"
            },
            "freightageInfo": {
                "data": [
                    {
                        "shippingType": "运输方式",
                        "shippingNumber": "号码",
                        "from": "出发地",
                        "to": "目的地",
                        "goods": "货物"
                    }
                ]
            },
            "noteInfo": {
                "note": "备注信息",
                "payee": "收款人",
                "reviewer": "复核人",
                "additionalInfo": [
                    {
                        "field": "example",
                        "type": "example",
                        "value": "example"
                    }
                ]
            },
            "personInfo": {
                "name": "***公司",
                "nation": "国籍",
                "certificateType": "A",
                "certificateCode": "证件号码",
                "uscc": "{{uscc}}"
            },
            "buildingServiceInfo": {
                "projectCode": "10001",
                "projectName": "***名称",
                "projectAddress": "**省**市**区**路**号",
                "addressDetail": "广东省深圳市南山区科技园",
                "crossArea": true,
                "crossRegionalTaxRegistrationNumber": 4403,
                "regionCode": "行政区划号码"
            },
            "immovablePropertyInfo": [
                {
                    "immovablePropertyCode": "10001",
                    "immovablePropertyAddress": "**省**市**区**路**号",
                    "addressDetail": "广东省深圳市南山区科技园",
                    "crossArea": true,
                    "landIncrementTaxProjectCode": "10001",
                    "priceIncludeTax": "核定计税价格",
                    "priceIncludeTaxTransaction": 1000,
                    "certificateOfTitle": "不动产权证号",
                    "areaUnit": "面积单位",
                    "regionCode": "行政区划号码"
                }
            ],
            "tractorInfo": {
                "engineNumber": "发动机号码",
                "chassisNumber": "底盘号/机架号"
            },
            "immovablePropertyRentInfo": [
                {
                    "immovablePropertyAddress": "**省**市**区**路**号",
                    "addressDetail": "广东省深圳市南山区科技园",
                    "startTime": "2024-01-01",
                    "endTime": "2024-12-31",
                    "crossArea": true,
                    "certificateOfTitle": "不动产权证号",
                    "areaUnit": "面积单位",
                    "cph": "车牌号",
                    "regionCode": "行政区划号码"
                }
            ],
            "passengerTransportationInfo": {
                "data": [
                    {
                        "name": "***公司",
                        "date": "2024-01-01",
                        "certificateType": "A",
                        "certificateCode": "证件号码",
                        "from": "出发地",
                        "to": "目的地",
                        "vehicle": "A",
                        "rank": "示例名称"
                    }
                ]
            },
            "paymentInfo": [
                {
                    "payChannelCode": "10001",
                    "transactionOrderNo": "交易单号"
                }
            ],
            "fplsh": "发票流水号",
            "isPurchaseByMultipleParties": true,
            "coPurchaserInfo": [
                {
                    "purchaserName": "***名称",
                    "documentTypeCode": "A",
                    "documentNumber": "证件号码"
                }
            ],
            "usedToRegisterTractor": true,
            "taxRelatedServiceInfo": {
                "sfkjsszyfwfppm": "是否开具涉税专业服务发票品目;\"Y\"表示是,\"N\"表示否;默认为\"N\"",
                "sszyfwxybh": "涉税专业服务协议编号; 当sfkjsszyfwfppm为\"Y\"时必填,可通过获取涉税专业服务协...",
                "sszyfwxm": "涉税专业服务项目;可不传",
                "sszyfwxmSp": [
                    "涉税专业服务项目商品;可不传"
                ]
            }
        }
    ]
}'

返回响应

🟢200
application/json
Success
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "taskID": 12345
    },
    "traceId": "xxxx-xxxx-xxxx-xxxx"
}
🟠400
🟠401
🔴500
修改于 2026-09-29 07:58:32
上一页
涉税专业服务协议要素采集信息表
下一页
蓝字发票开具任务状态查询
Built with