出票完成通知
当出票完成且机票详情可用时发送的 webhook 事件。
💬 需要帮助？ 如果遇到问题，请在帮助中心咨询 Eva，快速获取诊断建议。
当您需要订单的最终出票结果时，请使用此 webhook。
当您需要以下操作时，请从这里开始：
检测出票已完成
存储机票号码和航司 PNR
触发出票后的客户或运营工作流程
常见问题
何时应依赖此 webhook？
将此 webhook 用作出票完成的近实时信号。
当您需要最终核实时，请使用订单查询。
此事件的主要业务含义是什么？
此事件表示 Atlas 已完成出票，且机票详情在负载中可用。
最重要的结果是订单可以从出票跟进状态转移到已出票处理状态。
触发条件
出票完成后，Atlas 发送 order.ticketed。
您应该做什么
当您收到此事件时：
将订单标记为已出票
存储机票号码和航司 PNR
更新面向旅客的行程详情
如有需要，触发预订确认消息
推荐的处理方式
按以下顺序处理事件：
读取
type并确认其为order.ticketed。将
data.orderNo与您的内部预订进行匹配。为每位旅客存储
ticketNos和airlinePNRs。在检查通过后，将订单更新为已出票状态。
如果下游状态仍不清楚，请通过订单查询进行核对。
端点
POST 到您在 Atlas 注册的 webhook URL。
首先读取的字段
typedata.orderNodata.orderStatusdata.paxTicketInfos[].ticketNosdata.paxTicketInfos[].airlinePNRs
订单状态值
首先读取 data.orderStatus：
0: 未支付1: 出票中2: 已出票-3: 已取消（因请求信息问题导致预订失败）
典型负载
注意事项
orderStatus=2表示已出票status是内部字段，不应驱动业务逻辑使用订单号和机票号码进行下游核对
如果您的系统需要额外的确认步骤，请使用订单查询
此事件的最佳用途
将此事件用于：
订单履行更新
旅客确认流程
中台或财务核对输入
此事件不应取代的内容
此事件不应取代：
用于最终状态检查的订单查询
您自己的预订到客户核对
当更广泛的订单状态仍不清楚时的事件跟进
cid
类型: 字符串
必填: 是
描述: 用于跟踪请求的唯一客户端标识符。
默认值: 无
示例:
"XXXXXXX"
data
类型: Object
必填: 是
描述: 包含订单相关信息。
默认值: 无
示例:
data.orderNo
类型: 字符串
必填: 是
描述: 与机票购买关联的唯一订单号。
默认值: 无
示例:
"TESTL20230922153224323"
data.orderStatus
类型: 整数
必填: 是
描述: 订单状态。
有效值:
0: 未支付
1: 出票中
2: 已出票
-3: 已取消（因请求信息问题导致预订失败）
默认值: 无
示例:
2
data.paxTicketInfos
类型: 对象数组
必填: 是
描述: 包含旅客及其关联机票信息的详情。
默认值: 无
data.paxTicketInfos[]
类型: Object
必填: 是
描述: 单个旅客的机票详情。
示例:
data.paxTicketInfos[].name
类型: 字符串
必填: 是
描述: 旅客姓名，采用标准航司格式（姓/名 中间名）。
默认值: 无
示例:
"zhang/lisi"
data.paxTicketInfos[].passengerType
类型: 整数
必填: 是
描述: 旅客类型。
有效值：
0= 成人1= 儿童2= 婴儿
默认值: 无
示例:
1
data.paxTicketInfos[].birthday
类型: 字符串
必填: 是
描述: 旅客出生日期，格式为
YYYYMMDD。默认值: 无
示例:
"20160202"
data.paxTicketInfos[].gender
类型: 字符串
必填: 是
描述: 旅客性别。 有效值：
M表示男性F表示女性
默认值: 无
示例:
"F"
data.paxTicketInfos[].cardNum
类型: 字符串
必填: 是
描述: 身份证件号码（护照或身份证）。
默认值: 无
示例:
"123458"
data.paxTicketInfos[].cardType
类型: 字符串
必填: 是
描述: 身份证件类型。
有效值:
PP - 护照
GA - 港澳通行证（中国大陆居民）
TW - 台湾通行证（中国大陆居民）
TB - 台胞证（台湾居民）
HY - 国际海员证
默认值: 无
示例:
"PP"
data.paxTicketInfos[].cardIssuePlace
类型: 字符串
必填: 是
描述: 签发身份证件的国家或机构。
默认值: 无
示例:
"CN"
data.paxTicketInfos[].cardExpired
类型: 字符串
必填: 是
描述: 身份证件过期日期，格式为
YYYYMMDD。必须是有效的未来日期。默认值: 无
示例:
"20400101"
data.paxTicketInfos[].nationality
类型: 字符串
必填: 是
描述: 旅客国籍，使用国家代码（ISO 3166-1 alpha-2）。
默认值: 无
示例:
"CN"
data.paxTicketInfos[].ticketNos
类型: 字符串数组
必填: 是
描述: 与该旅客关联的已出票机票号码列表。
默认值: 无
示例:
["S30814"]
data.paxTicketInfos[].airlinePNRs
类型: 字符串数组
必填: 是
描述: 旅客姓名记录（PNR）代码列表。
默认值: 无
示例:
["S30814"]
data.paxTicketInfos[].ancillaries
类型: 数组
必填: 是
描述: 与该旅客关联的辅助服务列表（例如，额外行李、座位选择）。
默认值:
[]示例:
[]
status
类型: 整数
必填: 是
描述: 指示响应状态。
默认值: 无
示例:
-1
type
类型: 字符串
必填: 是
描述: 指定响应消息的类型。
默认值: 无
示例:
"order.ticketed"
相关页面
Last updated
Was this helpful?