81 行
2.9 KiB
Markdown
81 行
2.9 KiB
Markdown
# 接口变更记录 — 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> |