hl-api-changelog/changelogs/2026-03/2026-03-17_1540_26162ed_fix.md

68 行
2.9 KiB
Markdown

# 接口变更记录 — 2026-03-17 15:40
> **提交** `26162ed` · **作者** wx · **时间** 2026-03-17 15:40:06 +0800
>
> fix: 发票功能增强——重开/冲红/字段校验/中文提示
## 📦 其他数据对象变更
> 以下变更未直接关联到本次接口变更,但可能影响现有接口的请求/响应
### 小程序聚合服务
#### ✏️ MpInvoiceApplyRequest
- 🆕 `taxNumber` (`String`) — 纳税人识别号(企业发票必填)
- 🆕 `contactPhone` (`String`) — 联系电话
- 🆕 `remark` (`String`) — 备注信息
- 🆕 `bankName` (`String`) — 开户行(企业发票选填)
- 🆕 `bankAccount` (`String`) — 银行账号(企业发票选填)
- 🆕 `companyAddress` (`String`) — 企业地址(企业发票选填)
- 🆕 `companyPhone` (`String`) — 企业电话(企业发票选填)
-~~`taxpayerId`~~ (`String`) — 纳税人识别号(企业发票必填)
-~~`invoiceType`~~ (`String`) — 发票类型: PERSONAL(个人)/COMPANY(企业)
#### ✏️ MpInvoiceDetailVO
- 🆕 `taxNumber` (`String`) — 纳税人识别号
- 🆕 `titleType` (`String`) — 抬头类型: PERSONAL=个人, COMPANY=企业
-~~`taxpayerId`~~ (`String`) — 纳税人识别号
-~~`invoiceType`~~ (`String`) — 发票类型: PERSONAL/COMPANY
### 订单服务
#### ✏️ InvoiceApplyRequest
- 🆕 `contactPhone` (`String`) — 联系电话
- 🆕 `remark` (`String`) — 备注信息
- 🆕 `bankName` (`String`) — 开户行(企业发票选填)
- 🆕 `bankAccount` (`String`) — 银行账号(企业发票选填)
- 🆕 `companyAddress` (`String`) — 企业地址(企业发票选填)
- 🆕 `companyPhone` (`String`) — 企业电话(企业发票选填)
#### ✏️ InvoiceVO
- 🆕 `contactPhone` (`String`) — 联系电话
- 🆕 `remark` (`String`) — 备注信息
- 🆕 `bankName` (`String`) — 开户行(企业发票)
- 🆕 `bankAccount` (`String`) — 银行账号(企业发票)
- 🆕 `companyAddress` (`String`) — 企业地址(企业发票)
- 🆕 `companyPhone` (`String`) — 企业电话(企业发票)
- 🆕 `invoiceNo` (`String`) — 发票号码
- 🆕 `issuedAt` (`LocalDateTime`) — 开票时间
- 🆕 `issuedBy` (`String`) — 开票操作人ID
- 🆕 `userId` (`String`) — 用户ID
<details>
<summary>📁 全部变更文件 (点击展开)</summary>
```
M hl-mp-service/src/main/java/com/hulalv/mp/dto/MpInvoiceApplyRequest.java
M hl-mp-service/src/main/java/com/hulalv/mp/vo/MpInvoiceDetailVO.java
M hl-order-service/src/main/java/com/hulalv/order/dto/InvoiceApplyRequest.java
M hl-order-service/src/main/java/com/hulalv/order/entity/OrderInvoice.java
M hl-order-service/src/main/java/com/hulalv/order/service/InvoiceService.java
M hl-order-service/src/main/java/com/hulalv/order/vo/InvoiceVO.java
A sql/invoice_enhancement.sql
```
</details>