mozgbrasil/magento-jadlog-php56

Integração a Jadlog

Monday, September 4, 2017
by mozgbrasil
Repository
1 Watchers
1 Stars
366 Installations

1 Dependents
0 Suggesters
0 Forks
0 Open issues
5 Versions
1 % Grown

The README.md

valid XHTML , _(*1)

Mozg\Jadlog

Sinopse

Integração a Jadlog, _(*2)

Demonstração

, _(*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

Definir dimensões para os produtos, _(*7)
Definir dimensões, peso e valor da Embalagem/Caixa, _(*8)
Opção para embalar os produtos separadamente ou combinar na mesma Embalagem/Caixa, _(*9)
Embalagem do produto inteligente, exibe como os produtos serão agrupados e calcula o peso dimensional fazendo o envio fracionado se necessário, _(*10)
Armazenamento das requisições em Cache, _(*11)

~~- Definir como diferentes combinações de produtos são embalados em conjunto # TODO~~, _(*12)

~~- Atribuir produtos a determinadas caixas (produtos múltiplos podem ser atribuídos à mesma caixa) # TODO~~, _(*13)

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

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

A extensão permite você definir as dimensões de seus produtos, as dimensões de suas embalagens e regras de como empacotar diferentes combinações de produtos em conjunto., _(*16)

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

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

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

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

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

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

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

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

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

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

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

--, _(*27)

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

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

composer --version

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

--, _(*31)

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

Para visualizar se essa extensão está ativa em seu servidor, _(*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, Clique aqui, _(*38)

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

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

Clique aqui para ver os processos executados, _(*41)

--, _(*42)

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

--, _(*44)

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

--, _(*46)

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

--, _(*48)

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

--, _(*50)

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

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

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-jadlog-php56:dev-master

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

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

--, _(*54)

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

composer clear-cache && composer update

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

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

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

--, _(*58)

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-jadlog-php56 && composer clear-cache && composer update

--, _(*59)

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, _(*60)
Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg, _(*61)

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

Como configurar o método de entrega

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

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

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

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

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

• Ativar

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

• Ordem de exibição

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

• Título

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

• Serviços

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

• Serviço Para Entrega Gratuita

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

• Calcular taxa de manuseio

Podendo ser fixo ou percentual, _(*71)

• Taxa de Manuseio

Será adicionado o valor ao frete, _(*72)

• 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, _(*73)

• Debug

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

O arquivo, _(*75)

DATE_mozg.log, _(*76)

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

O arquivo, _(*78)

shipping_METHOD.log, _(*79)

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

• Identificador do atributo largura dos produtos

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

• Identificador do atributo comprimento dos produtos

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

• Identificador do atributo altura dos produtos

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

• Unidade de medida

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

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

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

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

• 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, _(*88)

• Tipo de entrega

Informe o seu Tipo de entrega, _(*89)

• Tipo de Seguro

Informe o seu Tipo do Seguro, _(*90)

• Frete a pagar no destino

Informe o modelo de pagamento do frete, _(*91)

• Valor da coleta

Informe o Valor da coleta, _(*92)

• CNPJ do cliente que será responsável pelo pagamento

Preencha nesse campo o número do CNPJ vinculado ao contrato com a Jadlog, _(*93)

• Senha

Informe a Senha, _(*94)

Quais os recursos do módulo

[✓] Cálculo do frete
[✓] Rastreamento

Perguntas mais frequentes "FAQ"

Como conferir os valores dos fretes junto a transportada

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

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

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

Ao efetuar o calculo do frete do produto, _(*97)

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

Caso o valor do peso cúbico seja maior que o peso esse deve ser enviado, _(*99)

A fórmula do peso cúbico é "(largura_embalagem)×(comprimento_embalagem)×(altura_embalagem)/coeficiente" sendo o coeficiente 6000 ou 3333 de acordo com o serviço, _(*100)

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

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

ou, _(*102)

http://wsdlbrowser.com/

Simulação da requisição da consulta

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

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

ou, _(*104)

http://wsdlbrowser.com/soapclient?wsdl_url=http%3A%2F%2Fjadlog.com.br%2FJadlogEdiWs%2Fservices%2FTrackingBean%3Fwsdl&function_name=consultar

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

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

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

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

Serviço Para Entrega Gratuita pré-selecionado como EXPRESSO

O "Serviço Para Entrega Gratuita" só deve funcionar quando definido na regra de promoção o frete grátis, _(*109)

Sobre o "Serviço Para Entrega Gratuita" já estar pré-selecionado como "EXPRESSO" isso está ocorrendo pois esse serviço tem o seu identificador sendo zero, e o identificador nativo do Magento para "Nenhuma das opções" também é zero ou vazio, _(*110)

Devido a está ocorrência não está sendo possível aplicar o "Serviço Para Entrega Gratuita" para o Serviço "EXPRESSO", _(*111)

Sobre o retorno de erro "Could not connect to host"

Se trata de bloqueio imposto no seu servidor de hospedagem para acesso a Jadlog, _(*112)

No Firewall crie uma condição liberando as portas no servidor "80" e "8080" e adicione na WHITE LIST o ip 187.93.97.51 da jadlog, _(*113)

Serviço retornando "Nao existe tarifa para parametros solicitados"

Caso queira na configuração do método altere a opção "Mostrar serviço com retorno de erro" para Não, _(*114)

Dados de contato - Jadlog

Para que sejam encaminhadas as solicitações ao webservice da JADLOG.
O cliente deverá efetuar o seu cadastro com o Departamento Comercial.
Telefone: 11 3563 2000
Contatos: Vera Ramos / Debora / Simone / Flavia / João Pedro, _(*115)

Comercial - JadLog comercial@jadlog.com.br, _(*116)

Suporte - JadLog helpdesk@jadlog.com.br, _(*117)

Programador - Ricardo Fernandes ricardo.fernandes@jadlog.com.br +55 11 3563-2000 ramal 2067, _(*118)

ricardo.azevedo@jadlog.com.br, _(*119)

ou acesse, _(*120)

Para entrar em contato com a Jadlog, _(*121)