Gelato

Gelato 是一个全球化的按需打印平台，可与 Odoo 集成，实现商品目录同步和订单履行自动化。

将 Gelato 的服务与 Odoo 的 销售 与 电商 应用关联，可实现以下功能：

  • 将 Odoo 销售订单同步至 Gelato，实现自动化订单履行
  • 在 Odoo 中创建并管理 Gelato 商品；支持商品变体和图片同步
  • 在 Odoo 中配置交付选项，并通过 Webhook 接收订单更新

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

Gelato 账户中的公司信息（公司名称 与 账单地址）必须与 Odoo 数据库中的公司信息保持一致，才能确认销售订单并发送至 Gelato 进行履行。

::::

在 Odoo 中配置 Gelato 连接器之前，首先需要从 Gelato 账户获取 API 凭证和 Webhook。

API 连接器让 Odoo 销售 能够向 Gelato 发送和接收订单处理数据，Webhook 则提供订单状态和运输跟踪的实时更新。

API Key 是唯一的认证令牌，允许 Odoo 安全地与 Gelato 的 API 通信，实现订单传输、状态更新和数据同步。

登录 Gelato 后，点击左侧菜单栏的 fa-code 开发者。随后点击 API keys。在新页面中，点击 Add API Key 按钮打开表单，填写名称后点击 Create Key。

使用 Copy to Clipboard 复制生成的 API Key。

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

复制 API Key 并安全保存后再离开此页面。页面刷新或退出后将无法再次复制。

若无法复制或丢失，请返回 API key 页面重新创建新的 API Key。 ::::

Webhook 是一种自动化通知系统，当 Gelato 处理、发货或交付订单时，立即在 Odoo 中更新，确保实时跟踪并将人工干预降至最低。

创建 Webhook 的步骤：

  1. 在左侧菜单栏的 Developer → Webhooks 中，点击 Add Webhook 打开 Create Webhook 表单。
  2. 表单需填写以下内容：
    • URL：填写 Odoo 数据库地址并追加后缀 /gelato/webhook，例如
      https://stealthywood.odoo.com/gelato/webhook
    • Events：选择 order_status_updated，确保 Odoo 自动接收订单状态变化。
    • Method：选择 HTTP Post，该请求方式用于从 Gelato 向 Odoo 发送数据。
    • 勾选 I want to take Authorization to this webhook。
    • Header Name：填写 [signature]，与 Odoo 中的字段对应。
    • 点击 Generate Key 生成 Header Value。
    • 最后点击 Create 完成配置。

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

在离开 Gelato 页面前，将 API Key 与 Webhook 信息复制到记事本备份。 ::::

在 Odoo 中，进入 销售应用 → 配置 → 设置，向下滚动到 连接器 部分，勾选 Gelato 连接器。随后将新生成的 API Key 与 Webhook 密钥粘贴到对应字段，保存后即可在 Odoo 销售 与 电商 中使用 Gelato。

建议先在 Gelato 中完成商品配置，再在 Odoo 中同步。获取 Gelato 商品 ID 的步骤：

  1. 在侧边栏菜单中进入 Templates 页面。
  2. 选择要同步的商品，鼠标悬停在商品卡片上出现 fa-ellipsis-v（竖向省略号）图标。
  3. 点击该图标并选择 Copy Template ID，将商品模板 ID 复制到剪贴板。

::: seealso 使用 Gelato 开始销售商品：快速简易设置 :::

在 Odoo 中创建与 Gelato 商品对应的商品：

  1. 进入 销售应用 → 商品 → 商品，点击 New 新建商品表单。
  2. 输入商品 名称，切换到 销售 选项卡。
  3. 在 Gelato 区域的 Template Reference 字段粘贴刚才复制的模板 ID，随后点击 Synchronize。

同步成功后，Gelato 商品的变体选项会自动导入到新建的 Odoo 商品中。

在新出现的 Print Images 字段，点击 default 标记设置默认商品图片。点击 fa-pencil（编辑）图标选择并上传商品图片，最后 保存并关闭。

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

所有 Gelato 商品及其对应的变体在可下单前，必须在 Print Images 字段配置图片。 ::::

要查看和编辑同步后的商品变体，切换到 属性 & 变体 选项卡，系统会显示从 Gelato 拉取的变体信息。点击 Configure 按钮即可编辑变体图片、交付方式、附加定价等。

同步完成后，Gelato 商品可通过 Odoo 的 sales quotations 或 电商 商店下单。交付选项会在 API 与 Webhook 配置后自动同步。

在销售订单中添加 Gelato 交付方式：

  1. 点击 Add shipping。
  2. 在 Shipping Method 字段选择 Standard Delivery 或 Express Delivery。
  3. 点击 Get rate 获取运费。

报价确认后即转为正式销售订单，系统会将订单发送至 Gelato 履行。Gelato 负责在最近的履行中心生产商品并直接发货给终端客户。

::: seealso sales_quotations/create_quotations :::

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

在同一销售订单中只能添加 Gelato 商品；当前 Gelato 连接器不支持多供应商混单。 ::::