README

Mozg\Jamef

简介

集成Jamef

演示

动机

为了满足Magento模块市场的需求，提供改进和优质的客户支持

支持/疑问

要获得适当的支持点击这里，尽可能详细地描述发生的原因，并附加屏幕截图以便我们理解

价格

点击这里

模块资源

[✓] 运费计算
[✓] 跟踪

技术特性

目前，许多第三方模块关于配送方法总是将产品的重量和尺寸相加，由于没有系统来分离产品到适当的包装中并分配其重量，因此在向运输公司提出请求时会产生错误。

我们的模块旨在实现执行过程的完全透明，为了分析效果，请查看存储在日志中的过程。

该扩展允许您定义产品的尺寸、包装/箱的尺寸、重量和价值以及如何将不同组合的产品打包在一起，例如将产品分别打包或将其打包在同一包装/箱中。

该扩展选择用于打包订单产品的包装。

该扩展可以将产品分配到多个包装中，直到达到包装的最大承重。

由于包装的尺寸和运输公司支持的重量已被登记，因此不应出现与尺寸或重量相关的错误。

在使用模块时，首先要考虑的是包装/箱管理，因为已经有一些预插入的记录，请确保根据您的需求更新记录。

请确保已为产品注册适当的尺寸。

对于每个包装，都会向运输公司提出一个请求，并传递适当的参数。

该模块具有缓存存储

在订单完成时，在订单历史中存储一个包含唯一标识符的注释，该标识符可以用于在日志文件中查询包装、项目和查看每个包装及其项目的3D视图。

在处理每个订单之前，请始终检查运费信息，如果发现任何不一致之处，则必须取消订单，直到问题得到纠正。

为了跟踪包裹，会访问WebService，并传递适当的参数，然后显示相应的返回值。

在Heroku上测试

我想展示我在Heroku平台上提供的应用程序

只需单击一次，应用程序就会创建使用电子商务平台Magento的虚拟商店，并安装MOZG的模块

https://github.com/mozgbrasil/heroku-magento#descrição

安装 - 更新 - 卸载 - 禁用

建议“打印”出执行的所有步骤的屏幕截图

在遇到任何困难时，请将屏幕截图发送给我们

此模块旨在使用Composer安装

在终端中执行以下命令，以查看Composer的存在及其版本

composer --version

如果您环境中没有Composer，建议阅读以下文章点击这里

服务器需要支持ionCube PHP Loader扩展

要查看PHP CLI环境中的扩展是否存在，请在终端中执行以下命令

php -v

要查看该扩展是否在PHP WEB环境中激活

请确认您的项目根目录中是否存在phpinfo.php文件

<?php phpinfo(); ?>

如果项目根目录中没有phpinfo.php文件，请创建该文件并添加上述内容

通过浏览器访问该文件

然后搜索“ionCube PHP Loader”术语

如果您的服务器不支持该扩展，请联系您的托管公司，并要求他们激活该扩展

如果您有权限并想激活该扩展，点击这里

在“Loader Downloads API”中，下载与您的服务器兼容的包

解压缩包并将loader-wizard.php文件上传到您的服务器，该文件将展示激活扩展的步骤

点击这里查看执行过程

在存在“ionCube PHP Loader”的情况下，下载以下文件并将其放置在服务器根目录下，然后访问，如果工作正常，则表示“ionCube”正在读取此类型的加密

https://raw.githubusercontent.com/mozgbrasil/heroku-magento/master/phpinfo-ioncube-encoder10-x86-64-php_56.php

要使用MOZG的模块，必须接受最终用户许可协议

建议保持一个测试环境进行测试，并且只有在测试完成后才在生产环境中应用相应的程序

建议备份Magento平台和数据库

在执行任何 Magento 更新之前，始终保持 Compiler 和 Cache 禁用

请确认您的项目根目录中存在composer.json文件，并且其参数类似于以下JSON模型

{
  "minimum-stability": "dev",
  "prefer-stable": true,
  "license": [
    "proprietary"
  ],
  "repositories": [
    {
      "type": "composer",
      "url": "https://packages.firegento.com"
    }
  ],
  "extra": {
    "magento-root-dir": "./",
    "magento-deploystrategy": "copy",
    "magento-force": true
  }
}

如果项目根目录中没有composer.json文件，请创建该文件并添加上述内容

要在服务器上的项目目录中安装模块，请执行以下命令

composer require mozgbrasil/magento-jamef-php_56:dev-master

您可以通过进入后台检查模块是否已安装

STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output

要更新模块，请执行以下命令

在执行任何涉及 Magento 更新的过程之前，建议保持 Compiler 和 Cache 禁用

composer update

在发生错误时，将 /vendor/mozgbrasil 文件夹重命名并重新执行

要检查模块的日期，请执行以下命令

grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil

要卸载模块，请执行以下命令

composer remove mozgbrasil/magento-jamef-php_56

要禁用模块

在执行涉及 Magento 更新的任何过程之前，必须保持 Compiler 和 Cache 禁用
如果您想禁用MOZG的模块，请重命名以下文件夹 app/code/local/Mozg

禁用模块可以用来检测特定事件是否与模块有关

如何配置配送方式

在配置模块之前，您需要注册原始CEP，进入后台

STORES -> Configuration -> Sales/Shipping Settings -> Origin

要配置配送方式，请进入后台

STORES -> Configuration -> Sales/Shipping Methods -> Jamef (powered by MOZG)

您将看到以下字段

• 启用

