错误处理

Atlas 使用以下 枚举 来存储 错误代码 和相应的 错误消息。

常规错误代码

代码	描述	解释	解决方案
-1	常见错误		Atlas 将调查并添加相关错误代码。
100	缺少必需的请求数据	缺少必填参数。	检查必填参数。
900	未授权访问	凭据不正确或账户状态不正确或尝试访问其他客户的数据。	检查凭据。如果错误仍然存在，请联系您的客户经理。
901	非法请求数据	检查请求格式。	请求格式应为 Json。
902	访问被拒绝	凭据不正确或账户状态不正确或您正在尝试访问其他客户的数据。	检查凭据。如果错误仍然存在，请联系您的客户经理。
9999	系统错误	这是意外错误。	Atlas 将调查并添加相关错误代码。

搜索错误代码

代码	描述	解释	解决方案
101	非法请求数据	检查请求格式。	格式应为 Json。
102	非法请求参数: {0}	请查看以下消息。
	成人数量不应少于 1	成人数量为 "0"。	添加成人乘客类型。
	最多允许 9 名乘客	乘客总数超过 9 名。	将乘客总数减少到最多 9 名。
	未知城市代码	城市代码不正确。	检查并更正城市代码。
	fromCity 或 fromAirport 不能为空	需要搜索票价的出发地是空的。	添加城市或机场代码。
	toCity 或 toAirport 不能为空	需要搜索票价的目的地是空的。	添加城市或机场代码。
	fromDate 不能为空	旅行开始日期为空。	添加旅行开始日期。
	retDate 不应为空	对于 tripType 为 2 的票价，返回日期为空。	添加返回日期。
	无效的 fromDate 格式	日期格式不正确。	将格式更改为 YYYYMMDD。
103	不支持往返搜索	只能搜索单程行程。	检查您的账户是否有相关限制，请联系您的客户经理。
104	不允许往返搜索	只返回单程票价。客户不能在搜索中使用 "2" 作为 "tripType"。	检查您的账户是否有相关限制，请联系您的客户经理。
105	城市对不在客户往返白名单中	此城市对尚未被加入白名单。	检查您的账户是否有相关限制，请联系您的客户经理。
106	不允许搜索		检查您的账户是否有相关限制，请联系您的客户经理。
107	余额不足	账户余额低于约定的阈值。	优先为账户充值。
108	航线受限 / 系统限制	航空公司有航班和报价，但 Atlas 出于某些原因关闭了销售。原因可能是 1) 销售被手动关闭 2) 系统检测到售罄风险 3) 附近航班有禁令。	稍后尝试预订。
109	搜索次数超过限制	每日搜索次数已超过允许的限制。	检查您的账户是否有相关限制。
110	并发请求过多	QPS（每秒查询数）高于允许的限制。	如果您的业务需要更多资源，请联系您的客户经理。
111	不允许实时搜索	此功能未为您的账户激活。	如果您需要此服务，请联系您的客户经理。
112	超时	搜索请求已超时。	更多详情请参考常见问题解答 --> Atlas API 通用信息。
113	航空公司正在维护	航空公司在 Atlas 处于"非活动"或"维护"状态。这不一定意味着航空公司网站本身有问题。	等待状态更改为"活动"。
114	无可用航班	"这可能发生在：- 航空公司在该日期没有飞往所搜索城市对的航班。"	检查航空公司网站，查看该日期是否有航班运营。
115	意外结果	系统错误。	重试。如果错误持续存在，请提交服务请求。
116	搜索数据未捕获	在 Atlas 端存储搜索数据时报告错误。	如果此错误不是持续报告，您可以尝试重试。极如果错误持续存在，则需要联系客户经理。
123	请求过多但付费订单太少	由于搜索请求过多而付费订单很少，服务已被阻止。	仅搜索所需的城市对。
124	不支持的结算货币	结算货币与 Atlas 接受的货币不同。	将货币更改为 Atlas 接受的结算货币。
126	requestId 不存在或已结束。	使用了不正确的 requestId 或 requestId 不再有效。	检查 requestId 或进行新的智能搜索并使用新的 requestId。
127	搜索超时	搜索已超时。	进行新的搜索。

