4.3 KiB
发票模块完整接口清单
本文档包含发票模块全部接口（管理端 + 用户端 + 内部调用），供前端对接参考
AdminInvoice (发票管理)
接口文档: http://192.168.100.236:8084/doc.html -> 分组「3.3 发票管理」 -> 标签「发票管理」
POST /admin/invoice/upload -- 上传发票文件
上传发票PDF/图片文件，返回文件访问URL。
响应 Result<Map<String, String>>
GET /admin/invoice/page -- 发票分页列表
分页查询发票申请列表，支持按状态、订单号、用户ID筛选。
响应 Result<PageResult<InvoiceVO>>
关联字典
invoice_status(发票状态): PENDING=待开票, ISSUED=已开票, FAILED=开票失败, VOIDED=已作废invoice_title_type(抬头类型): PERSONAL=个人, COMPANY=企业
GET /admin/invoice/{id} -- 发票详情
获取发票的完整信息，包含开票信息、用户信息、企业信息等。
响应 Result<InvoiceVO>
PUT /admin/invoice/{id}/issue -- 开票完成
管理员上传发票文件并填写发票号码后，将发票状态改为已开票。
响应 Result<InvoiceVO>
PUT /admin/invoice/{id}/fail -- 开票失败
标记发票开票失败，需填写失败原因。用户可根据原因修正后重新申请。
响应 Result<InvoiceVO>
PUT /admin/invoice/{id}/void -- 作废发票
将发票标记为已作废。已作废的发票不可重复作废。
响应 Result<InvoiceVO>
InternalInvoice (【内部接口】小程序发票（Feign调用）)
接口文档: http://192.168.100.236:8084/doc.html -> 标签「【内部接口】小程序发票（Feign调用）」
POST /internal/mp/invoice/apply -- 申请开票
用户对已支付订单申请开具电子发票。支持个人和企业抬头。
响应 Result<InvoiceVO>
关联字典
invoice_title_type(抬头类型，请求/返回字段titleType): PERSONAL=个人, COMPANY=企业invoice_type(发票类型，返回字段invoiceType): NORMAL=普通发票, SPECIAL=专用发票invoice_status(发票状态，返回字段status): PENDING=待开票, ISSUED=已开票, FAILED=开票失败, CANCELLED=已作废
GET /internal/mp/invoice/{id} -- 发票详情
关联字典：
响应 Result<InvoiceVO>
关联字典
invoice_title_type(抬头类型，返回字段titleType): PERSONAL=个人, COMPANY=企业invoice_type(发票类型，返回字段invoiceType): NORMAL=普通发票, SPECIAL=专用发票invoice_status(发票状态，返回字段status): PENDING=待开票, ISSUED=已开票, FAILED=开票失败, CANCELLED=已作废
GET /internal/mp/invoice/order/{orderId} -- 通过订单ID查询发票
查询订单关联的发票信息。未开票时返回null
响应 Result<InvoiceVO>
关联字典
invoice_title_type(抬头类型，返回字段titleType): PERSONAL=个人, COMPANY=企业invoice_type(发票类型，返回字段invoiceType): NORMAL=普通发票, SPECIAL=专用发票invoice_status(发票状态，返回字段status): PENDING=待开票, ISSUED=已开票, FAILED=开票失败, CANCELLED=已作废
MpInvoice (C端 - 发票接口)
接口文档: http://192.168.100.236:8086/doc.html -> 标签「C端 - 发票接口」
POST /mp/invoice/apply -- 申请开票
开票流程：订单完成后 → 填写发票信息(抬头/税号/类型) → 提交开票申请 → 管理员处理 → 发送电子发票
响应 Result<Map<String, Object>>
GET /mp/invoice/{id} -- 发票详情
获取发票的完整信息，包含开票状态、发票抬头、税号、金额、电子发票文件链接等
响应 Result<Map<String, Object>>
GET /mp/invoice/order/{orderId} -- 通过订单ID查询发票
查询指定订单的发票信息，如果订单未开票则返回null
响应 Result<Map<String, Object>>
POST /mp/invoice/{invoiceId}/reissue -- 发票换开
对已开发票申请换开（修改抬头/税号等），原发票作废后重新开具新发票
响应 Result<Map<String, Object>>