# Generated by ShowAPI OpenAPI generator # source: market/2417 # generated-at: 2026-09-10T07:14:43.182Z openapi: 3.0.3 info: title: 票据凭证OCR识别 description: 支持增值税发票、区块链发票等多种票据的OCR识别，自动提取信息并联网验真，适用于企业财税管理。 termsOfService: https://www.showapi.com/helpcenter/view#/4019/2 version: 1.0.0 servers: - url: https://route.showapi.com paths: /2417-8: x-pointCode: 8 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 出租车发票识别 description: 可识别全国多城市出租车票的结构化信息，包括发票号码、代码、车号、日期、总金额、燃油附加费、叫车服务费、上下车时间等。图片需小于4M，短边像素大于256，支持PNG、JPG、JPEG、BMP格式。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: get_on_time: type: string description: 上车时间 code: type: string description: 发票代号 service_province: type: string description: 省 date: type: string description: 乘车日期 unit_price: type: string description: 每公里单价 distance: type: string description: 里程 ret_code: type: number description: |- 0 无异常 10 参数错误 20 文件格式错误 30 操作失败,请勿重复提交 40 文件下载失败 50 文件内容过大 60 图片解析失败 70 OCR识别失败 80 服务超时 90 未知错误 num: type: string description: 发票号码 service_city: type: string description: 市 total_fee: type: string description: 总金额 taxi_num: type: string description: 车牌号 fuel_surcharge: type: string description: 燃油附加费 get_off_time: type: string description: 下车时间 description: 业务返回体 operationId: 2417_8_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: |- 图片base64字符串 img_base64和img_url 二选一，同时存在以base64为主 img_url: type: string description: |- 图片url img_base64和img_url 二选一，同时存在以base64为主 /2417-7: x-pointCode: 7 x-mode: mapping x-read-timeout: 30 x-connect-timeout: 30 post: summary: 二手车统一销售发票识别 description: 支持对二手车销售统一发票进行结构化识别，可提取开票日期、发票号码、买方单位、卖方单位等信息。图片需小于10M，避免重叠或重影，否则可能影响识别准确度。支持PNG、JPG、JPEG、BMP格式。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: |- 0 无异常(计费，其余不计费) 10 参数错误 20 文件格式错误 30 操作失败,请勿重复提交 40 文件下载失败 50 文件内容过大 60 图片解析失败 70 OCR识别失败 80 服务超时 90 未知错误 type_name: type: string description: 标题 invoice_copies: type: string description: 联次 invoice_date: type: string description: 开票日期 invoice_code: type: string description: 发票代码 invoice_num: type: string description: 发票号码 machine_code: type: string description: 机打代码 machine_num: type: string description: 机打号码 tax_code: type: string description: 税控码 purchaser_name: type: string description: 买方单位/个人 purchaser_code: type: string description: 买方单位代码/身份证号码 purchaser_addr: type: string description: 买方单位/个人地址 purchaser_phone: type: string description: 买方电话 seller_name: type: string description: 卖方单位/个人 seller_code: type: string description: 卖方单位代码/身份证号码 seller_addr: type: string description: 卖方单位/个人住址 seller_phone: type: string description: 卖方电话 license_plate_number: type: string description: 车牌照号 certificate_num: type: string description: 登记证号 vehicle_type: type: string description: 车辆类型 vin: type: string description: 车架号/车辆识别代码 brand_model: type: string description: 厂牌型号 transfer_vehicle_administration_name: type: string description: 转入地车辆管理所名称 total_amount_words: type: string description: 车价合计(大写) total_amount: type: string description: 车价合计(小写) used_car_market_name: type: string description: 二手车市场名称 used_car_market_tax_num: type: string description: 二手车市场纳税人识别号 used_car_market_addr: type: string description: 二手车市场地址 used_car_market_bank_account: type: string description: 二手车市场开户银行及账户 used_car_market_phone: type: string description: 二手车市场电话 remark: type: string description: 备注 drawer: type: string description: 开票人 description: 业务返回体 operationId: 2417_7_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: |- 图片base64字符串 img_base64和img_url 二选一，同时存在以base64为主 img_url: type: string description: |- 图片url（长度不超 2048） img_base64和img_url 二选一，同时存在以base64为主 /2417-6: x-pointCode: 6 x-mode: mapping x-read-timeout: 30 x-connect-timeout: 30 post: summary: 增值税发票识别 description: 本服务可识别增值税发票（普票、专票、电子发票、卷票、区块链发票）的关键字段，涵盖发票基本信息、销售方及购买方信息、商品信息、价税信息等。图片要求：小于4M，短边像素大于256，支持PNG、JPG、JPEG、BMP格式。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: machine_num: type: string description: 机打号码。仅增值税卷票含有此参数 purchaser_register_num: type: string description: 购方纳税人识别号 seller_add: type: string description: 销售方地址及电话 type: type: string description: 发票种类：普通发票、专用发票、电子普通发票、电子专用发票、通行费电子普票、区块链发票、通用机打电子发票 drawer: type: string description: 开票人 pwd_area_text: type: string description: 密码区 seller_bank: type: string description: 销售方开户行及账号 invoice_code: type: string description: 发票代码 city: type: string description: 市 ret_code: type: number description: |- 0 无异常 10 参数错误 20 文件格式错误 30 操作失败,请勿重复提交 40 文件下载失败 50 文件内容过大 60 图片解析失败 70 OCR识别失败 80 服务超时 90 未知错误 province: type: string description: 省 total_tax: type: string description: 合计税额 total_amount: type: string description: 合计金额 check_code: type: string description: 校验码。增值税专票无此参数 amount_in_words: type: string description: 价税合计(大写) payee: type: string description: 收款人 invoice_code_confirm: type: string description: 发票代码的辅助校验码 invoice_num_confirm: type: string description: 发票号码的辅助校验码 purchaser_addr: type: string description: 购方地址及电话 checker: type: string description: 复核 invoice_num: type: string description: 发票号码 Invoice_date: type: string description: 开票日期 purchaser_name: type: string description: 购方名称 machine_code: type: string description: 机器编号。仅增值税卷票含有此参数 purchaser_bank: type: string description: 购方开户行及账号 amount_in_figuers: type: string description: 价税合计(小写) items: type: array items: type: object properties: spec: type: string description: 规格 unit: type: string description: 单位 num: type: string description: 数量 item_tax_amount: type: string description: 金额 line_no: type: string description: 行号 product_name: type: string description: 服务/货物名称 item_tax_rate: type: string description: 税率 item_tax: type: string description: 税额 unit_price: type: string description: 单价 description: 开票项目 type_name: type: string description: 发票名称 seller_reg_num: type: string description: 销售方纳税人识别号 seller_name: type: string description: 销售方名称 description: 业务返回体 operationId: 2417_6_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: |- 图片base64字符串 img_base64和img_url 二选一，同时存在以base64为主 img_url: type: string description: |- 图片url img_base64和img_url 二选一，同时存在以base64为主 /2417-5: x-pointCode: 5 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 火车票识别 description: 可识别红、蓝火车票的结构化信息，涵盖车票号码、始发站、目的站、车次、日期、票价、席别、姓名、座位号、身份证号、时间等。图片需小于4M，短边像素大于256，支持PNG、JPG、JPEG、BMP格式。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: |- 0 无异常 10 参数错误 20 文件格式错误 30 操作失败,请勿重复提交 40 文件下载失败 50 文件内容过大 60 图片解析失败 70 OCR识别失败 80 服务超时 90 未知错误 ticket_num: type: string description: 车票号 start_station: type: string description: 始发站 train_num: type: string description: 车次号 dest_station: type: string description: 到达站 time: type: string description: 出发时间 ticket_price: type: string description: 车票金额 seat_type: type: string description: 席别 name: type: string description: 乘客姓名 id_num: type: string description: 身份证号 seat_num: type: string description: 座位号 date: type: string description: 出发日期 格式 YYYYMMDD description: 业务返回体 operationId: 2417_5_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: |- 图片base64字符串 img_base64和img_url 二选一，同时存在以base64为主 img_url: type: string description: |- 图片url img_base64和img_url 二选一，同时存在以base64为主 /2417-3: x-pointCode: 3 x-mode: mapping x-read-timeout: 60 x-connect-timeout: 60 post: summary: 增值税发票验真(base64) description: 支持识别发票图片信息，并联网核验发票真伪，返回完整票面信息（核验不通过时仍计费）。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: 接口调用是否成功,0为成功,其他为失败 remark: type: string description: |- 提示信息 成功： 校验成功 失败： 查验不成功，请重试。 查验不一致! 查无此票! 超过该张发票当日查验次数(请于次日再次查验)! itemList: type: array items: type: object properties: name: type: string description: 商品名称 priceAmt: type: string description: 金额 taxRate: type: string description: 税率 taxAmt: type: string description: 税额 priceUnit: type: string description: 单价 unit: type: string description: 单位 spec: type: string description: 规格 amount: type: string description: 数量 description: 商品信息 invoiceType: type: string description: |- 发票类型：(可能为空) 增值税专用发票 增值税普通发票 增值税专用发票（电子） 增值税普通发票（电子） 增值税普通发票（卷式） 增值税普通发票（通行费） invoiceCode: type: string description: 发票代码 invoiceNo: type: string description: 发票号码 invoiceDate: type: string description: 开票日期 buyerName: type: string description: 购方名称 buyerTaxNo: type: string description: 购方税号 buyerContact: type: string description: 购方地址电话 buyerBank: type: string description: 购方开户行账户 salerName: type: string description: 销方名称 salerTaxNo: type: string description: 销方税号 salerContact: type: string description: 销方地址电话 salerBank: type: string description: 销方开户行账户 invoiceAmt: type: string description: 合计金额 totalTaxAmt: type: string description: 合计税额 totalAmt: type: string description: 价税合计 notes: type: string description: 发票备注 status: type: string description: 发票状态 1、未作废　2、作废 3、红冲 description: 业务返回体 operationId: 2417_3_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: imgUrl: type: string description: 图片的可访问下载地址,与imgBase64参数二选一 imgBase64: type: string minLength: 0 maxLength: 10000000 description: 图片的Base64字符串,与imgUrl参数二选一 /2417-1: x-pointCode: 1 x-mode: mapping x-read-timeout: 60 x-connect-timeout: 60 post: summary: 增值税发票验真 description: 接入国家税务机关发票查验平台，可核验发票真伪及字段准确性，适用于企业税务核算、费控报销、供应链发票核验及财税代理记账等场景，有助于降低人力查验成本，保障企业财务信息安全。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: 接口调用是否成功,0为成功,其他为失败 remark: type: string description: |- 提示信息 成功： 校验成功 失败： 查验不成功，请重试。 查验不一致! 查无此票! 超过该张发票当日查验次数(请于次日再次查验)! itemList: type: array items: type: object properties: name: type: string description: 商品名称 priceAmt: type: string description: 金额 taxRate: type: string description: 税率 taxAmt: type: string description: 税额 priceUnit: type: string description: 单价 unit: type: string description: 单位 spec: type: string description: 规格 amount: type: string description: 数量 description: 商品信息 invoiceType: type: string description: |- 发票类型：(可能为空) 增值税专用发票 增值税普通发票 增值税专用发票（电子） 增值税普通发票（电子） 增值税普通发票（卷式） 增值税普通发票（通行费） invoiceCode: type: string description: 发票代码 invoiceNo: type: string description: 发票号码 invoiceDate: type: string description: 开票日期 buyerName: type: string description: 购方名称 buyerTaxNo: type: string description: 购方税号 buyerContact: type: string description: 购方地址电话 buyerBank: type: string description: 购方开户行账户 salerName: type: string description: 销方名称 salerTaxNo: type: string description: 销方税号 salerContact: type: string description: 销方地址电话 salerBank: type: string description: 销方开户行账户 invoiceAmt: type: string description: 合计金额 totalTaxAmt: type: string description: 合计税额 totalAmt: type: string description: 价税合计 notes: type: string description: 发票备注 machineCode: type: string description: 机器编码 verCode: type: string description: 校验码 status: type: string description: 发票状态 1、未作废　2、作废 3、红冲 description: 业务返回体 operationId: 2417_1_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: invoiceCode: type: string description: 发票代码【注意：除全电票外，其他必传】 invoiceNo: type: string description: 发票号码 invoiceDate: type: string description: 开票日期（格式：yyyy-MM-dd） invoiceAmt: type: string description: 不含税金额 ，必须精确到两位小数【注意：除普票外 其他必填。全电票传价税合计，其他发票传不含税金额】 verCode: type: string description: 校验码，除专票外，其他必填 required: - invoiceNo - invoiceDate - invoiceAmt components: securitySchemes: AppKeyAuth: type: apiKey in: query name: appKey description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp schemas: ShowapiResEnvelope: type: object description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body） properties: showapi_res_code: type: integer description: API 返回的状态码 showapi_res_error: type: string description: API 返回的错误信息 showapi_res_id: type: string description: API 请求的唯一标识 showapi_fee_num: type: integer description: API 调用计费次数 security: - AppKeyAuth: [] externalDocs: url: https://www.showapi.com/apiGateway/view/2417?tab=book x-apiCode: "2417" x-is-own: false x-is-op: false