storekeeper/magento2-plugin

Storekeeper插件

维护者

详细信息

github.com/storekeeper-company/magento2-plugin

源代码

问题

安装: 147

依赖: 1

建议者: 0

安全: 0

星标: 0

关注者: 3

分支: 1

开放问题: 2

类型:magento2-module

2.1.56 2024-09-20 10:34 UTC

Requires

LGPL-3.0-only 0fc8150ec5ad508458912eff3ea55cf1cd80c0b7

This package is auto-updated.

Last update: 2024-09-27 07:19:16 UTC

README

将您的Magento 2商店连接到StoreKeeper。

重要通知

在使用模块之前，请确保您的商店已根据商店所在区域配置了所有税费规则、类别和税率。请参阅此官方Magento指南。

如果您的项目使用多源库存（MSI）功能，或者启用了与MSI相关的模块，请安装此附加模块。

安装

  1. 进入您的Magento 2目录，并通过composer安装插件
composer require storekeeper/magento2-plugin
  1. 通过运行以下命令重新编译您的Magento 2安装
bin/magento setup:upgrade;
bin/magento setup:di:compile;
bin/magento setup:static-content:deploy;
bin/magento cache:clean;

配置

  1. 登录您的Magento 2后台，然后转到商店 -> 配置 -> StoreKeeper -> 常规

  2. 通过导航到左上角商店导航的最低级别来选择您的商店

  3. 通过将字段启用设置为是来启用插件

  4. 点击启用旁边的按钮StoreKeeper Connect，然后您将被重定向到StoreKeeper连接页面

  5. 按照屏幕上的说明输入您的StoreKeeper账户名称

  6. 如果它是有效的，则单击连接，然后您将被重定向到您的StoreKeeper账户仪表板

  7. 返回到Magento管理员商店 -> 配置 -> StoreKeeper -> 常规，然后点击刷新商店信息以接收StoreKeeper为当前集成预留的商店ID和商店名称

同步模式说明

当前扩展在以下4种模式之一中运行

  • 无 - M2和Storekeeper系统之间不进行数据交换
  • 产品 - 仅同步与产品相关的数据（产品创建、激活、停用和库存更新）
  • 订单 - 仅同步与订单相关的数据（订单主体、状态、项目、付款、发货）以及产品库存
  • 全部 - 上述两种方法的组合

可以在商店 -> 配置 -> StoreKeeper -> 常规 -> 同步模式部分调整同步模式

注意：由于在已发货和已送达之间缺少在Magento中的配送状态，因此从Magento管理员创建的订单配送将作为已完全配送同步到StoreKeeper后台办公室

配送方式配置

为了使用StoreKeeper多承运人配送配送选项，请在以下位置激活它
商店 -> 配置 -> 销售 -> 配送方式 -> StoreKeeper多承运人配送

之后，您在StoreKeeper后台办公室配置的所有配送报价都将可在Magento结账中访问

支付方式配置

通过Storekeeper支付网关可用的支付方式可以在两个地方激活

  1. 作为StoreKeeper支付支付方式的一个选项，在以下位置可用
    商店 -> 配置 -> 销售 -> 支付方式 -> 其他支付方式 -> StoreKeeper支付（是/否）

在这种情况下，客户将看到在其storekeeper账户上激活的所有支付选项。Storekeeper Payments available in Magento as single Payment option 2. 作为单独的支付选项
为了在Magento结账中显示Storekeeper账户上可用的任何支付方式作为单独的支付选项，管理员用户需要在此激活方法
商店->配置->店长->店长付款 作为单独付款选项可用的付款方式iDEAL

在这种情况下，激活的付款方式将作为单独的付款方式选项出现，并在店长付款中消失作为子选项作为单独付款选项可用的付款方式iDEAL

没有自己的标志的付款方式将收到在Magento管理员面板的“内容->设计->配置”区域设置的当前商店标志

导出

该模块允许导出以下Magento实体：产品、客户、分类、属性集、属性、属性选项、蓝图（简单产品的可能组合以组成可配置产品）。

导出的数据以csv格式保存，适用于StoreKeeper后端。通过路径生成和下载：系统->数据传输->店长导出数据

所有字段都是预先映射的，而特定项目的产品属性可以通过商店->配置->店长->导出下的“特色属性”选项卡进行映射

注意：默认情况下，条形码字段映射到SKU属性，并将符合EAN13要求的sku作为条形码映射属性导出

如果你的商店有专门的定制条形码属性，请通过特色属性选项卡进行映射。

队列

此插件使用Magento 2队列消费者功能。如果您想手动运行队列，可以使用以下命令

运行处理StoreKeeper webhook事件的消费者

bin/magento queue:consumer:start storekeeper.queue.events

运行处理StoreKeeper的Magento实体导出的消费者

bin/magento queue:consumer:start storekeeper.data.export

运行与StoreKeeper同步过程的消费者

bin/magento queue:consumer:start storekeeper.queue.sync.orders

断开连接

断开您的Magento 2商店可以通过两种方式完成

从店长断开连接

  1. 登录您的店长环境

  2. 选择您的店长销售渠道

  3. 转到设置

  4. 滚动到断开连接按钮并单击它

从Magento 2断开连接

  1. 登录您的Magento 2后台

  2. 登录您的Magento 2后台，然后转到商店 -> 配置 -> StoreKeeper -> 常规

  3. 通过导航到左上角商店导航的最低级别来选择您的商店

  4. 单击当前配置部分底部的从店长断开连接按钮

故障排除

调试

如果您在使用插件时遇到任何问题，首先应检查magento2/var/log/storekeeper.log以查找任何错误。

任务和事件日志

所有传入的webhook事件数据都会被记录，并可以在以下位置进行审查：
系统 -> 操作日志 -> 店长事件日志选项卡。
此网格收集有关请求路由、正文、方法、操作、响应代码和时间戳的每个传入webhook的信息。

所有与StoreKeeper相关的任务都记录在以下位置：
系统 -> 操作日志 -> 店长任务日志选项卡。
此网格收集有关主题名称、json格式的请求正文、更新时间、状态以及由Magento核心队列管理的尝试次数的信息，以完成任务。
任务日志记录同步队列中每个订单的添加、其处理以及与产品同步（导入、导出、更新）的每个操作。

运行集成测试

  1. 根据Magento 2集成测试文档准备您的环境https://developer.adobe.com/commerce/testing/guide/integration/

  2. 要从特定的目录树在Magento 2中运行集成测试，请使用以下命令

cd dev/tests/integration

../../../vendor/bin/phpunit ../../../vendor/storekeeper/magento2-plugin/Test/Integration
  1. 在Magento 2中运行单个测试类，请使用以下命令
cd dev/tests/integration

../../../vendor/bin/phpunit ../../../vendor/storekeeper/magento2-plugin/Test/Integration/OrderCreationTest.php