Shopify + AtoShip
把 Shopify 店铺的订单导入 atoship，购买折扣价的 USPS / UPS / FedEx 面单，再把物流单号和发货状态回传给店铺——全程通过安全的 OAuth 授权完成，无需安装任何插件。
工作原理
和 WooCommerce 不同，Shopify 采用原生的 OAuth 应用模式——不需要安装插件。你只需从 Shopify 应用商店 安装 atoship（或从 atoship 后台发起连接），在 Shopify 上授权访问，剩下的就交给 webhook 实时处理。
通过 OAuth 连接
在 Shopify 后台授权 atoship
订单自动同步
新订单通过 webhook + 定时同步进入系统
买面单，完成发货
物流单号和发货状态回传给 Shopify
完整演示——从 Shopify 应用商店安装，到购买第一张面单。
连接你的店铺
最快的方式——Shopify 应用商店：打开 apps.shopify.com/atoship， 点击 Add app，确认权限，店铺即完成连接——atoship 会自动打开。 想从 atoship 这边开始？改用下面的后台操作步骤即可。
第 1 步——发起连接
在 atoship 后台，进入 渠道 → 添加渠道 → Shopify。 输入你的店铺域名（例如 my-store.myshopify.com，或 仅填 my-store）。点击 连接。
你可以输入完整的 *.myshopify.com 域名， 也可以只填店铺名称——atoship 会自动规范化处理。
第 2 步——在 Shopify 上授权
系统会把你跳转到 Shopify 后台。查看 atoship 所需的权限（订单、商品、 发货、库存、物流），然后点击 Install app。
atoship 申请对订单、商品、发货记录、库存和物流的读写权限。 系统绝不保存你的 Shopify 密码——只保存一个安全、可随时撤销的访问令牌。
第 3 步——验证连接
授权完成后，你会被跳转回 atoship 后台。你的店铺应出现在 渠道 → Shopify 下，状态显示为 已启用。 Webhook 会在后台自动注册——新订单会立即开始流入。
在 Shopify 一侧，你会在店铺后台侧边栏的 Apps 中看到 atoship。 订单会立即开始同步。
在 Shopify 内购买面单
连接完成后，你可以直接在 Shopify 后台购买运输面单——无需切换到 atoship 后台。 有两个入口：
从订单列表（批量）
勾选一个或多个订单，点击 … 菜单，在 Apps 下选择 atoship - smart label。这会带你进入 atoship，并已预选好这些订单—— 可直接比价并批量购买面单。
从单个订单
打开任意订单，点击 More actions，选择 atoship - Smart Label。你会被直接带到 atoship， 订单详情已自动填好——几秒钟即可比较各承运商费率并打印面单。
同步设置
点击已连接的店铺，然后打开 设置 标签页。各项设置的作用如下：
订单同步
- 自动同步——开启/关闭订单自动导入。
- 同步频率——拉取订单的间隔：1、2、4 或 8 小时。定时同步之间由 webhook 提供实时更新。
- 同步范围——回溯查找订单的时间跨度：1 周、2 周或 1 个月。
订单状态筛选
- 发货状态——按发货状态决定导入哪些订单。默认：未发货和部分发货。
- 付款状态——按付款状态决定导入哪些订单。默认：已授权、已付款和部分退款。
- 排除国家/地区——跳过发往特定国家/地区的订单。
- 排除标签——跳过带有特定 Shopify 标签的订单（例如
hold、do-not-ship）。
发货与物流跟踪
- 更新订单状态——何时把 Shopify 订单标记为已发货：购买面单时、之后 X 小时、每天固定时间，或从不。
- 停用物流跟踪邮件——阻止 Shopify 发送其默认的发货确认邮件。如果你自行处理通知，这项很有用。
- 自动同步地址——自动把 atoship 中的地址修正回传给 Shopify。
商品同步
- 启用商品同步——把你的 Shopify 商品目录（含款式、SKU 和库存数量）导入 atoship。
- 集合（Collections）——启用商品同步后，自定义集合和智能集合都会自动同步。
- 兜底重量——没有重量数据的商品使用的默认重量（用于费率计算）。
- 兜底尺寸——没有尺寸数据的商品使用的默认包裹尺寸。
同步哪些内容
Shopify → atoship
- 订单号、下单日期、金额合计
- 账单地址与收货地址
- 含 SKU、数量、重量的商品行项目
- 订单标签与备注
- 客户姓名与邮箱
- 商品、款式与库存数量
- 自定义集合与智能集合
- 付款状态与发货状态
atoship → Shopify
- 物流单号与承运商
- 物流跟踪链接
- 发货状态更新
- 发货确认（触发 Shopify 邮件）
- 送达与异常通知
发货使用 Shopify 的新版 FulfillmentOrder API。当 atoship 生成面单后， 会把带物流信息的发货记录推送给 Shopify，由其自动通知客户。
实时 webhook
连接时，atoship 会在你的 Shopify 店铺自动注册 webhook。 它们在定时同步之间提供实时更新——你无需手动配置任何内容。
orders/create— 有新订单下单orders/updated— 订单被修改orders/fulfilled— 订单在外部完成发货orders/cancelled— 订单被取消products/create— 新增商品products/update— 商品有变更products/delete— 商品被删除app/uninstalled— 应用被从店铺移除所有 webhook 都使用 HMAC-SHA256 签名校验。如果你从 Shopify 卸载应用，app/uninstalled webhook 会在 atoship 一侧自动清理连接。
断开连接
你可以从任意一侧断开连接：
- 从 atoship：进入渠道，找到你的 Shopify 店铺，点击 删除店铺。Shopify 一侧的 webhook 会被自动注销。
- 从 Shopify：进入 Shopify 后台 → Settings → Apps，找到 atoship，点击 Uninstall。
app/uninstalledwebhook 会通知 atoship 清理连接。
断开连接不会删除 atoship 中已有的任何订单、面单或物流数据。它只是停止今后的同步。
故障排查
OAuth 跳转失败或超时
请确认你输入的店铺域名正确。OAuth 状态令牌在 10 分钟后过期—— 如果你在授权页面停留太久，请返回渠道页面重试。
店铺显示“已连接”
每个 Shopify 店铺只能连接到一个 atoship 组织。如果你之前用另一个账号连接过这个店铺， 请先在那边断开连接，再从当前账号重新连接。
订单不同步
请检查同步设置——订单会按发货状态（默认：未发货 + 部分发货）和 付款状态（默认：已授权 + 已付款 + 部分退款）进行筛选。不符合这些筛选条件的订单不会被导入。 你也可以在店铺设置页面手动触发一次同步。
Shopify 订单上不显示物流单号
请检查“更新订单状态”设置。如果设为“从不”，atoship 不会回传发货记录。 改为“购买面单时”即可立即更新物流单号。同时确认该订单在 Shopify 一侧存在待处理的 fulfillment order。
商品不同步
商品同步是一个独立的开关——请确认已在店铺设置中启用它。 商品匹配顺序为：现有关联 → SKU → UPC。如果都匹配不上，会创建一个新商品， 并自动生成 SKU。
客户收到重复的发货邮件
当 atoship 在 Shopify 上完成订单发货时，Shopify 会发送其标准的发货确认邮件。 如果你同时从 atoship 发送通知，请在店铺设置中开启 停用物流跟踪邮件， 以抑制 Shopify 的邮件。
前置要求
- 任意 Shopify 套餐（Basic、Shopify、Advanced 或 Plus）
- 拥有应用安装权限的店主或员工账号
- 无需在店铺上安装插件或改动代码