6、海关缴款书表头采集（税盘模式不支持）

请求参数

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/customBill/query

serialNo

string

必需

默认为空，循环获取时使用返回的批次号

dataFromIndex

number

必需

默认为0，数据源索引,循环获取时使用返回的nextDataFromIndex

dataIndex

number

必需

指定数据源的数据索引，默认为0，循环获取时使用返回的nextDataIndex即可

continueFlag

boolean

必需

循环标志，默认循环获取

taxNo

string

企业税号

必需

searchOpt

object

必需

customDeclarationNo

string

缴款书号码

必需

authenticateFlags

string

勾选、认证标志

必需

startTime

string

填发日期起

必需

endTime

string

填发日期止

必需

示例

{
  "account": "string",
  "request_path": "string",
  "serialNo": "string",
  "dataFromIndex": 0,
  "dataIndex": 0,
  "continueFlag": true,
  "taxNo": "string",
  "searchOpt": {
    "customDeclarationNo": "string",
    "authenticateFlags": "string",
    "startTime": "string",
    "endTime": "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": {
        "customDeclarationNo": "string",
        "authenticateFlags": "string",
        "startTime": "string",
        "endTime": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

traceId

string

必需

traceId用于排查异常

errcode

string

必需

操作码0000为成功，91300为电子税局登录失效，需要重新登录，1300位发票云token失效需要重新获取token

description

string

错误描述

必需

totalNum

number

发票采集的总数

必需

data

array [object {20}]

必需

invoiceType

number

发票类型

可选

customDeclarationNo

string

缴款书号码

可选

invoiceDate

string

填发日期

可选

salerName

string

销方名称

可选

salerTaxNo

string

销方税号

可选

invoiceAmount

string

不含税金额

可选

totalTaxAmount

string

总税额

可选

invoiceStatus

string

发票状态

可选

checkFlag

string

勾选标志

可选

deductionPurpose

string

抵扣用

可选

effectiveTaxAmount

string

有效税额

可选

selectTime

string

勾选时间

可选

manageStatus

string

管理状态

可选

authenticateFlag

number

勾选及认证合并状态

可选

checkAuthenticateFlag

string

认证状态

可选

selectAuthenticateTime

string

认证时间

可选

scanAuthenticateFlag

string

扫描认证状态

可选

scanAuthenticateTime

string

扫描认证时间

可选

taxPeriod

string

税期

可选

buyerTaxNo

string

购方税号

可选

serialNo

string

批次号

必需

nextDataFromIndex

number

必需

该批次下一个dataFromIndex

nextDataIndex

number

必需

该批次下一个dataIndex

endFlag

boolean

该批次结束标志

必需

示例

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