# 4.1.04.数电票发票单张查询 ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kapi/app/sim/openApi: post: summary: 4.1.04.数电票发票单张查询 deprecated: false description: '' tags: - 开票/发票查询接口 parameters: - name: access_token in: query description: '{access_token}' required: true example: '' schema: type: string - name: access_token in: header description: '' example: '{{access_token}}' schema: type: string default: '{{access_token}}' requestBody: content: application/json: schema: type: object description: '' properties: requestId: type: string description: 当前13位毫秒级时间戳加3位随机数字(总共16位) businessSystemCode: type: string description: 对接业务系统来源编码，用于区分不同业务系统的回调接口 interfaceCode: type: string description: 接口编码 const: ALLE.INVOICE.QUERY data: type: object description: 需要把data里面的object进行加密成字符串 properties: serialNo: type: string description: 开红、蓝票时传入的流水号 。与发票号码不能同时为空 invoiceNum: type: string description: 发票号码。与流水号不能同时为空， 请注意：5.0.027版本支持 sellerTaxpayerId: type: string description: 销售方纳税人识别号 required: - sellerTaxpayerId x-apifox-orders: - serialNo - invoiceNum - sellerTaxpayerId x-apifox-ignore-properties: [] required: - requestId - businessSystemCode - interfaceCode - data x-apifox-orders: - requestId - businessSystemCode - interfaceCode - data x-apifox-ignore-properties: [] examples: {} responses: '200': description: '' content: application/json: schema: type: object description: '' properties: success: type: boolean description: true或false errorCode: type: string description: '"0"为成功' message: type: string description: 错误描述 data: type: object description: 返回内容，需要解密 properties: batch: type: string description: 批次号 maxLength: 50 orderNo: type: string description: 发票流水号【长度30】 maxLength: 30 serialNo: type: string description: 单据编号【长度30】 maxLength: 30 buyerType: type: string description: >- 数据来源，0-单张,1-批量导入,2-数据同步,3-直接开票接口,4-单据拆合,5-作废重开,6-空白作废,7-扫码开票,8-excel导入,9-进项下载,10-公有云同步,11-手工新增红字信息表编号,12-小票码开票 buyerTaxpayerId: type: string description: 购买方税号 maxLength: 20 buyerName: type: string description: 购买方名称，GBK编码100个字节【长度：100】 maxLength: 100 buyerBank: type: string description: 购买方银行 maxLength: 200 buyerBankAccount: type: string description: 购买方银行账号 maxLength: 50 buyerAddress: type: string description: 购买方地址 maxLength: 200 buyerTel: type: string description: 购买方电话 maxLength: 50 buyerProperty: type: number description: 购买方性质，0-企业，1-个人【长度：1】 buyerRecipientMail: type: string description: 电子发票交付邮箱【长度：100】 buyerRecipientPhone: type: string description: 电子发票交付手机号，接收短信【长度：50】 deduction: type: number description: 差额【长度：(14,2)】 drawer: type: string description: 开票人【长度：10】 payee: type: string description: 收款人【长度：30】 reviewer: type: string description: 复核人【长度：30】 invoiceType: type: string description: 发票种类， 01-数字化电子专票，02-数字化电子普票 includeTaxAmount: type: number description: 价税合计 totalAmount: type: number description: 合计金额 totalTaxAmount: type: number description: 合计税额 invoiceNum: type: string description: 发票号码 maxLength: 50 specialType: type: string description: "特殊票种，00-非特殊票种 02-收购,06-抵扣通行费,07-不抵扣通行费,08-成品油,11-卷烟,18-机动车,E03-建筑服务发票,E04-货物运输,E05-不动产销售服务发票,E06-不动产经营租赁服务,E01-成品油（数电票）,E18卷烟（数电票）\t" invoiceFileUrl: type: string description: PDF文件URL maxLength: 200 xmlFileUrl: type: string description: XML文件URL maxLength: 200 ofdFileUrl: type: string description: OFD文件URL maxLength: 200 invoiceImageUrl: type: string description: 发票快照URL maxLength: 200 invoiceDate: type: string description: 开票日期 invoiceProperty: type: number description: 开票类型，0蓝票，1红票【长度：1】 originalInvoiceNumber: type: string description: 原蓝票号码，开红票必传【长度：8】 redInfoBillNo: type: string description: 红字确认单编号 maxLength: 50 govRedConfirmBillUuid: type: string description: 数电票红字确认单税局uuid maxLength: 50 remark: type: string description: 备注，GBK编码230字节【长度：230】 sellerName: type: string description: 销售方名称，GBK编码100个字节，未传入时使用销售方纳税人识别号匹配系统维护的名称【长度：100】 maxLength: 100 sellerTaxpayerId: type: string description: 销售方纳税人识别号【长度：20】 sellerAddress: type: string description: 销售方地址 maxLength: 200 sellerTel: type: string description: 销售方电话 maxLength: 50 sellerBank: type: string description: 销售方银行 maxLength: 200 sellerBankAccount: type: string description: 销售方银行账号 maxLength: 50 invoiceStatus: type: string description: 发票状态，0正常,2开票中,3红冲,4开票失败 redReason: type: string description: 红冲原因 maxLength: 200 issueErrorMessage: type: string description: 开票失败原因 systemSource: type: string description: 业务系统来源 maxLength: 50 agentUser: type: string description: （数电票）经办人名称 maxLength: 50 agentCardType: type: string description: （数电票）经办人证件类型 agentCardNo: type: string description: （数电票）经办人证件号码 maxLength: 30 agentCountry: type: string description: （数电票）经办人国籍(地区) agentTaxNo: type: string description: （数电票）经办人自然人纳税人识别号 maxLength: 30 naturalPersonFlag: type: string description: 自然人标识，Y-是，N-否；默认根据购方纳税人识别号取反，有值时为N，无值时为Y vatTaxRefundType: $ref: >- #/components/schemas/%E5%8D%B3%E5%BE%81%E5%8D%B3%E9%80%80%E7%B1%BB%E5%9E%8B description: 增值税即征即退类型，空：非增值税即征即退 invoiceDetail: type: array description: 发票明细 items: type: object properties: amount: type: number description: 金额【长度：(14,2)】 detailRowNo: type: number description: 发票明细行序号，从1开始 taxAmount: type: number description: 税额，若传入则校验误差[不含税金额*税率-税额≤±0.06]；【长度：(14,2)】 billSourceId: type: string description: 对应业务系统明细ID【长度：32】 goodsName: type: string description: 商品名称 lineProperty: type: number description: >- 行性质，0正常商品行[无折扣行项目]，1折扣行，2被折扣行[带有折扣的商品行，此商品行下一行是此商品的折扣行]【长度：2】 price: type: string description: 单价 privilegeType: description: >- 优惠政策标识，01：简易征收02：稀土产品03：免税04：不征税05：先征后退06：100%先征后退07：50%先征后 退08：按3%简易征收09：按5%简易征收10：按5%简易征收减按1.5%计征11：即征即退30% 12：即征即退50% 13：即征即退70% 14：即征即退100% 15：超税负3%即征即退16：超税负8%即征即退17 ：超税负12%即征即退18：超税负6%即征即退 $ref: >- #/components/schemas/%E4%BC%98%E6%83%A0%E6%94%BF%E7%AD%96%E6%A0%87%E8%AF%86 quantity: type: string description: >- 数量,金额不为空时，数量、单价可都为空，或通过另外一个换算得出；金额为空时，数量、单价都必填；【长度：20】 revenueCode: type: string description: 税收分类编码【长度：19】 revenueName: type: string description: 税收商品大类名称 specification: type: string description: 规格型号，GBK编码不超过40字节【长度：90】 taxRate: type: string description: >- 税率，支持小数位[0.01]、百分比[1%]、直接数值[1]三种传入格式,小数位最多3位【长度：5】 units: type: string description: 计量单位 x-apifox-orders: - amount - detailRowNo - taxAmount - billSourceId - goodsName - lineProperty - price - privilegeType - quantity - revenueCode - revenueName - specification - taxRate - units required: - detailRowNo x-apifox-ignore-properties: [] cardType: type: string description: >- 证件类型,103-税务登记证,201-居民身份证,208-外国护照,210-港澳居民来往内地通行证,213-台湾居民来往大陆通行证,215-外国人居留证,219-香港永久性居民身份证,220-台湾身份证,221-澳门特别行政区永久性居民身份证,233-外国人永久居留身份证（外国人永久居留证）,299-其他个人证件, account: type: string description: 电子税局账号 maxLength: 20 estateLeaseInfo: description: 不动产经营租赁服务信息，特定业务类型为06时必填 $ref: >- #/components/schemas/%E4%B8%8D%E5%8A%A8%E4%BA%A7%E7%A7%9F%E8%B5%81 estateSaleInfo: description: 不动产销售服务信息，特定业务类型为05时必填 $ref: >- #/components/schemas/%E4%B8%8D%E5%8A%A8%E4%BA%A7%E9%94%80%E5%94%AE buildInfo: description: 建筑服务信息，特定业务类型为03时必填 $ref: >- #/components/schemas/%E5%BB%BA%E7%AD%91%E6%9C%8D%E5%8A%A1 required: - orderNo - serialNo - buyerType - buyerName - buyerProperty - buyerRecipientMail - buyerRecipientPhone - deduction - drawer - invoiceType - includeTaxAmount - totalAmount - totalTaxAmount - invoiceNum - invoiceDate - invoiceProperty - govRedConfirmBillUuid - sellerName - sellerTaxpayerId - invoiceStatus - redReason - issueErrorMessage - agentUser - agentCardType - agentCardNo - agentCountry - agentTaxNo - naturalPersonFlag - vatTaxRefundType - invoiceDetail - estateLeaseInfo - estateSaleInfo - buildInfo x-apifox-orders: - batch - orderNo - serialNo - buyerType - buyerTaxpayerId - buyerName - buyerBank - buyerBankAccount - buyerAddress - buyerTel - buyerProperty - buyerRecipientMail - buyerRecipientPhone - deduction - drawer - payee - reviewer - invoiceType - includeTaxAmount - totalAmount - totalTaxAmount - invoiceNum - specialType - invoiceFileUrl - xmlFileUrl - ofdFileUrl - invoiceImageUrl - invoiceDate - invoiceProperty - originalInvoiceNumber - redInfoBillNo - govRedConfirmBillUuid - remark - sellerName - sellerTaxpayerId - sellerAddress - sellerTel - sellerBank - sellerBankAccount - invoiceStatus - redReason - issueErrorMessage - systemSource - agentUser - agentCardType - agentCardNo - agentCountry - agentTaxNo - naturalPersonFlag - vatTaxRefundType - invoiceDetail - cardType - account - estateLeaseInfo - estateSaleInfo - buildInfo x-apifox-ignore-properties: [] required: - success - errorCode - message - data x-apifox-orders: - 01HSSQEV8BB7YCWSKTZ22GGFCP - data x-apifox-refs: 01HSSQEV8BB7YCWSKTZ22GGFCP: $ref: >- #/components/schemas/%E8%8B%8D%E7%A9%B9API%E6%8E%A5%E5%8F%A3%E8%BF%94%E5%9B%9E%E5%80%BC x-apifox-ignore-properties: - success - errorCode - message example: 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: '' headers: {} x-apifox-name: 成功 security: [] x-apifox-folder: 开票/发票查询接口 x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/3905935/apis/api-146003726-run components: schemas: 建筑服务: type: object description: 建筑服务必填，发票云版本5.0.017支持 properties: simpleAddress: type: string description: 建筑服务发生地 detailAddress: type: string description: 具体地址 crossCitySign: type: string description: 跨地（市）标志 enum: - '0' - '1' default: '0' x-apifox-enum: - name: '' value: '0' description: 否 - name: '' value: '1' description: 是 buildingName: type: string description: 建筑项目名称 landTaxNo: type: string description: 土地增值税项目编号 maxLength: 20 specialIndustryNumber: type: string description: 不动产基础资料编码：其他参数为空时，自动根据该编号对应的基础资料补全剩余参数 crossCityTaxVerifyNo: type: string description: 跨区域涉税事项报验管理编号，当跨地市标志为是时必填 maxLength: 100 required: - simpleAddress - detailAddress - buildingName x-apifox-orders: - simpleAddress - detailAddress - crossCitySign - buildingName - landTaxNo - specialIndustryNumber - crossCityTaxVerifyNo x-apifox-ignore-properties: [] x-apifox-folder: '' 不动产销售: type: object description: 不动产销售必填，发票云版本5.0.020支持 properties: estateCode: type: string description: 不动产单元代码/网签合同备案编号 maxLength: 28 provinceAdress: type: string description: 省份 cityAdreess: type: string description: 城市 simpleAddress: type: string description: 不动产地址 ，不动产地址+不动产详细地址总长度限制为120 detailAddress: type: string description: 不动产详细地址，不动产地址+不动产详细地址总长度限制为120 crossCitySign: type: string description: 跨地（市）标志 enum: - '0' - '1' default: '0' x-apifox-enum: - name: '' value: '0' description: 否 - name: '' value: '1' description: 是 landTaxNo: type: string description: 土地增值税项目编号 maxLength: 20 approvedPrice: type: string description: 核定计税价格 actualTurnover: type: string description: 实际成交含税金额：按核定计税价格征税的，必填 areaunit: type: string description: 面积单位 enum: - 平方千米 - 平方米 - 公顷 - 亩 - h㎡ - k㎡ - ㎡ default: 平方千米 x-apifox-enum: - name: '' value: 平方千米 description: 平方千米 - name: '' value: 平方米 description: 平方米 - name: '' value: 公顷 description: 公顷 - name: '' value: 亩 description: 亩 - name: '' value: h㎡ description: h㎡ - name: '' value: k㎡ description: k㎡ - name: '' value: ㎡ description: ㎡ estateId: type: string description: 房屋产权证书/不动产权证号 maxLength: 40 specialIndustryNumber: type: string description: 不动产基础资料编码：其他参数为空时，自动根据该编号对应的基础资料补全剩余参数 required: - provinceAdress - cityAdreess - simpleAddress - detailAddress - crossCitySign - areaunit x-apifox-orders: - estateCode - provinceAdress - cityAdreess - simpleAddress - detailAddress - crossCitySign - landTaxNo - approvedPrice - actualTurnover - areaunit - estateId - specialIndustryNumber x-apifox-ignore-properties: [] x-apifox-folder: '' 不动产租赁: type: object description: 不动产租赁必填，发票云版本5.0.017支持 properties: provinceAdress: type: string description: 省份 cityAdreess: type: string description: 城市 simpleAddress: type: string description: 不动产地址 ；不动产地址+不动产详细地址总长度限制为120 detailAddress: type: string description: 不动产详细地址；不动产地址+不动产详细地址总长度限制为120 crossCitySign: type: string description: 跨地（市）标志 enum: - '0' - '1' default: '0' x-apifox-enum: - name: '' value: '0' description: 否 - name: '' value: '1' description: 是 areaunit: type: string description: 面积单位 enum: - 平方千米 - 平方米 - 公顷 - 亩 - h㎡ - k㎡ - ㎡ default: 平方千米 x-apifox-enum: - name: '' value: 平方千米 description: 平方千米 - name: '' value: 平方米 description: 平方米 - name: '' value: 公顷 description: 公顷 - name: '' value: 亩 description: 亩 - name: '' value: h㎡ description: h㎡ - name: '' value: k㎡ description: k㎡ - name: '' value: ㎡ description: ㎡ startLeaseDate: type: string description: 租赁开始日期 格式为yyyy-MM-dd format: date endLeaseDate: type: string description: 租赁结束日期 格式为yyyy-MM-dd format: date estateId: type: string description: 房屋产权证书/不动产权证号 specialIndustryNumber: type: string description: 不动产基础资料编码：其他（除日期）参数为空时，自动根据该编号对应的基础资料补全剩余参数 carBrandNo: type: string description: 车牌号 required: - provinceAdress - cityAdreess - detailAddress - areaunit - startLeaseDate - endLeaseDate - estateId x-apifox-orders: - provinceAdress - cityAdreess - simpleAddress - detailAddress - crossCitySign - areaunit - startLeaseDate - endLeaseDate - estateId - specialIndustryNumber - carBrandNo x-apifox-ignore-properties: [] x-apifox-folder: '' 优惠政策标识: type: string description: 优惠政策标识 enum: - '01' - '02' - '03' - '04' - '05' - '06' - '07' - '08' - '09' - '10' - '11' - '12' - '13' - '14' - '15' - '16' - '17' - '18' x-apifox-enum: - value: '01' name: '' description: 简易征收 - value: '02' name: '' description: 稀土产品 - value: '03' name: '' description: 免税 - value: '04' name: '' description: 不征税 - value: '05' name: '' description: 先征后退 - value: '06' name: '' description: 100%先征后退 - value: '07' name: '' description: 50%先征后退 - value: '08' name: '' description: 按3%简易征收 - value: '09' name: '' description: 按5%简易征收 - value: '10' name: '' description: 按5%简易征收减按1.5%计征 - value: '11' name: '' description: 即征即退30% - value: '12' name: '' description: 即征即退50% - value: '13' name: '' description: 即征即退70% - value: '14' name: '' description: 即征即退100% - value: '15' name: '' description: 超税负3%即征即退 - value: '16' name: '' description: 超税负8%即征即退 - value: '17' name: '' description: 超税负12%即征即退 - value: '18' name: '' description: 超税负6%即征即退 x-apifox-folder: '' 即征即退类型: type: string description: >- 即征即退类型 “有效增值税即征即退备案信息纳税人”在发票开具时若选择的商编在商编表中“即征即退”列非空且该条明细属于增值税即征即退收入时，为必填项 enum: - '01' - '02' - '03' - '04' - '05' - '06' - '07' - '08' - '09' - '10' - '11' - '12' x-apifox-enum: - value: '01' name: '' description: 增值税即征即退-软件产品 - value: '02' name: '' description: 增值税即征即退-资源综合利用产品 - value: '03' name: '' description: 增值税即征即退-管道运输服务 - value: '04' name: '' description: 增值税即征即退-有形动产融资租赁服务 - value: '05' name: '' description: 增值税即征即退-有形动产融资性售后回租服务 - value: '06' name: '' description: 增值税即征即退-新型墙体材料 - value: '07' name: '' description: 增值税即征即退-风力发电产品 - value: '08' name: '' description: 增值税即征即退-光伏发电产品 - value: '09' name: '' description: 增值税即征即退-动漫软件产品 - value: '10' name: '' description: 增值税即征即退-飞机维修劳务 - value: '11' name: '' description: 增值税即征即退-黄金 - value: '12' name: '' description: 增值税即征即退-铂金 x-apifox-folder: '' 苍穹API接口返回值: type: object description: '' properties: success: type: boolean description: true或false errorCode: type: string description: '"0"为成功' message: type: string description: 错误描述 data: type: object description: 请求结果 properties: {} x-apifox-orders: [] x-apifox-ignore-properties: [] required: - success - errorCode - message x-apifox-orders: - success - errorCode - message - data x-apifox-ignore-properties: [] x-apifox-folder: '' securitySchemes: {} servers: - url: https://cosmic-demo.piaozone.com/demo description: 测试环境 - url: https://cosmic-sandbox.piaozone.com/jdpjykjyxgs description: 快速开始环境 security: [] ```