4.1.04.数电票发票单张查询

POST/kapi/app/sim/openApi

请求参数

Query 参数

access_token

string

必需

{access_token}

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"
  }
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

success

boolean

必需

true或false

errorCode

string

"0"为成功

必需

message

string

错误描述

必需

data

object

返回内容，需要解密

必需

batch

string

批次号

可选

orderNo

string

必需

发票流水号【长度30】

serialNo

string

必需

单据编号【长度30】

buyerType

string

必需

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

buyerTaxpayerId

string

购买方税号

可选

buyerName

string

必需

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

buyerBank

string

购买方银行

可选

buyerBankAccount

string

购买方银行账号

可选

buyerAddress

string

购买方地址

可选

buyerTel

string

购买方电话

可选

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

发票号码

必需

specialType

string

可选

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

invoiceFileUrl

string

PDF文件URL

可选

xmlFileUrl

string

XML文件URL

可选

ofdFileUrl

string

OFD文件URL

可选

invoiceImageUrl

string

发票快照URL

可选

invoiceDate

string

开票日期

必需

invoiceProperty

number

必需

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

originalInvoiceNumber

string

可选

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

redInfoBillNo

string

红字确认单编号

可选

govRedConfirmBillUuid

string

必需

数电票红字确认单税局uuid

remark

string

可选

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

sellerName

string

必需

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

sellerTaxpayerId

string

必需

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

sellerAddress

string

销售方地址

可选

sellerTel

string

销售方电话

可选

sellerBank

string

销售方银行

可选

sellerBankAccount

string

销售方银行账号

可选

invoiceStatus

string

必需

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

redReason

string

红冲原因

必需

issueErrorMessage

string

开票失败原因

必需

systemSource

string

业务系统来源

可选

agentUser

string

必需

（数电票）经办人名称

agentCardType

string

必需

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

agentCardNo

string

必需

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

agentCountry

string

必需

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

agentTaxNo

string

必需

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

naturalPersonFlag

string

必需

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

vatTaxRefundType

enum<string>

必需

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

枚举值:

010203040506070809101112

invoiceDetail

array [object {13}]

发票明细

必需

cardType

string

可选

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

account

string

电子税局账号

可选

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": ""
  }
}

最后修改时间： 9 个月前