5007-红字确认单申请

开发环境

http://192.168.51.174

POST

/eTaxManage/openApi/apiPost

最后修改时间：2024-08-27 07:24:34

责任人：Shenxl_

外部系统可根据此接口进行数电红字确认单申请。

请求参数

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>

录入方身份

必需

录入方身份

枚举值:

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

createName

string

录入方名称

可选

2.0.6迭代新增

otherSideCreditCode

string

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

可选

2.0.6迭代新增

otherSideName

string

对方名称

可选

2.0.6迭代新增

blueTotalAmt

number

蓝字发票合计金额

可选

2.0.6迭代新增

blueTaxAmt

number

蓝字发票合计税额

可选

2.0.6迭代新增

blueInvType

enum<string>

蓝字发票票种代码

可选

2.0.6迭代新增发票种类： 61(数电电子普票)；62(数电电子专票) 纸质专用发票；纸质普通发票；电子专用发票；电子普通发票

枚举值:

0251526162

blueSpecialInvoiceMark

enum<string>

蓝字发票特定要素类型代码

可选

2.0.6迭代新增蓝字发票特定要素类型

枚举值:

01020304050607080910111213141516171820

creditType

string

购方企业类型

可选

2.0.9迭代新增字段 1（企业）；2（非企业单位）；3（个人）。

differenceTax

string

差额征税类型代码

可选

2.0.9迭代新增字段空：非差额发票 01：差额开票 02：全额开票。目前仅支持空（非差额发票）。

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": "3B5912776YJP5M8740",
    "invoiceSerialNumber": "do officia irure",
    "createIdentity": 1,
    "blueInvoiceCode": "ut",
    "blueInvoiceNum": "Excepteur",
    "blueInvoiceDate": "ex aute ipsum dolor eiusmod",
    "tolAmtIncl": 51819621.93209323,
    "totalAmt": -3703054.2995714694,
    "taxAmt": -88809234.71717174,
    "isTax": "in exercitation",
    "redReason": "3",
    "createName": "anim in veniam Lorem",
    "otherSideCreditCode": "id mollit adipisicing in",
    "otherSideName": "qui laborum in",
    "blueTotalAmt": 23480274.515178174,
    "blueTaxAmt": -45175450.25030274,
    "blueInvType": "61",
    "blueSpecialInvoiceMark": "06",
    "creditType": "ipsum dolor",
    "differenceTax": "sed sint",
    "detailItemList": [
        {
            "blueSerialNo": 9487358,
            "serialNo": 87653694,
            "matName": "ex sunt qui",
            "spec": "pariatur tempor do nisi Lorem",
            "unit": "minim Excepteur eu laborum pariatur",
            "quantity": "occaecat id anim laborum veniam",
            "price": "cupidatat et dolor",
            "amt": 76948053.20479205,
            "taxRate": -6533487.1469088495,
            "taxAmount": -48837093.578173764,
            "balance": 81062646.31372279,
            "revenueCode": "et deserunt cupidatat reprehenderit adipisicing",
            "privilegeType": "09",
            "taxShortName": "velit Excepteur"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://192.168.51.174/eTaxManage/openApi/apiPost' \
--header 'SID: 5007' \
--header 'Authorization: bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "creditCode": "3B5912776YJP5M8740",
    "invoiceSerialNumber": "do officia irure",
    "createIdentity": 1,
    "blueInvoiceCode": "ut",
    "blueInvoiceNum": "Excepteur",
    "blueInvoiceDate": "ex aute ipsum dolor eiusmod",
    "tolAmtIncl": 51819621.93209323,
    "totalAmt": -3703054.2995714694,
    "taxAmt": -88809234.71717174,
    "isTax": "in exercitation",
    "redReason": "3",
    "createName": "anim in veniam Lorem",
    "otherSideCreditCode": "id mollit adipisicing in",
    "otherSideName": "qui laborum in",
    "blueTotalAmt": 23480274.515178174,
    "blueTaxAmt": -45175450.25030274,
    "blueInvType": "61",
    "blueSpecialInvoiceMark": "06",
    "creditType": "ipsum dolor",
    "differenceTax": "sed sint",
    "detailItemList": [
        {
            "blueSerialNo": 9487358,
            "serialNo": 87653694,
            "matName": "ex sunt qui",
            "spec": "pariatur tempor do nisi Lorem",
            "unit": "minim Excepteur eu laborum pariatur",
            "quantity": "occaecat id anim laborum veniam",
            "price": "cupidatat et dolor",
            "amt": 76948053.20479205,
            "taxRate": -6533487.1469088495,
            "taxAmount": -48837093.578173764,
            "balance": 81062646.31372279,
            "revenueCode": "et deserunt cupidatat reprehenderit adipisicing",
            "privilegeType": "09",
            "taxShortName": "velit Excepteur"
        }
    ]
}'

返回响应

🟢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通用返回报文

修改于 2024-08-27 07:24:34

5006-开具数电红字发票

5008-红字确认单确认/拒绝