For the complete documentation index, see llms.txt. This page is also available as Markdown.

出票完成通知

当出票完成且机票详情可用时发送的 webhook 事件。

💬 需要帮助? 如果遇到问题,请在帮助中心咨询 Eva,快速获取诊断建议。

咨询 Eva

当您需要订单的最终出票结果时,请使用此 webhook。

当您需要以下操作时,请从这里开始:

  • 检测出票已完成

  • 存储机票号码和航司 PNR

  • 触发出票后的客户或运营工作流程

常见问题

何时应依赖此 webhook?

将此 webhook 用作出票完成的近实时信号。

当您需要最终核实时,请使用订单查询。

此事件的主要业务含义是什么?

此事件表示 Atlas 已完成出票,且机票详情在负载中可用。

最重要的结果是订单可以从出票跟进状态转移到已出票处理状态。

触发条件

出票完成后,Atlas 发送 order.ticketed

您应该做什么

当您收到此事件时:

  • 将订单标记为已出票

  • 存储机票号码和航司 PNR

  • 更新面向旅客的行程详情

  • 如有需要,触发预订确认消息

推荐的处理方式

按以下顺序处理事件:

  1. 读取 type 并确认其为 order.ticketed

  2. data.orderNo 与您的内部预订进行匹配。

  3. 为每位旅客存储 ticketNosairlinePNRs

  4. 在检查通过后,将订单更新为已出票状态。

  5. 如果下游状态仍不清楚,请通过订单查询进行核对。

端点

POST 到您在 Atlas 注册的 webhook URL。

首先读取的字段

  • type

  • data.orderNo

  • data.orderStatus

  • data.paxTicketInfos[].ticketNos

  • data.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?