5009-查询红字确认单（含主体和明细）

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5009

Authorization

string

可选

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

示例值:

bearer token

Body 参数application/json

creditCode

string

纳税人识别号

必需

invoiceType

string

发票种类

可选

<= 3 字符

fillInBeginDate

string

录入日期起

可选

<= 10 字符

fillInEndDate

string

录入日期止

可选

<= 10 字符

custCreditCode

string

购方税号

可选

购销身份 1我是购方：必传

<= 20 字符

custName

string

购方名称

可选

购销身份 1我是购方：必传

saleCreditCode

string

销方税号

可选

购销身份 0我是销方：必传

<= 20 字符

saleName

string

销方名称

可选

购销身份 0我是销方：必传

redConfirmNum

string

红字确认单编号

可选

<= 20 字符

userIdentity

string

购销身份

必需

0（销方）；1（购方）

<= 1 字符

pageNum

string

页号

必需

从1开始

<= 10 字符

pageSize

string

每页条数缺省100

必需

<= 10 字符

statusCode

string

确认单状态代码

可选

01：无需确认 02：销方录入待购方确认 03：购方录入待销方确认 04：购销双方已确认 05：作废(销方录入购方否认) 06：作废(购方录入销方否认) 07：作废(超72小时未确认) 08：作废(发起方撤销) 09：作废(确认后撤销) 10：作废(异常凭证)

<= 100 字符

requestIdentity

string

录入方身份

可选

0：销方 1：购方

<= 2 字符

blueInvoiceCode

string

蓝字发票代码

可选

<= 12 字符

blueInvoiceNum

string

蓝字发票号码

可选

<= 20 字符

示例

{
    "creditCode": "string",
    "invoiceType": "str",
    "fillInBeginDate": "string",
    "fillInEndDate": "string",
    "custCreditCode": "string",
    "custName": "string",
    "saleCreditCode": "string",
    "saleName": "string",
    "redConfirmNum": "string",
    "userIdentity": "s",
    "pageNum": "string",
    "pageSize": "string",
    "statusCode": "string",
    "requestIdentity": "st",
    "blueInvoiceCode": "string",
    "blueInvoiceNum": "string"
}

示例代码

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' \
--header 'SID: 5009' \
--header 'Authorization: bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "creditCode": "string",
    "invoiceType": "str",
    "fillInBeginDate": "string",
    "fillInEndDate": "string",
    "custCreditCode": "string",
    "custName": "string",
    "saleCreditCode": "string",
    "saleName": "string",
    "redConfirmNum": "string",
    "userIdentity": "s",
    "pageNum": "string",
    "pageSize": "string",
    "statusCode": "string",
    "requestIdentity": "st",
    "blueInvoiceCode": "string",
    "blueInvoiceNum": "string"
}'

返回响应

🟢200成功

application/json

Body

totalCountOfInfoForms

string

记录总数

必需

返回符合条件的记录总数

<= 10 字符

redConfirmNum

string

红字确认单编号

必需

<= 32 字符

redConfirmUuid

string

红字确认单uuid

必需

<= 10 字符

statusCode

string

确认单状态代码

必需

01：无需确认 02：销方录入待购方确认 03：购方录入待销方确认 04：购销双方已确认 05：作废(销方录入购方否认) 06：作废(购方录入销方否认) 07：作废(超72小时未确认) 08：作废(发起方撤销) 09：作废(确认后撤销) 10：作废(异常凭证)

<= 20 字符

blueInvoiceCode

string

对应蓝票发票代码

必需

<= 12 字符

blueInvoiceNum

string

对应蓝票发票号码

必需

<= 20 字符

blueInvoiceDate

string

对应蓝票开票日期

可选

数字化电子发票格式： YYYYMMDDHHMMSS

<= 14 字符

blueInvoiceType

string

蓝票发票种类

必需

61(数电电子普票)；62(数电电子专票)

<= 3 字符

paperInvoiceFlag

string

是否纸质发票标志

可选

Y=纸质发票；N=电子发票

blueTotalAmt

number

蓝字发票合计金额

