mozgbrasil/magento-jadlog-php_71

与Jadlog的集成

1.0.0 2018-03-01 14:27 UTC

This package is auto-updated.

Last update: 2024-09-05 17:22:35 UTC


README

valid XHTML

Mozg\Jadlog

摘要

Jadlog的集成

演示

Clique para visualizar o vídeo

动机

满足市场对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(); ?>

如果您的Magento项目根目录中没有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平台和数据库

--

在执行任何更新之前,请始终确保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
  }
}

如果您的Magento项目根目录中没有composer.json文件,请创建它并添加上述内容

要在终端的您的项目目录中安装模块,请执行以下命令

composer require mozgbrasil/magento-jadlog-php_71: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_71

--

要禁用模块

  1. 在执行涉及更新Magento的任何操作之前,必须保持Compiler和Cache处于禁用状态

  2. 如果您想禁用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 Kg 格式为 "千克" 时为 "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的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

ricardo.azevedo@jadlog.com.br

或访问

为与Jadlog联系

手册

https://github.com/cmacetko/APIs/blob/master/JadLog/Documentacao.pdf

贡献者

Mozg团队

许可证

商业许可证

徽章

Join the chat at https://gitter.im/mozgbrasil Latest Stable Version Total Downloads Latest Unstable Version License Monthly Downloads Daily Downloads Reference Status Dependency Status

🐈