[TITLE]
Odoo 与 Pricer 电子货架标签的配置与使用指南

[DESCRIPTION]
电子货架标签通过 Odoo 与 Pricer 集成,实现商品信息远程同步,无需重新打印标签。本文详细介绍 Pricer 账户创建、店铺与变量配置、Odoo 模块激活、标签关联及手动更新方法,并说明折扣标签的使用注意事项。

[KEYWORDS]
Odoo,Pricer,电子货架标签,配置,同步,商品信息,标签模板,折扣标签,API,POS

[TRANSLATED_CONTENT]

# 电子货架标签

电子货架标签可以在店铺货架上显示商品信息(如价格和条形码),并通过后端远程同步。当商品信息变化时,无需重新打印标签。

![Pricer 电子标签](electronic_labels/electronic-label.png)

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

Odoo 使用来自 [Pricer](https://www.pricer.com/) 的电子标签。  
::::

## 配置

### Pricer 设置

1.  [联系 Pricer](https://www.pricer.com/contact) 以创建并配置你的 Pricer 账户。

2.  创建你的店铺:一个 Pricer 店铺对应一个实体店。

3.  根据需要将多个收发器链接到 Pricer 店铺。

4.  创建以下变量,以在 Odoo 数据库系统和 Pricer 之间共享商品信息。这些变量在标签模板中充当占位符。

    - \`itemId\`:保存分配给每个商品的唯一内部标识符  
    - \`itemName\`:商品的实际名称  
    - \`price\`:商品的销售价格(含适用税费)  
    - \`presentation\`:Pricer 中用于在标签上显示商品信息的模板名称  
    - \`currency\`:公司使用的币种(如 USD、EUR)  
    - \`barcode\`:每个商品对应的条形码号码  

    :::: important
    ::: title
    重要
    :::
    这些变量的名称必须在 Pricer 数据库中 **完全相同**    ::::
    
5.  创建名为 **[NORMAL]** 的模板。此模板用于在数字标签上显示信息。

在 Pricer 上完成账户、店铺、变量和模板的配置后,即可继续 Odoo 数据库的设置。

:::: important
::: title
重要
:::
与你的 Pricer 店铺关联的账户必须拥有向 Pricer 发送 API 请求的权限。  
::::

### Odoo 设置

作为前置条件,`activate <general/install>` **POS Pricer** 模块(技术名称:`pos_pricer`),以获得使用 Pricer 电子标签所需的全部功能。

![从 Apps 安装 POS Pricer 模块](electronic_labels/pricer-module.png)

模块激活后,配置你的 `pricer stores <pricer_tags/stores>`,并将 `Pricer tags <pricer_tags/tags>` 与商品关联。

#### Pricer 店铺 {#pricer_tags/stores}

与 Pricer 中的配置类似,需要为每个实体地点创建一个 Pricer 店铺。操作路径:`Point of Sale --> Configuration --> Pricer Stores`,点击 `New`,填写以下信息:

- `Store Name`:自定义店铺名称。  
- `Pricer Tenant Name`:在 Pricer 中的公司账户名称,通常后缀 `[-country_code]`,由 Pricer 提供。  
- `Pricer Login`:Pricer 账户登录名。  
- `Pricer Password`:Pricer 账户密码。  
- `Pricer Store ID`:Pricer 数据库中对应店铺的 ID。  

![配置 Pricer 店铺](electronic_labels/pricer-stores-setup.png)

:::: note
::: title
注意
:::
- `Pricer Tags` 列在标签关联商品后会自动更新。  
- `Last Update``Last Update Status` 列在标签更新时会自动更新。  
::::

#### Pricer 标签 {#pricer_tags/tags}

要让标签显示特定商品信息,需要将标签与商品关联。步骤如下:

1. 打开商品表单:`Point of Sale --> Products --> Products`,点击 `New` 或选择已有商品。  

    :::: note
    ::: title
    注意
    :::
    创建新商品时,请先完成商品配置并保存,然后再关联 Pricer 标签。  
    ::::
    
2. 前往 `Sales` 选项卡,滚动至 `Pricer` 区段,选择对应的 `Pricer Store`
    ![将 Pricer 标签关联到商品](electronic_labels/pricer-product.png)

3.`Pricer tags ids` 字段中填写标签 ID(可从标签本体复制或扫描其条形码)。  

    :::: note
    ::: title
    注意
    :::
    Pricer 标签 ID 由一个字母加 16 位数字组成。  
    ::::

:::: tip
::: title
提示
:::
- 建议使用条码扫描器以加快编码过程。  
- 首次在 Odoo 中设置 Pricer 时,建议先只配置一个商品,确认信息能够在标签上显示后,再继续配置其他商品。  
::::

关联商品与 Pricer 标签后,即可将商品信息发送至 Pricer。

### 实际应用

如果对以下内容进行修改,Odoo 会每 12 小时自动向 Pricer 发送同步请求:

> - 商品名称、价格、条码或客户税率  
> - 币种  
> - 关联的 Pricer 店铺或 Pricer 标签  

如需强制更新,请启用 `developer mode <developer-mode>`,然后:

1. 前往 `Point of Sale --> Configuration --> Pricer Store`2. 选择目标店铺。  
3. 点击 `Update tags`,更新因以下变更而受影响的所有标签:  
   - 商品名称、价格、条码或客户税率  
   - 币种  
   - 关联的 Pricer 店铺或 Pricer 标签  

或者点击 `Update all tags`,强制更新所有标签(即使未发生变更)。

![更新所有 Pricer 标签](electronic_labels/update-all.png)

若 Pricer 已处理并接受请求,状态字段会显示 `Update successfully sent to Pricer`。若出现问题,系统会显示错误信息。

:::: warning
::: title
警告
:::
如果发送至 Pricer 的请求失败,Odoo 仍会认为商品已更新。此时建议强制更新所有标签。  
::::

### 折扣标签

要在 Pricer 标签上显示折扣标签,需要将 `pricelist <pricelists>` 关联到该标签对应的商品变体。

操作步骤:

1. 前往 `Point of Sale --> Products --> Product Variants`2. 选择要应用折扣的商品变体。  

然后设置所需的价目表:

1. 进入 `General Information` 选项卡。  
2.`Pricer Sales Pricelist` 字段中选择价目表。  

设置价目表后,会出现 `On Sale Price` 字段,显示已应用折扣的 `Sales Price`
![将价目表关联到商品变体](electronic_labels/pricer-sales-pricelist.png)

更新电子标签后,标签上会出现 `[PROMO]` 标记,显示原价(划线)和折扣价。

:::: note
::: title
注意
:::
- 目前不支持针对多件购买的折扣或基于其他价目表的价格计算的价目表。  
- 将价目表关联到商品变体仅影响电子标签的显示,结账时扫描商品并不会自动应用折扣。  
::::

::: seealso
`discounts`
:::

[SUMMARY]

- 电子货架标签
  - 配置
    - Pricer 设置
      - 创建 Pricer 账户
      - 创建店铺
      - 关联收发器
      - 创建变量 (itemId, itemName, price, presentation, currency, barcode)
      - 创建模板 [NORMAL]
    - Odoo 设置
      - 激活 POS Pricer 模块
      - 配置 Pricer 店铺
      - 配置 Pricer 标签并关联商品
  - 实际应用
    - 自动同步(每 12 小时)
    - 手动强制更新
      - 更新受商品、币种、店铺或标签变更影响的标签
      - 更新所有标签
  - 折扣标签
    - 将价目表关联到商品变体
    - 在标签上显示 PROMO 标记(原价+折扣价)