提交

2026-10-16 16:53:32 +08:00
parent fee0268391
commit 6211d4ae37
18 changed files with 222 additions and 65 deletions
@@ -7,7 +7,7 @@ paths:
  /api/merchant/v1/last-leg/warehouse-transfers/{transferNo}/increase-forecast-cartons:
    post:
      summary: 测量完成前增加预报箱数并补充箱唛
-      description: 客户身份及transfer:create权限；仅外来货物待审核或待PDA测量可用，按原预报快照追加既有SKU的箱数，原箱唛与件数不变。补箱及PDA完工锁定同一订单；成功后PDA刷新继续清点，无新增表字段。
+      description: 客户身份及transfer:create权限；仅外来货物待审核或待PDA测量可用，按原预报快照追加整单箱数，不绑定SKU，实际箱内SKU由PDA清点确定，原箱唛与件数不变。补箱及PDA完工锁定同一订单；成功后PDA刷新继续清点。
      parameters:
        - {name: transferNo, in: path, required: true, schema: {type: string}}
      requestBody:
@@ -16,14 +16,33 @@ paths:
          application/json:
            schema:
              type: object
-              required: [expectedPackageCount, transferItemId, expectedItemPackageCount, packageCount]
+              required: [expectedPackageCount, packageCount]
              properties:
                expectedPackageCount: {type: integer, minimum: 1, maximum: 5000, description: 修改前整单预报箱数}
-                transferItemId: {type: integer, format: int64, description: 当前单既有SKU明细}
-                expectedItemPackageCount: {type: integer, minimum: 0, maximum: 5000, description: 修改前该SKU预报箱数}
-                packageCount: {type: integer, minimum: 1, maximum: 5000, description: 增加后该SKU预报箱数}
+                packageCount: {type: integer, minimum: 1, maximum: 5000, description: 增加后整单预报箱数}
      responses:
        '200': {description: 返回补箱后的转运详情，相同原快照和目标箱数重试不重复生成箱唛}
+  /api/platform/v1/last-leg/warehouse-transfers/{transferNo}/increase-forecast-cartons:
+    post:
+      summary: 平台在测量完成前增加整单预报箱数
+      description: 平台身份及 platform:overseas-warehouse:warehouse-transfer:approve 权限；指定目标客户，沿用客户补箱的状态、并发及幂等规则，不改变SKU预报件数。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: transferNo, in: path, required: true, schema: { type: string } }
+        - { name: customerId, in: query, required: true, schema: { type: string } }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [expectedPackageCount, packageCount]
+              properties:
+                expectedPackageCount: { type: integer, minimum: 1, maximum: 5000 }
+                packageCount: { type: integer, minimum: 1, maximum: 5000 }
+      responses:
+        '200': { description: 补箱后的转运详情 }
+        '409': { description: 已完成测量或原预报箱数过期 }
  /api/pda/v1/last-leg/warehouse-transfers/{transferNo}/carton-label:
    get:
      summary: PDA读取转运箱标签
@@ -1796,6 +1815,31 @@ paths:
        - { name: itemId, in: query, required: false, schema: { type: integer, format: int64 } }
      requestBody: { required: true, content: { multipart/form-data: { schema: { type: object, required: [file], properties: { file: { type: string, format: binary } } } } } }
      responses: { '200': { description: 更新后的换标详情 }, '403': { description: 缺少换标文件维护权限 }, '409': { description: 状态或归属冲突 } }
+  /api/merchant/v1/last-leg/relabel-applications/{relabelNo}/files/{fileId}/download:
+    get:
+      summary: 客户查看或下载申请已绑定的贴标文件
+      description: 权限 merchant:overseas-warehouse:relabel:list；按登录客户隔离，并校验总文件或明细文件归属。响应禁止缓存。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: relabelNo, in: path, required: true, schema: { type: string } }
+        - { name: fileId, in: path, required: true, schema: { type: integer, format: int64, minimum: 1 } }
+        - { name: scope, in: query, required: true, schema: { type: string, enum: [TOTAL, CARTON_TOTAL, SKU_TOTAL, ITEM] } }
+        - { name: itemId, in: query, required: false, schema: { type: integer, format: int64 } }
+      responses:
+        '200': { description: 贴标 PDF, content: { application/pdf: { schema: { type: string, format: binary } } } }
+        '403': { description: 缺少客户查询权限 }
+        '404': { description: 申请或文件不存在或不属于当前客户 }
+  /api/platform/v1/last-leg/relabel-applications/{relabelNo}/shipping-label/{fileId}/download:
+    get:
+      summary: 平台查看客户上传的换标面单
+      description: 权限 platform:overseas-warehouse:relabel-order:list；校验平台身份及申请的面单绑定关系。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: relabelNo, in: path, required: true, schema: { type: string } }
+        - { name: fileId, in: path, required: true, schema: { type: integer, format: int64, minimum: 1 } }
+      responses:
+        '200': { description: 面单文件, content: { application/pdf: { schema: { type: string, format: binary } }, image/jpeg: { schema: { type: string, format: binary } }, image/png: { schema: { type: string, format: binary } } } }
+        '404': { description: 文件未绑定当前申请 }
  /api/merchant/v1/last-leg/relabel-applications/{relabelNo}/shipping-label/{fileId}/download:
    get:
      summary: 下载换标快递面单