b450b512a2
- 添加 mipu-api 作为 git submodule (Claude Code Skill) - 迁移 API 文档源文件到 docs/ 目录统一维护 - 添加 Gitea Actions 工作流：tag推送自动打包docs并发布Release - Skill 运行时自动从 mipu-open Release 下载最新文档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
33 lines
2.6 KiB
Markdown
33 lines
2.6 KiB
Markdown
<!-- mipuyun-api-doc: flight-fare -->
|
||
# FlightFare
|
||
|
||
FlightFare 实体用于描述不同乘客类型（成人 / 儿童 / 婴儿）的费用构成，拆分基础票价与税费等明细项，同时包含去程和返程的价格、政策信息，字段与实际响应完全对应。
|
||
|
||
> **说明**：带 `rtn` 前缀的字段为回程字段，仅往返程有值。
|
||
|
||
| **参数名称** | **类型** | **示例值** | **说明** |
|
||
| --- | --- | --- | --- |
|
||
| fareBasis | String | | 去 fareBasis 信息（如有） |
|
||
| rtnFareBasis | String | | 回程 fareBasis 信息（如有） |
|
||
| fareFamily | String | "Lion Economy" | 去程票价舱/产品类型名称 |
|
||
| rtnFareFamily | String | "Lion Promo" | 回程票价舱/产品类型名称 |
|
||
| currency | String | "USD" | 币种编码，遵循 ISO 4217 标准（如 USD = 美元，CNY = 人民币） |
|
||
| adultFare | BigDecimal | 6115.00 | 去程成人票价（不含税） |
|
||
| rtnAdultFare | BigDecimal | 6100.00 | 回程成人票价（不含税） |
|
||
| adultTax | BigDecimal | 13714.00 | 去程成人税费 |
|
||
| rtnAdultTax | BigDecimal | 8540.00 | 回程成人税费 |
|
||
| childFare | BigDecimal | 0.00 | 去程儿童票价（不含税），儿童定义为 2-12 周岁 |
|
||
| rtnChildFare | BigDecimal | 0.00 | 回程儿童票价（不含税） |
|
||
| childTax | BigDecimal | 0.00 | 去程儿童税费 |
|
||
| rtnChildTax | BigDecimal | 0.00 | 回程儿童税费 |
|
||
| infantFare | BigDecimal | 0.00 | 去程婴儿票价（不含税），婴儿定义为 0-2 周岁（无独立座位） |
|
||
| rtnInfantFare | BigDecimal | 0.00 | 回程婴儿票价（不含税） |
|
||
| infantTax | BigDecimal | 0.00 | 去程婴儿税费 |
|
||
| rtnInfantTax | BigDecimal | 0.00 | 回程婴儿税费 |
|
||
| bookingCode | String | "Y,Y" | 去程舱位代码（如 Y、B、M、W 等），廉航领域不一定存在，可通过系统设置-参数设置-默认舱位编码指定默认值。<br>**格式说明**：<br>- 单程直飞：单个代码，如 `"Y"`<br>- 单程转机：逗号分隔多段，如 `"B,Y"` 表示第一段 B 舱，第二段 Y 舱 |
|
||
| rtnBookingCode | String | "Y,Y" | 回程舱位代码（如 Y、B、M、W 等），廉航领域不一定存在。<br>**格式说明**：同 bookingCode，单段为单个代码，多段用逗号分隔 |
|
||
| availableSeats | int | 7 | 去程剩余座位数 |
|
||
| rtnAvailableSeats | int | 2 | 回程剩余座位数 |
|
||
| flightPolicy | [FlightPolicy](08-04_flight-policy.md) | | 去程航班政策（包含去程免费行李额、退改规则等） |
|
||
| rtnFlightPolicy | [FlightPolicy](08-04_flight-policy.md) | | 回程航班政策（包含回程免费行李额、退改规则等） |
|