openapi: 3.0.3
info: { title: Delivery fee coverage sources, version: 1.0.0 }
paths:
  /internal/finance/v1/delivery-fee-coverage/sources:
    post:
      summary: 按实际客户及头程入仓单批量读取可引用的原费用版本
      description: 仅内部服务身份，Gateway不公开。只返回该客户、指定原入仓单、FIRSTLEG来源的已审核有效应收最新版本；AVAILABLE或SETTLED不代表自动涵盖任何尾程服务，服务范围由运营明确确认。查询不冻结资金、不变更账务、不新增收费。
      parameters:
        - { in: header, name: X-Internal-Service-Token, required: true, schema: { type: string } }
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [customerId, inboundIds]
              properties:
                customerId: { type: string, pattern: '^[1-9][0-9]*$' }
                inboundIds: { type: array, minItems: 1, maxItems: 2000, items: { type: string, pattern: '^[1-9][0-9]*$' } }
      responses:
        '200':
          description: 原费用不可变来源版本；没有符合记录返回空数组
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: { type: array, items: { $ref: '#/components/schemas/FeeSource' } }
        '400': { description: 请求字段无效 }
        '401': { description: 内部服务令牌无效 }
components:
  schemas:
    FeeSource:
      type: object
      properties:
        financeFeeId: { type: string }
        sourceFeeId: { type: string }
        sourceType: { type: string, enum: [INBOUND_FEE, CONTAINER_FEE] }
        sourceVersion: { type: integer }
        customerId: { type: string }
        sourceInboundId: { type: string }
        inboundCode: { type: string, nullable: true }
        feeItemCode: { type: string }
        feeItemName: { type: string }
        currency: { type: string }
        amount: { type: number }
        sourceHash: { type: string }
        status: { type: string, enum: [AVAILABLE, SETTLED] }