必需

blueTotalTaxAmt

number

蓝字发票合计税额

必需

specialInvoiceMark

string

蓝字发票特定要素类型

必需

“00”非特定要素

<= 2 字符

custName

string

购方名称

必需

<= 100 字符

custCreditCode

string

购方税号

必需

<= 20 字符

saleName

string

销方名称

必需

<= 100 字符

saleCreditCode

string

销方税号

必需

<= 20 字符

totalAmt

number

红字撤销金额

必需

totalTaxAmt

number

红字撤销税额

必需

taxInclusivePriceMark

string

征税类型代码

必需

0：普通征税 2：差额征税—差额开票 3：差额征税—全额开票

<= 1 字符

redReason

string

冲红原因

可选

1-销货退回； 2-开票有误； 3-服务中止； 4-销售折让

<= 2 字符

requestIdentity

string

录入方身份

可选

0：销方 1：购方

<= 2 字符

confirmDate

string

确认日期

可选

yyyy-MM-dd HH:mm:ss

invoiceStatus

string

已开具红字发票标志

可选

Y：已开具 N：未开具

<= 1 字符

invoiceCode

string

红字发票号码

可选

<= 20 字符

invoiceDate

string

红字开票日期

必需

YYYYMMDDHHMMSS

<= 20 字符

validMark

string

有效标志

必需

Y：有效 N：无效

<= 1 字符

taxMark

string

含税标志

必需

含税标志：0(否)；1(是)。

<= 1 字符

statusDescription

string

状态描述

必需

detailId

string

商品行序号

必需

<= 8 字符

blueInvoiceDetailId

string

蓝票明细序号

必需

<= 8 字符

item

string

项目名称

必需

<= 92 字符

specification

string

规格型号

可选

<= 120 字符

unit

string

单位

可选

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

<= 80 字符

quantity

number

数量

可选

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

price

number

单价

可选

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

amount

number

金额

必需

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

taxAmount

number

税额

必需

taxRate

number

税率

可选

productCode

string

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

必需

税收分类编码

<= 19 字符

zeroTaxSchemeMark

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%即征即退

<= 1 字符

示例

{
    "totalCountOfInfoForms": "符合条件的全部记录数",
    "redConfirms": [
        {
            "redConfirmUuid": "1",
            "redConfirmNum": "红字确认单编号",
            "statusCode": "确认单状态代码",
            "blueInvoiceCode": "对应蓝票发票代码",
            "blueInvoiceNum": "对应蓝票发票号码",
            "blueInvoiceDate": "蓝字发票开票日期",
            "blueInvoiceType": "蓝字发票票种代码",
            "paperInvoiceFlag": "",
            "blueTotalAmt": "蓝字发票合计金额",
            "blueTotalTaxAmt": "蓝字发票合计税额",
            "specialInvoiceMark": "特定要素",
            "custName": "购方名称",
            "custCreditCode": "购方税号",
            "saleName": "销方名称",
            "saleCreditCode": "销方税号",
            "totalAmt": "合计金额",
            "totalTaxAmt": "合计税额",
            "taxInclusivePriceMark": "征税类型代码",
            "redReason": "冲红原因",
            "requestIdentity": "录入方身份",
            "confirmDate": "",
            "invoiceStatus": "已开具红字发票标志",
            "invoiceCode": "红字发票号码",
            "invoiceDate": "红字开票日期",
            "validMark": "有效标志",
            "taxMark": "",
            "redConfirmItems": [
                {
                    "detailId": "1",
                    "blueInvoiceDetailId": "蓝字发票明细序号",
                    "item": "项目名称",
                    "specification": "规格型号",
                    "unit": "单位",
                    "quantity": "数量",
                    "price": "单价",
                    "amount": "金额",
                    "taxRate": "税率",
                    "taxAmount": "税额",
                    "taxMark": "含税标志 N不含税，Y含税",
                    "productCode": "商品和服务税收分类合并编码",
                    "zerotaxSchemeMark": "优惠政策标识"
                }
            ]
        }
    ]
}

🟢200通用返回报文