14、当期已勾选或往期已认证缴款书（税盘模式不支持）

请求参数

Query 参数

access_token

string

必需

发票云租户授权token

示例值:

发票云租户授权token

reqid

string

必需

链路id，用于跟踪排查问题，建议不少于13位

示例值:

链路id，用于跟踪排查问题，建议不少于13位

taxNo

string

授权对应的企业税号

必需

示例值:

授权对应的企业税号

name

string

可选

数电模式：可不传，也可指定长链接name，请求将由与name对应的客户端向税局发送请求；税盘模式，使用客户端生成的长链接name即可

示例值:

数电模式：可不传，也可指定长链接name，请求将由与name对应的客户端向税局发送请求；税盘模式，使用客户端生成的长链接name即可

Body 参数application/json

account

string

可选

电子税局账号，选填，不传则使用配置的默认电子税局账号

request_path

string

必需

/fpdk/query/ygxCustomBill

serialNo

string

批次号

必需

dataFromIndex

number

必需

开始为0，后续根据返回的nextDataFromIndex字段获取

dataIndex

number

必需

开始为0，后续根据返回的nextDataIndex字段获取

continueFlag

boolean

必需

循环标志，如果循环获取，则根据返回的结束标志判断是否获取结束

taxNo

string

企业税号

必需

searchOpt

object

必需

taxPeriod

string

税期

必需

示例

{
    "account": "string",
    "request_path": "string",
    "serialNo": "string",
    "dataFromIndex": 0,
    "dataIndex": 0,
    "continueFlag": true,
    "taxNo": "string",
    "searchOpt": {
        "taxPeriod": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api-dev.piaozone.com/test/?access_token=发票云租户授权token&reqid=链路id，用于跟踪排查问题，建议不少于13位&taxNo=授权对应的企业税号' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account": "string",
    "request_path": "string",
    "serialNo": "string",
    "dataFromIndex": 0,
    "dataIndex": 0,
    "continueFlag": true,
    "taxNo": "string",
    "searchOpt": {
        "taxPeriod": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

traceId

string

必需

traceId用于排查异常

errcode

string

必需

description

string

必需

totalNum

number

返回的缴款书数量

必需

data

array [object {17}]

必需

invoiceType

number

固定返回21

可选

customDeclarationNo

string

缴款书号码

可选

invoiceDate

string

填发日期

可选

taxAmount

string

税额

可选

totalTaxAmount

string

税额

可选

invoiceStatus

string

缴款书状态

可选

checkFlag

number

是否勾选

可选

deductionPurpose

string

抵扣用途

可选

effectiveTaxAmount

string

有效税额

可选

selectTime

string

勾选日期

可选

manageStatus

string

管理状态

可选

authenticateFlag

number

勾选认证标志

可选

checkAuthenticateFlag

string

是否勾选认证标志

可选

selectAuthenticateTime

string

勾选认证日期

可选

scanAuthenticateFlag

string

扫描认证标志

可选

scanAuthenticateTime

string

扫描认证日期

可选

taxPeriod

string

勾选税期

可选

nextDataFromIndex

number

必需

分页传入的下一个dataFromIndex

nextDataIndex

number

必需

分页传入的下一个dataIndex

endFlag

boolean

必需

分页是否结束，根据这个判断下载是否结束，如果返回false，则需要再次获取，否则结束获取

示例

{
    "traceId": "string",
    "errcode": "string",
    "description": "string",
    "totalNum": 0,
    "data": [
        {
            "invoiceType": 0,
            "customDeclarationNo": "string",
            "invoiceDate": "string",
            "taxAmount": "string",
            "totalTaxAmount": "string",
            "invoiceStatus": "string",
            "checkFlag": 0,
            "deductionPurpose": "string",
            "effectiveTaxAmount": "string",
            "selectTime": "string",
            "manageStatus": "string",
            "authenticateFlag": 0,
            "checkAuthenticateFlag": "string",
            "selectAuthenticateTime": "string",
            "scanAuthenticateFlag": "string",
            "scanAuthenticateTime": "string",
            "taxPeriod": "string"
        }
    ],
    "nextDataFromIndex": 0,
    "nextDataIndex": 0,
    "endFlag": true
}