2.2.05税控红字信息表下载 - 发票云(旗舰版)API文档

请求参数

Query 参数

access_token

string

可选

示例值:

1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

对接业务系统来源编码，用于区分不同业务系统的回调接口

interfaceCode

enum<string>

接口编码

必需

枚举值:

REDINFOBILL.DOWNLOAD

data

object

必需

需要把data里面的object加密成base64字符串

applyTaxpayerId

string

必需

申请方纳税人识别号【最大长度：20】,只能15、17、18、20位

sellerTaxpayerId

string

可选

销售方纳税人识别号【最大长度：20】,只能15、17、18、20位

buyerTaxpayerId

string

购买方税号

可选

deviceNo

string

必需

设备编号【长度：20】

downloadScope

string

必需

下载范围， 1-全部 2-本企业申请： 1）企业自己作为销售方填写的红字申请表，下载后直接开具红票； 2）企业自己作为购买方申请的红字信息表，下载后提供红字信息表编号提供给销售方开具红票; 3-本企业接收：即其他企业作为购方申请（发票已抵扣/未抵扣），下载后由本企业开红票【长度：1】

redInfoBillNo

string

可选

红字信息表编号【长度：16】

applyDateS

string

可选

申请日期起【长度：10】，格式【yyyy-MM-dd】

applyDateE

string

可选

申请日期止【长度：10】，格式【yyyy-MM-dd】

invoiceType

string

必需

发票种类， 028：增值税电子专用发票 004：增值税纸质专用发票【长度：4】

pageNo

number

页码

必需

pageSize

number

分页大小，最大50

必需

示例

{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": " REDINFOBILL.DOWNLOAD",
    "data": {
        "applyTaxpayerId": "string",
        "sellerTaxpayerId": "string",
        "buyerTaxpayerId": "string",
        "deviceNo": "string",
        "downloadScope": "string",
        "redInfoBillNo": "string",
        "applyDateS": "string",
        "applyDateE": "string",
        "invoiceType": "string",
        "pageNo": 0,
        "pageSize": 0
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi?access_token=1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": " REDINFOBILL.DOWNLOAD",
    "data": {
        "applyTaxpayerId": "string",
        "sellerTaxpayerId": "string",
        "buyerTaxpayerId": "string",
        "deviceNo": "string",
        "downloadScope": "string",
        "redInfoBillNo": "string",
        "applyDateS": "string",
        "applyDateE": "string",
        "invoiceType": "string",
        "pageNo": 0,
        "pageSize": 0
    }
}'

返回响应

🟢200成功

application/json

Body

message

string

必需

errorCode

string

必需

success

boolean

成功响应

必需

data

object

必需

需要把data里面的object加密成base64字符串

totals

number

必需

redInfoBills

array [object {18}]

必需

红字信息表array

示例

{
    "message": "string",
    "errorCode": "string",
    "success": true,
    "data": {
        "totals": 0,
        "redInfoBills": [
            {
                "serialNo": "string",
                "redInfoBillNo": "string",
                "redInfoBillStatus": "string",
                "redInfoBillDesc": "string",
                "originalInvoiceCode": "string",
                "originalInvoiceNumber": "string",
                "multiTaxRateFlag": 0,
                "applyDate": "string",
                "sellerName": "string",
                "sellerTaxpayerId": {},
                "buyerName": "string",
                "buyerTaxpayerId": "string",
                "invoiceType": "string",
                "totalAmount": 0,
                "totalTaxAmount": 0,
                "taxRate": "string",
                "includeTaxrFlag": 0,
                "redInfoBillDetail": {
                    "goodsName": "string",
                    "specification": "string",
                    "units": "string",
                    "quantity": "string",
                    "price": "string",
                    "amount": "string",
                    "taxRate": "string",
                    "taxAmount": "string",
                    "revenueCode": "string",
                    "privilegeFlag": "string",
                    "privilegeContent": "string",
                    "zeroTaxRateFlag": "string"
                }
            }
        ]
    }
}

🟢200失败