mipu-open/docs/08-06_fee-items.md

<!-- mipuyun-api-doc: fee-items -->
# feeItems 实体定义

该实体用于拆分航班预订费用，字段与最新响应数据完全对齐，同时补充业务含义说明：

### **字段结构**

```plaintext
feeItems
├── amount (总金额)
├── currency (货币代码)
├── fare (票价)
│   ├── amount (票价总金额)
│   ├── name (费用名称)
│   ├── remark (费用备注)
│   └── passengers (按乘机人拆分)
│       └── 每个乘客的票价明细
├── tax (税费)
│   ├── amount (税费总金额)
│   ├── name (费用名称)
│   ├── remark (费用备注)
│   ├── passengers (按乘机人拆分)
│   │   └── 每个乘客的税费明细
│   │       └── fees (税费细项)
│   │           └── 每个税费的明细
│   └── fees (税费总细项)
│       └── 每个税费的明细
├── cabinBaggage (手提行李)
│   ├── amount (手提行李总金额)
│   ├── name (费用名称)
│   ├── remark (费用备注)
│   └── passengers (按乘机人拆分)
│       └── 每个乘客的手提行李费用明细
├── checkedBaggage (托运行李)
│   ├── amount (托运行李总金额)
│   ├── name (费用名称)
│   ├── remark (费用备注)
│   └── passengers (按乘机人拆分)
│       └── 每个乘客的托运行李费用明细
├── seat (座位)
│   ├── amount (座位总金额)
│   ├── name (费用名称)
│   ├── remark (费用备注)
│   └── passengers (按乘机人拆分)
│       └── 每个乘客的座位费用明细
├── payment (支付手续费)
│   ├── amount (支付手续费总金额)
│   ├── name (费用名称)
│   └── remark (费用备注)
└── other (其他额外费用)
    ├── amount (其他额外费用总金额)
    ├── name (费用名称)

```

| 字段名 | 数据类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| totalPrice | Decimal | "850.00" | 总金额：航班预订的全部费用合计，单位与 currency 一致 |
| currency | String | "CNY" | 货币代码：标识费用的货币类型（如 CNY 为人民币、USD 为美元） |
| ticketPrice | Object | {"amount":"200.00","name":"票价",...} | 票价对象：包含票价总金额、费用名称、备注及可选的乘机人拆分明细（PassengerFee 数组） |
| tax | Object | {"amount":"250.00","name":"税",...} | 税费对象：包含税费总金额、费用名称、备注，可选乘机人拆分明细（PassengerFee 数组）和税费细项（FeeDetail 数组） |
| cabinBaggage | Object | {"amount":"50.00","name":"手提行李",...} | 手提行李费用对象：包含总金额、费用名称、备注及可选的乘机人拆分明细（PassengerFee 数组），可选字段 |
| checkedBaggage | Object | {"amount":"150.00","name":"托运行李",...} | 托运行李费用对象：包含总金额、费用名称、备注及可选的乘机人拆分明细（PassengerFee 数组），可选字段 |
| seat | Object | {"amount":"100.00","name":"座位",...} | 座位费用对象：包含总金额、费用名称、备注及可选的乘机人拆分明细（PassengerFee 数组），可选字段 |
| payment | Object | {"amount":"50.00","name":"支付手续费",...} | 支付手续费对象：包含总金额、费用名称、备注，无乘机人拆分，可选字段 |
| other | Object | {"amount":"0.00","name":"其他费用",...} | 其他额外费用对象：包含总金额、费用名称、备注，无乘机人拆分，可选字段 |

## 嵌套实体定义

### PassengerFee（乘机人费用明细）

| 字段名 | 数据类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| amount | Decimal | "100.00" | 乘机人对应费用金额：单个乘客在该费用类型下的应付金额 |
| name | String | "willow/yang" | 乘机人姓名：对应乘客的姓名标识 |
| remark | String | "成人票价" | 备注：说明该乘客费用的相关信息（如乘客类型、费用用途） |
| fees | Array[FeeDetail] | [{"amount":"100.00","name":"机场税",...}] | 税费细项数组：仅税费对象的乘机人明细中可选，包含该乘客的具体税费拆分，可选字段 |

### FeeDetail（费用细项明细）

| 字段名 | 数据类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| amount | Decimal | "170.00" | 细项金额：单个费用细项的总金额或乘机人对应金额 |
| name | String | "机场税" | 细项名称：描述费用细项的类型（如机场税、燃油附加费） |
| remark | String | "机场税" | 备注：补充说明费用细项的相关信息，与名称语义一致 |
| code | String | - | 费用细项编码：唯一标识该费用细项类型，可选字段 |

### **响应示例**

```json
{
  "success": true,
  "feeItems": {
    "totalPrice": "850.00",
    "currency": "CNY",
    "ticketPrice": {
      "amount": "200.00",
      "name": "票价",
      "remark": "票价",
      "passengers": [
        {
          "amount": "100.00",
          "name": "willow/yang",
          "remark": "成人票价"
        },
        {
          "amount": "100.00",
          "name": "jasen/yang",
          "remark": "成人票价"
        }
      ]
    },
    "tax": {
      "amount": "250.00",
      "name": "税",
      "remark": "税费",
      "passengers": [
        {
          "amount": "150.00",
          "name": "willow/yang",
          "remark": "成人税价",
          "fees": [
            {
              "amount": "100.00",
              "name": "机场税",
              "remark": "机场税"
            },
            {
              "amount": "50.00",
              "name": "燃油附加费",
              "remark": "燃油附加费"
            }
          ]
        },
        {
          "amount": "100.00",
          "name": "jasen/yang",
          "remark": "成人税价",
          "fees": [
            {
              "amount": "70.00",
              "name": "机场税",
              "remark": "机场税"
            },
            {
              "amount": "30.00",
              "name": "燃油附加费",
              "remark": "燃油附加费"
            }
          ]
        }
      ],
      "fees": [
        {
          "amount": "170.00",
          "name": "机场税",
          "remark": "机场税"
        },
        {
          "amount": "80.00",
          "name": "燃油附加费",
          "remark": "燃油附加费"
        }
      ]
    },
    "cabinBaggage": {
      "amount": "50.00",
      "name": "手提行李",
      "remark": "手提行李费",
      "passengers": [
        {
          "amount": "25.00",
          "name": "willow/yang",
          "remark": "手提行李费"
        },
        {
          "amount": "25.00",
          "name": "jasen/yang",
          "remark": "手提行李费"
        }
      ]
    },
    "checkedBaggage": {
      "amount": "150.00",
      "name": "托运行李",
      "remark": "托运行李费",
      "passengers": [
        {
          "amount": "75.00",
          "name": "willow/yang",
          "remark": "托运行李费"
        },
        {
          "amount": "75.00",
          "name": "jasen/yang",
          "remark": "托运行李费"
        }
      ]
    },
    "seat": {
      "amount": "100.00",
      "name": "座位",
      "remark": "选座费",
      "passengers": [
        {
          "amount": "50.00",
          "name": "willow/yang",
          "remark": "选座费"
        },
        {
          "amount": "50.00",
          "name": "jasen/yang",
          "remark": "选座费"
        }
      ]
    },
    "payment": {
      "amount": "50.00",
      "name": "支付手续费",
      "remark": "支付手续费"
    },
    "other": {
      "amount": "0.00",
      "name": "其他费用",
      "remark": "其他费用"
    }
  }
}
```