优化

财务管理/openapi/finance-phase1-five-pages-v1.yaml

@@ -961,7 +961,7 @@ components:
       required: [statementId, statementNo, customerId, customerName, periodStart, periodEnd, creditDays, currency, lineCount, sourceCount, sourceAmount, adjustmentAmount, totalReceivable, receivedAmount, outstandingAmount, settled, status, version, createdBy, createdAt, updatedBy, updatedAt]
       properties:
         statementId: {$ref: '#/components/schemas/Id'}
-        statementNo: {type: string}
+        statementNo: {type: string, pattern: '^REC-\d{6}-\d{4}$', example: REC-260818-0001}
         customerId: {$ref: '#/components/schemas/Id'}
         customerName: {type: string}
         periodStart: {type: string, format: date}
@@ -1091,7 +1091,7 @@ components:
       properties:
         id: {$ref: '#/components/schemas/Id'}
         customerId: {$ref: '#/components/schemas/Id'}
-        settlementNo: {type: string}
+        settlementNo: {type: string, pattern: '^AR-\d{6}-\d{4}$', example: AR-260818-0001}
         billDate: {type: string, format: date}
         dueDate: {type: string, format: date}
         receivableAmount: {$ref: '#/components/schemas/Money'}
@@ -1106,7 +1106,7 @@ components:
       properties:
         id: {$ref: '#/components/schemas/Id'}
         customerId: {$ref: '#/components/schemas/Id'}
-        settlementNo: {type: string}
+        settlementNo: {type: string, pattern: '^AP-\d{6}-\d{4}$', example: AP-260818-0001}
         costType: {type: string, enum: [SINGLE_ORDER, CONTAINER_SHARED]}
         orderId: {$ref: '#/components/schemas/Id'}
         inboundId: {$ref: '#/components/schemas/Id'}
@@ -1178,7 +1178,7 @@ components:
       required: [settlementId, settlementNo, direction, currency, totalAmount, paidAmount, outstandingAmount, generatedDate, dueDate, paymentStatus, status, version]
       properties:
         settlementId: {$ref: '#/components/schemas/Id'}
-        settlementNo: {type: string}
+        settlementNo: {type: string, pattern: '^(AR|AP)-\d{6}-\d{4}$', example: AR-260818-0001}
         direction: {$ref: '#/components/schemas/FeeDirection'}
         customerId: {$ref: '#/components/schemas/Id'}
         customerName: {type: string}

财务管理/财务一期五页产品与接口验收契约.md

@@ -22,6 +22,8 @@
 
 所有金额只使用 CNY。原型中的 USD、汇率、开票日期、利润审批、利润金额仅为历史原型字段，一期删除。
 
+客户对账单、应收结算单、应付结算单统一使用短业务编号：`REC-YYMMDD-NNNN`、`AR-YYMMDD-NNNN`、`AP-YYMMDD-NNNN`。日期按北京时间的单据创建日计算，各单据类型分别按日从 `0001` 递增；编号生成后不可修改，作废也不回收。
+
 ## 2. 客户账户冲突处理（已确认）
 
 原型客户账户是“预充值余额 + 冻结 + 可用余额 + 手动充值”的钱包模型，与此前确认的“不做钱包/预收”冲突。产品已确认按以下方案处理，不再等待额外产品结论：