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_54.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_54:dev-master

您可以通过访问后端来检查模块是否已安装

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

要更新模块，请在服务器上项目的目录中执行以下终端命令

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

composer update

如果发生错误，请将/vendor/mozgbrasil文件夹重命名，然后重新执行

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

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

要卸载模块，请在服务器上项目的目录中执行以下终端命令

composer remove mozgbrasil/magento-jamef-php_54

要禁用模块

在执行任何涉及更新关于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 Kg在“千克”格式中为“1.000”，在“克”格式中为“1000.000”

• 显示配送期限

是否向客户显示配送期限

• 显示配送期限的消息

是否向客户显示配送期限

• 将（天数）添加到配送期限

要添加的天数

• 显示错误返回的服务

当配置为“否”时，如果返回任何服务错误，则不应在配送方法中显示

• 要运输的产品类型

要运输的产品类型

• 将支付责任的客户CPF或CNPJ

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

• 将执行商品采集和为客户开具CTRC的Jamef分支机构

将执行商品采集和为客户开具CTRC的Jamef分支机构

• 商品原产地市的名称。与客户负责人相同的市

商品原产地市的名称。与客户负责人相同的市。

不要输入重音符号

• 原产地州的缩写

原产地州的缩写

常见问题解答 "FAQ"

关于配送期限的返回

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

要显示购物车中的城市字段，需要启用DHL方法或编辑*.phtml文件，这是针对原生RWD模板的

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

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

在产品编辑中，名为“运费”的标签页由MOZG模块创建。

如果存在名为“快递”的标签页，通常是由“PedroTeixeira”创建的。

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

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

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

如有必要，添加符合您产品需求的新记录。

如何与运输公司核对运费

您可以在日志中查看发送给运输公司的参数。

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

价格请求的模拟

执行产品的运费计算

产品的尺寸是“(LxCxA): 49 x 49 x 8 cm”

包装尺寸是“(LxCxA) 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> </SOAP-ENV:Envelope>' http://www.jamef.com.br/webservice/JAMW0520.apw

查询请求的模拟