mozgbrasil / magento-jadlog-php55
Jadlog 集成
Requires
This package is auto-updated.
Last update: 2024-09-06 11:01:19 UTC
README
Mozg\Jadlog
简介
集成到 Jadlog
演示
动机
为了满足 Magento 模块市场的需求,提供改进和优秀的支持
支持 / 疑问
要获取适当的支持,请点击此处,尽可能详细地报告发生的原因,并附加屏幕截图以供我们理解
价格
资源
-
为产品定义尺寸
-
定义包装/箱子的尺寸、重量和价值
-
选项:分别包装产品或组合在同一包装/箱子里
-
智能产品包装,显示产品如何分组,并计算体积重量,必要时进行分批发货
-
缓存存储请求
- 定义不同产品组合如何包装在一起(# TODO)
- 将产品分配给特定的箱子(多个产品可以分配到同一个箱子)(# TODO)
技术特性
目前,许多第三方模块在处理运输方式时总是将产品的重量和尺寸相加,这会导致向运输公司发出请求时失败,因为没有系统可以分离产品到相应的包装中并分配其重量。
我们的模块旨在执行过程的完全透明,为了分析效果,可以查看存储在日志中的过程。
扩展允许您定义产品的尺寸、包装的尺寸以及如何将不同的产品组合包装在一起的规定。
扩展会选择用于订单的产品的包装。
扩展可以将产品分配到多个包装中,直到达到包装的最大承重。
由于运输公司注册的包装具有尺寸和承重限制,因此不应出现与尺寸或重量相关的错误。
使用此模块时首先要考虑的是 包装/箱子管理,一些预插入的记录已经存在,请确保根据您的需要更新记录。
请确保为产品注册了正确的尺寸。
对于每个包装,都会向运输公司发出请求,并传递适当的参数
模块具有缓存存储功能
在订单完成时,将包含唯一标识符的注释存储在订单历史记录中,该标识符可以用于在日志文件中查询包装的详细信息以及以3D视图显示每个包装及其项目
在处理每个订单之前,请务必检查运费信息,如果存在不一致的情况,则必须取消订单,直到问题得到纠正
为了跟踪包裹,将访问 WebService,并传递适当的参数以显示相应的返回结果
安装 - 更新 - 卸载 - 禁用
--
此模块应使用 Composer 进行安装
在终端中执行以下命令,以查看 Composer 的存在及其版本
composer --version
如果您的环境中没有Composer,建议阅读以下文章 点击此处
--
服务器需要支持扩展 ionCube PHP Loader
为了查看该扩展是否在您的服务器上激活
请确认在项目根目录下是否存在文件 phpinfo.php
<?php phpinfo(); ?>
如果项目根目录中没有 phpinfo.php 文件,请创建该文件并添加上述内容
通过浏览器访问该文件
然后在其中搜索“ionCube PHP Loader”
如果您的服务器不支持该扩展,请点击此处
在“Loader Downloads API”中,下载适用于您的服务器的兼容包
解压缩包并将 "loader-wizard.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-jadlog-php55:dev-master
您可以通过访问后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
在项目目录的服务器终端中执行以下命令来更新模块
在涉及更新Magento的任何过程中,建议保持Compiler和Cache未启用状态
composer clear-cache && composer update
如果发生错误,请重命名文件夹 /vendor/mozgbrasil 并重新执行
要检查模块的日期,请执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
要卸载模块,请在项目目录的服务器终端中执行以下命令
composer remove mozgbrasil/magento-jadlog-php55 && composer clear-cache && composer update
--
要禁用模块
-
在涉及更新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"
如何检查运输公司的运费值
您可以在日志中查看发送给运输公司的参数
当订单完成时,它会被存储在历史记录中,用于获取运费的箱子的尺寸
价格请求的模拟
执行产品运费计算时
使用包装尺寸来计算体积重量
如果体积重量值大于实际重量,则应发送实际重量
体积重量的公式是 "(包装宽度)×(包装长度)×(包装高度)/系数",系数根据服务为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>1</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/
查询请求的模拟
在处理以下请求时,我们得到适当的返回值
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的本地规则,如果出现任何问题,建议禁用所有促销规则,然后逐一启用,直到找到问题原因
预选为“快速”的“免费交付服务”
“免费交付服务”仅在促销规则中定义了免费运费时才应使用
关于“免费配送服务”,已预先选中为“快递”,这是因为该服务的标识符为0,而Magento中“无选项”的本地标识符也是0或空
由于此原因,无法将“免费配送服务”应用于“快递”服务
关于错误“无法连接到主机”的说明
这是由您的托管服务器对访问Jadlog实施的封锁
在防火墙中创建一个条件,释放服务器的“80”和“8080”端口,并将Jadlog的IP地址187.93.97.51添加到白名单
服务返回“没有针对请求参数的费率”
如果您想在方法配置中更改,请将“显示返回错误的服务”选项更改为“否”
联系信息 - Jadlog
为了将请求发送到JADLOG的Web服务。
客户需要向商业部门进行注册。
电话: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 分机 2067
或访问
要联系Jadlog
手册
http://www.youblisher.com/p/641712-Manual-de-integracao-JADLOG/
贡献者
Mozg团队
许可
徽章
🐈