README

Ježek Duel 插件

特性

提供与 Duel 会计软件的集成。

• 将 Sylius 订单下载到 Duel
• 更新 Sylius 的产品数据
• 您可以更新任何产品数据，默认情况下，插件只更新库存水平。有关详细信息，请参阅 mango:jezek:update 命令的 updateProduct() 方法。
• 结合 支付费用模块，它可以处理现金送货费用（在捷克和斯洛伐克称为 "Dobírka"），包括税费。

要求

• 基于 Ježek Duel 集成的实现方式，您需要一个 FTP 账户作为存储用于数据传输的 XML 文件。

安装

1. 运行 $ composer require mangoweb-sylius/sylius-jezek-duel-plugin。
2. 在您的 Kernel 中注册 \MangoSylius\JezekDuelPlugin\MangoSyliusJezekDuelPlugin。
3. 将 ftp 参数添加到 config.yml 中

    mango_sylius_jezek_duel:
        server_url: 'server_url'
        username:   'username'
        password:   'password'

1. 您的实体 Order 必须实现 \MangoSylius\JezekDuelPlugin\Model\OrderWithExportedAtInterface。您可以使用 Trait MangoSylius\JezekDuelPlugin\Model\OrderWithExportedAtTrait。
2. 您的实体 ProductVariant 必须实现 \MangoSylius\JezekDuelPlugin\Model\ProductVariantWithJezekIdsInterface。您可以使用 Trait MangoSylius\JezekDuelPlugin\Model\ProductVariantWithJezekIdsTrait。
3. 将模板 Resources/views/Channel/extendedChannelForm.html.twig 包含到 @SyliusAdmin/Channel/_form.html.twig 中。

有关使用您自己的实体的指南，请参阅 Sylius 文档 - 自定义模型

用法

• 在 Duel 中设置电商平台
  使用 "Webový servis" 或 "eBrána" 类型。在 "Agenda" 选项卡中点击 "Založit e-shop"（询问文件夹名称的 ID，保留默认值 - "in" 和 "out"）。
• 链接产品
  使用 Ježek 产品 UID 代码作为 Sylius 中产品的代码，或者如果您在 Sylius 电商平台使用其他代码，请在专用产品参数 "Ježek ID" 中放入 Duel 的产品 UID。您可以将多个 UID（每行一个）放入以连接更多 Duel 产品到单个 Sylius 产品，当销售产品组合时。插件首先检查 "Ježek ID" 字段，如果为空，则检查产品代码以通过 Ježek UID 匹配产品。对于可配置产品，每个变体有一个 "Ježek ID"。您也可以为多个变体和产品使用相同的 "Ježek ID"。
• Sylius 的数据处理
  按以下说明设置 cron 命令。建议的频率为订单 5 分钟（繁忙的商店可能更少）和产品一小时（如果您更新产品不频繁，请使用每日同步）。
• 发票传入同步（来自电商平台的订单）
  在 "Agenda" 选项卡中点击 "Stažení objednávek z e-shopu"。
• 发票传出同步（产品数据到电商平台）
  在 "Agenda" 选项卡中点击 "Aktualizace dat v e-shopu"。

命令

• 导出订单到 FTP。

  mango:jezek:export

• 从 FTP 更新产品详细信息。

  mango:jezek:update

开发

用法

• 从 .env.dist 创建到 .env 的符号链接或创建您自己的 .env 文件
• 在 /src 中开发您的插件
• 请参阅 bin/ 以获取有用的命令

测试

在您的更改之后，您必须确保测试仍然通过。

• 简单的编码标准

  bin/ecs.sh

• PHPStan

  bin/phpstan.sh

许可证

本库采用MIT许可证。

致谢

由manGoweb开发。