验证错误代码

代码	描述	解释	解决方案
200	非法路由标识符	"routingIdentifier" 标签的信息与搜索响应中收到的路由标识符不匹配。	检查路由标识符并使用正确的 "routingIdentifier" 重新发送验证请求。
201	无效路由	航空公司有航班和报价，但 Atlas 出于某些原因关闭了销售。原因可能是 1) 销售被手动关闭 2) 系统检测到售罄风险 3) 附近航班有禁令。	稍后尝试预订。
202	路由标识符过期	"routingIdentifier" 的有效期为 6 小时。如果在此时间段后使用 "routingIdentifier"，则会显示此错误。	再次进行"搜索"并使用新的 "routingIdentifier"。
203	航空公司关闭	航空公司不再营业。
205	超时	Atlas 端为验证响应设置了超时时间。验证响应花费了更长时间。	更多详情请参考常见问题解答 --> Atlas API 通用信息。
206	无航班	从航空公司端找不到所需的航班，可能是由于航班已售罄。	再次进行搜索。
207	目标航班不存在	从航空公司端找不到所需的航班，可能是由于航班极已售罄	再次进行搜索。
208	舱位已更改	预订舱位已更改。	再次进行搜索。
209	座位强验证失败	在价格验证期间已启用座位验证。	联系您的客户经理。
210	票价系列已售罄	航班或票价系列在航空公司不再可用。	再次进行搜索并重新预订。
211	航班或票价系列未找到	航班或票价系列在航空公司不再可用。	再次进行搜索并重新预订。
212	非法请求参数	某些参数缺失或多余。	检查验证请求。
299	验证失败	这是 Atlas 需要采取操作的错误。在一些不可控的情况下，如网络问题、升级和重启，可能会发生 299 错误。可能航空公司不可极用或 Atlas 端存在挑战。Atlas 需要在内部处理这些错误。	重试验证。如果收到相同的错误，则从搜索开始。如果错误仍然存在，请升级到 Atlas。

订单错误代码

代码	描述	解释	解决方案
300	无效的会话信息	"sessionID" 不正确。	检查会话 ID 并输入正确的会话 ID。
301	会话不存在或超时	"sessionID" 的有效期为 2 小时。如果在此时间段后使用 "sessionID"，则会显示此错误	检查会话 ID 并输入正确的会话 ID。如果时间超过 2 小时，则从验证阶段开始（如果验证响应时间少于 6 小时）
302	目标航班不存在	"在验证和预订之间，航班已售罄。这也可能是由于预订的乘客数量所致。预订时的乘客数量和验证时的乘客数量可能不同。创建预订时，价格会根据实际预订的乘客数量进行验证。	再次进行搜索并重新预订。
303	航空公司关闭	航空公司已停止存在或不再运营。
304	验证失败	在一些不可控的情况下，如网络问题、升级和重启，可能会发生 304 错误，但不多。如果有很多 304 错误，可能航空公司不可用或 Atlas 端存在技术问题。	如果此错误持续重复，请联系您的客户经理。
305	无效路由	生成订单时，系统发现航班由于各种原因不再销售，例如 1) L2B 2) 系统识别到航班可能有售罄风险 3) 航空公司的销售已关闭	再次进行搜索并重新预订。
306	舱位已更改	预订舱位已更改。	再次进行搜索。
307	非法预订请求参数:	一个请求参数有问题。请检查消息。	检查错误消息。更正并重新提交预订。
	passengers->name	乘客姓名似乎不正确。	检查乘客姓名，更正并重新提交预订。
	passengers->passengerType	乘客类型不正确。	检查乘客姓名，更正并重新提交预订。
	passengers->birthday	出生日期格式不正确或缺失。	更正格式并重新提交预订。
	passengers->gender	性别不正确或缺失。	更正或添加信息并重新提交预订。
	passengers->cardExpired	身份证过期日期格式不正确或缺失。	更正或添加信息并重新提交预订。
	额外行李超过限制。最大允许: 1	附加行李数量超过允许限制。	更正行李数量并重新提交预订。
	附加服务与航段数量不匹配(入境)	航段数量和附加服务不匹配。	检查附加服务和航段并重新提交预订。
	XXX 字段无效	字段未正确输入。	检查字段并重新提交请求。
