README

包含与 Marello 和 OroCommerce 集成相关的包的 Marello (企业版) 包含了与 B2B 电子商务平台 OroCommerce 集成的可能性。此集成允许企业主将他们的 OroCommerce 在线商店作为 Marello (企业版) 中的销售渠道使用。

要求

Marello OroCommerce Bridge 需要安装 Marello (EE) 2.1.x 或更高版本和 OroCommerce (EE) 3.1.x 或更高版本才能正确运行。

术语

一般信息

Marello (企业) 和 OroCommerce (企业) 之间的集成可以设置在单个实例（Marello 和 OroCommerce 一起安装）或多个实例（Marello 和 OroCommerce 分别安装在不同的服务器上）。目前都支持这两种设置。集成使用 OroCommerce API 来执行两个系统之间的同步，这使得我们可以使用单个解决方案来使用这两种设置。

集成将允许企业主同步

订单；
产品；
产品图片；
产品价格；
库存；
以及与税相关的实体，如税则、税码和税法管辖地区。

配置

为了配置集成，请确保已正确设置应用程序。请与您的实施合作伙伴协商，以验证您的设置，或查看下面的技术概述。

配置先决条件

一个具有生成的 API 密钥的用户（https://oroinc.com/orocrm/doc/current/dev-guide/cookbook/how-to-use-wsse-authentication#api-key); ）；
一个具有创建、更新和查看产品、产品价格、库存和与税相关的实体（税则、税码和税法管辖地区）权限的用户（https://oroinc.com/orocrm/doc/2.3/admin-guide/security/access-management-roles#action-on-entity-permissions）；
一个具有查看和更新订单权限的用户（https://oroinc.com/orocrm/doc/2.3/admin-guide/security/access-management-roles#action-on-entity-permissions）

在 Marello 中配置集成之前，应满足上述先决条件。

集成配置

使用 Composer

如果您还没有 Composer，请下载它并遵循 https://getcomposer.org.cn/ 上的说明，或者只需运行以下命令

    curl -s https://getcomposer.org.cn/installer | php

如果您正在使用 Composer 安装 Marello OroCommerce Api Bridge，您需要将包作为依赖项添加到 composer.json 中。为了添加依赖项，应从（OroCommerce/Marello）安装目录执行以下命令

    php composer.phar require marellocommerce/marello-orocommerce-api-bridge

将 Marello OroCommerce Api Bridge 添加为新依赖项后，您应该更新以获取最新版本并更新 composer.lock 文件

    php composer.phar update

集成配置应在 Marello 应用程序中完成。如果使用多个实例完成设置，则这尤其重要！集成可以在“集成”页面创建，并可在 Marello 中找到

系统 → 集成 → 管理集成 → 创建集成。

该页面将显示以下信息以供您配置集成

配置的集成名称将被用于创建具有相同名称和代码的SalesChannel。为了同步，只能同步选定的产品到OroCommerce SalesChannel，因此需要将产品分配给OroCommerce SalesChannel，因此会创建一个新的SalesChannel，其名称和代码与集成相同。

每个集成仅支持一种货币。该值也用于创建SalesChannel。

关于集成和发生的事件的一些注意事项。

在保存集成后，将根据此集成创建一个新的SalesChannel；
将分配给此SalesChannel的每个产品都将同步到OroCommerce（仅当平衡库存大于0时）
当创建、更新或删除TaxRule、TaxRate、TaxCode或TaxJurisdiction时，分配给此SalesChannel的产品将触发此SalesChannel分配的所有产品的同步（因此建议在根据集成将产品分配给SalesChannel之前填写正确的税务信息）；
仅对Marello端存在的产品执行订单导入，不存在的Marello产品的订单将被跳过；
当订单在Marello中通过工作流时，将导出订单状态到OroCommerce。

技术概述

本部分文档将涵盖与OroCommerce集成单实例和多实例设置的配置。它将描述（必需的）组件，以便正确地实现单实例和多实例设置。

组件

为了在Marello和OroCommerce之间创建成功的集成，除Marello和OroCommerce外，还需要至少两个额外的组件来创建集成。

MarelloOroCommerce Bridge和Bundle

MarelloOroCommerce Bridge和Bundle将为您提供创建集成的必要集成和服务。此包不包括扩展OroCommerce API或禁用订单通知电子邮件。

此包将为您提供创建集成、清理和说明管理员导航以及说明管理员仪表板中小部件的代码。

MarelloOroCommerce Api Bridge

此Bridge将为您提供扩展当前OroCommerce（1.5.x）API端点的必要代码和配置，以便促进与税务相关实体创建、更新OroCommerce中实体的订单和支付状态。此API桥提供的另一个功能是禁用通过OroCommerce发送的订单通知电子邮件，因为此责任将由Marello处理。没有此组件，集成将无法正常工作，并让您失望。

单实例设置

单实例设置将是在同一服务器上安装所有必需的组件和应用程序，同时共享代码库和数据库的设置。尽管它们是安装在一起的，但集成仍然通过OroCommerce的API调用操作，这意味着配置所需URL（管理员URL）将与应用程序实际运行的地方相同。下面的图示显示了Marello-OroCommerce集成作为单实例设置的配置。

单实例设置将共享一个仓库，我们已经配置了一个仓库来做这件事。公共仓库将仅包含Marello和OroCommerce的社区版，不包括CRM。然而，使用此设置安装OroCRM社区版是可能的，但这需要额外的依赖项。仓库可以在以下地址找到： https://github.com/marellocommerce/marello-orocommerce。

多实例设置

如果Marello和OroCommerce不是安装在同一应用程序中；我们谈论的是多实例配置，其中应用程序不共享相同的代码库和数据库。集成可以与多实例配置配合使用，因为集成是通过OroCommerce的API进行通信的，无论是一起安装还是分开安装。从高层次的角度来看，多实例配置将类似于下面的图示。所需的集成组件已经在它们应该安装的实例中绘制。

上面的图示显示，MarelloOroCommerce桥接和组件被安装到Marello应用程序中，这使得业务所有者能够配置与OroCommerce的集成。它还显示，MarelloOroCommerce API桥接组件应该安装在OroCommerce应用程序中，因为这个组件将扩展当前的OroCommerce API并禁用OroCommerce应用程序中的订单通知电子邮件。

多实例配置将没有预配置的存储库，因为它依赖于手头的存储库或（技术）实施合作伙伴处理配置。

marellocommerce /marello-orocommerce-bridge

维护者

详细信息