fix(order): complete root fulfillment only after effective remainders

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

@@ -303,6 +303,29 @@ paths:
             schema: {$ref: '#/components/schemas/OrderDeclarationUpdatedEvent'}
       responses:
         '200': {description: 成功、幂等重放或旧版本已忽略；冲突时响应体 code=A0409}
+  /internal/firstleg/v1/inbounds/order-fulfillment-completed:
+    post:
+      summary: 接收 Order 履约最终完成并幂等同步入仓订单状态摘要
+      description: >-
+        由 Order 事务 Outbox 可靠投递，签收聚合和最后有效余量取消都使用同一正式完成事实。
+        按客户、来源订单号及入仓码核验全部有效入仓已为 DELIVERED 后更新摘要；重复调用不重复递增版本。
+      security:
+        - internalServiceToken: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [tenantId, orderId, orderNo, inboundCode, completedAt]
+              properties:
+                tenantId: {type: integer, format: int64, minimum: 1}
+                orderId: {type: integer, format: int64, minimum: 1}
+                orderNo: {type: string, minLength: 1}
+                inboundCode: {type: string, minLength: 1}
+                completedAt: {type: string, format: date-time}
+      responses:
+        '200': {description: data 返回实际更新入仓摘要数量，幂等重放为 0；未签收或来源不符时拒绝写入}
   /internal/firstleg/v1/inbounds/order-remarks-updated:
     post:
       summary: 同步 Order 权威协作备注到未冻结预装明细