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

# ORBEXA Shopify集成接入指南

> Shopify商店接入ORBEXA完整操作指南：从安装应用并完成OAuth授权流程配置到商品数据自动同步，详解Webhook事件处理机制、库存价格实时更新与UCP/ACP/MCP协议端点自动部署的全流程步骤，无需编写任何代码即可让AI代理快速发现并推荐你的Shopify商品

# Shopify接入

## 概述

Shopify是ORBEXA支持的最简接入方式。商家只需完成OAuth授权，无需编写任何代码，ORBEXA即自动同步商品数据并部署全部协议端点。

## OAuth授权流程

ORBEXA通过标准的Shopify OAuth流程完成授权：

1. **商家发起授权** -- 在ORBEXA控制台点击「连接Shopify」
2. **跳转Shopify** -- 重定向到Shopify授权页面，商家确认授权范围
3. **回调处理** -- Shopify回调ORBEXA，平台获取Access Token
4. **自动同步** -- 立即从Shopify拉取全部商品数据
5. **端点部署** -- 自动为该商家部署UCP/ACP/MCP全部端点

整个过程包含完整的OAuth状态验证和Token管理。

## 商品自动同步

授权完成后，ORBEXA自动从Shopify同步以下数据：

* 商品基本信息（名称、描述、价格、图片）
* 商品变体（尺码、颜色、规格）
* 库存数量
* 商品状态（上架/下架）
* 商品分类和标签

同步完成后，商品数据进入AI Refinery Pipeline进行自动清洗和标准化（详见[第7章](/zh/book-7/ch7-data-quality)），然后通过所有协议端点对外暴露。

## Webhook事件处理

ORBEXA注册以下Shopify Webhook，确保数据实时同步：

| Webhook事件        | 触发条件   | ORBEXA处理                 |
| ---------------- | ------ | ------------------------ |
| Product Update   | 商品信息变更 | 自动更新商品数据，重新生成协议端点内容      |
| Product Delete   | 商品删除   | 从所有协议端点移除该商品             |
| Inventory Update | 库存变动   | 实时更新库存数量，UCP/ACP/MCP同步反映 |
| Order Create     | 新订单创建  | 记录订单信息                   |
| Order Update     | 订单状态变更 | 更新订单状态                   |
| Order Fulfilled  | 订单已发货  | 标记订单完成                   |
| App Uninstalled  | 商家卸载应用 | 清理授权信息，停用协议端点            |

### 事件处理机制

所有Webhook事件由ORBEXA自动处理：

* **商品变更**：商品更新或删除时，平台即时同步变更到本地数据库，所有协议端点自动反映最新状态
* **库存变动**：库存数量变化实时同步，AI代理查询到的库存始终准确
* **订单事件**：订单创建、更新、发货状态自动记录和同步
* **应用卸载**：商家在Shopify后台卸载ORBEXA应用时，平台自动清理关联数据和授权

## 平台调用限速

为遵守Shopify API限制，ORBEXA对Shopify平台的调用限制在 **2次/秒**。这是平台侧的限速，不影响AI代理访问ORBEXA端点的速率。

## 零代码接入

Shopify商家不需要：

* 编写任何代码
* 配置任何Webhook
* 管理API密钥
* 理解UCP/ACP/MCP协议

只需在ORBEXA控制台完成OAuth授权，其余全部自动化。

## 小结

Shopify接入是ORBEXA最轻量的集成方式：OAuth授权完成后，商品自动同步，7种Webhook事件自动处理，全部协议端点立即可用。商家完全不需要接触技术细节。

***

下一章：[WooCommerce接入](/zh/book-7/ch3-woocommerce) -- 插件安装、API连接、商品/订单/库存三向同步