> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/api-wen-dang/product-guides/booking/booking-step-guides/create-order/hang-si-cheng-ji-ren-bi-tian-zi-duan-shuo-ming.md).

# 航司乘机人必填字段说明

了解填写要求，获取航司配置信息，一起让预订更顺畅。

{% hint style="info" %}
💬 **需要帮助？** 如果遇到问题，请在帮助中心咨询 Eva，快速获取诊断建议。

<a href="https://www.atriptech.com/" class="button primary" data-icon="comments">咨询 Eva</a>
{% endhint %}

{% hint style="info" %}
**最新更新 · 2026 年 11 月 12 日**

* 发布航司乘机人必填字段说明。
* 新增 `bookingRequirement.passenger`、Verify 返回示例、静态配置参考和 `605` 错误处理说明。

查看 [第 6 节“更新日志”](https://resources.atriptech.com/api-wen-dang/product-guides/booking/booking-step-guides/create-order/hang-si-cheng-ji-ren-bi-tian-zi-duan-shuo-ming#id-6.-更新日志) 获取完整记录。
{% endhint %}

这份说明帮助 travel agency 了解不同航司的乘机人信息要求，并介绍如何参考 Atlas 收集的配置，完成填写提示、预订前检查及问题处理。

为填写与校验提供帮助

Atlas 提供航班报价和履约服务，也会持续整理航司的乘机人信息要求，帮助 travel agency 更方便地准备填写页面和校验规则。航司要求可能随时调整，如发现配置与实际情况有差异，欢迎通过 eva 告诉我们，我们会协助核实并完善。

## 1. 字段及通用规则 <a href="#fields" id="fields"></a>

乘机人信息要求由航空公司决定。预订需要填写基础信息，并可能根据航司、路线、乘客类型及乘客国籍等条件，进一步要求出生日期、国籍或证件信息。姓名还可能受到长度限制。

| 信息类别 | 内容                    | 使用说明                                                                 |
| ---- | --------------------- | -------------------------------------------------------------------- |
| 基础信息 | 乘客类型、姓名、性别            | 对应 `passengerType`、`name`、`gender`。                                  |
| 出生日期 | 乘机人的出生日期              | 对应 `birthday`，按适用规则判断是否必填。                                           |
| 国籍   | 乘机人的国籍                | 对应 `nationality`，按适用规则判断是否必填。                                        |
| 证件信息 | 证件类型、证件号码、证件有效期、证件签发地 | 分别对应 `cardType`、`cardNum`、`cardExpired`、`cardIssuePlace`，动态接入时逐字段判断。 |
| 姓名长度 | 航司配置的姓名长度限制           | 可参考 `name.maxLength`。未配置表示 Atlas 尚未验证，不代表航空公司没有限制。                   |

填写要求除了与“国内”或“国际”有关，还可能受具体路线方向、乘客类型及国籍条件影响。接入时结合这些条件一起查看，会更容易找到适合当前预订的要求。

**给旅客的小提示：** 预订时是否需要提交证件信息，与旅行时需要携带哪些证件是两回事。即使出票时无需提交，仍建议提醒旅客查看航空公司的旅行证件要求。

## 2. Atlas 如何处理乘机人信息 <a href="#policy" id="policy"></a>

### 一起做好预订前的信息准备

| 参与方           | 协作方式                                     |
| ------------- | ---------------------------------------- |
| travel agency | 在旅客填写信息时提供提示，并在提交订单前完成相应检查，帮助旅客准确填写。     |
| Atlas         | 提供航班报价和履约服务，同时整理航司必填字段配置，为填写页面和校验规则提供参考。 |
| 航空公司          | 在接收预订时，按其实际要求处理乘机人信息并返回预订结果。             |

在生单环节，Atlas 会将 travel agency 提交的乘机人信息原样传给航空公司，不对航司的乘机人必填及格式要求进行前置校验和拦截。

这样处理，是希望让预订尽可能按照航空公司的实际要求完成。由于参考配置可能与航司最新要求存在时间差，Atlas 不会仅依据这些配置提前拦截订单，以免影响原本可以完成的预订。提交前的信息提示和校验，通常由 travel agency 在旅客填写环节完成，Atlas 收集的配置可以为这一环节提供帮助。

### 如果需要补充或调整信息

如果航空公司因乘机人信息缺失或格式错误无法接受预订，Atlas 会取消订单，返回错误码 **605**，并附带错误信息，方便 travel agency 检查和调整。例如：

```json
{
  "errorCode": "605",
  "errorMessage": "Incorrect passenger information"
}
```

收到这类返回后，可以结合错误信息检查已提交的内容，补充或调整后再按正常流程重新发起预订。如果暂时无法判断需要调整哪一项，也欢迎通过 eva 联系 Atlas 协助核查。

为方便 travel agency 在填写环节准备所需信息，Atlas 也整理了航司必填字段配置，供接入和日常维护时参考。

## 3. 如何获取 Atlas 收集的航司必填信息 <a href="#reference" id="reference"></a>

如果 travel agency 希望参考 Atlas 收集的航司乘机人必填信息，可以通过以下两种方式获取，并根据自身填写页面的实现方式选择使用。

### 方式一：动态读取 Verify 接口

如果乘机人填写页面依赖上游供应商返回的信息动态决定必填字段，可以读取 Verify 响应中的 `bookingRequirement.passenger`。

| 属性                | 含义                                      |
| ----------------- | --------------------------------------- |
| `type`            | 字段的数据类型，例如 `string` 或 `int`。            |
| `required: true`  | 该字段要求必填。                                |
| `required: false` | 该字段不要求必填。                               |
| `description`     | 额外说明；示例中的 `null` 表示未提供额外说明。             |
| `maxLength`       | 字段的长度限制配置。姓名长度未配置表示 Atlas 尚未验证，不能视为无限制。 |

### Verify 返回示例 <a href="#verify-example" id="verify-example"></a>

以下为真实返回示例中的 `bookingRequirement` 片段，不是完整的 Verify 响应：

```json
{
  "bookingRequirement": {
    "passenger": {
      "birthday": {
        "type": "string",
        "required": true,
        "description": null,
        "maxLength": null
      },
      "cardIssuePlace": {
        "type": "string",
        "required": false,
        "description": null,
        "maxLength": null
      },
      "cardNum": {
        "type": "string",
        "required": false,
        "description": null,
        "maxLength": null
      },
      "passengerType": {
        "type": "int",
        "required": true,
        "description": null,
        "maxLength": null
      },
      "gender": {
        "type": "string",
        "required": true,
        "description": null,
        "maxLength": null
      },
      "nationality": {
        "type": "string",
        "required": false,
        "description": null,
        "maxLength": null
      },
      "cardExpired": {
        "type": "string",
        "required": false,
        "description": null,
        "maxLength": null
      },
      "name": {
        "type": "string",
        "required": true,
        "description": null,
        "maxLength": "32/32"
      },
      "cardType": {
        "type": "string",
        "required": false,
        "description": null,
        "maxLength": null
      }
    }
  }
}
```

该示例要求填写**乘客类型、姓名、性别和出生日期**；国籍及各证件字段不要求必填。姓名的长度配置为 `"32/32"`。实际接入时，可以按当前 Verify 返回的字段要求设置填写页面。

**如果 `bookingRequirement` 为空：** 表示 Atlas 尚未核实到对应的必填信息，而非当前预订没有必填要求。正常情况下不应出现这种情况；如果遇到，欢迎通过 eva 反馈，我们会协助核查。

### 方式二：自行维护规则，参考 Atlas 配置页面

如果乘机人填写页面的必填规则由 travel agency 自行维护，可以通过以下页面查看 Atlas 收集的航司配置信息，作为规则维护参考：

* [查看航司乘机人字段配置](https://resources-doc.atriptech.com/airline-passenger-requirements-zh.html)

配置页面支持按航司及字段要求筛选，并可导出当前筛选结果或全部航司的 Excel。

以下说明可以帮助你更方便地阅读和使用这些配置：

* **通用规则。** 表示未对出发和到达国家/地区作限定的配置，与国际航班规则是不同概念。
* **路线方向。** `MY→ID` 与 `ID→MY` 的要求可能不同，建议按实际出发和到达方向查看。
* **`ALL` 表示未限定。** `ALL→ALL` 表示未限定出发和到达国家/地区。
* **逗号分隔的路线是备选条件。** 同一行中的路线按“或”理解；该行的乘客类型和乘客国籍条件仍需同时满足。
* **“乘客国籍条件”和“国籍是否必填”不同。** 前者决定规则适用于哪些旅客，后者决定是否需要提交国籍字段。
* **配置更新。** 航司要求可能随时调整，参考配置与实际要求之间也可能存在时间差。如遇差异，以航空公司的实际要求为准，Atlas 会积极核查并完善配置。

## 4. 航司特殊情况说明 <a href="#exceptions" id="exceptions"></a>

下面列出几种接入时可能遇到的情况，帮助理解不同航司的要求。示例来自现有配置，更多适用条件可以在配置页面查看。

| 差异类型     | 配置中的例子                                 | 填写建议                         |
| -------- | -------------------------------------- | ---------------------------- |
| 乘客国籍不同   | SG、QP、IX 的印度国内配置含印度籍旅客专用规则。            | 同时查看路线及乘客国籍条件。               |
| 国内要求可能更多 | YQ 的墨西哥国内、JA 的哥伦比亚国内配置，比各自通用规则多要求证件信息。 | 可以结合具体航司和路线查看，国内航班也可能需要更多信息。 |
| 路线方向不同   | 亚航系部分配置中，`ID→TH` 与 `TH→ID` 的要求不同。      | 去程与回程可以分别确认，保留实际出发和到达方向。     |
| 出生日期要求不同 | 6E、IX 的当前配置不要求出生日期。                    | 可以根据各航司的具体要求设置填写项。           |

如果在使用中发现配置与航司实际要求不一致，欢迎通过 eva 告诉我们，Atlas 会协助核实并修复。

## 5. FAQ <a href="#faq" id="faq"></a>

<details>

<summary>01为什么 Atlas 不在生单前拦截缺失或格式错误的乘机人信息？</summary>

Atlas 提供航班报价和履约服务。travel agency 在旅客填写信息的环节提供提示，并完成提交前的检查；Atlas 整理的字段配置，可以为这一环节提供参考。

考虑到航司要求可能变化，参考配置与实际要求之间也可能存在时间差，Atlas 会将提交的信息原样交给航空公司处理，而不依据参考配置进行生单前的乘机人必填及格式拦截。这样可以尽量避免配置差异影响原本可以完成的预订。

如果航空公司因信息缺失或格式错误无法接受预订，Atlas 会取消订单，并返回 `605` 及错误信息，方便 travel agency 补充或调整。需要帮助时，也可以通过 eva 联系我们。

</details>

<details>

<summary>02如何确定当前预订需要填写哪些乘机人信息？</summary>

动态接入时，读取 Verify 响应中的 `bookingRequirement.passenger`，根据各字段的 `required` 值决定是否必填，并参考 `type`、`description` 和 `maxLength`。

自行维护填写规则时，可以参考配置页面，并结合航司、路线方向、乘客类型及乘客国籍等适用条件维护规则。如有不明确的地方，欢迎通过 eva 联系 Atlas 协助确认。

</details>

<details>

<summary>03bookingRequirement 为空，是否代表没有额外的必填要求？</summary>

为空表示 Atlas 尚未核实到对应的必填信息，而非当前预订没有必填要求。

正常情况下不应出现这种情况。如果遇到，欢迎通过 eva 反馈给 Atlas，我们会协助核查。

</details>

<details>

<summary>04通用规则是否代表国际航班规则？</summary>

通用规则与国际航班规则是不同概念。这里的通用规则表示未对出发和到达国家/地区作限定的配置。

特定航线、路线方向、乘客类型或国籍条件可能对应特殊规则。特殊规则既可能增加必填字段，也可能减少必填字段。

</details>

<details>

<summary>05同时匹配通用规则和特殊规则时，应该如何处理？</summary>

动态接入时，可根据当前 Verify 响应中的 `bookingRequirement` 设置填写要求。

参考静态配置页面时，建议结合航司、路线方向、乘客类型及乘客国籍条件，找到适合当前预订的要求。若不确定某项配置应如何使用，欢迎通过 eva 联系 Atlas 协助确认。

</details>

<details>

<summary>06姓名长度显示“未配置”，是否代表没有长度限制？</summary>

“未配置”表示 Atlas 暂时尚未验证该航司的姓名长度要求，实际限制仍需要结合航司要求确认。

已配置时，可以参考对应的 `name.maxLength`；如果需要进一步了解长度配置的含义或实际限制，欢迎通过 eva 联系 Atlas 协助核实。

</details>

<details>

<summary>07已满足配置页面列出的要求，为什么仍可能返回 605？</summary>

航司的信息要求可能调整，Atlas 的参考配置有时还需要进一步同步，因此会出现填写内容符合当前配置，但航司仍提示需要补充或调整的情况。

遇到这类情况，可以先按航空公司的实际要求补充或调整信息，也欢迎通过 eva 把相关返回发给 Atlas。我们会协助定位，并积极核查、更新相应配置。

除了必填项，也可以一起检查姓名长度及相关字段格式，便于更快找到需要调整的地方。

</details>

<details>

<summary>08收到 605 后，应该如何处理？</summary>

对于因乘机人信息缺失或格式错误导致的预订失败，Atlas 会取消订单，并返回 `errorCode: "605"`，错误信息可能为 `Incorrect passenger information`。

可以结合错误信息检查已提交的内容，包括必填字段、姓名长度及相关字段格式。补充或调整后，再按正常流程重新发起预订。

如果暂时无法定位问题，欢迎通过 eva 提供相关订单或请求标识、航司、路线、Verify 返回片段及错误返回，我们会协助排查。

</details>

<details>

<summary>09预订时不要求提交证件，是否意味着旅客不需要携带证件？</summary>

这里的“不要求提交”，仅指该预订或出票流程无需提交对应的证件信息。

旅客旅行和乘机时仍需要按照航空公司的要求准备证件，建议在填写或出行提示中提醒旅客确认。

</details>

<details>

<summary>10如何反馈配置与航空公司实际要求不一致的问题？</summary>

欢迎通过 eva 把相关情况告诉我们，Atlas 会协助核查并积极完善配置。

提供航司、路线、相关订单或请求标识、Verify 返回的要求及实际错误信息，可以帮助我们更快定位问题。

</details>

**有问题，欢迎通过** [**eva**](https://www.atriptech.com/) **与我们交流**

附上航司、路线、订单或请求标识及相关返回信息，可以帮助我们更快核查和完善配置。

## 6. 更新日志

**本页更新记录**

本节记录本页发布及后续内容变更。接口请求、响应和航司实际要求仍以最新接口返回及航司规则为准。

**2026-11-12**

**发布新文档**

* 发布航司乘机人必填字段说明，帮助 travel agency 准备填写提示和预订前检查。
* 说明 `bookingRequirement.passenger` 的读取方式，并提供 Verify 返回示例。
* 说明静态配置页面的适用条件，包括路线方向、乘客类型和国籍条件。
* 提供 `605` 错误处理、姓名长度和旅行证件边界等常见问题。

**说明**

* 本页为新增文档，不代表本次调整了接口请求、响应或航司乘机人信息处理规则。