关于“激活”或“停用”方法的使用

• 显示顺序

这是在订单关闭步骤中显示的交付方法顺序

• 标题

应显示的方法名称

• 服务

选择所需的服务，要选择多个服务，请按住“Ctrl”键并单击服务

• 免费送货服务

当存在免费运费折扣时，此服务将显示为零价值

• 计算处理费

可以是固定费用或百分比

• 处理费

此值将添加到运费中

• 如果不适适用时显示方法

当设置为“否”时，如果返回了有错误的服务，则不会显示交付方法

• 调试

模块过程应存储在 var/log/

文件

DATE_mozg.log

这是模块的日志，是一个更详细的日志，包含所有过程，包括由模块的外部库执行的过程

文件

shipping_METHOD.log

这是关于交付方法的本机 Magento 日志

• 产品宽度属性标识符

允许定义项目中使用的产品宽度属性名称

• 产品长度属性标识符

允许定义项目中使用的产品长度属性名称

• 产品高度属性标识符

允许定义项目中使用的产品高度属性名称

• 计量单位

产品重量的标准单位为千克

如果使用质量单位克，则产品和包装都必须遵守同一标准

在方法配置中指定使用质量单位克时，将执行从克到千克的转换

1 千克在“千克”格式中将是“1.000”，在“克”格式中将是“1000.000”

• 显示交货期限

是否向客户显示交货期限

• 显示交货期限的消息

是否向客户显示交货期限

• 将（天数）添加到交货期限

要添加的天数

• 显示有错误的服务

当设置为“否”时，如果返回了有错误的服务，则不应在交付方法中显示

• 运输产品类型

要运输的产品类型

• 将负责付款的客户 CPF 或 CNPJ

在此字段中填写与 Jamef 合同关联的 CPF 或 CNPJ 号码

• 将收集货物并为客户发出 CTRC 的 Jamef 分支机构

将收集货物并为客户发出 CTRC 的 Jamef 分支机构

• 货物的原产市镇名称。与客户负责的市镇相同

货物的原产市镇名称。与客户负责的市镇相同。

不要输入重音符号

• 原产州简称

原产州简称

常见问题解答 “FAQ”

关于交货期限的返回

仅在填写目的地州和市时才应返回期限

为了在购物车中显示城市字段，需要激活 DHL 方法，或编辑 *.phtml 文件，这适用于本机 RWD 模板

... 没有与该运费模式或与该产品尺寸/重量兼容的包装

请确保已为产品登记了适当的尺寸

在产品编辑中，MOZG 模块创建了一个名为“运费”的选项卡

如果存在名为“Correios”的选项卡，则通常是由“PedroTeixeira”创建的

在后台菜单中访问：MOZG -> 包装/纸箱管理器

您会看到一个名为“通用”的包装记录，它与该方法关联。之所以这样做，是因为我没有从承运商那里获得标准包装列表。

因此，添加符合商店产品的新包装记录非常重要。

根据需要添加符合您产品需求的新记录。

如何与承运商确认运费

您可以在日志中查看发送给承运商的参数。

完成订单后，使用的箱子的尺寸将被存储在历史记录中，用于计算运费。

价格请求的模拟

执行产品运费计算时

产品尺寸是 "(LxWxH): 49 x 49 x 8 cm"

包装尺寸是 "(LxWxH) 91 x 101 x 143 cm" 且将存储 10kg

使用包装尺寸进行体积重量计算

体积重量的公式是 "(包装宽度/100)×(包装长度/100)×(包装高度/100)"，即

METRO3 = (91/100)×(101/100)×(143/100) = 1.314313

处理以下请求时得到相应的返回

curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'SOAPAction:JAMW0520_03' --data '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.jamef.com.br/">
    <SOAP-ENV:Body>
        <ns1:JAMW0520_03>
            <ns1:TIPTRA>1</ns1:TIPTRA>
            <ns1:CNPJCPF>00000000000000</ns1:CNPJCPF>
            <ns1:MUNORI>Belo Horizonte</ns1:MUNORI>
            <ns1:ESTORI>MG</ns1:ESTORI>
            <ns1:SEGPROD>000004</ns1:SEGPROD>
            <ns1:QTDVOL>1</ns1:QTDVOL>
            <ns1:PESO>10</ns1:PESO>
            <ns1:VALMER>730</ns1:VALMER>
            <ns1:METRO3>1.314313</ns1:METRO3>
            <ns1:CNPJDES />
            <ns1:FILCOT>02</ns1:FILCOT>
            <ns1:CEPDES>08250580</ns1:CEPDES>
        </ns1:JAMW0520_03>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>' http://www.jamef.com.br/webservice/JAMW0520.apw

或

http://wsdlbrowser.com/soapclient?wsdl_url=http%3A%2F%2Fwww.jamef.com.br%2Fwebservice%2FJAMW0520.apw%3Fwsdl&function_name=JAMW0520_03

配送预测模拟

curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'SOAPAction:JAMW0520_02' --data '<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.jamef.com.br/" SOAP-ENV:Body ns1:JAMW0520_02 ns1:TIPTRA1 ns1:MUNORIBelo Horizonte ns1:ESTORIMG ns1:MUNDESSão Paulo ns1:ESTDESSP ns1:CNPJCPF00000000000000 ns1:CDATINI05/02/2018 ns1:CHORINI13:09 /ns1:JAMW0520_02> </SOAP-ENV:Body>' http://www.jamef.com.br/webservice/JAMW0520.apw

查询请求模拟