2.1.13 红字确认单编号查询 - 发票云(旗舰版)API文档

请求参数

Query 参数

access_token

string

必需

{access_token}

Body 参数application/json

requestId

string

必需

当前13位毫秒级时间戳加3位随机数字(总共16位)

interfaceCode

enum<string>

必需

接口编码，固定值：ALLE.REDCONFIRMBILL.QUERY

枚举值:

ALLE.REDCONFIRMBILL.QUERY

businessSystemCode

string

必需

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

data

object

必需

taxpayerId

string

授权对应的企业税号

可选

<= 20 字符

orgCode

string

可选

组织编码（组织编码和授权对应税号二者必填其一）

<= 20 字符

redInfoBillNo

string

可选

红字确认单编号（支持乐企。如需支持rpa，需先将本红字确认单下载至发票云，再通过本接口可获取该确认单最新信息，如确认单状态。）

<= 30 字符

identity

enum<string>

录入方身份

必需

枚举值:

01

startDate

string <date>

录入日期起

必需

示例值:

2022-05-05

endDate

string <date>

录入日期止

必需

示例值:

2020-05-05

示例

{
  "requestId": "string",
  "interfaceCode": "ALLE.REDCONFIRMBILL.QUERY",
  "businessSystemCode": "string",
  "data": {
    "taxpayerId": "string",
    "orgCode": "string",
    "redInfoBillNo": "string",
    "identity": "0",
    "startDate": "2022-05-05",
    "endDate": "2020-05-05"
  }
}

示例代码

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=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "interfaceCode": "ALLE.REDCONFIRMBILL.QUERY",
    "businessSystemCode": "string",
    "data": {
        "taxpayerId": "string",
        "orgCode": "string",
        "redInfoBillNo": "string",
        "identity": "0",
        "startDate": "2022-05-05",
        "endDate": "2020-05-05"
    }
}'

返回响应

🟢200成功

application/json

Body

errorCode

string

响应码

必需

success

string

响应状态

必需

message

string

响应说明

必需

data

object

返回数据

必需

dataList

array [object {21}]

必需

下载的红字确认单数据

pageNo

integer

当前分页

必需

pageSize

integer

分页大小

必需

totalElement

integer

总条数

必需

示例

{
  "errorCode": "string",
  "success": "string",
  "message": "string",
  "data": {
    "dataList": [
      {
        "govRedConfirmBillUuid": "string",
        "redConfirmBillStatus": "01",
        "redInfoBillNo": "string",
        "redConfirmEnterDate": "string",
        "redReason": "1",
        "enterIdentity": "0",
        "buyerName": "string",
        "buyerTaxpayerId": "string",
        "sellerName": "string",
        "sellerTaxpayerId": "string",
        "invoiceNo": "string",
        "totalAmount": "string",
        "totalTaxAmount": 0,
        "invoiceDate": "string",
        "originalInvoiceType": "string",
        "originalInvoiceCode": "string",
        "originalInvoiceNumber": "string",
        "originalInvoiceAmount": 0,
        "originalTotalTaxAmount": 0,
        "originalIssueTime": "string",
        "items": [
          {
            "blueInvoiceItemIndex": "string",
            "index": "string",
            "revenueCode": "string",
            "goodsName": "string",
            "specification": "string",
            "units": "string",
            "quantity": "string",
            "price": "string",
            "amount": 0,
            "taxAmount": 0,
            "taxRate": 0
          }
        ]
      }
    ],
    "pageNo": 0,
    "pageSize": 0,
    "totalElement": 0
  }
}