出票完成通知

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

当你需要拿到订单最终出票结果时，使用这个 webhook。

触发时机

出票完成后，Atlas 会发送 order.ticketed。

收到后建议处理

收到事件后，建议：

• 把订单标记为已出票

• 保存票号和航司 PNR

• 更新面向旅客的行程信息

• 按需触发预订确认通知

推送方式

Atlas 会向你已注册的 webhook 地址发起 POST 请求。

建议优先读取的字段

• type

• data.orderNo

• data.orderStatus

• data.paxTicketInfos[].ticketNos

• data.paxTicketInfos[].airlinePNRs

典型载荷

{
  "cid": "XXXXXXX",
  "data": {
    "orderNo": "TESTL20230922153224323",
    "orderStatus": 2,
    "paxTicketInfos": [
      {
        "name": "zhang/lisi",
        "passengerType": 1,
        "ticketNos": ["S30814"],
        "airlinePNRs": ["S30814"],
        "ancillaries": []
      }
    ]
  },
  "status": -1,
  "type": "order.ticketed"
}

说明

• orderStatus=2 表示已出票

• status 是内部字段，不要作为业务判断依据

• 对账时优先使用订单号和票号

字段说明

cid

• 类型： String

• 是否必填： 是

• 说明： 用于跟踪请求的客户唯一标识。

• 默认值： 无

• 示例： "XXXXXXX"

data

• 类型： Object

• 是否必填： 是

• 说明： 包含订单相关信息。

• 默认值： 无

• 示例：

{
  "orderNo": "TESTL20230922153224323",
  "orderStatus": 2,
  "paxTicketInfos": [ ... ]
}

data.orderNo

• 类型： String

• 是否必填： 是

• 说明： 订单唯一编号。

• 默认值： 无

• 示例： "TESTL20230922153224323"

data.orderStatus

• 类型： Integer

• 是否必填： 是

• 说明： 订单状态。

• 可选值：

  • 0：未支付

  • 1：出票中

  • 2：已出票

  • -3：已取消

• 默认值： 无

• 示例： 2

data.paxTicketInfos

• 类型： Object 数组

• 是否必填： 是

• 说明： 乘客及其票务信息列表。

• 默认值： 无

data.paxTicketInfos[]

• 类型： Object

• 是否必填： 是

• 说明： 单个乘客的票务信息。

• 示例：

{
  "name": "zhang/lisi",
  "passengerType": 1,
  "birthday": "20160202",
  "gender": "F",
  "cardNum": "123458",
  "cardType": "PP",
  "cardIssuePlace": "CN",
  "cardExpired": "20400101",
  "nationality": "CN",
  "ticketNos": ["S30814"],
  "airlinePNRs": ["S30814"],
  "ancillaries": []
}

data.paxTicketInfos[].name

• 类型： String

• 是否必填： 是

• 说明： 乘客姓名，采用航司标准格式。

• 默认值： 无

• 示例： "zhang/lisi"

data.paxTicketInfos[].passengerType

• 类型： Integer

• 是否必填： 是

• 说明： 乘客类型。

• 可选值：

  • 0 = 成人

  • 1 = 儿童

  • 2 = 婴儿

• 默认值： 无

• 示例： 1

data.paxTicketInfos[].birthday

• 类型： String

• 是否必填： 是

• 说明： 出生日期，格式为 YYYYMMDD。

• 默认值： 无

• 示例： "20160202"

data.paxTicketInfos[].gender

• 类型： String

• 是否必填： 是

• 说明： 性别。

  • M：男

  • F：女

• 默认值： 无

• 示例： "F"

data.paxTicketInfos[].cardNum

• 类型： String

• 是否必填： 是

• 说明： 证件号码。

• 默认值： 无

• 示例： "123458"

data.paxTicketInfos[].cardType

• 类型： String

• 是否必填： 是

• 说明： 证件类型。

• 可选值：

  • PP：护照

  • GA：港澳通行证

  • TW：台湾通行证

  • TB：台湾居民来往大陆通行证

  • HY：国际海员证

• 默认值： 无

• 示例： "PP"

data.paxTicketInfos[].cardIssuePlace

• 类型： String

• 是否必填： 是

• 说明： 证件签发国家或机构。

• 默认值： 无

• 示例： "CN"

data.paxTicketInfos[].cardExpired

• 类型： String

• 是否必填： 是

• 说明： 证件有效期，格式为 YYYYMMDD。

• 默认值： 无

• 示例： "20400101"

data.paxTicketInfos[].nationality

• 类型： String

• 是否必填： 是

• 说明： 旅客国籍，使用 ISO 3166-1 alpha-2 国家码。

• 默认值： 无

• 示例： "CN"

data.paxTicketInfos[].ticketNos

• 类型： String 数组

• 是否必填： 是

• 说明： 该乘客对应的已出票票号。

• 默认值： 无

• 示例： ["S30814"]

data.paxTicketInfos[].airlinePNRs

• 类型： String 数组

• 是否必填： 是

• 说明： 航司 PNR 列表。

• 默认值： 无

• 示例： ["S30814"]

data.paxTicketInfos[].ancillaries

• 类型： Array

• 是否必填： 是

• 说明： 乘客的附加服务列表。

• 默认值： []

• 示例： []

status

• 类型： Integer

• 是否必填： 是

• 说明： 返回状态，仅供内部使用。

• 默认值： 无

• 示例： -1

type

• 类型： String

• 是否必填： 是

• 说明： 事件类型。

• 默认值： 无

• 示例： "order.ticketed"

示例

相关页面

• Webhook 概览

• 查询订单

• 事件查询