2017 © Pedro Peláez
 

magento-module magento-jamef-php_71

Integração a Jamef

image

mozgbrasil/magento-jamef-php_71

Integração a Jamef

  • Friday, July 27, 2018
  • by mozgbrasil
  • Repository
  • 1 Watchers
  • 0 Stars
  • 0 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 2 Versions
  • 0 % Grown

The README.md

valid XHTML, (*1)

Mozg\Jamef

Sinopse

Integração a Jamef, (*2)

Demonstração

Clique para visualizar o vídeo, (*3)

Motivação

Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte, (*4)

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, (*5)

Preço

Clique aqui, (*6)

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., (*7)

O nosso módulo foi desenvolvido visando total transparência dos processos executados, para efeito de análise visualize os processos armazenado em log., (*8)

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., (*9)

A extensão escolhe qual embalagem será utilizado para embalar os produtos para o pedido., (*10)

A extensão pode distribuir os produtos em diversas embalagens até o peso máximo suportado para a embalagem., (*11)

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., (*12)

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., (*13)

Certifique se ter cadastrado as devidas dimensões para os produtos., (*14)

Para cada embalagem é feito uma requisição a transportadora onde é passado os devidos parâmetros, (*15)

O módulo possui armazenamento de cache, (*16)

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, (*17)

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, (*18)

Para o rastreamento do pacote é feito acesso ao WebService onde é passado os devidos parâmetros e exibido o devido retorno, (*19)

Testando na Heroku

Gostaria de apresentar o aplicativo que disponibilizei para a plataforma Heroku, (*20)

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, (*21)

https://github.com/mozgbrasil/heroku-magento#descrição, (*22)

Instalação - Atualização - Desinstalação - Desativação

--, (*23)

Sugiro "printar" as telas com todos os procedimentos executados, (*24)

Envie para nós as imagens das telas na eventualidade de quaisquer dificuldades, (*25)

--, (*26)

Este módulo destina-se a ser instalado usando o Composer, (*27)

Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão, (*28)

composer --version

Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui, (*29)

--, (*30)

É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader, (*31)

Para visualizar a existência da extensão nesse ambiente denominado PHP CLI, execute o seguinte comando no terminal, (*32)

php -v

Para visualizar se essa extensão está ativa em seu servidor no ambiente denominado PHP WEB, (*33)

Certique se da presença do arquivo phpinfo.php na raiz do seu projeto, (*34)

<?php phpinfo(); ?>

Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima, (*35)

Acesse o arquivo pelo browser, (*36)

Em seguida pesquise pelo termo "ionCube PHP Loader", (*37)

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, (*38)

Caso tenha a permissão e queira ativar a extensão, Clique aqui, (*39)

Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor, (*40)

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, (*41)

Clique aqui para ver os processos executados, (*42)

--, (*43)

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, (*44)

https://raw.githubusercontent.com/mozgbrasil/heroku-magento/master/phpinfo-ioncube-encoder10-x86-64-php_71.php, (*45)

--, (*46)

Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final, (*47)

--, (*48)

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, (*49)

--, (*50)

Sugiro efetuar backup da plataforma Magento e do banco de dados, (*51)

--, (*52)

Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado, (*53)

--, (*54)

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, (*55)

