mozgbrasil / magento-jadlog-php_72
Jadlog 集成
Requires
- mozgbrasil/magento-boxpacker-php_72: dev-master
This package is auto-updated.
Last update: 2024-09-05 18:05:41 UTC
README
Mozg\Jadlog
简介
集成到 Jadlog
演示
动机
满足 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环境中的扩展是否存在,请在终端中执行以下命令
php -v
为了查看该扩展是否在称为PHP WEB的服务器环境中激活
请确认在项目根目录中存在phpinfo.php文件
<?php phpinfo(); ?>
如果项目根目录中没有phpinfo.php文件,请创建该文件并添加上述内容
通过浏览器访问该文件
然后搜索“ionCube PHP Loader”术语
如果您的服务器不支持此扩展,请联系您的托管公司并要求他们激活此扩展
如果您有权限并希望激活此扩展,请点击此处
在“Loader Downloads API”部分,下载与您的服务器兼容的包
解压缩包并将“loader-wizard.php”文件上传到您的服务器上,它将展示激活扩展的逐步操作
点击此处查看执行过程
--
在存在“ionCube PHP Loader”的情况下,下载以下文件并将其放置在服务器根目录下,然后访问,如果功能正常,则表示“ionCube”正在读取此类加密
--
为了使用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-jadlog-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-jadlog-php_72
--
要禁用模块
-
在进行任何涉及更新Magento的过程之前,必须保持Compiler和Cache禁用
-
如果您想禁用MOZG的模块,请重命名以下文件夹app/code/local/Mozg
禁用模块可以用来检测特定事件是否与模块有关
如何配置配送方式
在配置模块之前,您需要注册源CEP,请访问后端
STORES -> Configuration -> Sales/Shipping Settings -> Origin
要配置配送方式,请访问后端
STORES -> Configuration -> Sales/Shipping Methods -> Jadlog (powered by MOZG)
您将拥有以下字段
• 启用
关于“启用”或“禁用”方法的使用
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
应显示的方法名称
• 服务
选择所需服务,要选择多个,请按住“Ctrl”键并单击服务
• 免费送货服务
当有免费运费折扣时,此服务将显示为零值
• 计算处理费
可以是固定值或百分比
• 处理费
该值将添加到运费中
• 显示不适用的方法
当配置为“否”时,如果返回某个服务存在错误,则不会显示交付方法
• 调试
应在var/log/模块中存储进程
文件
DATE_mozg.log
这是模块的日志,是一个更详细的日志,包含所有进程,包括模块外部库的执行过程
文件
shipping_METHOD.log
这是与交付方法相关的magento本地日志
• 产品宽度属性标识符
允许定义项目中使用的产品宽度属性名称
• 产品长度属性标识符
允许定义项目中使用的产品长度属性名称
• 产品高度属性标识符
允许定义项目中使用的产品高度属性名称
• 计量单位
产品重量的标准单位是千克
如果使用质量单位克,则产品和包装都必须遵守同一标准
在方法配置中输入使用质量单位克时,将进行克到千克的转换
1千克在“千克”格式中为“1.000”,在“克”格式中为“1000.000”
• 显示返回错误的サービス
当配置为“否”时,如果返回某个服务存在错误,则不应在交付方法中显示
• 交付类型
请输入您的交付类型
• 保险类型
请输入您的保险类型
• 目的地的运费
请输入运费的支付模式
• 收集费
请输入收集费
• 负责支付的客户CNPJ
在此字段中填写与Jadlog合同关联的CNPJ号码
• 密码
请输入密码
常见问题解答(FAQ)
... 没有与这种运费或包装兼容的包装与之关联,无法满足该产品的尺寸/重量要求
在后台菜单中访问:MOZG -> 包装/箱子管理器
您将看到一些与该方法关联的包装记录,在该情况下,我们从运输公司的网站上获得了包装记录
根据需要添加新的记录以满足您的产品需求
如何与运输公司核对运费
您可以在日志中查看发送给运输公司的参数
完成订单后,将使用的箱子尺寸存储在历史记录中,以获取运费
运费请求的模拟
进行产品运费的计算
使用包装尺寸计算体积重量
如果体积重量值大于实际重量,则必须发送该重量
体积重量的公式是“(包装宽度)×(包装长度)×(包装高度)/系数”,系数根据服务为6000或3333
处理以下请求后的返回值
curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'SOAPAction:valorar' --data '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://jadlogEdiws">
<SOAP-ENV:Body>
<ns1:valorar>
<ns1:vModalidade>0</ns1:vModalidade>
<ns1:Password>C2o0E1m3</ns1:Password>
<ns1:vSeguro>N</ns1:vSeguro>
<ns1:vVlDec>31,18</ns1:vVlDec>
<ns1:vVlColeta>10,00</ns1:vVlColeta>
<ns1:vCepOrig>08215430</ns1:vCepOrig>
<ns1:vCepDest>08215430</ns1:vCepDest>
<ns1:vPeso>1.05</ns1:vPeso>
<ns1:vFrap>N</ns1:vFrap>
<ns1:vEntrega>D</ns1:vEntrega>
<ns1:vCnpj>17977285000118</ns1:vCnpj>
</ns1:valorar>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>' http://jadlog.com.br/JadlogEdiWs/services/ValorFreteBean?wsdl
或
http://wsdlbrowser.com/
或
http://www.jadlog.com.br:8080/JadlogEdiWs/services/ValorFreteBean?method=valorar&vModalidade=0&Password=C2o0E1m3&vSeguro=N&vVlDec=31,18&vVlColeta=10,00&vCepOrig=08215430&vCepDest=08215430&vPeso=1,05&vFrap=N&vEntrega=D&vCnpj=17977285000118
查询请求的模拟
处理以下请求后的返回值
curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'SOAPAction:consultar' --data '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://jadlogEdiws">
<SOAP-ENV:Body>
<ns1:consultar>
<ns1:CodCliente>17977285000118</ns1:CodCliente>
<ns1:Password>C2o0E1m3</ns1:Password>
<ns1:NDs>123</ns1:NDs>
</ns1:consultar>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>' http://jadlog.com.br/JadlogEdiWs/services/TrackingBean?wsdl
或
http://wsdlbrowser.com/soapclient?wsdl_url=http%3A%2F%2Fjadlog.com.br%2FJadlogEdiWs%2Fservices%2FTrackingBean%3Fwsdl&function_name=consultar
如何应用免费运费
在配送模块配置中,可以定义“免费配送服务”功能,该功能应在“促销规则”中设置“免费运费”动作时应用。
在Magento后台,访问菜单:促销 -> 促销规则 -> 创建规则 -> 创建一个规则,并在“操作”选项卡中定义使用免费运费。
这样,在运费计算显示中,所选服务将显示为零值。
这是一个Magento的本地规则,如果出现问题,建议禁用所有促销规则,并逐一启用,以找到问题原因。
“免费配送服务”预选为“快递”。
“免费配送服务”仅在促销规则中定义为免费运费时才应工作。
关于“免费配送服务”预选为“快递”,这是因为该服务的标识符为零,而Magento的“无选项”本地标识符也是零或空。
因此,无法将“免费配送服务”应用于“快递”服务。
关于错误“无法连接到主机”的返回。
这是您的托管服务器对Jadlog访问的封锁。
在防火墙中创建一个条件,释放服务器“80”和“8080”的端口,并将Jadlog的IP地址187.93.97.51添加到白名单。
服务返回“不存在请求参数的运费”。
如果需要,在方法配置中,将“显示返回错误的服务”选项更改为“否”。
联系方式 - Jadlog
以便将请求发送到JADLOG的webservice。
客户需要在商业部门进行注册。
电话:11 3563 2000
联系人:Vera Ramos / Debora / Simone / Flavia / João Pedro
商业 - JadLog comercial@jadlog.com.br
支持 - JadLog helpdesk@jadlog.com.br
程序员 - Ricardo Fernandes ricardo.fernandes@jadlog.com.br +55 11 3563-2000 ramal 2067
或访问
联系Jadlog Jadlog
手册
https://github.com/cmacetko/APIs/blob/master/JadLog/Documentacao.pdf
贡献者
Mozg团队
许可证
徽章
🐈