客户运费计费

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

@@ -183,7 +183,11 @@ paths:
       parameters:
         - {name: orderId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
       responses:
-        '200': {description: 成功或业务失败，按响应体 code 判断}
+        '200':
+          description: 成功；publishedFeeDetail 是后台和客户共同读取的同一条已发布入库运费明细，latestFee 仅为兼容保留的计费快照
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/MerchantInboundBillingEnvelope'}
         '403': {description: 非当前客户或无订单查看权限}
   /api/platform/v1/inbounds/{inboundId}/measurements/exception-release:
     post:
@@ -255,6 +259,63 @@ components:
       in: query
       schema: {type: integer, format: int64, minimum: 1, maximum: 200, default: 20}
   schemas:
+    MerchantInboundBillingEnvelope:
+      type: object
+      properties:
+        code: {type: string, example: '200'}
+        message: {type: string}
+        data:
+          type: object
+          properties:
+            inbound: {type: object, description: 入库单详情}
+            measurementSummary: {type: object, description: 测量汇总}
+            measurementItems: {type: array, items: {type: object}}
+            weightResults: {type: array, items: {type: object}}
+            measurementImages: {type: array, items: {type: object}}
+            weightImages: {type: array, items: {type: object}}
+            billingBasis: {type: object, description: 计费依据}
+            latestFee: {type: object, nullable: true, description: 兼容保留的最新计费快照}
+            publishedFeeDetail:
+              allOf:
+                - {$ref: '#/components/schemas/PublishedFreightFeeDetail'}
+              nullable: true
+              description: 后台与客户共用的已发布FBA头程运费应收明细
+    PublishedFreightFeeDetail:
+      type: object
+      description: 审核发布后绑定入库单的FBA头程运费应收明细
+      properties:
+        id: {type: integer, format: int64, description: 入库费用明细ID}
+        inboundId: {type: integer, format: int64}
+        inboundCode: {type: string}
+        sourceFeeId: {type: integer, format: int64, description: 来源计费快照ID}
+        sourceFeeVersion: {type: integer}
+        sourceFeeNo: {type: string}
+        direction: {type: string, enum: [RECEIVABLE]}
+        businessDate: {type: string, format: date}
+        customerId: {type: integer, format: int64}
+        customerName: {type: string}
+        invoiceTitle: {type: string, nullable: true}
+        channelCode: {type: string, nullable: true}
+        channelName: {type: string, nullable: true}
+        destinationCode: {type: string, nullable: true}
+        destinationName: {type: string, nullable: true}
+        packageCount: {type: integer, nullable: true}
+        actualGrossWeightKg: {type: number, format: double, nullable: true}
+        actualVolumeCbm: {type: number, format: double, nullable: true}
+        volumeWeightKg: {type: number, format: double, nullable: true}
+        chargeableWeightKg: {type: number, format: double, nullable: true}
+        chargeableVolumeCbm: {type: number, format: double, nullable: true}
+        chargeableQuantity: {type: number, format: double}
+        chargeUnit: {type: string, enum: [KG, CBM]}
+        feeTypeName: {type: string, example: FBA头程运费}
+        unitPrice: {type: number, format: double}
+        currency: {type: string, example: CNY}
+        amount: {type: number, format: double, description: 客户应收金额}
+        reviewStatus: {type: string, enum: [APPROVED]}
+        publicationStatus: {type: string, enum: [PUBLISHED]}
+        publishedAt: {type: string, format: date-time}
+        inboundedAt: {type: string, format: date-time, nullable: true}
+        settlementIncluded: {type: boolean, example: true}
     InboundOrderPageEnvelope:
       type: object
       properties: