确认单创建

POST

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

接口描述

该接口用于向企业电子发票服务平台提交红字发票确认单创建请求。

触发异步任务向税局申请生成红字确认单。

调用流程

调用「确认单创建」接口，调用成功后获取到任务ID（taskId）

调用「确认单创建任务状态查询」接口，通过 taskId 轮询任务状态；当 status=1（成功）时，表明确认单已成功提交至税局

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "invoiceNumber": "24442000000012345678",
    "invoiceCode": "10001",
    "invoiceSdpHm": "24442000000012345678",
    "isSeller": true,
    "isIncludeTax": true,
    "reason": "",
    "productReturnList": [
        {
            "index": 1,
            "number": "99",
            "amount": 1000,
            "tax": 130
        }
    ],
    "discountList": [
        {
            "index": 1,
            "amount": 1000,
            "tax": 130
        }
    ],
    "serviceBrokenList": [
        {
            "index": 1,
            "number": "99",
            "amount": 1000,
            "tax": 130
        }
    ],
    "jshj": 1130
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'openapi.nmy.cn/api/v1/open/red-invoice/confirmation/create' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "invoiceNumber": "24442000000012345678",
    "invoiceCode": "10001",
    "invoiceSdpHm": "24442000000012345678",
    "isSeller": true,
    "isIncludeTax": true,
    "reason": "",
    "productReturnList": [
        {
            "index": 1,
            "number": "99",
            "amount": 1000,
            "tax": 130
        }
    ],
    "discountList": [
        {
            "index": 1,
            "amount": 1000,
            "tax": 130
        }
    ],
    "serviceBrokenList": [
        {
            "index": 1,
            "number": "99",
            "amount": 1000,
            "tax": 130
        }
    ],
    "jshj": 1130
}'

返回响应

🟢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

字段删除

确认单创建任务状态查询