308	价格已更改		重新生成预订或创建全新的预订。
309	未找到附加服务	输入了不正确的附加产品代码。	检查并输入正确的附加产品代码。
310	不允许婴儿		创建没有婴儿乘客类型的新预订。婴儿乘客可以通过航空公司网站"离线"添加。
311	座位强验证失败	检查验证响应以获取允许的最大座位数。	根据验证响应调整乘客数量并创建新预订。
312	预订座位过多	预订的乘客数量超过了当前航班剩余（或允许）的座位数。	重新预订行程。
313	票价系列已售罄		创建新预订。
314	无法重新生成订单: 原始订单正在出票或已出票		检查具有相同乘客和航班详情的订单。
315	座位不足	座位已售罄	重新预订行程
316	超时	航空公司端出现超时错误。请查看常见问题解答（通用信息）以获取有关超时的更多详细信息。	重新预订行程。
317	航空公司预订不成功	航空公司端发生错误。	重新预订行程。
318	重复预订		检查是否存在具有相同乘客详情和航班号的预订。确认后，忽略此预订。
320	请求的座位未找到或已被占用。		重新预订座位并提交新订单。
324	航空公司系统问题		稍后重试。如果问题持续存在，请联系我们的运营团队。
326	您在航空公司端的账户余额不足	BYOA 客户在相关航空公司持有的账户中的保证金余额无效。	充值余额，然后在余额更新后重试。

支付错误代码

代码	描述	解释	解决方案
400	非法请求参数	请求参数非法，错误场景包括 1) 无效的 VCC 有效期 2) 缺少 VCC 持卡人信息	重新生成现有订单或创建新预订并更新 VCC 详细信息。
401	支付超时	预订支付晚于支付截止时间发起。默认支付截止时间为创建订单后 30 分钟。	重新生成现有订单或创建新预订。
402	订单状态不支持支付	订单状态可能为"出票中"或"已出票"，支付已完成。	检查订单是否已支付。如果"是"，请不要发送支付请求。
403	不支持的支付方法	此航空公司不支持该支付方法。	更改为替代支付方法。
404	订单已支付	订单已支付。	检查订单是否已支付。如果"是"，请不要发送支付请求。
406	支付操作正在进行中	之前的支付请求仍在处理中。	等待航空公司 PNR 在 PNR 详情响应中收到。
407	一些错误消息指示乘客信息不正确	未提交乘客的某些必填元素。	检查信息并更正后重新提交。
408	乘客不能单独登机	此订单中仅预订了儿童乘客。	创建新订单并为儿童乘客添加成人乘客。
409	额外行李与航班航段不匹配	额外行李的"productCode"与此航班可用的产品代码不匹配。	检查"productCode"并使用正确的代码更新。
410	使用正确的格式"XXXX-XXXXXXXX"作为联系电话。例如: 0001-87291810, 0086-13928109091	联系信息格式不正确。	检查联系信息并确认其符合所需格式。
411	通用支付错误	检查您的账户时发生错误。例如，"余额不足"。	检查余额或根据错误中收到的消息。
413	不支持此卡。	使用 MoR 支付时，传入的卡类型不在 Atlas 支持范围内。	更换卡片。
414	卡不匹配。	卡类型与生成订单时传入的 (cardType) 不一致。	更换卡片以使其与创建订单时传入的卡类型一致。
415	用户未确认订单	与 FR 集成时，需要在创建订单 (order.do) 之后和支付 (pay.do) 之前调用 orderCommit.do API。

座位可用性代码

代码	描述	解释	解决方案
214	会话 ID 无效或过期	会话 ID 无效或过期。	发送新的座位可用性请求
216	座位选择失败	无法获取座位可用性信息。	稍后重试。如果问题持续存在，请提交服务请求。
217	未知错误	未知错误
218	航空公司目前不支持座位选择	此刻此航空公司的座位选择不可用	检查与您的客户经理何时将支持此航空公司的座位可用性

