> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/api-wen-dang/readme/yu-ding-hou-gai-lan/yu-ding-hou-cao-zuo/fei-piao.md).

# 废票

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

用这一栏处理废票流程。

### 本栏目覆盖内容

* 请求废票报价
* 提交废票申请
* 查询废票状态和结果

### 典型流程

{% stepper %}
{% step %}

### 废票报价

获取最新可废票金额和废票条件。
{% endstep %}

{% step %}

### 提交废票

使用最新 `voidOfferId` 提交废票申请。
{% endstep %}

{% step %}

### 查询废票状态

持续跟踪，直到废票完成、被拒绝或关闭。
{% endstep %}
{% endstepper %}

### 适用场景

* 航司窗口期内的废票处理
* 仅按订单维度发起废票
* 废票进度和结果跟踪

### 使用规则

* Atlas 只接受整单废票
* 不支持部分乘客废票
* 不支持先拆单或拆 PNR 后再通过 Atlas 提交废票
* `voidDeadline` 通常是当日截止时间。具体以报价返回值为准
* 超过 `voidDeadline` 后，再提交会实时返回错误
* 即使服务费是固定值，也必须先调用 `voidQuotation.do`

### Webhook 通知

Atlas 提供独立的 `order.void` webhook。

它覆盖废票提交成功、状态变化和自动执行失败。

沿用现有 webhook 注册地址即可接收。

提交后，通常可在 `5` 分钟内看到申请是否已成功受理。

最终进展和结果，仍建议结合 webhook 和 `queryVoidOrders.do` 跟踪。

详情见：

* [废票通知](/api-wen-dang/readme/webhook-gai-lan/fei-piao-tong-zhi.md)

### 完整 API 参考

接口级详情见：

* [废票](/api-wen-dang/api-can-kao/yu-ding-hou-api/fei-piao.md)

### 相关页面

* [退款](/api-wen-dang/readme/yu-ding-hou-gai-lan/yu-ding-hou-cao-zuo/tui-kuan.md)
* [预订后 API](/api-wen-dang/api-can-kao/yu-ding-hou-api.md)
* [预订后](/api-wen-dang/pai-zhang-yu-zhi-chi/faqs/atlas-api-post-ticketing.md)
* [废票通知](/api-wen-dang/readme/webhook-gai-lan/fei-piao-tong-zhi.md)
* [错误码](/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://resources.atriptech.com/api-wen-dang/readme/yu-ding-hou-gai-lan/yu-ding-hou-cao-zuo/fei-piao.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.