4.02 进项发票表头归集 - 发票云(旗舰版)API文档

请求参数

Query 参数

access_token

string

必需

access_token

Body 参数application/json

businessSystemCode

string

必需

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

interfaceCode

enum<string>

必需

接口编码，固定值：invoiceDown

枚举值:

invoiceDown

requestId

string

可选

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

data

object

必需

需要把data的值加密成字符串，默认为base64

taxNo

string

企业税号

必需

<= 20 字符

asyncFlag

string

可选

异步标志:0-同步（默认），1-异步

searchOpt

object

查询参数

必需

示例

{
  "businessSystemCode": "string",
  "interfaceCode": "invoiceDown",
  "requestId": "string",
  "data": {
    "taxNo": "string",
    "asyncFlag": "string",
    "searchOpt": {
      "invoiceCode": "string",
      "invoiceNo": "string",
      "salerTaxNo": "string",
      "authenticateFlags": "空字符串",
      "invoiceStatus": "空字符串",
      "invoiceType": "空字符串",
      "startTime": "2022-06-01",
      "endTime": "2022-07-01",
      "taxPeriod": "202206"
    }
  }
}

示例代码

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/rim/deduction?access_token=' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

Body

errorCode

string

必需

响应码，0000-成功

message

string

响应描述

必需

success

boolean

请求是否成功

必需

data

object

必需

返回内容data，需要解密，默认为base64

asyncFlag

string

可选

异步标志:0-同步（默认），1-异步

taskNo

string

可选

异步任务号（asyncFlag=1时返回）

totalElement

integer

发票总数量

必需

invoicesData

array [object {22}]

发票数组

必需

示例

{
  "errorCode": "string",
  "message": "string",
  "success": true,
  "data": {
    "asyncFlag": "string",
    "taskNo": "string",
    "totalElement": 0,
    "invoicesData": [
      {
        "invoiceType": "string",
        "invoiceCode": "string",
        "invoiceNo": "string",
        "invoiceDate": "string",
        "salerName": "string",
        "salerTaxNo": "string",
        "invoiceAmount": "string",
        "totalTaxAmount": "string",
        "invoiceStatus": "string",
        "checkFlag": "string",
        "deductionPurpose": "string",
        "effectiveTaxAmount": "string",
        "selectTime": "string",
        "manageStatus": "string",
        "authenticateFlag": "string",
        "checkAuthenticateFlag": "string",
        "selectAuthenticateTime": "string",
        "scanAuthenticateFlag": "string",
        "scanAuthenticateTime": "string",
        "taxPeriod": "202206",
        "buyerTaxNo": "string",
        "notDeductibleType": "string"
      }
    ]
  }
}