Starshipit 运输

Starshipit 是一个运输服务运营商，帮助将澳大利亚及新西兰的快递公司与 Odoo 集成。集成后，用户可以创建运输方式，系统会根据预设条件自动从特定快递（如 Australia Post、NZ Post、DHL 等）获取运费。

自动计算运费 <../setup_configuration> - 集成其他第三方快递 <third_party_shipper> :::

要开始使用，请访问 Starshipit 平台 配置账户并生成连接器凭证。使用已有的 Starshipit 账户登录，若没有则创建新账户。

登录 Starshipit 账户后，进入 Settings --> Pickup address，填写 Pickup address。该地址需与仓库地址保持一致。

{.align-center}

要集成第三方快递，进入 Settings --> Couriers，选择 Couriers。

{.align-center}

:::: tip ::: title 提示 :::

有关不同快递的集成细节，请参考 Starshipit 支持中心。 ::::

配置运费计算，进入 Settings --> Checkout rates。选定的运费将在 Odoo 计算运费时自动应用。

{.align-center}

配置运输规则，以在特定条件下为订单分配正确的运输方式。创建规则步骤：

  1. 前往 Settings --> Rules，点击 Add a new rule。
  2. 将 Condition 设置为 Contains。
  3. 将 Value 设置为 product code（产品代码）。
  4. 将 Action 设置为 Set Courier & Product Code。

{.align-center}

在 Starshipit 账户的侧边菜单中，进入 Settings --> API。此页面展示连接 Odoo 所需的 API (Application Programming Interface) 密钥。

{.align-center}

在 Starshipit 账户设置完成后，前往 Odoo 的 Apps 模块，搜索 Starshipit Shipping，点击 Activate 安装。

{.align-center}

安装完成后，进入 Inventory --> Configuration --> Settings，在 Shipping Connectors 部分勾选 Starshipit Connector。

激活后，点击列出的连接器下方的 Starshipit Shipping Methods 链接，进入 Shipping Methods 页面并点击 Create。

:::: tip ::: title 提示 :::

也可以通过 Inventory --> Configuration --> Delivery --> Shipping Methods 访问 Shipping Methods。 ::::

在 Shipping Methods 表单中填写以下字段：

  • Shipping Method：输入 Starshipit。
  • Provider：从下拉菜单选择 Starshipit。
  • Delivery Product：指派或创建在计算运费时显示在销售订单行的交付产品。

:::: note ::: title 注意 :::

本节讨论的字段专用于 Starshipit 配置。其他字段信息请参见 ../setup_configuration。 ::::

在 Starshipit Configuration 选项卡中，填写以下内容：

  • Starshipit API Key：输入从 Starshipit 获得的 API 密钥 <inventory/shipping_receiving/star-api>。
  • Starshipit Subscription Key：输入同页面获取的订阅密钥。
  • Origin Address：填写发货地址，此字段对运费计算和生成运单标签至关重要。
  • Default Package Type：设置默认包装类型，以在自动计算运费时将空包装重量计入。

:::: important ::: title 重要 :::

要设置默认包装类型，必须在 Inventory --> Configuration --> Settings 中启用 Packages 功能。 ::::

手动点击表单右上角的云图标（Save）保存。

加载新配置的运输产品，点击 Starshipit Configuration 选项卡底部的 Select a service linked to the Starshipit account 链接。

弹出窗口 Choose Starshipit Shipping Service 中，在 Delivery Service 下拉框选择所需的运输服务（包括退货），然后点击 Confirm。

选定的服务名称将填入 Service Name 字段。

::: example 在 Odoo 中配置的 Starshipit 运输产品示例：

| Sendle: Sendle drop off | | Shipping Product： [Sendle Delivery] | | Starshipit Service Code： [STANDARD-DROPOFF] | :::

{.align-center}

:::: tip ::: title 提示 :::

Starshipit 在测试环境下不提供测试密钥。若在 Odoo 中创建运单，可能会产生费用。Odoo 在测试环境会自动取消创建的标签，以防止意外收费。但部分快递可能仍会收取标签打印费用，除非在快递平台手动取消订单。

通过点击运输方式表单顶部的 Environment 智能按钮，可在测试与生产环境之间切换。 ::::

在 Odoo 中创建报价时，点击 Add shipping 按钮添加 Starshipit 运输方式。

在弹出的 Add a shipping method 窗口中，选择 Starshipit 作为 Shipping Method。

点击 Get rate 计算运费，然后点击 Add 将运费成本加入销售订单行（即交付产品）。

:::: note ::: title 注意 :::

在 Odoo Sales 与 eCommerce 两个应用中均可自动计算 Starshipit 运费。 ::::

随后 Validate 交付。系统会在聊天记录中自动生成运单文档，包含：

  1. Shipping label(s)（视包裹数量而定）。
  2. Tracking number(s)（若所选快递支持）。
  3. Return label(s)（若 Starshipit 连接器已配置返回功能）。

{.align-center}

:::: important ::: title 重要 :::

Odoo 中的包裹重量 = 商品重量 + 数据库中保存的空包装重量。请确保选择了正确的运输选项，系统不会自动校验包装重量。

Starshipit 在创建订单时会检查收货地址，请务必确认地址无误。

部分快递可能需要额外信息（如电子邮件、电话号码），请在发送运输订单前确保已填写完整。 ::::

Starshipit 支持以下快递的退货：

  • Australia Post eParcel
  • TNT
  • Couriers Please
  • Aramex
  • StarTrack
  • DHL Express
  • NZ Post Domestic

在对应的交付订单上点击 Return 智能按钮；若快递支持退货，Print Return Label 按钮将可用。

如果在 Odoo 中取消交付订单，Starshipit 会自动将其归档，但不会向快递公司发送取消请求。请登录相应快递平台手动处理取消。