> 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/pai-zhang-yu-zhi-chi/errors-handing/yan-jia-xia-dan-yu-chu-piao-cuo-wu.md).

# 验价、下单与出票错误

{% hint style="info" %}
遇到 API 接入问题时，可登录 [Eva](https://www.atriptech.com/) 寻求帮助。
{% endhint %}

当搜索成功后、最终出票前的流程报错时，使用这个页面。

### 验价阶段错误码

#### `200` Illegal routing identifier

`routingIdentifier` 与有效搜索结果不匹配。

**处理建议**

* Use the latest identifier from search
* Do not modify the value

#### `202` Routing identifier expired

该标识已过期。

**处理建议**

* Run search again
* Use the new `routingIdentifier`

#### `206` / `207` No flights or target flight does not exist

搜索后库存发生变化。

**处理建议**

* Start from search again

#### `210` / `211` Fare family sold out or not found

舱位或票价产品已不可用。

**处理建议**

* Search again and re-select a valid offer

### 下单阶段错误码

#### `300` Invalid session information

`sessionId` 不正确。

**处理建议**

* Use the `sessionId` returned by verify

#### `301` Session does not exist or timed out

验价会话已过期。

**处理建议**

* If verify is still recent, repeat verify
* Otherwise start from search

#### `214` Unsupported or invalid seat availability request

选座请求不满足调用前提。

**常见原因**

* 只传了航班信息，没有有效 `sessionId` 或 `offerId`
* 使用了已失效、错误或不匹配当前交易链路的 `sessionId`
* 使用了已失效、错误或不匹配当前交易链路的 `offerId`

**处理建议**

* 使用 `verify.do` 返回的最新 `sessionId`
* 或使用 `getOffers.do` 返回的最新 `offerId`
* 不要仅凭航班信息直接调用 `seatAvailability.do`

#### `307` Illegal booking request parameters

预订请求参数不符合要求。

`getLuggage.do` 虽然按航段返回行李选项，但联程行李校验按方向执行。

**常见原因**

* `passengers` 字段缺失，或格式不正确
* 联系人、证件或乘客字段不符合航司要求
* 同一方向的联程航班选择了不一致的托运行李方案
* 同一方向下只为部分中转航段加购了托运行李

**处理建议**

* 只使用当前 `verify`、`getOffers` 或 `getLuggage` 返回的最新数据
* 对联程航班，保持同一方向全部航段的行李规格一致
* 去程和回程可分别选择不同方案

#### `308` Price changed

验价后到建单前价格发生变化。

**处理建议**

* Restart from search or verify
* Reconfirm current price before booking

#### `309` Ancillary not found

附加服务 `productCode` 无效或已失效。

**处理建议**

* Re-read ancillary options from verify
* Use returned `productCode` values only

#### `320` The requested seats were not found or they are already occupied

所选座位在下单时已不可用。

这类场景的最终处理结果，取决于 `ifSeatOccupied`。

**处理建议**

* 确认是否在 `order.do` 传入 `ifSeatOccupied`
* 确认座位 `productCode` 来自当前有效交易上下文
* 如果未启用自动处理，重新选座后再提交订单

#### `312` / `315` Too many seats booked or not enough seats

库存变化，或请求座位数超过可用数量。

**处理建议**

* Reduce seats or restart from search

#### `318` Duplicate booking

同乘客同航班的订单可能已存在。

**处理建议**

* Query existing orders before retrying

### 出票阶段错误码

#### `602` / `603` Flight not found or sold out

支付后票价或库存失效。

**处理建议**

* Start a new booking flow

#### `609` Contact email is blocked by airline

航司拒绝了提交的联系邮箱。

**处理建议**

* Use another email
* Or use Atlas-generated contact email flow

#### `613` Payment rejected by airline risk control

航司风控拦截了出票。

**处理建议**

* Try another card
* Or retry with deposit mode

#### `616` 3DS authentication required

Atlas 在该流程里无法完成 3DS 验证。

**处理建议**

* Use a non-3DS card
* Or pay with deposit mode

#### `617` Insufficient balance

出票时 Atlas 预存余额不足。

**处理建议**

* Top up the account and retry

### 相关页面

* [验价](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/yan-jia.md)
* [创建订单](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/chuang-jian-ding-dan.md)
* [支付与出票](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/zhi-fu-yu-chu-piao.md)
* [查询订单](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/cha-xun-ding-dan.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing/yan-jia-xia-dan-yu-chu-piao-cuo-wu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.