优化

2026-08-30 17:02:19 +08:00
parent 0aa77327d5
commit ca9e7b60e8
40 changed files with 1471 additions and 6 deletions
@@ -3,6 +3,17 @@ info:
  title: Lastleg Overseas Business API
  version: 1.0.0
 paths:
+  /api/platform/v1/last-leg/inventory/inbound-code-relationships/{inboundCode}:
+    get:
+      summary: 按入仓码查询海外关系摘要
+      description: 仅平台且要求 lastleg:inventory:list；不接收customerId，不跨国内数据库查询，未命中返回found=false和空关系。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { in: path, name: inboundCode, required: true, schema: { type: string, minLength: 1, maxLength: 128 } }
+      responses:
+        '200': { description: 海外订单、计划、收货、托盘和库存业务关系, content: { application/json: { schema: { $ref: '#/components/schemas/InboundCodeRelationshipApiResponse' } } } }
+        '403': { description: 非平台身份或缺少库存查看权限 }
+        '409': { description: 入仓码跨客户或快照关系不一致 }
  /api/pda/v1/last-leg/receiving-containers/candidates:
    get:
      summary: 查询当前客户待签收柜号
@@ -643,6 +654,57 @@ paths:
      responses: { '200': { description: 统一 ApiResponse 包装的换标单详情 }, '409': { description: 非法状态迁移或关联尾程单缺失 } }
 components:
  schemas:
+    InboundCodeRelationship:
+      type: object
+      required: [inboundCode, found, taillegOrders, inboundPlans, palletCodes, inventory]
+      properties:
+        inboundCode: { type: string }
+        found: { type: boolean }
+        customer: { $ref: '#/components/schemas/InboundCodeRelationshipCustomer', nullable: true }
+        overseasWarehouse: { $ref: '#/components/schemas/InboundCodeRelationshipWarehouse', nullable: true }
+        overseasReceivingStatus: { type: string, nullable: true }
+        taillegOrders: { type: array, items: { $ref: '#/components/schemas/InboundCodeRelationshipOrder' } }
+        inboundPlans: { type: array, items: { $ref: '#/components/schemas/InboundCodeRelationshipPlan' } }
+        palletCodes: { type: array, uniqueItems: true, items: { type: string } }
+        inventory: { type: array, items: { $ref: '#/components/schemas/InboundCodeRelationshipInventorySku' } }
+    InboundCodeRelationshipCustomer:
+      type: object
+      required: [customerId]
+      properties:
+        customerId: { type: string, description: 字符串业务隔离标识，禁止按JavaScript number处理 }
+        customerName: { type: string, nullable: true }
+    InboundCodeRelationshipWarehouse:
+      type: object
+      properties:
+        warehouseId: { type: string, nullable: true, description: 字符串共享仓库ID，禁止按JavaScript number处理 }
+        warehouseCode: { type: string, nullable: true }
+        warehouseName: { type: string, nullable: true }
+    InboundCodeRelationshipOrder:
+      type: object
+      required: [orderNo]
+      properties:
+        orderNo: { type: string }
+        orderStatus: { type: string, nullable: true }
+    InboundCodeRelationshipPlan:
+      type: object
+      required: [planNo]
+      properties:
+        planNo: { type: string }
+        planStatus: { type: string, nullable: true }
+        receivingStatus: { type: string, nullable: true }
+    InboundCodeRelationshipInventorySku:
+      type: object
+      required: [skuCode, packageCount]
+      properties:
+        skuCode: { type: string }
+        productNameZh: { type: string, nullable: true }
+        productNameEn: { type: string, nullable: true }
+        packageCount: { type: integer, format: int64, minimum: 0 }
+    InboundCodeRelationshipApiResponse:
+      allOf:
+        - { $ref: '#/components/schemas/ReceivingApiResponseBase' }
+        - type: object
+          properties: { data: { $ref: '#/components/schemas/InboundCodeRelationship' } }
    FbaTransferDestination:
      type: object
      required: [warehouseId, warehouseCode, warehouseName]