优化

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

@@ -6,6 +6,37 @@ info:
 security:
   - bearerAuth: []
 paths:
+  /internal/order/v1/fulfillment-completions:
+    post:
+      security: []
+      summary: Firstleg 回传海外派送完成并结束对应订单
+      description: >-
+        仅接受内部服务令牌。请求必须携带海外事件已验证的来源订单 ID、订单号、入仓码、
+        FBA 派送单号和完成时间；只推进该派送单关联的订单，COMPLETED 重放返回成功。
+      parameters:
+        - name: X-Internal-Service-Token
+          in: header
+          required: true
+          schema: {type: string}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [tenantId, orderId, orderNo, inboundCode, deliveryNo, completedAt, eventId, payloadHash]
+              properties:
+                tenantId: {type: string, pattern: '^[1-9][0-9]*$'}
+                orderId: {type: string, pattern: '^[1-9][0-9]*$'}
+                orderNo: {type: string}
+                inboundCode: {type: string}
+                deliveryNo: {type: string}
+                completedAt: {type: string, format: date-time}
+                eventId: {type: string, format: uuid}
+                payloadHash: {type: string, pattern: '^[0-9a-fA-F]{64}$'}
+      responses:
+        '200': {description: 对应订单已完成或幂等重放成功}
+        '403': {description: 内部服务令牌无效}
   /internal/order/v1/cargoes/{tenantId}/{orderId}:
     get:
       security: []