跳转到主要内容

Shippo

当你需要为订单、标签或跟踪获取运输数据时,可以使用 Shippo。它在结账后、订单更新或履约步骤之后都很适合使用。

配置

在你配置此步骤之前,请在工作区的 Integrations 中通过登录流程连接 Shippo。如果没有可用的活动连接,步骤会显示警告,并提供指向 Integrations 的链接,而不是账户选择器。

Arguments form

当你选择一个操作时,Arguments 部分会根据该操作的输入 schema 渲染一个表单。引用现有记录的字段包含下拉选择器。 如果你更喜欢手动编写完整的参数对象,请切换到 Raw JSON 选项卡。任一选项卡中的更改都会保持同步。

常用操作

像删除记录之类的破坏性操作,不可在工作流操作选择器中使用。

输出

此步骤会将 Shippo 响应存储为步骤输出。响应的结构取决于所选操作。 在后续步骤中使用完整输出引用:

示例

  1. 打开 Integrations,如果你还没有连接过 Shippo,就先连接它。
  2. 在你的工作流中添加一个 Shippo 步骤。
  3. 在 Authentication 中选择一个已连接的账户。
  4. 在 Action 中选择 Create address。
  5. 填写所需字段。使用 Insert Variable 为任何字段值引用前面步骤的输出。
  6. 点击步骤标题栏中的 Run 来测试操作,然后在 Output 中查看返回的有效载荷。

用例

创建运输标签

  1. Create address
  2. Create parcel
  3. Create shipment
  4. List shipment rates

跟踪订单货件

  1. Create track
  2. Get tracking status
  3. Get transaction

处理新订单

  1. Create order
  2. Get order
  3. Create shipment
  4. Create transaction

说明

  • 此步骤依赖于你工作区中已连接的 Shippo 集成。
  • 工作流操作选择器显示的是一组精选操作。拥有 Shippo 工具的代理可以使用更多操作。
  • 登录界面可能会显示第三方授权品牌标识。

将 Shippo 作为代理工具使用

你也可以在 Agent Editor 中将 Shippo 添加为工具。打开代理,点击 Add tool,然后选择 Shippo。在工具设置面板中,选择代理应使用的已连接账户。代理会在相关于对话时调用 Shippo 操作。 另见:Integrations、Creating and Editing 和 Testing and Iteration