> 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/product-guides/extensions-and-integrations/atlas-shu-ju-tui-song.md).

# Atlas 数据推送

将 Atlas 航班价格数据接入本地购物层，并通过 Atlas Transaction API 完成实时核价和出票。

Atlas 数据推送将航班价格数据交付到您的本地平台。

使用本地数据承接高并发购物。用户准备购买时，再通过 Atlas Transaction API 确认价格和库存、创建订单并出票。

{% hint style="info" %}
数据推送用于搜索和展示，不是最终预订的真实来源。
{% endhint %}

### 为什么使用数据推送

将高频购物与交易履约分离。

您的平台从本地数据层完成搜索、比价、排序和推荐。用户准备购买时，Atlas 处理实时交易。

* 减少展示阶段对 `search.do` 实时调用的依赖。
* 基于结构化票价数据构建本地搜索、排序和商业规则。
* 在 Atlas 完成最终价格确认、库存确认、支付和出票。

### 工作方式

```mermaid
flowchart LR
    A[Atlas 数据推送] --> B[本地数据库或缓存]
    B --> C[搜索、比价、排序与推荐]
    C --> D[用户选择行程]
    D --> E[getOffers.do]
    E --> F[order.do]
    F --> G[pay.do]
    G --> H[订单查询或 Webhook]
```

1. Atlas 将全量和增量价格文件推送至您的 SFTP 服务器。
2. 您的平台将数据加载至本地数据库、缓存或搜索索引。
3. 用户在本地购物层中搜索并选择行程。
4. 调用 `getOffers.do` 获取最新可订报价和 `OfferId`。
5. 创建订单、完成支付，并跟进最终出票状态。

{% hint style="warning" %}
不要将推送数据作为最终可订价格。调用 `order.do` 前，必须调用 `getOffers.do`。
{% endhint %}

### 使用场景

#### 高并发搜索与比价

使用本地数据支持高频搜索、筛选、比价和排序。

适用于 OTA、聚合比价平台和企业差旅平台。在流量高峰期间，购物体验仍可保持稳定。

#### 自有搜索或第三方数据源

保留既有搜索引擎、推荐服务或外部购物数据源。

用户选定已知行程后，调用 `getOffers.do` 获取 Atlas 的可订报价。随后通过 `order.do` 和 `pay.do` 完成履约。

#### 动态打包与商业规则

将航班数据与酒店、保险、会员权益或利润规则组合。

在本地完成批量定价和排序。用户结账时，再通过 Atlas 确认最终航班价格和库存。

#### AI 搜索与智能推荐

将结构化的行程、票价、行李、库存和价格数据建立在自有检索系统中。

用于自然语言搜索、推荐和辅助销售。每个选定行程都应在预订前实时确认。

#### 数据分析与运营

使用全量和增量文件进行价格分析、航线覆盖评估、供给监控和运营报表。

这避免为分析任务重复调用交易 API。

### 选择合适的预订路径

| 您的模式              | 推荐路径                                              |
| ----------------- | ------------------------------------------------- |
| Atlas 负责购物和预订     | `search.do` → `verify.do` → `order.do` → `pay.do` |
| 您负责购物层，Atlas 负责出票 | 数据推送 → `getOffers.do` → `order.do` → `pay.do`     |

当您需要本地购物能力时，数据推送最适合。它不要求替换现有预订 API。

### 现有 Atlas 客户需要调整什么

现有 `search.do` 和 `verify.do` 集成仍可继续使用。

启用数据推送后，将购物流量迁移至本地数据层。用户选定行程后，使用 `getOffers.do` 替代最终的 `search.do` 与 `verify.do` 步骤。

您需要：

1. 通过 SFTP 接收全量和增量文件。
2. 按 `atlas_flight_fare_id` 和 `update_time` 更新本地数据。
3. 建设或复用本地存储和查询层。
4. 仅在用户准备继续购买时调用 `getOffers.do`。

`getOffers.do` 和 `verify.do` 共享默认 `60 QPM` 履约池。不要使用 `getOffers.do` 承接高频展示查询。

### 是否适合使用数据推送

当您需要高吞吐本地购物、自定义排序、批处理或 AI 检索时，选择数据推送。

当 Atlas 应继续作为主要购物层时，保留标准搜索路径。若必须将推送价格直接视为最终可订价格，则不适合使用数据推送。

### 后续阅读

{% content-ref url="/spaces/DGvFJgcmYPDYk6hvtLpx/pages/5C7kwhcWvMZ1zFQjmY30" %}
[Atlas 数据推送 — 技术接入指南](/api-wen-dang/product-guides/extensions-and-integrations/atlas-shu-ju-tui-song/flight-data-feed.md)
{% endcontent-ref %}

{% content-ref url="/spaces/DGvFJgcmYPDYk6hvtLpx/pages/QHiKeybwAKkKBSUgLFKd" %}
[获取报价接口](/api-wen-dang/product-guides/booking/booking-flows/get-offer-flow.md)
{% endcontent-ref %}