# 4.1.01已开发票查询 ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kapi/app/sim/openApi: post: summary: 4.1.01已开发票查询 deprecated: false description: > 税控票或税控票+数电票共用时使用；纯数电票开票（比如直接开票-数电开票）请用4.1.04或4.1.03接口。 ### FAQ | 序号 | 问 | 答 | | --- | --- | --- | | 1 | [4.1.01已开发票查询](https://open-ultimate.piaozone.com/api-146003723.md)，蓝票开票成功，它的发票明细的剩余可红冲不含税金额，剩余可红冲数量，剩余可红冲税额，可红冲不含税单价等4个字段都有值了吗？ | 是的，开完蓝票就会写这几个值| | 2 | [4.1.01已开发票查询](https://open-ultimate.piaozone.com/api-146003723.md)，发票明细的detailId，是我们调用蓝字发票开具接口或红冲接口，发票明细billSourceId参数传的值吗？|不是，已开发票查询接口的billSourceId，对应开蓝票接口的billSourceId| tags: - 开票/发票查询接口 parameters: - 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 title: 时间戳（毫秒级） x-apifox-mock: '{{$date.millisecondsTimestamp}}' businessSystemCode: type: string title: 业务系统编码 description: |- 发票云-系统管理-业务系统中存在的业务系统编码 对接业务系统来源编码，用于区分不同业务系统的回调接口 examples: - FPY interfaceCode: type: string title: 接口编码 description: 固定值：INVOICE.QUERY examples: - INVOICE.QUERY data: type: object description: 需要把data里面的object加密成base64字符串 properties: serialNo: type: string description: 调用开票接口时传的serialno【长度：50】 maxLength: 50 title: 外部流水号 x-apifox-mock: '{{$string.uuid}}' sellerTaxpayerId: type: string title: 销售方纳税人识别号 description: 已开发票的销售方税号，必须是发票云-基础资料中已授权销项许可的税号 maxLength: 20 minLength: 15 examples: - 91440300XXXXXXXXXX invoiceDateS: type: string title: 开票日期起 description: |- 示例：YYYY-MM-DD invoiceDateS有值，则invoiceDateE必填【长度：10】 x-apifox-mock: '{{$date.anytime|format(''yyyy-MM-dd'')}}' maxLength: 10 format: date invoiceDateE: type: string title: 开票日期止 description: |- 示例：YYYY-MM-DD invoiceDateE有值，则invoiceDateS必填【长度：10】 x-apifox-mock: '{{$date.anytime|format(''yyyy-MM-dd'')}}' format: date invoiceCode: type: string description: 税控发票需传，数电发票不传【长度：12】 maxLength: 12 title: 发票代码 invoiceNumberS: type: string description: |- 如果仅查询一张发票，发票号码起、止传同一个发票号码 【税控发票长度：8，数电发票长度：20】 title: 发票号码起 invoiceNumberE: type: string description: |- 如果仅查询一张发票，发票号码起、止传同一个发票号码 【税控发票长度：8，数电发票长度：20】 title: 发票号码止 invoiceStatus: type: string enum: - '0' - '1' - '2' - '3' - '4' - '6' - '7' x-apifox-enum: - value: '0' name: 正常 description: '' - value: '1' name: 失控 description: '' - value: '2' name: 部分红冲 description: '' - value: '3' name: 红冲 description: '' - value: '4' name: 异常 description: '' - value: '6' name: 作废 description: '' - value: '7' name: 作废中 description: '' title: 发票状态 invoiceType: type: string enum: - 08xdp - 10xdp - '004' - '007' - '025' - '026' - '028' x-apifox-enum: - value: 08xdp name: 数电发票（增值税专用发票） description: '' - value: 10xdp name: 数电发票（普通发票） description: '' - value: '004' name: 增值税纸质专用发票 description: '' - value: '007' name: 增值税纸质普通发票 description: '' - value: '025' name: 卷票 description: '' - value: '026' name: 增值税电子普通发票 description: '' - value: '028' name: 增值税电子专用发票 description: '' title: 发票种类 pageNo: type: integer title: 页码 examples: - 0 multipleOf: 1 pageSize: type: integer title: 分页大小 description: '每页返回发票数量，最大300，超过则按最大300发票数量返回 ' required: - sellerTaxpayerId - pageNo - pageSize x-apifox-orders: - serialNo - sellerTaxpayerId - invoiceType - invoiceStatus - invoiceDateS - invoiceDateE - invoiceCode - invoiceNumberS - invoiceNumberE - pageNo - pageSize title: 数据体 required: - requestId - businessSystemCode - interfaceCode - data x-apifox-orders: - requestId - businessSystemCode - interfaceCode - data examples: '1': value: requestId: '1751546157921' businessSystemCode: FPY interfaceCode: INVOICE.QUERY data: serialNo: 023115ad-0bc6-40d4-8169-15f8e8bd7529 sellerTaxpayerId: 91440300XXXXXXXXXX invoiceType: '025' invoiceStatus: '2' invoiceDateS: '2026-01-11' invoiceDateE: '2024-11-13' invoiceCode: '30' invoiceNumberS: '93' invoiceNumberE: '6' pageNo: 0 pageSize: 68 summary: 请求参数示例（加密前） '2': value: requestId: '1751546157921' businessSystemCode: FPY interfaceCode: INVOICE.QUERY data: >- ewogICAgICAgICJzZXJpYWxObyI6ICIwMjMxMTVhZC0wYmM2LTQwZDQtODE2OS0xNWY4ZThiZDc1MjkiLAogICAgICAgICJzZWxsZXJUYXhwYXllcklkIjogIjkxNDQwMzAwWFhYWFhYWFhYWCIsCiAgICAgICAgImludm9pY2VUeXBlIjogIjAyNSIsCiAgICAgICAgImludm9pY2VTdGF0dXMiOiAiMiIsCiAgICAgICAgImludm9pY2VEYXRlUyI6ICIyMDI2LTAxLTExIiwKICAgICAgICAiaW52b2ljZURhdGVFIjogIjIwMjQtMTEtMTMiLAogICAgICAgICJpbnZvaWNlQ29kZSI6ICIzMCIsCiAgICAgICAgImludm9pY2VOdW1iZXJTIjogIjkzIiwKICAgICAgICAiaW52b2ljZU51bWJlckUiOiAiNiIsCiAgICAgICAgInBhZ2VObyI6IDAsCiAgICAgICAgInBhZ2VTaXplIjogNjgKICAgIH0= summary: 请求参数示例 （data数据体base64加密后） responses: '200': description: '' content: application/json: schema: type: object description: '' properties: data: type: array description: 请求成功返回内容，需要base64解密 items: type: object properties: abolishReason: type: string title: 作废原因 batch: type: string description: '' title: 开票批次号 buyerAddressAndTel: type: string title: 购买方地址和电话 maxLength: 100 buyerBankAndAccount: type: string title: 购买方银行和银行账号 maxLength: 100 buyerName: type: string title: 购买方名称 maxLength: 100 buyerProperty: type: integer title: 购买方性质 enum: - 0 - 1 - 3 x-apifox-enum: - value: 0 name: 企业 description: '' - value: 1 name: 个人 description: '' - value: 3 name: 非企业单位 description: '' buyerRecipientMail: type: string title: 电子发票交付邮箱 maxLength: 100 buyerRecipientPhone: type: string title: 电子发票交付手机号 maxLength: 50 buyerTaxpayerId: type: string title: 购方税号 maxLength: 20 buyerType: type: number title: 开票来源 enum: - 0 - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 x-apifox-enum: - value: 0 name: 单张 description: '' - value: 1 name: 批量导入 description: '' - value: 2 name: 数据同步 description: '' - value: 3 name: 直接开票接口 description: '' - value: 4 name: 单据拆合 description: '' - value: 5 name: 作废重开 description: '' - value: 6 name: 空白作废 description: '' - value: 7 name: 扫码开票 description: '' - value: 8 name: excel导入 description: '' - value: 9 name: 进项下载 description: '' - value: 10 name: 公有云同步 description: '' - value: 11 name: 手工新增红字信息表编号 description: '' - value: 12 name: 小票码开票 description: '' canceler: type: string title: 作废人 deduction: type: number title: 扣除额 description: 适用差额征税 maximum: 14 multipleOf: 1 deviceNo: type: string description: 适用于税控发票 title: 设备编号 drawer: type: string title: 开票人 includeTaxAmount: type: number title: 价税合计 includeTaxFlag: type: string title: 含税标识 enum: - '0' - '1' x-apifox-enum: - value: '0' name: 不含税 description: '' - value: '1' name: 含税 description: '' examples: - '0' inventoryMark: type: string title: 清单标志 enum: - '0' - '1' x-apifox-enum: - value: '0' name: 无清单 description: '' - value: '1' name: 有清单 description: '' invoiceCode: type: string title: 发票代码 invoiceNum: type: string title: 发票号码 invoiceFileUrl: type: string description: >- 数电票为OFD文件；航信百旺税盘开普通电票为PDF文件，开电子专票为OFD文件；ukey开电票为OFD文件。 title: 数电票版式文件下载地址 invoicePdfFileUrl: type: string description: 适用版本：发票云5.0.025及以后版本 title: 数电票pdf下载地址 invoiceXmlFileUrl: type: string description: 适用版本：发票云5.0.025及以后版本 title: 数电票xml下载地址 invoiceImageUrl: type: string title: 发票预览图片下载地址 invoiceDate: type: string title: 开票日期 examples: - '2021-06-24' format: date invoiceDetail: type: array items: type: object x-apifox-refs: {} properties: redPrice: type: number title: 可红冲单价 amount: type: number description: 根据含税标志判断是“含税金额”还是“不含税金额” title: 行金额小计 billSourceId: type: string title: 单据来源id detailId: type: string title: 明细行id detailRowNo: type: integer title: 明细行序号 goodsName: type: string description: '*税分编码简称*+开票名称' title: 商品名称 includeTaxAmount: type: number title: 含税金额 includeTaxPrice: type: number title: 含税单价 lineProperty: type: string title: 发票行性质 enum: - '0' - '1' - '2' x-apifox-enum: - value: '0' name: 明细行 description: '' - value: '1' name: 折扣行 description: '' - value: '2' name: 被折扣行 description: '' price: type: number title: 单价 description: 根据含税标志判断是“含税单价还是“不含税单价” privilegeContent: type: string title: 享受优惠内容 enum: - 免税 - 不征税 - 简易征收 - 按3%简易征收 - 按5%简易征收 - 按5%简易征收减按1.5%计征 - 稀土产品 - 先征后退 - 50%先征后退 - 100%先征后退 - 即征即退30% - 即征即退50% - 即征即退70% - 即征即退100% - 超税负3%即征即退 - 超税负6%即征即退 - 超税负8%即征即退 - 超税负12%即征即退 x-apifox-enum: - value: 免税 name: '' description: '' - value: 不征税 name: '' description: '' - value: 简易征收 name: '' description: '' - value: 按3%简易征收 name: '' description: '' - value: 按5%简易征收 name: '' description: '' - value: 按5%简易征收减按1.5%计征 name: '' description: '' - value: 稀土产品 name: '' description: '' - value: 先征后退 name: '' description: '' - value: 50%先征后退 name: '' description: '' - value: 100%先征后退 name: '' description: '' - value: 即征即退30% name: '' description: '' - value: 即征即退50% name: '' description: '' - value: 即征即退70% name: '' description: '' - value: 即征即退100% name: '' description: '' - value: 超税负3%即征即退 name: '' description: '' - value: 超税负6%即征即退 name: '' description: '' - value: 超税负8%即征即退 name: '' description: '' - value: 超税负12%即征即退 name: '' description: '' privilegeFlag: type: string title: 是否享受优惠 enum: - '0' - '1' x-apifox-enum: - value: '0' name: 不享受 description: '' - value: '1' name: 享受 description: '' quantity: type: number title: 数量 remainRedAmount: type: number title: 剩余可红冲金额 remainRedQuantity: type: number title: 剩余可红冲数量 remainRedTax: type: number title: 剩余可红冲税额 revenueCode: type: string title: 税收分类编码 revenueName: type: string title: 税收商品大类名称 seq: type: integer title: 分录行号 specification: type: string title: 规格型号 taxAmount: type: number title: 税额 taxFlag: type: integer title: 含税标志 enum: - 0 - 1 x-apifox-enum: - value: 0 name: 不含税 description: '' - value: 1 name: 含税 description: '' taxRate: type: string title: 税率 examples: - '0.09' description: 两位小数格式 units: type: string title: 计量单位 zeroTaxRateFlag: type: string title: 零税率标识 x-apifox-orders: - seq - detailRowNo - detailId - lineProperty - billSourceId - taxFlag - quantity - price - taxRate - taxAmount - amount - includeTaxAmount - includeTaxPrice - redPrice - remainRedQuantity - remainRedTax - remainRedAmount - goodsName - revenueName - revenueCode - specification - units - privilegeFlag - privilegeContent - zeroTaxRateFlag required: - amount - billSourceId - detailId - detailRowNo - goodsName - includeTaxAmount - includeTaxPrice - lineProperty - price - privilegeContent - privilegeFlag - quantity - remainRedAmount - remainRedQuantity - remainRedTax - revenueCode - revenueName - seq - specification - taxAmount - taxFlag - taxRate - units - zeroTaxRateFlag title: 发票明细 invoiceProperty: type: integer title: 发票性质 enum: - 0 - 1 x-apifox-enum: - value: 0 name: 蓝票 description: '' - value: 1 name: 红票 description: '' invoiceType: type: string title: 发票种类 enum: - 08xdp - 10xdp - '004' - '007' - '025' - '026' - '028' x-apifox-enum: - value: 08xdp name: 数电发票（增值税专用发票） description: '' - value: 10xdp name: 数电发票（普通发票） description: '' - value: '004' name: 增值税纸质专用发票 description: '' - value: '007' name: 增值税纸质普通发票 description: '' - value: '025' name: 卷票 description: '' - value: '026' name: 增值税电子普通发票 description: '' - value: '028' name: 增值税电子专用发票 description: '' orderNo: type: string title: 发票流水号 org: type: string title: 组织id originalInvoiceCode: type: string description: 查询红字发票所对应的原蓝票代码 title: 原蓝票代码 originalInvoiceNumber: type: string description: 查询红字发票所对应的原蓝票号码 title: 原蓝票号码 payee: type: string title: 收款人 printFlag: type: string title: 打印标识 enum: - '0' - '1' - '2' x-apifox-enum: - value: '0' name: 未打印 description: '' - value: '1' name: 已打印 description: '' - value: '2' name: 打印失败 description: '' redInfoBillNo: type: string title: 红字信息表编号 remark: type: string title: 备注 reviewer: type: string title: 复核人 sellerAddressAndTel: type: string title: 销售方地址和电话 maxLength: 100 sellerBankAndAccount: type: string title: 销售方银行和银行账号 maxLength: 100 sellerName: type: string title: 销售方名称 sellerTaxpayerId: type: string title: 销售方纳税人识别号 maxLength: 20 serialNo: type: string title: 单据编号 systemSource: type: string title: 数据来源系统 taxedType: type: string title: 征税方式 enum: - '0' - '1' - '2' x-apifox-enum: - value: '0' name: 普通征税 description: '' - value: '1' name: 减按计征 description: '' - value: '2' name: 差额征税 description: '' terminalNo: type: string title: 终端编号 description: 适用于百望服务器开具的税控发票 totalAmount: type: number title: 不含税金额合计 totalTaxAmount: type: number title: 税额合计 checkCode: type: string title: 校验码 description: 税控发票有，数电票无 skm: type: string title: 密码区 description: 适用于税控发票 invoiceStatus: type: string title: 发票状态 enum: - '0' - '1' - '2' - '3' - '4' - '6' - '7' x-apifox-enum: - value: '0' name: 正常 description: '' - value: '1' name: 失控 description: '' - value: '2' name: 部分红冲 description: '' - value: '3' name: 红冲 description: '' - value: '4' name: 异常 description: '' - value: '6' name: 作废 description: '' - value: '7' name: 作废中 description: '' issueErrorMessage: type: string title: 开票失败原因 specialType: type: string title: 特殊票种 enum: - '00' - '02' - '06' - '07' - '08' - '11' - '18' - E01 - E03 - E04 - E05 - E06 - E07 - E09 - E12 - E14 - E18 x-apifox-enum: - value: '00' name: 非特殊票种 description: '' - value: '02' name: 收购 description: '' - value: '06' name: 抵扣通行费 description: '' - value: '07' name: 不抵扣通行费 description: '' - value: '08' name: 成品油 description: '' - value: '11' name: 卷烟 description: '' - value: '18' name: 机动车 description: '' - value: E01 name: 成品油（数电票） description: '' - value: E03 name: 建筑服务发票 description: '' - value: E04 name: 货物运输 description: '' - value: E05 name: 不动产销售服务发票 description: '' - value: E06 name: 不动产经营租赁服务 description: '' - value: E07 name: 代收车船税（数电票） description: '' - value: E09 name: 旅客运输（数电票） description: '' - value: E12 name: 自产农产品销售 description: '' - value: E14 name: 机动车（数电票） description: '' - value: E18 name: 卷烟（数电票） description: '' account: type: string title: 电子税局账号 coBuyerFlag: type: string title: 是否共同购买方 description: 不动产销售特殊票种适用 invoiceDetailDate: type: string title: 开票日期时分秒 format: date-time originalInvoiceType: type: string title: 原发票种类 description: 查询红字发票所对应的原蓝票种类 redReason: type: string title: 冲红原因 enum: - '1' - '2' - '3' - '4' x-apifox-enum: - value: '1' name: 销货退回 description: '' - value: '2' name: 开票有误 description: '' - value: '3' name: 服务中止 description: '' - value: '4' name: 销售折让 description: '' x-apifox-orders: - account - buyerType - systemSource - org - serialNo - batch - orderNo - issueErrorMessage - invoiceType - invoiceProperty - invoiceStatus - specialType - taxedType - invoiceCode - invoiceNum - invoiceDate - invoiceDetailDate - totalAmount - totalTaxAmount - includeTaxAmount - sellerName - sellerTaxpayerId - sellerAddressAndTel - sellerBankAndAccount - buyerProperty - buyerName - buyerTaxpayerId - buyerAddressAndTel - buyerBankAndAccount - buyerRecipientMail - buyerRecipientPhone - drawer - reviewer - payee - canceler - remark - invoiceFileUrl - invoicePdfFileUrl - invoiceXmlFileUrl - invoiceImageUrl - originalInvoiceType - originalInvoiceCode - originalInvoiceNumber - redInfoBillNo - redReason - deduction - abolishReason - coBuyerFlag - printFlag - inventoryMark - skm - checkCode - deviceNo - terminalNo - includeTaxFlag - invoiceDetail required: - buyerAddressAndTel - buyerBankAndAccount - buyerName - buyerProperty - buyerTaxpayerId - buyerType - deduction - deviceNo - drawer - includeTaxAmount - includeTaxFlag - inventoryMark - invoiceCode - invoiceNum - invoiceFileUrl - invoicePdfFileUrl - invoiceXmlFileUrl - invoiceImageUrl - invoiceDate - invoiceDetail - invoiceProperty - invoiceType - orderNo - org - sellerAddressAndTel - sellerBankAndAccount - sellerName - sellerTaxpayerId - serialNo - taxedType - totalAmount - totalTaxAmount - checkCode - skm - invoiceStatus - payee - specialType - account - buyerRecipientMail - buyerRecipientPhone - batch - issueErrorMessage - abolishReason - canceler - coBuyerFlag - invoiceDetailDate - originalInvoiceType - redReason title: 返回数据体 errorCode: type: string title: 接口响应码 enum: - '0' x-apifox-enum: - value: '0' name: 成功 description: '' success: type: boolean title: 是否成功 status: type: boolean title: 接口响应状态 required: - data - errorCode - success - status x-apifox-orders: - data - errorCode - status - success x-apifox-refs: {} 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-146003723-run components: schemas: {} securitySchemes: {} servers: - url: https://cosmic-demo.piaozone.com/demo description: 测试环境 - url: https://cosmic-sandbox.piaozone.com/jdpjykjyxgs description: 快速开始环境 security: [] ```