查询异步开票结果-v4

开发中

GET/invoice/query

:::caution
本接口只支持v4版本的调用，详情请参考：开发指南的版本说明一节

开发中请勿对接

:::
环境url要选择：

该接口返回的是异步开票的结果的错误码中

1304 代表的是：异步开票中
除1304外，其他错误码都代表本次异步开票结束
如果不是0000，又需要重试，需要重新发起请求

请求参数

Query 参数

access_token

string

授权token

必需

reqid

string

必需

当前13位毫秒级时间戳加3位随机数字(总共16位)

示例值:

1624601109096123

taxNo

string

授权对应的企业税号

必需

fpdk_type

string

星瀚传4，其它传3

必需

示例值:

serialNo

string

流水号

必需

Header 参数

Content-Type

string

必需

示例值:

application/json

object {0}

{}

示例代码

返回响应

成功(200)

失败(401)

HTTP 状态码: 200

内容格式: JSONapplication/json

traceId

string

必需

链路跟踪id，可根据这个排查问题

data

object

必需

invoiceCode

string

必需

数电票该字段为空字符串，数电纸质发票时返回12位发票号码

invoiceNo

string

必需

数电发票时返回20位数电号码，数电纸质发票时返回8为纸质发票号码

etaxInvoiceNo

string

20位数电发票号码

必需

invoiceDate

string

必需

开票日期精确到秒，格式如：2023-08-17 16:40:50

xmlUrl

string

可选

xml下载地址，没有下载成功返回空字符串，数电纸质发票返回为空字符串

ofdUrl

string

可选

ofd下载地址，没有下载成功返回空字符串，数电纸质发票返回为空字符串

pdfUrl

string

可选

pdf下载地址，没有下载成功返回空字符串，数电纸质发票返回生成的pdf地址

snapshotUrl

string

快照地址

可选

govSerialNo

string

税局开票流水号

必需

serialNo

string

发票云开票流水号

必需

availableVolume

string

可用授信额度

可选

totalVolume

string

总授信额度

可选

redConfirmBillStatus

string

可选

红字确认单状态：开具红票时，如果因为红字确认单状态不允许开票时返回，对应的errcode为91401

drawer

string

开票人

必需

{
  "errcode": "0000",
  "description": "操作成功[f3f435-e0c02046ebc05d-wevx11]",
  "data": {
    "invoiceCode": "",
    "invoiceNo": "23442000000166283262",
    "invoiceDate": "2023-08-17 16:40:50",
    "govSerialNo": "697a591f-23dc-4ff8-ae9c-70d1edbb2917",
    "serialNo": "3HDZZSTVALPUGS9Z1P7Y",
    "drawer": "",
    "ofdUrl": "https://api.piaozone.com/rpa/free/preview/366808209278528000/91440101618428412/3HDZZSTVALPUGS9Z1P7Y?type=1",
    "pdfUrl": "https://api.piaozone.com/rpa/free/preview/366808209278528000/91440101618428412/3HDZZSTVALPUGS9Z1P7Y?type=0",
    "xmlUrl": "https://api.piaozone.com/rpa/free/preview/366808209278528000/91440101618428412/3HDZZSTVALPUGS9Z1P7Y?type=3",
    "snapshotUrl": "https://api.piaozone.com/rpa/free/preview/366808209278528000/91440101618428412/3HDZZSTVALPUGS9Z1P7Y?type=2",
    "availableVolume": "28285532001.75",
    "totalVolume": "28300000000.00"
  },
  "traceId": "e0c02046ebc05d-wevx11"
}

最后修改时间： 1 个月前