2、进项发票表头采集 - 发票云(标准版)API文档

请求参数

Query 参数

access_token

string

必需

发票云租户授权token

reqid

string

必需

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

taxNo

string

授权对应的企业税号

必需

name

string

可选

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

Body 参数application/json

account

string

可选

数电模式，电子税局账号

request_path

string

必需

/fpdk/queryInvoice

serialNo

string

必需

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

dataFromIndex

number

必需

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

dataIndex

number

必需

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

continueFlag

boolean

必需

循环标志，默认循环获取

taxNo

string

企业税号

必需

searchOpt

object

必需

invoiceCode

string

发票代码

可选

invoiceNo

string

发票号码

可选

salerTaxNo

string

销方税号

可选

authenticateFlags

string

可选

勾选、认证标志，勾选认证状态空为查询全部，支持多个逗号分隔的字符串，如0,1,2,3对应表示未勾选、已勾选的发票、勾选认证、扫描认证

invoiceStatus

string

可选

发票状态， 0:正常 1:失控 2:作废 3:红冲（税控平台红冲的值，数电平台查询请使用，7或者8） 4:异常，7: 部分红冲，8：全额红冲

invoiceType

string

发票类型

可选

startTime

string

必需

开票开始日期，格式：2023-09-01

endTime

string

必需

开票结束日期，格式：2023-09-01

示例

{
    "account": "string",
    "request_path": "string",
    "serialNo": "string",
    "dataFromIndex": 0,
    "dataIndex": 0,
    "continueFlag": true,
    "taxNo": "string",
    "searchOpt": {
        "invoiceCode": "string",
        "invoiceNo": "string",
        "salerTaxNo": "string",
        "authenticateFlags": "string",
        "invoiceStatus": "string",
        "invoiceType": "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=&reqid=&taxNo=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account": "string",
    "request_path": "string",
    "serialNo": "string",
    "dataFromIndex": 0,
    "dataIndex": 0,
    "continueFlag": true,
    "taxNo": "string",
    "searchOpt": {
        "invoiceCode": "string",
        "invoiceNo": "string",
        "salerTaxNo": "string",
        "authenticateFlags": "string",
        "invoiceStatus": "string",
        "invoiceType": "string",
        "startTime": "string",
        "endTime": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

traceId

string

必需

traceId用于排查异常

errcode

string

必需

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

description

string

错误描述

必需

totalNum

number

发票采集的总数

必需

nextDataFromIndex

number

必需

该批次下一个dataFromIndex

nextDataIndex

number

必需

该批次下一个dataIndex

serialNo

string

必需

批次号，循环再次获取时传入

endFlag

boolean

该批次结束标志

必需

data

array [object {23}]

必需

invoiceType

number

发票类型

可选

invoiceCode

string

发票代码

可选

etaxInvoiceNo

string

数电纸票数电号码

可选

invoiceNo

string

发票号码

可选

invoiceDate

string

发票开票日期

可选

salerName

string

销方名称

可选

salerTaxNo

string

销方税号

可选

invoiceAmount

string

不含税金额

可选

totalTaxAmount

string

总税额

可选

invoiceStatus

string

发票状态

可选

deductionPurpose

string

抵扣用途

可选

effectiveTaxAmount

string

有效税额

可选

checkFlag

string

勾选标志

可选

selectTime

string

可选

勾选时间:，格式如：2019-09-30 11:31:29

checkAuthenticateFlag

string

勾选认证状态

可选

selectAuthenticateTime

string

可选

勾选认证时间，格式如2019-09-30 11:31:29

scanAuthenticateFlag

string

扫描认证状态

可选

scanAuthenticateTime

string

可选

扫描认证时间，格式如2019-09-30 11:31:29

manageStatus

string

管理状态

可选

taxPeriod

string

可选

税期：格式202310

buyerTaxNo

string

购方税号

可选

invoiceRiskLevel

string

发票风险等级

可选

invoiceSource

string

发票来源

可选

示例

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