# 接口变更记录 — 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<InvoiceVO>`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `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 — 发票换开~~

---

<details>
<summary>📁 全部变更文件 (点击展开)</summary>

```
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
```
</details>