4.07 当前统计查询 - 发票云(旗舰版)API文档

请求参数

Query 参数

access_token

string

必需

access_token

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

businessSystemCode

string

必需

对接不同系统来源编码，用于区分不同系统的回调接口；例如SRM系统，你可以传入SRM

interfaceCode

enum<string>

必需

接口编码，定义本接口的操作种类，传固定字符串值：statisticQuery

枚举值:

statisticQuery

requestId

string

可选

定义本次接口的请求ID码，可用当前13位毫秒级时间戳加3位随机数字(总共16位)生成的字符串

data

object

必需

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

taxNo

string

必需

本次进行统计查询的纳税人识别号（税号）

示例

{
    "businessSystemCode": "string",
    "interfaceCode": "statisticQuery",
    "requestId": "string",
    "data": {
        "taxNo": "string"
    }
}

示例代码

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 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessSystemCode": "string",
    "interfaceCode": "statisticQuery",
    "requestId": "string",
    "data": {
        "taxNo": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

errorCode

string

必需

返回响应码，0000：成功

message

string

响应描述

必需

success

boolean

必需

请求是否成功，布尔值

data

object

必需

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

taxPeriod

string

所属税期

必需

示例值:

202205

skssq

string

税款所属期信息

必需

gxrqfw

string

勾选可操作范围

必需

updateTime

string

更新时间

必需

createTjbbStatus

enum<string>

统计表状态

必需

枚举值:

01020304052122

isAllowQxTj

boolean

是否允许撤销统计表

必需

isAllowQrtj

boolean

是否允许确认统计表

必需

allowChangeSsqBySeason

boolean

必需

接口冗余字段，按月或者按季度，发票云属期参数只支持传年-月，可不处理

tjInfo

string

统计信息（字符串）

必需

示例值:

01=147=4548746.11=279799.65=0=0=0;03=0=0=0=0=0=0;14=0=0=0=0=0=0;21=0=0=0=0=0=0;24=0=0=0=0=0;99=147=4548746.11=279799.65=0=0=0;

tjInfoArr

array [object {7}]

必需

统计信息（字符数组）

示例

{
    "errorCode": "string",
    "message": "string",
    "success": true,
    "data": {
        "taxPeriod": "202205",
        "skssq": "string",
        "gxrqfw": "string",
        "updateTime": "string",
        "createTjbbStatus": "01",
        "isAllowQxTj": true,
        "isAllowQrtj": true,
        "allowChangeSsqBySeason": true,
        "tjInfo": "01=147=4548746.11=279799.65=0=0=0;03=0=0=0=0=0=0;14=0=0=0=0=0=0;21=0=0=0=0=0=0;24=0=0=0=0=0;99=147=4548746.11=279799.65=0=0=0;",
        "tjInfoArr": [
            {
                "invoiceType": "string",
                "deductibleNum": 0,
                "deductibleAmount": 0,
                "deductibleTax": 0,
                "unDeductibleNum": 0,
                "unDeductibleAmount": 0,
                "unDeductibleTax": 0
            }
        ]
    }
}