4.02 进项发票表头归集

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/kapi/app/rim/deduction

请求参数

Query 参数

access_token

string

必需

access_token

Header 参数

access_token

string

可选

默认值:

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": {
            "taxPeriod": "202206",
            "invoiceCode": "string",
            "invoiceNo": "string",
            "salerTaxNo": "string",
            "authenticateFlags": "空字符串",
            "invoiceStatus": "空字符串",
            "invoiceType": "空字符串",
            "startTime": "2022-06-01",
            "endTime": "2022-07-01"
        }
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/rim/deduction?access_token=' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessSystemCode": "string",
    "interfaceCode": "invoiceDown",
    "requestId": "string",
    "data": {
        "taxNo": "string",
        "asyncFlag": "string",
        "searchOpt": {
            "taxPeriod": "202206",
            "invoiceCode": "string",
            "invoiceNo": "string",
            "salerTaxNo": "string",
            "authenticateFlags": "空字符串",
            "invoiceStatus": "空字符串",
            "invoiceType": "空字符串",
            "startTime": "2022-06-01",
            "endTime": "2022-07-01"
        }
    }
}'

返回响应

🟢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"
            }
        ]
    }
}

修改于 2025-07-08 06:49:22

4.01 税局登录

4.03 进项发票表头归集结果查询