机票错误代码

代码	描述	解释	解决方案
601	票价已更改
602	未找到航班	航班在航空公司平台上不再可用。	创建新预订。
603	航班已售罄	航班已售罄，没有可用座位。这在支付完成后但机票签发前发生。	创建新预订。
604	直通卡支付失败	航空公司不接受 VCC。	尝试使用不同的卡进行支付。
605	乘客信息不正确	"passengers" 数组中的信息不正确。	检查乘客详情并在更正后重新提交。
606	航班信息已更新	在搜索和预订之间，航空公司对同一航班号进行了日程变更。	再次从搜索开始。
607	座位已售罄		再次从搜索开始。
608	重复预订		检查是否存在具有相同乘客详情和航班号的预订。确认后，忽略此预订。
609	联系邮箱被航空公司阻止	根据其政策，航空公司已阻止您的邮箱地址。	使用不同的邮箱地址创建新预订 OR 授权 Atlas 使用 Atlas 的邮箱地址。请参阅"Atlas API 订单"常见问题解答以获取更多详细信息。
611	PNR 已取消或过期	PNR 已被航空公司取消或支付超过时间限制。	再次从搜索开始。
613	被航空公司风险控制拒绝	根据其业务规则，航空公司已阻止订单。	尝试使用不同的 VCC 进行支付。如果问题持续存在，请使用"保证金"进行支付。
614	年龄错误	儿童乘客的年龄不正确。	检查年龄并重新提交预订。
615	支付完成但未能从航空公司获取 PNR 号码	有时对于 VCC 支付，航空公司未能响应，因此未收到 PNR。在这种情况下，Atlas 将手动与航空公司处理并获取 PNR 并将其添加到预订中。
616	3DS 认证	使用的卡需要 3DS 认证。Atlas 目前不支持此功能。	使用没有 3DS 认证的不同卡 OR 通过保证金支付模式支付。
617	余额不足	保证金余额低于最低阈值。	检查您的余额并优先充值。
618	行李重量无法与航空公司匹配	行李重量不包括航空公司拥有的选项之一。	与 Atlas 运营团队核实
619	缺少支付信息	pay.do 请求中的某些信息缺失/不正确。	检查 pay.do 请求并重新提交。
620	异常往返票价类型	往返票价被航空公司限制为基础票价，不能与其他票价类型组合。	仅预订单程行程或为每个方向创建 1 个预订。
621	不支持婴儿	Atlas 不支持此航空公司的"婴儿"乘客类型。	创建没有婴儿乘客的新预订。
623	卡余额不足/卡消费限制	提供的 VCC 余额不足/极卡消费限制。	请使用具有足够卡余额的不同 VCC 支付。
624	暂时不支持往返	此刻此航空公司的往返功能不受支持	预订 2 个单程作为单独订单。
625	ffp 手动签发。	目前不支持常旅客，只能手动处理。
626	当前订单中有未支付的服务。	航空公司识别出此 PNR 下有未支付的交易，导致后续业务操作失败。	为任何未支付的订单付款
627	当前订单不支持出票后附加购买。	此订单不允许出票后附加服务。	移除附加服务并创建新订单。
628	出票后附加购买订单的航班信息与原始航班不匹配。	航班详情不正确。	检查航班详情并创建新订单。
631	行李票价已更改。	履行时行李价格已更改。	从验证开始过程。
632	行李票价已更改。	由于航空公司风险控制，出票失败。	从验证开始过程。如果问题仍然存在，请联系我们的运营团队。
633	支付被航空公司拒绝。	由于航空公司风险控制，支付被拒绝。	使用"保证金"作为支付模式并重试。
634	航空公司系统问题		创建新订单。如果问题持续存在，请联系我们的运营团队。
699	系统问题。		稍后重试。如果问题持续存在，请联系支持。

查询订单错误代码

