优化

2026-08-24 17:51:11 +08:00
parent 4893542ec4
commit f4a1ec92de
3 changed files with 449 additions and 0 deletions
@@ -441,6 +441,133 @@ components:
        cartonMark: { type: string, minLength: 1 }
        palletCode: { type: string, minLength: 1 }
        idempotencyKey: { type: string, minLength: 1, maxLength: 255 }
+    ReceivingApiResponseBase:
+      type: object
+      required: [code, message, timestamp]
+      properties:
+        code: { type: string, example: '00000' }
+        message: { type: string }
+        requestId: { type: string, nullable: true }
+        traceId: { type: string, nullable: true }
+        timestamp: { type: string, format: date-time }
+    ReceivingInbound:
+      type: object
+      required: [inboundCode, destinationType, plannedPalletCount, totalPackages, receivedPackages, pendingPackages]
+      properties:
+        inboundCode: { type: string }
+        destinationType: { type: string, enum: [FBA, OVERSEAS] }
+        destinationWarehouseId: { type: string, nullable: true }
+        destinationWarehouseCode: { type: string, nullable: true }
+        destinationWarehouseName: { type: string, nullable: true }
+        fbaWarehouseCode: { type: string, nullable: true }
+        plannedPalletCount: { type: integer }
+        totalPackages: { type: integer }
+        receivedPackages: { type: integer }
+        pendingPackages: { type: integer }
+    ReceivingCandidate:
+      type: object
+      required: [containerNo, status, planCount, inboundCodeCount, totalPackages, receivedPackages, currentAccount]
+      properties:
+        containerNo: { type: string }
+        status: { type: string, enum: [WAIT_SIGN, SIGNED, RECEIVING, COMPLETED] }
+        planCount: { type: integer }
+        inboundCodeCount: { type: integer }
+        totalPackages: { type: integer }
+        receivedPackages: { type: integer }
+        currentAccount: { type: boolean }
+    ReceivingSession:
+      type: object
+      required: [containerNo, status, version, photoFileIds, totalPackages, receivedPackages, pendingPackages, inbounds]
+      properties:
+        containerNo: { type: string }
+        status: { type: string, enum: [WAIT_SIGN, SIGNED, RECEIVING, COMPLETED] }
+        operatorName: { type: string, nullable: true }
+        version: { type: integer }
+        photoFileIds: { type: array, items: { type: integer, format: int64 } }
+        preparedAt: { type: string, format: date-time, nullable: true }
+        signedAt: { type: string, format: date-time, nullable: true }
+        receivingAt: { type: string, format: date-time, nullable: true }
+        completedAt: { type: string, format: date-time, nullable: true }
+        totalPackages: { type: integer }
+        receivedPackages: { type: integer }
+        pendingPackages: { type: integer }
+        inbounds: { type: array, items: { $ref: '#/components/schemas/ReceivingInbound' } }
+    ReceivingPhoto:
+      type: object
+      required: [fileId, fileName, contentType, sizeBytes]
+      properties:
+        fileId: { type: integer, format: int64 }
+        fileName: { type: string }
+        contentType: { type: string }
+        sizeBytes: { type: integer, format: int64 }
+    ReceivingCartonResolved:
+      allOf:
+        - { $ref: '#/components/schemas/ReceivingInbound' }
+        - type: object
+          required: [cartonMark]
+          properties:
+            cartonMark: { type: string }
+            skuCode: { type: string, nullable: true }
+    ReceivingPalletResolved:
+      type: object
+      required: [palletCode, warehouseId, status, inboundCode, destinationType, compatible]
+      properties:
+        palletCode: { type: string }
+        warehouseId: { type: integer, format: int64 }
+        status: { type: string }
+        fbaWarehouseCode: { type: string, nullable: true }
+        inboundCode: { type: string }
+        destinationType: { type: string, enum: [FBA, OVERSEAS] }
+        compatible: { type: boolean }
+    ReceivingReceipt:
+      type: object
+      required: [result, containerNo, inboundCode, destinationType, palletCode, acceptedPackages, receivedPackages, pendingPackages, sessionStatus]
+      properties:
+        result: { type: string }
+        containerNo: { type: string }
+        inboundCode: { type: string }
+        destinationType: { type: string, enum: [FBA, OVERSEAS] }
+        palletCode: { type: string }
+        acceptedPackages: { type: integer }
+        receivedPackages: { type: integer }
+        pendingPackages: { type: integer }
+        sessionStatus: { type: string, enum: [SIGNED, RECEIVING] }
+    ReceivingCandidateListApiResponse:
+      allOf:
+        - { $ref: '#/components/schemas/ReceivingApiResponseBase' }
+        - type: object
+          required: [data]
+          properties: { data: { type: array, items: { $ref: '#/components/schemas/ReceivingCandidate' } } }
+    ReceivingSessionApiResponse:
+      allOf:
+        - { $ref: '#/components/schemas/ReceivingApiResponseBase' }
+        - type: object
+          required: [data]
+          properties: { data: { $ref: '#/components/schemas/ReceivingSession' } }
+    ReceivingPhotoApiResponse:
+      allOf:
+        - { $ref: '#/components/schemas/ReceivingApiResponseBase' }
+        - type: object
+          required: [data]
+          properties: { data: { $ref: '#/components/schemas/ReceivingPhoto' } }
+    ReceivingCartonResolvedApiResponse:
+      allOf:
+        - { $ref: '#/components/schemas/ReceivingApiResponseBase' }
+        - type: object
+          required: [data]
+          properties: { data: { $ref: '#/components/schemas/ReceivingCartonResolved' } }
+    ReceivingPalletResolvedApiResponse:
+      allOf:
+        - { $ref: '#/components/schemas/ReceivingApiResponseBase' }
+        - type: object
+          required: [data]
+          properties: { data: { $ref: '#/components/schemas/ReceivingPalletResolved' } }
+    ReceivingReceiptApiResponse:
+      allOf:
+        - { $ref: '#/components/schemas/ReceivingApiResponseBase' }
+        - type: object
+          required: [data]
+          properties: { data: { $ref: '#/components/schemas/ReceivingReceipt' } }
    SmartDispatchCandidate:
      type: object
      properties: