服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 仅管理应用自有 delivery profile、且不读取商家 profile 的应用，官方说无需为这项迁移改动；读取或修改商家配送配置的应用需要检查路径。
- 2026 年 10 月 1 日是计划中的商家 rollout 起点：未标兼容的新安装会看到警告；已有商家若手动启用而应用尚未升级，可能遇到功能故障。日期是目标，可能变化。
- Shopify 在确认应用兼容前不会自动迁移使用该应用的商家；2027 年 7 月 1 日是所有商家进入新模式的当前目标，不是已经完成的事实。
- 读商家费率可按应用能力选择 Contextual Product Feeds，或用 ShopFeatures.marketDrivenShipping 在 Market.delivery 与旧 deliveryProfiles 间分支；写入优先评估应用自有 profile。
- 先在新建的开发店启用 feature preview，回归读写和结账结果，再提交兼容性 self-attestation；本文未登录商店或验证具体应用结果。
先判断自己是否需要迁移
Shopify 的 2026 年 7 月 1 日开发者公告和当前升级指南说明，商家自有配送配置会转入 Markets；deliveryProfile 与 deliveryProfiles 对商家配置逐步弃用，而应用自有 profile 继续使用现有 API。先搜索 GraphQL 查询和 mutation 中的 deliveryProfile、deliveryProfiles、deliveryProfileCreate、deliveryProfileUpdate、deliveryProfileRemove，并标出每次操作的是商家 profile 还是应用自己创建的 profile。
影响矩阵：只创建、维护应用自有 profile 且不读取商家 profile，无需因这项变化重写；读取商家配送配置，要迁移读取路径；创建或修改商家 profile，要迁移写入路径；兼有两种行为的应用分别处理。把 Carrier Service 注册与商家配送配置也分开，另见<a href="/resources/shopify-api-2026-10-migration-checklist">Shopify API 2026-10 迁移清单</a>，两条时间线不能混成一次 API 版本升级。
10 月 1 日的警告与手动启用边界
Shopify 将 2026 年 10 月 1 日列为商家 rollout、未标兼容应用的新安装警告及已有商家可手动启用的起点。若商家手动启用，而应用仍依赖旧商家 profile 路径，官方提示可能发生 breakage；不能从公开公告断言某个商家已经启用或其应用实际失败。
Shopify 说明，在确认兼容前不会自动迁移使用该应用的商家。升级指南把 2027 年 7 月 1 日列为所有商家进入新模式的目标，并明确目标日期可能调整。实际商家状态、警告是否出现和迁移批次，应由应用团队在被授权的店铺与项目中核对。
读取路径：按用途选择 Feed 或 Markets API
若应用是 sales channel 或可以成为 sales channel，Shopify 推荐 Contextual Product Feeds：它按商品变体和市场给出配送选项估计，同时涵盖商家市场费率与应用自有费率，要求 read_product_listings。先确认应用实际需要的国家、地区、商品和费率数据在 Feed 中都有覆盖；不满足该资格或需要读取原始配置时，不要强行套用这条路径。
若必须直接读商家配送配置，使用 ShopFeatures.marketDrivenShipping 判断店铺模式：新模式读取 Market.delivery，旧模式继续读取 deliveryProfiles，所需权限为 read_markets。过渡期要在两种模式下检查相同市场、商品、地点和费率的结果；不能仅凭 API 请求成功就认定结账费率正确。
写入路径：优先隔离应用费率，再评估 Markets API
官方推荐多数写入商家配送配置的应用转为管理应用自有 delivery profile：用 deliveryProfileCreate 创建，按实际商品与地点配置；只有确实覆盖全部商品时才评估 coversAllItems。先并行比对旧路径与新 profile 的费率，再停止写商家 profile。应用自有 profile 沿用原 API 和既有权限，不能把它误写成全部 deliveryProfile 操作都被删除。
若应用自有 profile 无法表达所需配置，使用 Markets API：ShopFeatures.marketDrivenShipping 为真时用 marketCreate 或 marketUpdate，旧模式仍写原商家 profile；这一路径需要 read_markets 与 write_markets。先复核权限、市场与费率归属，在两种店铺模式下分别验证，避免把某一商家的市场设置覆盖到其他市场。
开发店预检、兼容声明与验收
前提是有可用的开发店和应用测试版本。创建新的 development store 时选择 Market-driven shipping feature preview；官方说不能给已有店追加该 preview。为旧模式另准备受控测试店，按应用实际的读路径、写路径和结账地址设计夹具。这里是测试方案，不是本文已做过的账户实测。
在新旧店分别记录 ShopFeatures.marketDrivenShipping、相关 Market 或 profile、权限、读取到的费率以及代表性商品和地址的结账结果；核查应用自有费率与商家市场费率是否重复或丢失。升级并验证后，可按 Shopify 指引提交 compatibility self-attestation，由 Shopify 标记兼容并清除商家警告；提交表单本身不能代替实际读写与结账回归。
失败时停止扩量与可用的回滚
若模式分支与店铺实际不一致、权限不足、市场费率丢失或重复、结账结果异常，停止扩大启用范围，保存店铺模式、请求 ID、市场、商品、地点与响应证据。不要通过切换出口或重试同一旧请求来掩盖配置与权限错误。
尚未迁移的旧模式商家可暂时保留经验证的旧读写路径；已手动启用新模式的商家不能假设能自行回退店铺状态，应停止有风险的写入并按 Shopify 支持的路径处理。本文没有验证任何商家的回滚权限、实际迁移结果或自我声明状态。PRODUCT_FIT=NONE：IP 切换不能修复 API 模式、权限或运费配置问题。
资料来源
常见问题
所有使用 deliveryProfiles 的 Shopify 应用都要迁移吗？
不是。仅管理应用自有 profile 且不读取商家 profile 的应用，官方说无需为这项变化改动；读取或修改商家配送配置的应用应分别检查迁移路径。
2026 年 10 月 1 日会让所有商家的旧配送 API 失效吗？
不会据此推断。10 月 1 日是计划中的 rollout、安装警告与商家可手动启用起点；Shopify 在确认应用兼容前不会自动迁移其商家，目标日期也可能变化。
读取商家配送费率应该选哪条路径？
符合 sales channel 条件且只需上下文化费率时可评估 Contextual Product Feeds；需要原始配置时按 ShopFeatures.marketDrivenShipping 在 Market.delivery 与旧 deliveryProfiles 间分支。
修改商家配送配置时仍能使用应用自有 profile 吗？
可以。Shopify 推荐优先评估应用自有 profile；无法表达需求时，再按店铺模式使用 Markets API 或旧商家 profile 路径。
怎样测试 Market-driven shipping feature preview？
创建新的 development store 时启用 preview，并在新旧模式下回归读写与结账费率。官方说不能把 preview 加到已有店。
提交兼容声明后就算完成迁移了吗？
不是。先验证应用的读取、写入和结账结果，再按 Shopify 指引提交 self-attestation；具体商家是否已迁移仍需在被授权账户中核对。