代码	描述	解释	解决方案
701	识别出多订单，请添加额外参数后再次请求	已识别出具有相同记录定位器的多个订单。	添加额外参数并重试。
702	airlinePNR 和 carrier 是订单检索的必填项，请检查并再次请求	记录定位器和航空公司代码是请求中的必填项。	添加提到的参数并重试。
703	未找到订单，请检查参数	订单号似乎不正确。	检查订单号并重试。
704	参数不匹配，请检查并重试	输入的参数不正确。	检查参数，更正后重试。
705	超时	响应已超时	稍后重试。如果问题持续存在，请联系支持。
800	订单不存在	相关订单不存在。	请重新检查订单号并重试。

退款报价错误代码

代码	描述	解释	解决方案
801	订单不存在	输入了不正确的订单号。	检查订单号并输入正确的订单号。
802	儿童不能单独旅行	仅 ADT 乘客不能退款。CHD 乘客也应一起退款。	请求包括儿童乘客在内的完整订单退款。
803	乘客已提交乘客和/或航段的退款	输入了不正确的订单号。	检查订单号并输入正确的订单号。
807	乘客不存在。	输入了不正确的乘客姓名。	检查乘客姓名并在需要时更正。
809	订单未出票。	此订单的出票正在处理中或未支付。	等待订单出票或为此订单付款。
810	非法请求参数: xxx	一个请求参数不正确。	检查请求并更正所需参数。
811	未输入完整行程。请输入完整行程并重试。	这可能由于各种原因发生。	检查下面列出的任何场景是否适用并采取相关操作。
		对于往返行程，需要退款完整机票。	如果机票完全未使用，请输入整个行程的详细信息并重试。
		对于联程航班，两个航段需要一起退款。	检查请求中是否两个航段都可用并重试。
		旅程中一个航段已飞行。	与航空公司核实。Atlas 不支持"部分"飞行行程的退款。
812	无法将乘客 xxx 与订单匹配。	乘客姓名与订单不匹配。	检查乘客姓名并重新提交请求。
815	未找到机票。		检查机票号并重试。
824	不支持附加订单退款。请提供原始订单极号。	仅允许主订单退款。	检查并确认订单号是否为原始订单号。
902	访问被拒绝。
8041	航段不存在。	请求中的一个航段不存在。	检查航段并仅提供该退款请求的航段。

退款提交错误代码

代码	描述	解释	解决方案
801	订单不存在	输入了不正确的订单号。	检查订单号并输入正确的订单号。
802	儿童不能单独旅行	仅 ADT 乘客不能退款。CHD 乘客也应一起退款。	请求包括儿童乘客在内的完整订单退款。
803	乘客已提交乘客和/或航段的退款	输入了不正确的订单号。	检查订单号并输入正确的订单号。
805	RefundOfferId 已过期。	"refundOfferId" 已过期。	发送新的退款请求以获取最新的 "refundOfferId"。
807	乘客不存在。	输入了不正确的乘客姓名。	检查乘客姓名并在需要时更正。
809	订单未出票。	此订单的出票正在处理中或未支付。	等待订单出票或为此订单付款。
810	非法请求参数: xxx	一个请求参数不正确。	检查请求并更正所需参数。
811	未输入完整行程。请输入完整行程并重试。	这可能由于各种原因发生。	检查下面列出的任何场景是否适用并采取相关行动。
		对于往返行程，需要退款完整机票。	如果机票完全未使用，请输入整个行程的详细信息并重试。
		对于联程航班，两个航段需要一起退款。	检查请求中是否两个航段都可用并重试。
		旅程中一个航段已飞行。	与航空公司核实。Atlas 不支持"部分"飞行行程的退款。
