diff --git a/changelogs/2026-03/2026-03-24_1745_90d8f9f_feat_51.md b/changelogs/2026-03/2026-03-24_1745_90d8f9f_feat_51.md new file mode 100644 index 0000000..c004426 --- /dev/null +++ b/changelogs/2026-03/2026-03-24_1745_90d8f9f_feat_51.md @@ -0,0 +1,81 @@ +# 接口变更记录 — 2026-03-24 17:45 + +> **提交** `90d8f9f` · **作者** wx · **时间** 2026-03-24 17:45:04 +0800 +> +> feat: 发票功能补全单元测试(51个) + 修复3个BUG + +## 变更总览 + +- **订单服务** + - InternalInvoice (+1) + - InternalOrderStats (-2) + +--- + +## 订单服务 + +### InternalInvoice + +> 📖 **接口文档**: [http://192.168.100.236:8084/doc.html](http://192.168.100.236:8084/doc.html) → 标签 **「【内部接口】小程序发票(Feign调用)」** + +### 🆕 `POST` /internal/mp/invoice/reissue — 发票换开 + +> 已开发票更换抬头信息(如个人改企业、更换公司名称等)。 + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `id` | `String` | 发票ID | +| `orderId` | `String` | 订单ID | +| `orderNo` | `String` | 订单号 | +| `amount` | `String` | 金额 | +| `titleType` | `String` | 抬头类型(personal=个人/company=企业) | +| `invoiceTitle` | `String` | 发票抬头 | +| `taxNumber` | `String` | 税号 | +| `email` | `String` | 接收邮箱 | +| `invoiceType` | `String` | 发票类型 | +| `invoiceContent` | `String` | 发票内容 | +| `status` | `String` | 发票状态 | +| `fileUrl` | `String` | 发票文件URL | +| `failReason` | `String` | 失败原因 | +| `contactPhone` | `String` | 联系电话 | +| `remark` | `String` | 备注信息 | +| `bankName` | `String` | 开户行(企业发票) | +| `bankAccount` | `String` | 银行账号(企业发票) | +| `companyAddress` | `String` | 企业地址(企业发票) | +| `companyPhone` | `String` | 企业电话(企业发票) | +| `invoiceNo` | `String` | 发票号码 | +| `issuedAt` | `LocalDateTime` | 开票时间 | +| `issuedBy` | `String` | 开票操作人ID | +| `userId` | `String` | 用户ID | +| `originalInvoiceId` | `String` | 原发票ID(换开时关联) | +| `reissueCount` | `Integer` | 换开次数 | +| `createdAt` | `LocalDateTime` | 创建时间 | +| `updatedAt` | `LocalDateTime` | 更新时间 | + +**关联字典** + +- `invoice_title_type`(抬头类型,请求/返回字段titleType):PERSONAL=个人, COMPANY=企业 +- `invoice_status`(发票状态,返回字段status):PENDING=待开票, ISSUED=已开票, FAILED=开票失败, VOIDED=已作废 + +### InternalOrderStats + +> 📖 **接口文档**: [http://192.168.100.236:8084/doc.html](http://192.168.100.236:8084/doc.html) → 标签 **「内部-订单统计」** + +### ❌ ~~`GET` /internal/mp/order/internal/mp/order~~ + +### ❌ ~~`POST` /internal/mp/order/invoice/reissue — 发票换开~~ + +--- + +
+📁 全部变更文件 (点击展开) + +``` +M hl-order-service/src/main/java/com/hulalv/order/controller/InternalInvoiceController.java +M hl-order-service/src/main/java/com/hulalv/order/controller/InternalOrderStatsController.java +M hl-order-service/src/main/java/com/hulalv/order/service/InvoiceService.java +A hl-order-service/src/test/java/com/hulalv/order/service/InvoiceServiceTest.java +``` +
\ No newline at end of file