shellpea / magento-cdek-shipping

CDEK 邮件模块用于 Magento 2

维护者

详细信息

github.com/shellpea/Magento-2-CDEK-Module

源代码

问题

安装: 4

依赖关系: 0

建议者: 0

安全性: 0

星标: 12

关注者: 0

分支: 2

开放问题: 0

类型:magento2-module

1.0.0 2023-11-10 12:05 UTC

Requires

  • php: ^8.0
  • magento/framework: *

OSL-3.0 1b2c8dea8b4b5131d65b2f57a7f76318627843c8

This package is auto-updated.

Last update: 2024-09-12 12:01:52 UTC

README

适用于 Magento 2.4.6 及以上版本的 CDEK 邮件服务集成模块。

模块功能

  • 通过 CDEK 俄罗斯运输公司发送包裹
  • 实现了“包裹”和“经济型包裹”两种计费方式
  • 计算配送费用
    • 在自提点
    • 在智能包裹柜
    • 通过快递员
  • 在订单结算时，可以选择邮局作为配送点
  • 在订单结算时，可以选择智能包裹柜作为配送点
  • 在 CDEK 信息系统中创建订单
  • 生成条形码打印表
  • 订单跟踪
  • 可以选择通过 CDEK 运输公司配送包裹的方式
    • 自行将包裹送到自提点
    • 通过快递员配送

模块配置

步骤 1. 与 CDEK 签订合同。

使用此模块需要与 CDEK 运输服务签订合同。
如果您还没有合同，您可以在此处签订。

步骤 2. 安装 CDEK 模块

composer require shellpea/magento-cdek-shipping

步骤 3. 为您的商店启用 CDEK。

  1. 转到管理员面板，在
    商店 > 设置 > 配置 > 销售 > 配送方法 > CDEK

  2. 将“启用”字段的值设置为“是”。

  3. 在“标题”字段中输入将在订单结算时显示给用户的配送方法名称。

  4. 填写“账户”和“安全密码”字段，这些字段对应于CDEK 个人账户中的“标识符”和“密码”，在“集成”部分。

  5. 可选：模块中包含与 Yandex Maps 的集成，要启用，需要填写“启用结算时的地图”和“Yandex Api Key”两个字段，API 密钥可以在Yandex Maps API 获取。

  6. 将“测试模式”字段的值设置为“否”。
    如果您想在 CDEK 测试环境中测试配送，则需要将“测试模式”设置为“是”并输入测试账户的密钥。
    测试账户的数据是公开的，在文档中指定。

  7. 在“包裹如何送至 CDEK？”字段中，需要选择将包裹送至 CDEK 的方式

    • 我将自行将包裹送到 CDEK - 您将自行将包裹送到 CDEK 办公室。
    • 快递员必须取走包裹 - 快递员必须取走包裹并将其送至 CDEK。
      此字段负责选择配送方式（上门/到仓库），这会影响配送费用。

  8. 在“ZIP/邮政编码”字段中，输入发件城市的邮政编码。

  9. 发件地址可以通过以下方式之一设置

    • 当“包裹如何送至 CDEK？”设置为“我将自行将包裹送到 CDEK”时
      可用“自提点”字段，根据“ZIP/邮政编码”字段中的邮政编码显示办公室列表。
      选择合适的办公室，配送费用将基于该办公室计算。
      (您将自行将包裹送到选定的办公室。)
    • 当“包裹如何送至 CDEK？”设置为“快递员必须取走包裹”时
      需要指定快递员送货的地址，请填写以下字段
      • 地区/州
      • 城市
      • 街道地址
      • 街道地址行 2 (非必填)

  10. 在 配送方式 字段中选择用户在下单时可以使用的配送方式

    • 快递员配送 (快递配送)
    • 自提点配送 (自提配送)
    • 包裹终端配送 (包裹自提终端配送)

  11. 为了让 Magento 接收到 Webhooks，需要将 Webhooks Enable 设置为 是，将 测试模式 设置为 否。
    请确保在 账户 和 安全密码 中填写了来自 个人账户 的正确数据
    (在测试模式下，Webhooks 不会到来。)

  12. 打印运单份数 - 打印形式的副本数。

  13. 条码格式 - 打印格式。可能接受以下值：A4，A5，A6，A7。

  14. 设置包装尺寸：(影响配送费用)

    • 在 包装 字段中选择列表中的盒子
      当 包装 等于 您的包装 时，为以下字段设置值
      • 包装长度（cm）
      • 包装宽度（cm）
      • 包装高度（cm）
        (单位为厘米)
    • 在 默认属性集 中添加了以下属性
      • Cdek 包裹长度（cm）
      • Cdek 包裹宽度（cm）
      • Cdek 包裹高度（cm）
        (单位为厘米)
        如果产品指定了这些属性的值，它们将被用于计算配送成本，
        否则 - 使用在包装字段中选择的包装的尺寸        .

  15. 在 排序顺序 字段中输入数字，以确定 Cdek 在下单时与其他配送方式显示的顺序。

  16. 点击 保存配置。

在 Cdek 中注册订单

  1. 在管理员侧边栏中打开 销售 > 订单 选项卡
    找到所需订单并转到订单查看页面。

  2. 对于已存在的发货

    • 打开 发货 选项卡，转到所需发货页面
      在 配送和跟踪信息 部分中点击 创建运单。

    创建新的发货

    • 点击 发货 按钮。在出现的窗口中，需要选择 创建运单 选项。
      然后点击 提交发货… 按钮。

  3. 将商品分配到包装中，为它们指定重量和尺寸，点击保存。
    (请注意，每个包装都有重量（kg/lb）和尺寸（cm/in）的测量单位。
    在 Cdek 中的值将分别以 kg 和 cm 发送。
    因此，如果包装的重量单位是 lb，重量将转换为 kg。
    同样，尺寸将从 in 转换为 cm)

  4. 成功创建运单后，在 配送和跟踪信息 部分将出现 打印运单 按钮
    和跟踪号码，可以用来在 Cdek 中追踪订单。
    (如果在创建运单时出现任何问题，将在 创建运单 表单中出现错误信息。)

  5. 要下载打印的条码，请点击 打印运单