mozgbrasil / magento-jamef-php55
Jamef集成
Requires
This package is auto-updated.
Last update: 2024-09-06 11:12:25 UTC
README
Mozg\Jamef
简介
与Jamef集成
演示
动机
满足市场对Magento模块的需求,提供改进和优质支持
支持/疑问
要获得支持,请点击此处,尽可能详细地说明发生原因,并附上屏幕截图以便我们理解
价格
资源
-
[✓] 运费计算
-
[✓] 跟踪
-
定义产品的尺寸
-
定义包装/箱的尺寸、重量和值
-
选项:分别包装产品或将其组合在同一包装/箱中
-
智能产品包装,显示产品如何组合并计算体积重量,必要时进行分批发送
-
将请求存储在缓存中
- 定义如何将不同产品的组合打包在一起 # TODO
- 将产品分配到特定的箱中(多个产品可以分配到同一个箱中) # TODO
技术特性
目前,许多第三方模块的配送方法总是将产品的重量和尺寸相加,由于没有分离产品到相应包装中并分配其重量的系统,因此在向运输公司发送请求时会产生错误。
我们的模块旨在完全透明地执行过程,为了分析效果,请查看存储在日志中的过程。
该扩展允许您定义产品的尺寸、包装的尺寸以及如何打包不同组合的规则。
该扩展选择用于订单的产品的包装。
该扩展可以将产品分配到多个包装中,直到达到包装的最大承重。
由于运输公司对包装的尺寸和承重要求,因此需要正确登记包装的尺寸和承重要求,以避免尺寸或重量错误。
在模块使用过程中,首先要考虑的是包装/箱管理,由于已预插入一些记录,请确保根据您的需要更新记录。
请确保已为产品注册了适当的尺寸。
为每个包装向运输公司发送请求,并传递适当的参数
模块具有缓存存储功能
在订单完成时,在订单历史中存储一条注释,其中包含一个唯一的标识符,该标识符可用于在日志文件中查找包及其项目的区分,以及以3D视图查看每个包及其项目
在处理每个订单之前,始终检查运费信息,如果出现不一致的情况,则需要取消订单,直到问题得到纠正
为了追踪包裹,通过Web服务进行访问,传递适当的参数,并显示相应的返回信息
安装 - 更新 - 卸载 - 禁用
--
此模块旨在使用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平台和数据库
--
在执行任何更新操作之前,请始终确保禁用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-php55:dev-master
您可以通过访问后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
要更新模块,请在服务器的项目目录中执行以下命令:
在进行任何涉及更新操作之前,建议保持Compiler和Cache禁用状态
composer clear-cache && composer update
在出现错误时,重命名/vender/mozgbrasil文件夹并重新执行
要检查模块的日期,请执行以下命令:
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
要卸载模块,请在服务器项目的终端中执行以下命令:
composer remove mozgbrasil/magento-jamef-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 -> 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"
如何检查运输公司提供的运费值
您可以在日志中查看发送给运输公司的参数
订单完成后,使用的箱子尺寸将被存储在历史记录中,以获取运费
价格请求模拟
执行产品运费计算
产品尺寸是 "(LxWxH): 49 x 49 x 8 cm"
包装尺寸是 "(LxWxH) 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>Duque de Caxias</ns1:MUNORI>
<ns1:ESTORI>RJ</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>06</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
查询请求模拟
处理以下请求后我们有相应的返回
http://www.jamef.com.br/e-commerce/RastreamentoCargaServlet?CIC_RESP_PGTO=17325279000186&CIC_DEST=48787285401&COD_REGN_ORIG=12&NUM_NF=472&SERIE_NF=&SAIDA=XML
如何应用免费运费
在模块的配送方式配置中,可以定义“免费配送服务”功能,该功能在“促销规则”中设置“免费运费”动作时应用。
在Magento后端,访问菜单:促销 -> 促销规则 -> 创建规则 -> 创建一个规则,并在“动作”选项卡中定义使用免费运费。
这样,在运费计算显示中,将显示所选服务为零的值。
这是一个Magento的内置规则功能。如果出现问题,建议停用所有促销规则,逐个启用,直到找到问题原因。
联系方式 - Jamef
商业 - Jamef comercial.bhz@bhz.jamef.com.br
请联系JAMEF的商业部门。
请申请您的账户作为客户,以便访问JAMEF的web服务。
电话:(31) 2102-8808
传真:(31) 2102-8803
IT - Jamef
如有疑问,请通过电话联系Jamef的IT团队。
电话:(31) 2102-8904 - IT支持
brunoferreira@bhz.jamef.com.br - IT支持
或访问
要联系Jamef,请访问 Jamef
手册
贡献者
Mozg团队
许可证
徽章
🐈