> ## Documentation Index
> Fetch the complete documentation index at: https://beaver.voc.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 订单数据同步总览

> 订单数据同步业务链路概览

Shulex VOC 通过调用**你提供的 HTTP 接口**主动拉取订单数据。你只需在 Shulex 平台完成集成授权与同步配置，并按规范实现订单查询接口即可。

## 整体流程

<Steps>
  <Step title="选择自定义数据平台">
    在 **集成（Integration）** 页选择 **自定义数据平台（Custom Data）**。
  </Step>

  <Step title="进入列表页授权">
    进入 Custom Data 列表页，对账号进行授权。
  </Step>

  <Step title="配置订单同步">
    授权完成后，进入**订单同步配置**。填入 Base URL 与 Shulex 生成的 Token。
  </Step>

  <Step title="测试字段 & 功能" icon="circle-check">
    **必须**点击「测试字段 & 功能」按钮，Shulex 会校验：

    * 接口可达性
    * 必传字段是否齐全
    * 字段名是否符合规范

    测试成功后方可进入下一步。
  </Step>

  <Step title="启用自动同步">
    测试通过后，Shulex 即可通过该接口自动同步订单数据。
  </Step>
</Steps>

<Warning>
  在「测试字段 & 功能」未通过前，不能启用同步任务。
</Warning>

## 调用方向

| 方向                | 接口                           | 谁实现   |
| ----------------- | ---------------------------- | ----- |
| Shulex VOC → 你的系统 | `POST {baseUrl}/orders` 订单查询 | 第三方实现 |

<Note>
  订单同步采用 **Shulex 主动轮询拉取**模式，不依赖 Webhook 推送。
</Note>

## 鉴权方式

* 每次请求 Header 携带 `Authorization: Bearer {Token}`
* Token 由 Shulex 平台生成并在配置页面提供

## 下一步

<Card title="订单查询 API" icon="arrow-right-from-bracket" href="/api/order-product-sync/orders-query">
  查看订单查询接口的完整规范与字段定义。
</Card>