mozgbrasil / magento-jamef-php_54
Integração a Jamef
Installs: 5
Dependents: 1
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 1
Open Issues: 0
Type:magento-module
Requires
This package is auto-updated.
Last update: 2024-12-05 17:47:55 UTC
README
Mozg\Jamef
Sinopse
Integração a Jamef
Demonstração
Motivação
Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte
Suporte / Dúvidas
Para obter o devido suporte Clique aqui, relatando o motivo da ocorrência o mais detalhado possível e anexe o print da tela para nosso entendimento
Preço
Recursos do módulo
- [✓] Cálculo do frete
- [✓] Rastreamento
Característica técnica
Atualmente diversos módulos de terceiros relativo a métodos de entrega sempre soma o peso e dimensões dos produtos gerando falha na requisição a transportadora devido não terem um sistema que separa os produtos em sua devida embalagem distribuindo seu peso.
O nosso módulo foi desenvolvido visando total transparência dos processos executados, para efeito de análise visualize os processos armazenado em log.
A extensão permite você definir as dimensões de seus produtos, as dimensões, peso e valor de sua Embalagem/Caixa e regras de como empacotar diferentes combinações de produtos em conjunto como por exemplo embalar os produtos separadamente ou combinar os produtos na mesma Embalagem/Caixa.
A extensão escolhe qual embalagem será utilizado para embalar os produtos para o pedido.
A extensão pode distribuir os produtos em diversas embalagens até o peso máximo suportado para a embalagem.
Como será cadastrado a embalagem com as dimensões e peso suportado pelas transportadoras não deve ocorrer falha relativa as dimensões ou peso.
A primeira coisa a se levar em consideração no uso do módulo é o Gerenciamento de Embalagem/Caixa, como já vem alguns registros pré inseridos certifique se de atualizar os registros conforme sua necessidade.
Certifique se ter cadastrado as devidas dimensões para os produtos.
Para cada embalagem é feito uma requisição a transportadora onde é passado os devidos parâmetros
O módulo possui armazenamento de cache
Na finalização do pedido é armazenado no histórico do pedido um comentário contendo um identificador único que poderá ser usado para consulta no arquivo de log a discriminação dos pacotes seus itens e a visualização de cada pacote com seus itens em 3D
Sempre confira as informações de frete antes de processar cada pedido, caso algo esteja inconsistente será necessário cancelar o pedido até a correção da ocorrência
Para o rastreamento do pacote é feito acesso ao WebService onde é passado os devidos parâmetros e exibido o devido retorno
Testando na Heroku
Gostaria de apresentar o aplicativo que disponibilizei para a plataforma Heroku
Com apenas 1 clique, o aplicativo cria sua loja virtual usando a plataforma de comércio eletrônico Magento e instala os módulos da MOZG
https://github.com/mozgbrasil/heroku-magento#descrição
Instalação - Atualização - Desinstalação - Desativação
--
Sugiro "printar" as telas com todos os procedimentos executados
Envie para nós as imagens das telas na eventualidade de quaisquer dificuldades
--
Este módulo destina-se a ser instalado usando o Composer
Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão
composer --version
Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui
--
É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader
Para visualizar a existência da extensão nesse ambiente denominado PHP CLI, execute o seguinte comando no terminal
php -v
Para visualizar se essa extensão está ativa em seu servidor no ambiente denominado PHP WEB
Certique se da presença do arquivo phpinfo.php na raiz do seu projeto
<?php phpinfo(); ?>
Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima
Acesse o arquivo pelo browser
Em seguida pesquise pelo termo "ionCube PHP Loader"
Caso o seu servidor não tenha o suporte a extensão, entre em contato com sua empresa de hospedagem e peça para que eles ativem a extensão
Caso tenha a permissão e queira ativar a extensão, Clique aqui
Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor
Descompacte o pacote e faça upload do arquivo "loader-wizard.php" para seu servidor, onde será demonstrado o passo a passo para a ativação da extensão
Clique aqui para ver os processos executados
--
Na presença do "ionCube PHP Loader" efetue o download do seguinte arquivo e coloque na raiz do seu servidor e acesse, se funcionar quer dizer que o "ionCube" está lendo esse tipo de encriptação
--
Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final
--
Sugiro manter um ambiente de testes para efeito de testes e somente após os devidos testes aplicar os devidos procedimento no ambiente de produção
--
Sugiro efetuar backup da plataforma Magento e do banco de dados
--
Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado
--
Certique se da presença do arquivo composer.json na raiz do seu projeto Magento e que o mesmo tenha os parâmetros semelhantes ao modelo JSON abaixo
{
"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
}
}
Caso não exista o arquivo composer.json na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima
Para instalar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
composer require mozgbrasil/magento-jamef-php_54:dev-master
Você pode verificar se o módulo está instalado, indo ao backend em:
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
Para atualizar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
Antes de efetuar qualquer processo que envolva atualização no Magento é recomendado manter o Compiler e Cache desativado
composer update
Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente
Para checar a data do módulo execute o seguinte comando
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
Para desinstalar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
composer remove mozgbrasil/magento-jamef-php_54
--
Para desativar o módulo
-
Antes de efetuar qualquer processo que envolva atualização sobre o Magento é necessário manter o Compiler e Cache desativado
-
Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg
A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo
Como configurar o método de entrega
Antes de configurar o módulo você deve cadastrar o CEP de origem, indo ao backend em:
STORES -> Configuration -> Sales/Shipping Settings -> Origin
Para configurar o método de entrega, acesse no backend em:
STORES -> Configuration -> Sales/Shipping Methods -> Jamef (powered by MOZG)
Você terá os campos a seguir
• Ativar
Para "ativar" ou "desativar" o uso do método
• Ordem de exibição
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido
• Título
Nome do método que deve ser exibido
• Serviços
Selecione os serviços desejado, para selecionar mais de um, segure a tecla "Ctrl" e clique nos serviços
• Serviço Para Entrega Gratuita
Quando houver um desconto de frete grátis, esse serviço terá o valor zero
• Calcular taxa de manuseio
Podendo ser fixo ou percentual
• Taxa de Manuseio
Será adicionado o valor ao frete
• Mostrar método se não aplicável
Quando configurado como "Não", caso seja retornado algum serviço com erro, não será exibido o método de entrega
• Debug
Deve ser armazenado os processos do módulo em var/log/
O arquivo
DATE_mozg.log
se trata de log do módulo sendo um log mais detalhado contendo todos os processos inclusive das execuções realizadas pelas bibliotecas externas do módulo
O arquivo
shipping_METHOD.log
se trata de log nativo do magento relativo ao método de entrega
• Identificador do atributo largura dos produtos
Permite definir o nome do atributo de largura dos produtos usado no projeto
• Identificador do atributo comprimento dos produtos
Permite definir o nome do atributo de comprimento dos produtos usado no projeto
• Identificador do atributo altura dos produtos
Permite definir o nome do atributo de altura dos produtos usado no projeto
• Unidade de medida
Sendo o padrão do peso do produto como kilo
Caso esteja usando a unidade de massa em gramas, tanto os produtos como as embalagens devem respeitar o mesmo padrão
Ao informar na configuração do método o uso da unidade de massa em gramas é feito a conversão do peso de grama para kilo
1 Kg no formato "Kilo" será "1.000", já em "Gramas" será "1000.000"
• Exibir Prazo de Entrega
Se será ou não mostrado o prazo de entrega para seu cliente
• Mensagem que Exibe o Prazo de Entrega
Se será ou não mostrado o prazo de entrega para seu cliente
• Adicionar (dias) ao prazo de entrega
Quantidade de dias que será adicionado ao prazo
• Mostrar serviço com retorno de erro
Quando configurado como "Não", caso seja retornado algum serviço com erro, o mesmo não deve ser exibido no método de entrega
• Tipo de Produto a ser transportado
Tipo de Produto a ser transportado
• CPF ou CNPJ do cliente que será responsável pelo pagamento
Preencha nesse campo o número do CPF ou CNPJ vinculado ao contrato com a Jamef
• Filial da Jamef que irá efetuar a coleta da mercadoria e emitir o CTRC do cliente.
Filial da Jamef que irá efetuar a coleta da mercadoria e emitir o CTRC do cliente.
• Nome do Município de origem da Mercadoria. Mesmo Município do Cliente Responsável
Nome do Município de origem da Mercadoria. Mesmo Município do Cliente Responsável.
Não informar acentos
• Sigla do Estado de origem
Sigla do Estado de origem
Perguntas mais frequentes "FAQ"
Sobre o retorno do prazo
Só deve ser retornado o prazo no preenchimento do estado e cidade destino
Para exibir o campo cidade no carrinho de compras é necessário ativar o método DHL, ou editar o arquivo *.phtml, isso para o template nativo RWD
... não há embalagem associada a essa modalidade de frete ou embalagem compatível para atender as dimensões / peso desse produto
Certifique se de ter cadastrada as devidas dimensão aos produtos
Na edição dos produtos a aba denominada "Fretes" foi criada pelo módulo da MOZG
No caso da presença da aba denominada "Correios", geralmente essa aba é criada pelo "PedroTeixeira"
Acesse no backend o menu: MOZG -> Gerenciador de Embalagem/Caixa
Veja que tem 1 registro de embalagem que denominei "Genérica" que está associada ao método, foi feito dessa forma pois não obtive uma lista de possiveis embalagens padronizada pela transportadora
Por isso é importante adicionar novos registros de embalagens que atende os produtos da loja
Adicione se necessário novos registros que atenda a necessidade dos seus produtos
Como conferir os valores dos fretes junto a transportada
Você pode visualizar no log os parâmetros enviado a transportada
Quando finalizado o pedido é armazenado no historico as dimensões da caixa que foi usada para o obter o frete
Simulação da requisição do preço
Ao efetuar o calculo do frete do produto
As dimensões do produto é "(LxCxA): 49 x 49 x 8 cm"
As dimensões da embalagem é "(LxCxA) 91 x 101 x 143 cm" e será armazenado 10kg
É usado as dimensões da embalagem para cálculo do peso cúbico
A formula do peso cúbico é "(largura_embalagem/100)×(comprimento_embalagem/100)×(altura_embalagem/100)" ou seja
METRO3 = (91/100)×(101/100)×(143/100) = 1.314313
Temos o devido retorno ao processar a seguinte requisição
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
ou
http://wsdlbrowser.com/soapclient?wsdl_url=http%3A%2F%2Fwww.jamef.com.br%2Fwebservice%2FJAMW0520.apw%3Fwsdl&function_name=JAMW0520_03
Simulação da Previsão de Entrega
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
Simulação da requisição da consulta
Temos o devido retorno ao processar a seguinte requisição
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
Como aplicar o Frete Grátis
Na configuração do módulo para o método de entrega é possível definir o "Serviço Para Entrega Gratuita" recurso que deve ser aplicado quando definido a ação de "Frete Grátis" nas "Regras da Promoção"
No Backend do Magento, acesse o menu: Promoções -> Regras de Promoção -> Criar regra -> Crie uma regra e defina na aba "Ações" o uso do Frete Grátis
Dessa forma na exibição do cálculo do frete será exibido para o serviço escolhido o valor zerado
Esse recurso se trata de regra nativa do Magento caso tenha algum problema sugiro desativar todas as regras de promoção e ativar uma de cada vez até encontrar o motivo da ocorrência
Dados de contato - Jamef
Comercial - Jamef comercial.bhz@bhz.jamef.com.br
Entre em contato com o setor comercial da JAMEF
Solicite a habilitação da sua conta como cliente para acesso ao webservice da JAMEF
Fone: (31) 2102-8808
Fax: (31) 2102-8803
TI - Jamef
Em caso de dúvidas, favor entrar em contato com a equipe de TI da Jamef através do telefone
Tel.: (31) 2102-8904 - Suporte TI
brunoferreira@bhz.jamef.com.br - Suporte TI
ou acesse
Para entrar em contato com a Jamef
Manual
Contribuintes
Equipe Mozg
License
Badges
🐈