提交

lastleg-service/src/main/resources/openapi/procurement-workflow-v1.yaml

@@ -6,6 +6,33 @@ info:
 security:
   - bearerAuth: []
 paths:
+  /api/merchant/v1/last-leg/overseas-procurements/{orderNo}/reject:
+    post:
+      summary: 客户驳回采购结果并填写原因
+      description: 仅当前认证客户，权限 merchant:cross-border:procurement:create。仅 WAIT_CUSTOMER_CONFIRM，成功回到 RECEIVING；保存原因及当前已上传照片快照，平台须重新上传各批收货照片才能再次提交确认。
+      parameters:
+        - $ref: '#/components/parameters/OrderNo'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: { $ref: '#/components/schemas/RejectionCommand' }
+      responses:
+        '200': { $ref: '#/components/responses/WorkflowResponse' }
+  /api/platform/v1/last-leg/overseas-procurements/{orderNo}/receipt-photos:
+    post:
+      summary: 驳回后替换指定批次的收货照片
+      description: 权限 platform:overseas-business:purchase:receive-overseas。仅客户驳回后的 RECEIVING；文件须为本单新上传图片，不接受驳回前的文件；仅替换照片，不改变实收数量及时间。
+      parameters:
+        - $ref: '#/components/parameters/OrderNo'
+        - $ref: '#/components/parameters/CustomerId'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: { $ref: '#/components/schemas/ReceiptPhotosCommand' }
+      responses:
+        '200': { $ref: '#/components/responses/WorkflowResponse' }
   /api/platform/v1/last-leg/overseas-procurements/{orderNo}/workflow:
     get:
       summary: 读取采购实收、库存和出库批次
@@ -43,7 +70,7 @@ paths:
   /api/platform/v1/last-leg/overseas-procurements/{orderNo}/request-confirmation:
     post:
       summary: 采购完成并请求客户确认
-      description: 权限 platform:overseas-business:purchase:receive-overseas；仅平台主体，必须指定目标客户 customerId。仅 RECEIVING 且已有实收；提交后不再追加收货。
+      description: 权限 platform:overseas-business:purchase:receive-overseas；仅平台主体，必须指定目标客户 customerId。仅 RECEIVING 且已有实收；客户驳回后必须替换各批旧照片。提交后不再追加收货。
       parameters:
         - $ref: '#/components/parameters/OrderNo'
         - $ref: '#/components/parameters/CustomerId'
@@ -265,6 +292,21 @@ components:
       uniqueItems: true
       items:
         $ref: '#/components/schemas/Id'
+    RejectionCommand:
+      allOf:
+        - $ref: '#/components/schemas/Command'
+        - type: object
+          required: [reason]
+          properties:
+            reason: {type: string, minLength: 1, maxLength: 1000}
+    ReceiptPhotosCommand:
+      allOf:
+        - $ref: '#/components/schemas/Command'
+        - type: object
+          required: [receiptId, fileIds]
+          properties:
+            receiptId: { $ref: '#/components/schemas/Id' }
+            fileIds: { $ref: '#/components/schemas/FileIds' }
     ReceiptCommand:
       allOf:
         - $ref: '#/components/schemas/Command'
@@ -331,6 +373,8 @@ components:
       required: [orderNo, version, status, receivedQuantity, stockQuantity, reservedQuantity, availableQuantity, receipts, outbounds, files]
       description: stockQuantity = receivedQuantity - 已完成出库数量；reservedQuantity 为未完成出库占用；availableQuantity = stockQuantity - reservedQuantity。主状态优先显示运输中批次，其次派送中；全部批次完成但仍有库存时回到已确认，无剩余库存才签收完成。
       properties:
+        rejectionReason: {type: string, nullable: true, description: 客户驳回原因}
+        photosNeedUpdate: {type: boolean, description: 存在尚未替换的被驳回照片}
         orderNo: {type: string}
         version: {type: integer, format: int64, minimum: 0}
         status: