Unicommerce 是许多电商平台的聚合器，它允许您通过多个受支持的市场销售商品，并通过名为 Uniware 的统一界面处理订单。了解更多关于 Unicommerce 的信息，请访问 https://unicommerce.com/
ERPNext 与 Unicommerce 的集成
ERPNext 使用 Uniware 的 REST API 提供与 Unicommerce 的完整双向集成。此集成通过 Frappe 团队官方支持的 Frappe 应用提供。此集成大致涵盖以下内容：
- 商品目录与 Unicommerce 同步（双向）
- 库存同步（单向，从 ERPNext 到 Unicommerce）
- 新销售订单同步
- 销售发票同步或销售发票生成（应使用任一选项）
应用安装
- 如果您在 Frappe Cloud 上托管 ERPNext 站点，您可以通过进入站点仪表板快速安装该应用。该应用在 Frappe Cloud 市场中可用。
- 如果您的站点由 Frappe 托管，请提交支持工单以在您的站点上安装该应用。
- 如果您自行托管 ERPNext，您可以使用 Frappe bench 安装该应用。请参阅 bench 文档以了解如何安装 Frappe 应用。
bench get-app ecommerce_integrations --branch main
身份验证与基本设置
- 应用安装完成后，进入“Unicommerce 设置”页面。
- 点击“启用 Unicommerce”复选框。
- 输入您的 Unicommerce 站点、用户名和密码。
- 默认已添加客户端 ID，但如果您配置了单独的客户端 ID，则需要在此处更新。如果您不确定您的客户端 ID，请联系 Unicommerce 支持团队。
- 点击“保存”，这将启动与 Unicommerce 的身份验证以及为集成设置自定义字段的流程。
- 此设置完成后，您将在“身份验证详情”部分看到访问/刷新令牌。这意味着身份验证成功，您现在可以开始进行进一步的设置。
如果身份验证失败：
- 请重新检查输入的信息。
- 您的服务器可能被防火墙阻止。请联系 Unicommerce 支持团队，将您服务器的 IP 加入白名单。
商品同步
此集成会每小时检查新创建的商品并将其上传到 Unicommerce。要启用此功能，您需要进行以下设置：
- 进入“Unicommerce 设置”并启用“将新商品上传到 Unicommerce”。
- 设置一个默认商品组。这仅在商品组缺失时作为后备使用。
- 创建新商品时，勾选“与 Unicommerce 同步”复选框，以将该商品上传到 Unicommerce。
- 此复选框也可以对现有商品启用。
Unicommerce SKU 代码是不可变的，因此您不应在创建后更改商品代码。
为了正确地将商品组与产品类别同步，您需要将所有商品组映射到 Unicommerce 上相应的产品类别。
要将商品组映射到产品类别：
- 首先在 Unicommerce 上找到产品类别代码。
- 在 ERPNext 上打开相关的商品组，并在那里更新 Unicommerce 产品类别代码。
商品同步字段映射如下：
| ERPNext 字段 | Unicommerce 字段 | 备注 |
|---|---|---|
| 商品代码 | SKU | 适用 Unicommerce SKU 限制 |
| 商品名称 | 商品名称 | |
| 描述 | 描述 | |
| 每单位重量 | 重量 | 仅当以克为单位设置时。 |
| 保质期（天） | 保质期 | |
| HSN 代码 | HSN 代码 | |
| 图片 | 图片 | |
| Unicommerce 商品长度 | 长度 | |
| Unicommerce 商品宽度 | 宽度 | |
| Unicommerce 商品高度 | 高度 | |
| 已禁用 | 已启用 | （映射关系相反） |
| EAN 条码 | EAN | |
| UPC 条码 | UPC-A | |
| 商品组 | 产品类别 |
库存同步
一旦设置了商品同步，就可以启用库存同步。集成会检查 ERPNext 库存中的变更，并按配置的时间间隔将其推送到 Unicommerce。集成将 ERPNext 库存水平视为唯一数据来源，Unicommerce 的库存水平会被 ERPNext 的库存值覆盖。
- 前往“Unicommerce 设置”并向下滚动到“库存同步”部分。
- 勾选“启用库存同步”
- 配置同步频率。建议频率为 15 到 60 分钟。
- 在仓库映射表中，添加您在 Unicommerce 中拥有的所有设施代码，并将其与 ERPNext 仓库进行映射。
- 为所有要启用的设施勾选“启用”复选框。
- 保存设置。
注意：所有库存都会推送到“DEFAULT”货架。此集成不支持 Unicommerce 货架，请确保您在 Unicommerce 中只有一个名为“DEFAULT”的货架，以确保库存同步的准确性。
注意：与其他电子商务集成一样，Unicommerce 不支持小数库存。
销售订单处理 – 工作流程
以下是在 ERPNext 上处理订单的工作流程。您也可以选择在 Unicommerce 上处理订单，仅同步已完成的订单。
销售订单同步 – 渠道设置
Unicommerce 集成支持从多个渠道接收和处理订单。为此，销售订单同步的设置也需要分多个阶段进行。
销售订单同步的默认设置
- 前往“Unicommerce 设置”。
- 滚动到“销售订单同步”设置部分。
- 设置订单同步频率。建议频率为 30 到 60 分钟。
- 设置默认客户组和单据的命名系列。
特定渠道的销售订单同步配置
为了允许对每个渠道进行灵活配置，您需要为每个要启用销售订单同步的渠道创建“Unicommerce 渠道”单据。
- 从搜索栏或 Unicommerce 设置页面前往“Unicommerce 渠道”。
- 点击“添加 Unicommerce 渠道”
- 填写所需详细信息，如渠道 ID、默认仓库、公司、科目和命名系列。
- 如果该渠道的配送由市场平台处理，则勾选“配送由市场平台处理”，否则取消勾选。
- 完全配置渠道后，点击“启用”复选框。
在 Unicommerce 中创建的新销售订单现在将开始与 ERPNext 同步。在此过程中，如果遇到新商品，则会使用 Unicommerce 中的信息在 ERPNext 中创建该商品。有关 Unicommerce 订单的相关信息会映射到 ERPNext 字段，其他信息可在销售订单上的“Unicommerce 详情”部分找到。
销售发票同步
销售发票同步可以通过以下两种方式之一处理。请根据您的需求选择合适的选项。
1. 在 Unicommerce 上处理发票（推荐）
如果您希望在 Unicommerce 上处理订单和发票，并且仅在 ERPNext 中同步完全处理完毕的订单，请在 Unicommerce 设置中启用“仅同步已完成的订单”。
2. 在 ERPNext 上处理发票
如果您只想从 ERPNext 处理订单，则需要从 ERPNext 的销售订单生成发票。
要生成发票，请前往已同步的 Unicommerce 销售订单，点击“Unicommerce > 生成发票”。这将创建一张销售发票并同时扣减库存。
发货清单
如果您使用上述方法 #2 在 ERPNext 上处理订单，则需要创建并提交发货清单，以告知 Unicommerce 您已发货。
前提是设置以下单据类型，您可以在 Unicommerce 清单创建页面找到代码：
- 创建 Unicommerce 配送服务商
- 创建 Unicommerce 配送方式
创建清单的流程：
- 当您准备好将包裹交给配送服务商时，应创建“Unicommerce 发货清单”单据。前往搜索栏 > “Unicommerce 发货清单” > + 添加
- 选择渠道 ID、配送方式和配送服务商代码。
- 然后，您可以使用“获取包裹”按钮根据所选筛选条件获取未结订单，或使用“扫描 AWB 代码”字段扫描包裹的 AWB。保存后，两者都会自动填充其余详细信息。
- 确认所有详细信息无误后，保存并提交该单据。
- 提交清单后，将在 Unicommerce 上创建并关闭相同的清单，并且发货状态将标记为“已发货”。同时也会获取 Unicommerce 清单 PDF，并将其附加到 ERPNext 清单单据上。
状态更新
Unicommerce 的状态会定期在 ERPNext 中更新，您可以在“Unicommerce 详情”部分查看当前状态。
订单取消
当订单在 Unicommerce 上被取消时，集成会同步此操作，并在 ERPNext 中取消该订单。部分取消的订单也会同步，被取消的商品会从 ERPNext 销售订单中移除。完整取消和部分取消都会每小时同步一次，并且在生成发票之前也会同步。
订单退货
当在 Unicommerce 上创建退货时，集成会同步此操作，并在 ERPNext 中创建一张草稿贷项通知单。
两种退货情况均由集成处理：
- RTO（退回发件人）
当货件退回发件人时，货件状态会更新，并在ERPNext中自动生成一张贷记凭证（同时更新库存）。该贷记凭证为全额退货。 - CIR（客户发起退货）
当客户退回货件时，该操作会反映在Unicommerce的销售订单部分。根据客户发起退货的性质，系统会生成全额或部分贷记凭证。
您可以通过进入“销售发票”并筛选“是否退货”为“是”来查看所有退货记录。退货跟踪编码也会记录在贷记凭证上。
创建退货时，退货仓库将根据Unicommerce设置中配置的退货仓库进行选择。如果未设置，则使用原仓库。