优化

order/src/main/resources/openapi/order-v1.yaml

@@ -212,8 +212,12 @@ paths:
       description: >-
         需要 platform:order:declaration:edit。货物使用订单内 itemNo 定位，不接受货物数据库 ID；
         不允许修改客户、国内收货仓、订单号、入仓码、状态、仓库/PDA/设备实测、测量审核或计费事实。
-        审核通过订单仅在尚无测量、同柜组、分柜、装柜或计费事实时受理，并通过
-        ORDER_DECLARATION_UPDATED_V1 Outbox 快照同步 Firstleg；消费者按 eventId 幂等、version 顺序应用。
+        已有测量或计费事实不阻断客户申报快照更新，详情继续以最新申报与既有实测分别展示；
+        只有渠道发生变化时才在写入前校验同柜/分柜/装柜可逆性和重新计价资格，任何校验失败均不写入。
+        正式门禁分别为 /internal/firstleg/v1/inbounds/order-channel-changes/validate 与
+        /internal/firstleg/v1/pricing/order-channel-changes/validate，两个服务均失败关闭。
+        国内收货仓或中转仓如需变化必须重新下单。成功后通过 ORDER_DECLARATION_UPDATED_V1 Outbox
+        同步 Firstleg；消费者按 eventId 幂等、version 顺序刷新申报快照，不覆盖实测、箱码或已确认费用。
       parameters:
         - $ref: '#/components/parameters/UnifiedOrderId'
         - $ref: '#/components/parameters/UnifiedTenantId'
@@ -223,7 +227,7 @@ paths:
           application/json:
             schema: {$ref: '#/components/schemas/OrderDeclarationUpdateRequest'}
       responses:
-        '200': {description: 成功返回新版本、渠道历史标记和字段级前后值；版本冲突或存在不可逆履约事实时响应体业务码为 A0409}
+        '200': {description: 成功返回新版本、渠道历史标记和字段级前后值；版本冲突、渠道与不可逆履约或已确认费用不兼容时响应体业务码为 A0409}
         '403': {description: 无权限或非平台身份}
   /api/merchant/v1/orders:
     get: