# 出票完成通知

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

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

### 触发时机

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

### 收到后建议处理

收到事件后，建议：

* 把订单标记为已出票
* 保存票号和航司 PNR
* 更新面向旅客的行程信息
* 按需触发预订确认通知

### 推送方式

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

### 建议优先读取的字段

* `type`
* `data.orderNo`
* `data.orderStatus`
* `data.paxTicketInfos[].ticketNos`
* `data.paxTicketInfos[].airlinePNRs`

### 典型载荷

```json
{
  "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` 是内部字段，不要作为业务判断依据
* 对账时优先使用订单号和票号

{% tabs %}
{% tab title="字段说明" %}
**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"`
  {% endtab %}

{% tab title="示例" %}

```json
{
  "cid": "XXXXXXX",
  "data": {
    "orderNo": "TESTL20230922153224323",
    "orderStatus": 2,
    "paxTicketInfos": [
      {
        "airlinePNRs": [
          "S30814"
        ],
        "ancillaries": [],
        "birthday": "20160202",
        "cardExpired": "20400101",
        "cardIssuePlace": "CN",
        "cardNum": "123458",
        "cardType": "PP",
        "gender": "F",
        "name": "zhang/lisi",
        "nationality": "CN",
        "passengerType": 1,
        "ticketNos": [
          "S30814"
        ]
      },
      {
        "airlinePNRs": [
          "S30814"
        ],
        "ancillaries": [],
        "birthday": "19920202",
        "cardExpired": "20400101",
        "cardIssuePlace": "CN",
        "cardNum": "123457",
        "cardType": "PP",
        "gender": "F",
        "name": "li/si",
        "nationality": "CN",
        "passengerType": 0,
        "ticketNos": [
          "S30814"
        ]
      },
      {
        "airlinePNRs": [
          "S30814"
        ],
        "ancillaries": [],
        "birthday": "19910101",
        "cardExpired": "20400101",
        "cardIssuePlace": "CN",
        "cardNum": "123456",
        "cardType": "PP",
        "gender": "M",
        "name": "zhang/san",
        "nationality": "CN",
        "passengerType": 0,
        "ticketNos": [
          "S30814"
        ]
      }
    ]
  },
  "status": -1,
  "type": "order.ticketed"
}
```

{% endtab %}
{% endtabs %}

### 相关页面

* [Webhook 概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/webhook-gai-lan)
* [查询订单](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/yu-ding-liu-cheng-gai-lan/cha-xun-ding-dan)
* [事件查询](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/webhook-gai-lan/shi-jian-cha-xun)