5007-红字确认单申请

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5007

Authorization

string

可选

获取token接口返回token类型加token

示例值:

bearer token

Body 参数application/json

creditCode

string

纳税人识别号 / 统一社会信用代码

必需

正则匹配:

^[^_IOZSVa-z\W]{2}\d{6}[^_IOZSVa-z\W]{10}$

invoiceSerialNumber

string

请求流水号

必需

唯一标识。长度不能超过 64 个字符，且不能为中文。同步接口，用于重复性校验

<= 64 字符

createIdentity

enum<integer>

录入方身份

必需

录入方身份

枚举值:

01

blueInvoiceCode

string

对应蓝票代码

可选

blueInvoiceNum

string

对应蓝票号码

必需

blueInvoiceDate

string <yyyy-MM-dd HH:mm:ss>

蓝字发票开票日期

必需

yyyy-MM-dd HH:mm:ss

tolAmtIncl

number

红字冲销价税合计

必需

totalAmt

number

红字冲销合计金额（不含税）

必需

taxAmt

number

红字冲销合计税额

必需

isTax

string

含税标志

必需

0 (否)；1 (是)

redReason

enum<string>

冲红原因

可选

为空时，默认 2 开票有误

枚举值:

1234

detailItemList

array [object {14}]

商品信息明细行

可选

部分红冲时必传，全额红冲时可不传

blueSerialNo

integer

蓝字发票明细序号

必需

serialNo

integer

明细行序号

必需

matName

string

项目名称

必需

spec

string

规格型号

可选

unit

string

单位

可选

quantity

string

数量

可选

如 “单价”“单位” 栏次非空，则本栏次必须非空

price

string

单价

可选

如 “数量”“单位” 栏次非空，则本栏次必须非空含税标志为 0 时，为不含税单价含税标志为 1 时，为含税单价

amt

number

金额

必需

含税标志为 0 时，为不含税金额含税标志为 1 时，为含税金额

taxRate

number

增值税税率 / 征收率

必需

taxAmount

number

税额

必需

balance

number

扣除额

可选

差额征税 - 全额开票：0；差额征税 - 差额开票： 0< 扣除额 <= 含税金额。明细行只能是一行。 1. 具体差额征税发票的计算方法如下： 1.1 不含税差额 = 不含税金额 - 扣除额；税额 = 不含税差额 * 税率。扣除额不能大于不含税金额。预留字段，暂不支持

revenueCode

string

商品和服务税收分类合并编码

必需

privilegeType

enum<string>

优惠政策标识

可选

01：简易征收；02：稀土产品；03：免税；04：不征税；05：先征后退；06：100% 先征后退；07：50% 先征后退；08：按 3% 简易征收；09：按 5% 简易征收；10：按 5% 简易征收减按 1.5% 计征；11：即征即退 30%；12：即征即退 50%；13：即征即退 70%；14：即征即退 100%；15：超税负 3% 即征即退；16：超税负 8% 即征即退；17：超税 12% 即征即退；18：超税负 6% 即征即退乐企前置接口有，税局乐企没有

枚举值:

010203040506070809101112131415161718

taxShortName

string

商品简称

可选

示例

{
    "creditCode": "915101000549157085",
    "invoiceSerialNumber": "202304130001",
    "totalAmt": -1,
    "tolAmtIncl": -1.09,
    "blueInvoiceDate": "2023-04-13 16:29:48",
    "blueInvoiceNum": "23446000000000000653",
    "createIdentity": 0,
    "taxAmt": -0.09,
    "isTax": "0",
    "detailItemList": [
        {
            "blueSerialNo": 1,
            "matName": "*海水产品*三目蟹",
            "serialNo": 1,
            "revenueCode": "1010403000000000000",
            "taxAmount": -0.09,
            "taxRate": 0.09,
            "amt": -1,
            "spec": "",
            "price": "",
            "taxShortName": ""
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://192.168.51.174/eTaxManage/openApi/apiPost/8' \
--header 'SID: 5007' \
--header 'Authorization: bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "creditCode": "915101000549157085",
    "invoiceSerialNumber": "202304130001",
    "totalAmt": -1,
    "tolAmtIncl": -1.09,
    "blueInvoiceDate": "2023-04-13 16:29:48",
    "blueInvoiceNum": "23446000000000000653",
    "createIdentity": 0,
    "taxAmt": -0.09,
    "isTax": "0",
    "detailItemList": [
        {
            "blueSerialNo": 1,
            "matName": "*海水产品*三目蟹",
            "serialNo": 1,
            "revenueCode": "1010403000000000000",
            "taxAmount": -0.09,
            "taxRate": 0.09,
            "amt": -1,
            "spec": "",
            "price": "",
            "taxShortName": ""
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

confirmNo

string

红字确认单编号

必需

uuid

string

红字确认单uuid

必需

confirmStatus

enum<string>

确认单状态代码

必需

枚举值:

01020304050607080910

示例

{
    "message": "成功",
    "msgCode": 0,
    "success": true,
    "value": "{\"confirmNo\":\"44201422081000000301\",\"confirmStatus\":\"TZD0000\",\"creditCode\":\"915101000549157085\",\"uuid\":\"2ae145de60a74d5789d1a40f966026ae\"}"
}

🟢200通用返回报文