{
  "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, (*56)

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_71:dev-master

Você pode verificar se o módulo está instalado, indo ao backend em:, (*57)

STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output

--, (*58)

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, (*59)

composer update

Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente, (*60)

Para checar a data do módulo execute o seguinte comando, (*61)

grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil

--, (*62)

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_71

--, (*63)

Para desativar o módulo

  1. Antes de efetuar qualquer processo que envolva atualização sobre o Magento é necessário manter o Compiler e Cache desativado, (*64)

  2. Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg, (*65)

A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo, (*66)

Como configurar o método de entrega

Antes de configurar o módulo você deve cadastrar o CEP de origem, indo ao backend em:, (*67)

STORES -> Configuration -> Sales/Shipping Settings -> Origin

Para configurar o método de entrega, acesse no backend em:, (*68)

STORES -> Configuration -> Sales/Shipping Methods -> Jamef (powered by MOZG)

Você terá os campos a seguir, (*69)

Ativar

Para "ativar" ou "desativar" o uso do método, (*70)

Ordem de exibição

É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, (*71)

Título

Nome do método que deve ser exibido, (*72)

Serviços

Selecione os serviços desejado, para selecionar mais de um, segure a tecla "Ctrl" e clique nos serviços, (*73)

Serviço Para Entrega Gratuita

Quando houver um desconto de frete grátis, esse serviço terá o valor zero, (*74)

Calcular taxa de manuseio

Podendo ser fixo ou percentual, (*75)

Taxa de Manuseio

Será adicionado o valor ao frete, (*76)

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, (*77)

Debug

Deve ser armazenado os processos do módulo em var/log/, (*78)

O arquivo, (*79)

DATE_mozg.log, (*80)

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, (*81)

O arquivo, (*82)

shipping_METHOD.log, (*83)

se trata de log nativo do magento relativo ao método de entrega, (*84)

Identificador do atributo largura dos produtos

Permite definir o nome do atributo de largura dos produtos usado no projeto, (*85)

Identificador do atributo comprimento dos produtos

Permite definir o nome do atributo de comprimento dos produtos usado no projeto, (*86)

Identificador do atributo altura dos produtos

Permite definir o nome do atributo de altura dos produtos usado no projeto, (*87)

Unidade de medida

Sendo o padrão do peso do produto como kilo, (*88)

Caso esteja usando a unidade de massa em gramas, tanto os produtos como as embalagens devem respeitar o mesmo padrão, (*89)

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, (*90)

1 Kg no formato "Kilo" será "1.000", já em "Gramas" será "1000.000", (*91)

Exibir Prazo de Entrega

Se será ou não mostrado o prazo de entrega para seu cliente, (*92)

Mensagem que Exibe o Prazo de Entrega

Se será ou não mostrado o prazo de entrega para seu cliente, (*93)

Adicionar (dias) ao prazo de entrega

Quantidade de dias que será adicionado ao prazo, (*94)

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, (*95)

Tipo de Produto a ser transportado

Tipo de Produto a ser transportado, (*96)

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, (*97)

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., (*98)

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., (*99)

Não informar acentos, (*100)

Sigla do Estado de origem

Sigla do Estado de origem, (*101)

Perguntas mais frequentes "FAQ"

Sobre o retorno do prazo

Só deve ser retornado o prazo no preenchimento do estado e cidade destino, (*102)

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, (*103)

... não há embalagem associada a essa modalidade de frete ou embalagem compatível para atender as dimensões / peso desse produto

1., (*104)

Certifique se de ter cadastrada as devidas dimensão aos produtos, (*105)

Na edição dos produtos a aba denominada "Fretes" foi criada pelo módulo da MOZG, (*106)

No caso da presença da aba denominada "Correios", geralmente essa aba é criada pelo "PedroTeixeira", (*107)

2., (*108)

Acesse no backend o menu: MOZG -> Gerenciador de Embalagem/Caixa, (*109)

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, (*110)

Por isso é importante adicionar novos registros de embalagens que atende os produtos da loja, (*111)

Adicione se necessário novos registros que atenda a necessidade dos seus produtos, (*112)

Como conferir os valores dos fretes junto a transportada

Você pode visualizar no log os parâmetros enviado a transportada, (*113)

Quando finalizado o pedido é armazenado no historico as dimensões da caixa que foi usada para o obter o frete, (*114)

Simulação da requisição do preço

Ao efetuar o calculo do frete do produto, (*115)

As dimensões do produto é "(LxCxA): 49 x 49 x 8 cm", (*116)

As dimensões da embalagem é "(LxCxA) 91 x 101 x 143 cm" e será armazenado 10kg, (*117)

É usado as dimensões da embalagem para cálculo do peso cúbico, (*118)

A formula do peso cúbico é "(largura_embalagem/100)×(comprimento_embalagem/100)×(altura_embalagem/100)" ou seja, (*119)

METRO3 = (91/100)×(101/100)×(143/100) = 1.314313, (*120)

Temos o devido retorno ao processar a seguinte requisição, (*121)

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, (*122)

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 ' 1 Belo Horizonte MG São Paulo SP 00000000000000 05/02/2018 13:09 ' http://www.jamef.com.br/webservice/JAMW0520.apw, (*123)

Simulação da requisição da consulta

Temos o devido retorno ao processar a seguinte requisição, (*124)

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", (*125)

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, (*126)

Dessa forma na exibição do cálculo do frete será exibido para o serviço escolhido o valor zerado, (*127)

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, (*128)

Dados de contato - Jamef

Comercial - Jamef comercial.bhz@bhz.jamef.com.br, (*129)

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, (*130)

TI - Jamef, (*131)

Em caso de dúvidas, favor entrar em contato com a equipe de TI da Jamef através do telefone, (*132)

Tel.: (31) 2102-8904 - Suporte TI, (*133)

brunoferreira@bhz.jamef.com.br - Suporte TI, (*134)

ou acesse, (*135)

Para entrar em contato com a [Jamef][contact-jamef], (*136)

Manual

http://www.jamef.com.br/jamef/ecp/comunidade.do?evento=portlet&pIdPlc=ecpTaxonomiaMenuPortal&app=portal&tax=21381&lang=pt_BR&pg=20004&taxn=20035&taxp=0&, (*137)

Contribuintes

Equipe Mozg, (*138)

License

Comercial License, (*139)

Badges

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, (*140)

:cat2:, (*141)

The Versions

27/07 2018

dev-master

9999999-dev http://mozg.com.br

Integração a Jamef

  Sources   Download

proprietary

The Requires

 

shipping magento cerebrum mozg entrega transportadora jamef

01/03 2018

1.0.0

1.0.0.0 http://mozg.com.br

Integração a Jamef

  Sources   Download

proprietary

The Requires

 

shipping magento cerebrum mozg entrega transportadora jamef