4.1.04.数电票发票单张查询 - 发票云(旗舰版)API文档

请求参数

Query 参数

access_token

string

必需

{access_token}

Body 参数application/json

requestId

string

必需

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

businessSystemCode

string

必需

对接业务系统来源编码，用于区分不同业务系统的回调接口

interfaceCode

enum<string>

接口编码

必需

枚举值:

ALLE.INVOICE.QUERY

data

object

必需

需要把data里面的object进行加密成字符串

serialNo

string

可选

开红、蓝票时传入的流水号。与发票号码不能同时为空

invoiceNum

string

可选

发票号码。与流水号不能同时为空，请注意：5.0.027版本支持

sellerTaxpayerId

string

销售方纳税人识别号

必需

示例

{
  "requestId": "string",
  "businessSystemCode": "string",
  "interfaceCode": "ALLE.INVOICE.QUERY",
  "data": {
    "serialNo": "string",
    "invoiceNum": "string",
    "sellerTaxpayerId": "string"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

success

boolean

必需

true或false

errorCode

string

"0"为成功

必需

message

string

错误描述

必需

data

object

返回内容，需要解密

必需

batch

string

批次号

可选

<= 50 字符

orderNo

string

必需

发票流水号【长度30】

<= 30 字符

serialNo

string

必需

单据编号【长度30】

<= 30 字符

buyerType

string

必需

数据来源，0-单张,1-批量导入,2-数据同步,3-直接开票接口,4-单据拆合,5-作废重开,6-空白作废,7-扫码开票,8-excel导入,9-进项下载,10-公有云同步,11-手工新增红字信息表编号,12-小票码开票

buyerTaxpayerId

string

购买方税号

可选

<= 20 字符

buyerName

string

必需

购买方名称，GBK编码100个字节【长度：100】

<= 100 字符

buyerBank

string

购买方银行

可选

<= 200 字符

buyerBankAccount

string

购买方银行账号

可选

<= 50 字符

buyerAddress

string

购买方地址

可选

<= 200 字符

buyerTel

string

购买方电话

可选

<= 50 字符

buyerProperty

number

必需

购买方性质，0-企业，1-个人【长度：1】

buyerRecipientMail

string

必需

电子发票交付邮箱【长度：100】

buyerRecipientPhone

string

必需

电子发票交付手机号，接收短信【长度：50】

deduction

number

必需

差额【长度：(14,2)】

drawer

string

必需

开票人【长度：10】

payee

string

可选

收款人【长度：30】

reviewer

string

可选

复核人【长度：30】

invoiceType

string

必需

发票种类， 01-数字化电子专票，02-数字化电子普票

includeTaxAmount

number

价税合计

必需

totalAmount

number

合计金额

必需

totalTaxAmount

number

合计税额

必需

invoiceNum

string

发票号码

必需

<= 50 字符

specialType

string

可选

特殊票种，00-非特殊票种 02-收购,06-抵扣通行费,07-不抵扣通行费,08-成品油,11-卷烟,18-机动车,E03-建筑服务发票,E04-货物运输,E05-不动产销售服务发票,E06-不动产经营租赁服务,E01-成品油（数电票）,E18卷烟（数电票）

invoiceFileUrl

string

PDF文件URL

可选

<= 200 字符

xmlFileUrl

string

XML文件URL

可选

<= 200 字符

ofdFileUrl

string

OFD文件URL

可选

<= 200 字符

invoiceImageUrl

string

发票快照URL

可选

<= 200 字符

invoiceDate

string

开票日期

必需

invoiceProperty

number

必需

开票类型，0蓝票，1红票【长度：1】

originalInvoiceNumber

string

可选

原蓝票号码，开红票必传【长度：8】

redInfoBillNo

string

红字确认单编号

可选

<= 50 字符

govRedConfirmBillUuid

string

必需

数电票红字确认单税局uuid

<= 50 字符

remark

string

可选

备注，GBK编码230字节【长度：230】

sellerName

string

必需

销售方名称，GBK编码100个字节，未传入时使用销售方纳税人识别号匹配系统维护的名称【长度：100】

<= 100 字符

sellerTaxpayerId

string

必需

销售方纳税人识别号【长度：20】

sellerAddress

string

销售方地址

可选

<= 200 字符

sellerTel

string

销售方电话

可选

<= 50 字符

sellerBank

string

销售方银行

可选

<= 200 字符

sellerBankAccount

string

销售方银行账号

可选

<= 50 字符

invoiceStatus

enum<string>

必需

发票状态，0正常,2开票中,3红冲,4开票失败

枚举值:

0123467

redReason

string

红冲原因

必需

<= 200 字符

issueErrorMessage

string

开票失败原因

必需

systemSource

string

业务系统来源

可选

<= 50 字符

agentUser

string

必需

（数电票）经办人名称

<= 50 字符

agentCardType

string

必需

（数电票）经办人证件类型

agentCardNo

string

必需

（数电票）经办人证件号码

<= 30 字符

agentCountry

string

必需

（数电票）经办人国籍(地区)

agentTaxNo

string

必需

（数电票）经办人自然人纳税人识别号

<= 30 字符

naturalPersonFlag

string

必需

自然人标识，Y-是，N-否；默认根据购方纳税人识别号取反，有值时为N，无值时为Y

vatTaxRefundType

enum<string>

必需

增值税即征即退类型，空：非增值税即征即退

枚举值:

010203040506070809101112

invoiceDetail

array [object {14}]

发票明细

必需

cardType

string

可选

证件类型,103-税务登记证,201-居民身份证,208-外国护照,210-港澳居民来往内地通行证,213-台湾居民来往大陆通行证,215-外国人居留证,219-香港永久性居民身份证,220-台湾身份证,221-澳门特别行政区永久性居民身份证,233-外国人永久居留身份证（外国人永久居留证）,299-其他个人证件,

account

string

电子税局账号

可选

<= 20 字符

estateLeaseInfo

object (不动产租赁)

必需

不动产经营租赁服务信息，特定业务类型为06时必填

estateSaleInfo

object (不动产销售)

必需

不动产销售服务信息，特定业务类型为05时必填

buildInfo

object (建筑服务)

必需

建筑服务信息，特定业务类型为03时必填

示例

{
  "errorCode": "0",
  "success": true,
  "errorMsg": "",
  "data": {
    "batch": "",
    "orderNo": "3ZUAOD4LKWG90BQG9O1L",
    "buyerType": 2,
    "systemSource": "",
    "serialNo": "300_20240311134422540_0001",
    "invoiceType": "02",
    "sellerTaxpayerId": "91440300MA5G9GK78Y",
    "sellerName": "金蝶票据云科技（深圳）有限公司",
    "sellerAddress": "",
    "sellerTel": "",
    "sellerBank": "",
    "sellerBankAccount": "",
    "buyerTaxpayerId": "91440300358768292H",
    "buyerName": "深圳金蝶账无忧网络科技有限公司",
    "buyerAddress": "",
    "buyerTel": "",
    "buyerBank": "",
    "buyerBankAccount": "",
    "originalInvoiceNumber": "",
    "invoiceProperty": 0,
    "buyerProperty": 0,
    "buyerRecipientPhone": "",
    "buyerRecipientMail": "",
    "remark": "",
    "deduction": 0,
    "drawer": "",
    "payee": "",
    "reviewer": "",
    "redInfoBillNo": "",
    "includeTaxAmount": 9.54,
    "totalAmount": 9,
    "totalTaxAmount": 0.54,
    "invoiceDate": "2024-03-11 12:06:51",
    "invoiceNum": "24952000000028787793",
    "specialType": "",
    "invoiceStatus": "0",
    "redReason": "",
    "issueErrorMessage": "",
    "invoiceFileUrl": "",
    "invoiceImageUrl": "",
    "ofdFileUrl": "https://api-sit.piaozone.com/doc/free/fileInfo/preview/f1217432316435607552324890169",
    "xmlFileUrl": "https://api-sit.piaozone.com/test/rpa/free/preview/5368720388/91440300MA5G9GK78Y/3ZUAOD4LKWG90BQG9O1L?type=3",
    "invoiceDetail": [
      {
        "seq": 0,
        "billSourceId": "",
        "goodsCode": "",
        "revenueName": "",
        "revenueCode": "3040201010000000000",
        "goodsName": "*信息技术服务*纸电一体开收票",
        "specification": "",
        "units": "件",
        "quantity": "1.0000000000000",
        "price": "2.0000000000000",
        "taxUnitPrice": 0,
        "amount": 2,
        "includeTaxAmount": 2.12,
        "taxRate": "0.06",
        "taxAmount": 0.12,
        "discountAmount": 0,
        "discountRate": "",
        "privilegeType": "",
        "lineProperty": 0
      },
      {
        "seq": 1,
        "billSourceId": "",
        "goodsCode": "",
        "revenueName": "",
        "revenueCode": "3040201010000000000",
        "goodsName": "*信息技术服务*纸电一体开收票",
        "specification": "",
        "units": "件",
        "quantity": "1.0000000000000",
        "price": "3.0000000000000",
        "taxUnitPrice": 0,
        "amount": 3,
        "includeTaxAmount": 3.18,
        "taxRate": "0.06",
        "taxAmount": 0.18,
        "discountAmount": 0,
        "discountRate": "",
        "privilegeType": "",
        "lineProperty": 0
      },
      {
        "seq": 2,
        "billSourceId": "",
        "goodsCode": "",
        "revenueName": "",
        "revenueCode": "3040201010000000000",
        "goodsName": "*信息技术服务*纸电一体开收票",
        "specification": "",
        "units": "件",
        "quantity": "1.0000000000000",
        "price": "4.0000000000000",
        "taxUnitPrice": 0,
        "amount": 4,
        "includeTaxAmount": 4.24,
        "taxRate": "0.06",
        "taxAmount": 0.24,
        "discountAmount": 0,
        "discountRate": "",
        "privilegeType": "",
        "lineProperty": 0
      }
    ],
    "cardType": "",
    "account": ""
  }
}