库存转移元字段触发器
当库存转移元字段发生变化时,触发Shopify Flow工作流程。在Workflow Trigger Extensions中跟踪该变化,并获取新旧值。
商家在仓库之间调拨库存时,会将承运商的追踪编号填写到“承运商编号”(custom.carrier_reference)元字段中。该元字段一经填写,收货仓库就应收到该信息。
本页面介绍了如何利用Workflow Trigger Extensions扩展,在库存转移的元字段发生变化时触发Shopify Flow工作流程。对于该资源类型的每个元字段,操作步骤均相同;本示例以承运商参考码(custom.carrier_reference)为例。
您需要准备的物品
- 元字段定义。请在Shopify后台的设置>元字段和元对象>转移中创建该元字段。未定义的元字段无法被追踪。
- 库存转移数据访问权限。请在应用的权限页面中授予该权限,详情请参阅 权限与数据访问。
1. 跟踪元字段
- 在应用中打开元字段触发器,然后点击添加触发器。
- 选择资源类型转移。
- 勾选元字段,此处为承运人参考号。您可以同时勾选多个选项,或使用全选功能。
- 点击添加触发器。
若要跟踪此资源类型的所有元字段(包括您稍后创建的元字段),请选择所有元字段而非逐个勾选,然后点击跟踪所有元字段。

该触发器为“立即激活”。应用程序首次读取库存转移数据时,会存储当前值而不启动工作流程;此后每次发生变更都会启动一个工作流程。
如果列表中缺少该元字段,请在“元字段触发器”页面上点击刷新元字段:该应用会将定义列表保存一小时。
2. 工作流程接收的内容
每次更改都会在 Shopify Flow 中触发Metafield Update触发器,并使用以下值:
| 变量 | 值 |
|---|---|
resourceType |
TRANSFER |
resourceId |
库存转移的 ID,例如 gid://shopify/InventoryTransfer/1234567890 |
metafieldKey |
命名空间和键,此处为 custom.carrier_reference |
metafield.value |
新价值 |
metafield.previousValue |
更改前的值;当元字段首次设置时,该值为空 |
metafield.type |
元字段的类型,例如single_line_text_field |
3. 构建工作流程
- 在 Shopify Flow 中,创建一个工作流程,并选择Workflow Trigger Extensions中的元字段更新触发器。
- 添加一个条件:
resourceType等于TRANSFER。由于“元字段更新”会针对您跟踪的每种资源类型触发,因此该条件可确保此工作流程仅处理库存转移。如果您跟踪该类型的多个元字段,请将metafieldKey等于custom.carrier_reference作为第二个条件添加。 - 添加所需的操作。该示例会发送一封内部邮件,其中包含旧值和新值。

从示例开始
- 请下载本页面底部附带的
.flow文件。 - 在您的 Shopify 管理后台中打开Shopify Flow,点击导入,然后选择文件。
- 打开发送内部电子邮件步骤,并输入收件人。该文件特意未包含任何地址。
- 启用该工作流程。
让它成为你的
- 添加条件“
metafield.previousValue为空”,以便仅在首次填写该引用时触发反应。 - 使用发送 HTTP 请求将参考号发送至收货仓库的系统。
- 在跟踪多个转账元字段时,请为
metafieldKey添加一个条件。
反应速度有多快
Shopify 不会就此发送通知,因此该应用大约每分钟读取一次被追踪的元字段。工作流程预计将在一两分钟内完成。
值得了解
- 系统会监控过去90天内创建的转账。如果对更早的转账修改了元字段,则不会触发任何工作流程。
- 大约一分钟内会首次检测到新的数据变更。此时元字段已有的值即为其初始值,该值不会触发任何工作流程;此后每次变更都会触发工作流程。
更多
- 元字段触发器:元字段触发器的工作原理,适用于所有资源类型。
- 事件历史记录和故障排除:查看应用程序发送的每个事件,包括旧值和新值。
