README

Mozg\Jamef

简介

与Jamef集成

演示

动机

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

支持/疑问

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

价格

点击这里

模块功能

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

技术特性

目前许多第三方模块关于配送方式总是将产品重量和尺寸相加，由于没有系统分离产品到相应的包装中分配重量，导致向承运人提出请求时出现错误。

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

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

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

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

由于承运人已注册的包装具有尺寸和重量，因此不应发生与尺寸或重量相关的错误。

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

请确保已为产品注册了相应的尺寸。

对于每个包装，都会向承运人发出请求，并传递相应的参数

模块具有缓存存储功能

在订单完成时，在订单历史记录中存储一个包含唯一标识符的注释，该标识符可用于在日志文件中查询包及其项的描述，以及以3D视图显示每个包及其项

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

对于包裹跟踪，将访问Web服务，并传递相应的参数以显示相应的返回值

在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_71.php

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

建议维护一个测试环境进行测试，并在测试通过后，在生产环境中应用相应的流程

建议备份Magento平台和数据库

在更新Magento之前，始终保持编译器和缓存处于禁用状态

请确认在项目根目录中存在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_71:dev-master

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

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

要更新模块，请在服务器上执行以下命令

在执行任何涉及更新Magento的流程之前，建议保持编译器和缓存处于禁用状态

composer update

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

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

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

要卸载模块，请在服务器上执行以下命令

composer remove mozgbrasil/magento-jamef-php_71

要禁用模块

在执行任何涉及更新Magento的流程之前，需要保持编译器和缓存处于禁用状态
如果您想禁用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模块创建了一个名为“运费”的选项卡

如果存在名为“邮政”的选项卡，通常该选项卡是由“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

查询请求模拟