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_72.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_72: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_72

为了禁用模块

在执行任何涉及更新关于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 -> 包装/纸箱管理器

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

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

如有需要，请添加新的记录以满足您产品的需求。

如何与运输公司核对运费

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

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

价格请求的模拟

执行产品运费计算

产品的尺寸是 "(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:TIPTRA> ns1:MUNORIBelo Horizonte</ns1:MUNORI> ns1:ESTORIMG</ns1:ESTORI> ns1:MUNDESSão Paulo</ns1:MUNDES> ns1:ESTDESSP</ns1:ESTDES> ns1:CNPJCPF00000000000000</ns1:CNPJCPF> ns1:CDATINI05/02/2018</ns1:CDATINI> ns1:CHORINI13:09</ns1:CHORINI> </ns1:JAMW0520_02> </SOAP-ENV:Body> </SOAP-ENV:Envelope>' http://www.jamef.com.br/webservice/JAMW0520.apw

查询请求的模拟