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 安装该应用。有关安装 Frappe 应用的说明，请参阅 bench 文档。
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设置中配置的退货仓库进行选择。如果未设置，则使用原始仓库。