812	无法将乘客 xxx 与订单匹配。	乘客姓名与订单不匹配。	检查乘客姓名并重新提交请求。
814	退款提交正在进行中。请等待。	退款流程正在进行中。请稍等片刻。	稍后重试。如果问题持续重复，请联系您的客户经理。
815	票号未找到。		检查票号并重试。
816	退款请求已提交。	退款请求已经提交。	无需操作。您可以使用 queryRefundOrders.do API 请求检查退款状态。
817	Atlas 退款已应用。	退款请求已经提交。	无需操作。您可以使用 queryRefundOrders.do API 请求检查退款状态。
818	退款索赔已应用。	退款索赔已经提交。	无需操作。您可以使用 queryRefundOrders.do API 请求检查退款状态。
820	票状态已使用。	航段已经飞行。	检查航段是否已飞行。如果航段未飞行，请联系我们的运营团队。
821	超过票退款截止日期。	退款提交已在退款截止日期之后进行。	如有任何疑问，请联系我们的运营团队。
822	超过票作废截止日期。	作废提交已在截止日期之后进行。	如有任何疑问，请联系我们的运营团队。
823	未作废所有乘客。
824	附加服务订单不支持退款。请提供原始订单号。	仅允许对主订单进行退款。	检查并确认订单号是否为原始订单。
902	访问被拒绝。
905	提交过于频繁，请稍后再试。
8041	航段不存在。	请求中的某个航段不存在。	检查航段并仅提供该退款请求的航段。

退款查询错误代码

代码	描述	解释	解决方案
801	订单不存在	输入的订单号不正确。	检查订单号并输入正确的订单号。
810	非法请求参数: xxx	请求参数之一不正确。	检查请求并更正所需参数。
902	访问被拒绝。

预订后附加服务搜索错误代码

代码	描述	解释	解决方案
117	该订单不允许购买行李，因为订单状态不是已出票状态	票尚未出票。	等待状态变为"已出票"，然后搜索附加服务。
118	Atlas 目前不支持该航空公司的座位或行李服务		向航空公司查询附加行李服务或向 Atlas 提交服务请求。
119	包含婴儿的订单不支持行李或座位选择	预订中有婴儿乘客。	直接向航空公司预订附加行李或向 Atlas 提交服务请求。
120	该航班的行李或座位选择已关闭	航空公司不再接受该航班的附加服务。	向航空公司查询或向 Atlas 提交服务请求。

预订后附加服务订单错误代码

代码	描述	解释	解决方案
501	不允许添加购买	不允许为该订单添加附加服务。	向航空公司查询或向 Atlas 提交服务请求。
502	价格已上涨，订单创建失败。请重新搜索。	从搜索附加服务订单到现在的价格发生了变化。	重新搜索附加服务订单。
503	行李选择不正确	请检查以下消息。
	重复添加相同类型的行李。	每位乘客每个航段只能选择一件行李。	移除重复的相同类型行李。
	行程中不同航段的行李不一致。	对于某些航空公司，行程中每个航段的行李必须相同。	使此行程中每个航段的行李保持一致。
	产品代码与航段搜索结果不匹配。	产品代码必须与航段搜索结果匹配。	使用搜索结果中的正确产品代码。
504	不允许添加额外行李。原始订单中已存在附加行李	Atlas 只允许附加行李服务一次。	直接向航空公司预订附加行李或向 Atlas 提交服务请求。
505	不允许添加额外行李。已作为出票后附加服务预订了行李	Atlas 只允许附加行李服务一次。	直接向航空公司预订附加行李或向 Atlas 提交服务请求。
506	包含婴儿的订单不支持座位选择	预订中有婴儿乘客。	直接向航空公司预订附加行李或座位，或向 Atlas 提交服务请求。

错误示例

214：会话 ID 无效或已过期

请求：

{
    "sessionId": "49871954-6aaa-44fa-b768-1a590d21be08"
}

响应：

{
    "cabins": null,
    "status": 214,
    "msg": "会话 ID 无效或已过期"
}

216: 座位选择失败

请求：

{
    "mockError": "mockSeatError", 
    "sessionId": "31f1c47c-1fbb-4cfd-8620-49e73ab26f60"
}

响应：

{
    "cabins": null,
    "status": 216,
    "msg": "座位选择失败"
}

217: 未知错误

系统回退异常，通常不会触发

响应：

{
    "cabins": null,
    "status": 217,
    "msg": "未知错误"
}