README

此插件允许拥有 Magento 在线商店的商家将订单自动发送到 PPM 履行服务。

仅适用于同时拥有 PPM 账户的 Magento 用户。

以下是其工作原理

1. 客户下单购买一个或多个商品。
2. 下单时，我们会检查这些商品中是否有任何由 PPM 履行
3. 该订单中由 PPM 履行的商品将被添加到装运（包裹集合）并发送给 PPM
4. 随着订单更新（以跟踪号码的形式）的传入，PPM 会发布订单更新

安装

通过 Magento 市场安装此插件是最好的方式（待定）

您也可以使用 composer 安装

$ composer require ppm_fulfillment/magento-fulfillment

在服务器的应用程序根目录中执行此操作。然后，继续按照 本文中的说明 进行操作

最后，您可以通过手动上传文件进行安装

1. 从 GitHub 下载扩展
2. 在您的 Magento 安装中创建一个名为 app/code/Ppm/Fulfillment 的目录
3. 将此存储库的内容复制到该目录
4. 在安装根目录中运行 php bin/magento setup:upgrade
5. 在安装根目录中运行 php bin/magento setup:di:compile
6. 验证模块状态： $ bin/magento module:status
7. 清除缓存： $ bin/magento cache:clean

配置

要使用此插件，您需要

• PPM 履行服务的有效账户
• 有效的第三方 API 集成和 API 密钥
• PPM API URL（提供了一个默认值）
• 您的 "所有者代码”（您将从 PPM 获取）
• 有效的 Magento 商店

第 1 步：设置插件

首先，在侧边菜单中，选择 商店 > 所有商店。

从那里，您将想要选择正确的 网站。每一行对应于您网站中的一个商店。如果您有多个商店，您将需要为每个商店重复此过程，每次使用不同的 PPM 第三方集成 API 密钥。

这将打开您的网站配置。三个 PPM 特定的字段是

• PPM API 密钥（由 PPM 提供）
• PPM 所有者代码（由 PPM 提供）
• PPM API URL（您几乎肯定希望保留默认值 https://portal.ppmfulfillment.com/api/External/ThirdPartyOrders）

在将订单自动提交到 PPM 之前，这三个字段都必须填写完整。

第 2 步：配置产品

假设您已正确设置了插件，接下来您需要配置单个产品。对于您希望由 PPM 履行的每个产品，您需要

1. 指出该产品由 PPM 履行
2. 提供 PPM 产品 ID（由 PPM 提供）

我们假设您将有一些产品由 PPM 履行，而另一些产品将通过其他渠道履行（无论这些渠道是什么）。因此，我们要求您明确指出将由 PPM 履行的单个产品。

当客户下单时，如果该订单包含任何由 PPM 履行的产品（通过具有 "true" 值的 由 PPM 履行？ 和 PPM 产品 SKU 来识别），这些产品（及其数量）将作为订单过程的最后一步发送到 PPM。订单中的任何非 PPM 履行的产品都不会发送到 PPM。

第 3 步：从 Magento 发起 PPM 履行请求（自动化）

当创建新订单时，此扩展将遍历订单中包含的目录产品，并构建一个待由PPM履行的目录产品列表。目录项必须有一个PPM产品ID值，并且由PPM履行必须设置为是，否则此目录产品将不会包含在发送给PPM的请求中。

在此阶段，订单网格视图中的是否有PPM装运？列应显示是。请注意，即使在PPM尚未创建装运记录之前，此列也会显示是。此列默认由扩展安装时启用，但可以通过columns清单隐藏此视图。

步骤4：PPM履行更新Magento管理后台（自动）

一旦PPM完成了包含所需内容的装运，就会向Magento发送更新，执行以下操作

1. 创建一个新的装运记录
2. 创建一个新的装运跟踪记录
3. 为装运中包含的每个项目创建一个详细说明数量、批号和序列号的新的PPM装运详情记录。

步骤5：装运信息审查

一旦创建装运记录，它将出现在您的装运网格下。如果由PPM履行创建了装运，则由PPM履行？列将显示是。此列默认由扩展安装时启用，但可以通过columns清单从视图中隐藏。

装运视图页面将提供有关特定装运的批号、序列号和数量的信息。