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