Product maps 商品映射

> This module is exclusively available in the Headquarters (HQ) backend. It is designed to map standard HQ products to corresponding local products in different branch outlets. 本模块仅在总店（HQ）后台提供。其主要功能是将总店的标准商品映射绑定到各个分店对应的本地商品上。
>
> By completing this product mapping, merchants ensure that Product Vouchers issued by HQ can be automatically and seamlessly redeemed at any selected branch store. 通过完成商品映射，商户可以确保由总店发放的“商品券”能够在任何指定的分店内实现跨店自动无缝核销。

#### Product Maps 商品映射与管理

1. **Select HQ Products**: The mapping process starts by selecting the base products from the HQ list. You can either click **Map** on a single item row, or check multiple product boxes and click the **Bulk Map** button at the top to process them simultaneously. 1. **选择总店商品**：映射流程从选择总店列表中的基准商品开始。您可以点击单个商品行上的 **Map (关联映射)**，或者勾选多个商品复选框并点击顶部的 **Bulk Map (批量映射)** 按钮以同时处理它们。
2. **View and Delete Mappings**: Under the "Mapped Outlets" column, you can click the **View** link (e.g., next to 0/18). This opens a detailed list of currently mapped stores for that specific product, where you can click "Remove" to delete existing incorrect mappings. 2. **查看与删除映射**：在“关联门店数”列下，您可以点击 **View (查看)** 链接（例如 0/18 旁边的按钮）。这将打开该特定商品当前已关联门店的详细列表，您可以在其中点击“删除门店”以取消现有的错误映射。
 
![](/media/202604/2026-04-21_170346_2237800.1384652588449673.png)

#### Map Wizard 映射向导
1. **Step 1: Select Outlets**: After initiating the mapping action, the wizard will prompt you to select which specific branch stores you want to sync these HQ products to. Check the required branches from the available list. 1. **第一步：选择门店**：发起映射操作后，向导会提示您选择要将这些总店商品同步到哪些具体的分店。从待选列表中勾选需要的分店。
![](/media/202604/2026-04-21_170555_6818660.7802627476224707.png)

2. **Step 2: Review Matchs**: The system will attempt to match products based on identical names. 2. **第二步：核对匹配结果**：系统将尝试基于相同的名称自动匹配商品。
 * **Auto-matched (自动匹配成功)**: If the HQ product and the branch product share the exact same name, the system links them automatically. **Auto-matched (自动匹配成功)**：如果总店商品和分店商品名称完全一致，系统会自动将它们关联。
 * **No exact match (未找到同名商品)**: If names differ, you must manually click the dropdown menu to search and select the corresponding local product in that branch to enforce the link. **No exact match (未找到同名商品)**：如果名称不同，您必须手动点击下拉菜单，搜索并选择该分店对应的本地商品以强制关联。
 * **Remove (删除门店)**: If you decide not to map a product for a specific branch during this review, click "Remove" on the right side of the row. **Remove (删除门店)**：如果在核对过程中决定不对某个特定分店进行映射，请点击行右侧的“删除门店”。
![](/media/202604/2026-04-21_170657_5165450.7743407352274366.png)

3. **Step 3: Results**: Click "Confirm & Submit". The final page will display a summary of successfully mapped items and detail any errors (e.g., items skipped because no local product was manually selected). 3. **第三步：完成结果**：点击“确认并提交映射”。最后一页将显示成功映射的商品汇总，并详细列出任何异常情况（例如：因未手动选择本地商品而跳过的项目）。
![](/media/202604/2026-04-21_170734_6396160.5665323557129297.png)

---

### 2. Frequently Asked Questions (FAQ) 常见问题

* **Q: What happens if I issue a product voucher but forget to map the products here?** **Q：如果我发放了商品券，但忘记在这里进行商品映射，会发生什么？**
 * **A:** If unmapped, the branch POS system will not automatically recognize the product for the voucher when the item is ordered. Customers can still use the voucher, but the branch cashier will have to perform a manual redemption, which significantly reduces checkout efficiency. **A**：如果未映射，分店的 POS 机在顾客点单时将无法自动识别该券对应的商品。顾客依然可以使用该券，但分店收银员必须进行手动核销，这会大幅降低结账效率。

* **Q: Why can't I see the "Product Maps" option in my backend menu?** **Q：为什么我在后台菜单里看不到“商品映射”这个选项？**
 * **A:** This module is centrally controlled and is only accessible from the Headquarters (HQ) account. Branch-level accounts do not have permission to view or configure cross-store product mappings. Please ensure you are logged into the correct HQ account. **A**：该模块为总部集中控制，仅限总店（HQ）账号访问。分店级别的账号无权查看或配置跨店商品映射。请确保您登录的是正确的总店账号。