mozgbrasil/magento-jamef-php55

Integração a Jamef

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

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

The README.md

valid XHTML , _(*1)

Mozg\Jamef

Sinopse

Integração a Jamef, _(*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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

--, _(*29)

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

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

composer --version

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

--, _(*33)

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

Para visualizar se essa extensão está ativa em seu servidor, _(*35)

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

<?php phpinfo(); ?>

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

Acesse o arquivo pelo browser, _(*38)

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

Caso o seu servidor não tenha o suporte a extensão, Clique aqui, _(*40)

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

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

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

--, _(*44)

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

--, _(*46)

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

--, _(*48)

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

--, _(*50)

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

--, _(*52)

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

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

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

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

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

--, _(*56)

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

composer clear-cache && composer update

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

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

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

--, _(*60)

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

--, _(*61)

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

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

Como configurar o método de entrega

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

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

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

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

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

• Ativar

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

• Ordem de exibição

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

• Título

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

• Serviços

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

• Serviço Para Entrega Gratuita

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

• Calcular taxa de manuseio

Podendo ser fixo ou percentual, _(*73)

• Taxa de Manuseio

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

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

• Debug

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

O arquivo, _(*77)

DATE_mozg.log, _(*78)

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

O arquivo, _(*80)

shipping_METHOD.log, _(*81)

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

• Identificador do atributo largura dos produtos

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

• Identificador do atributo comprimento dos produtos

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

• Identificador do atributo altura dos produtos

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

• Unidade de medida

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

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

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

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

• Exibir Prazo de Entrega

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

• Mensagem que Exibe o Prazo de Entrega

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

• Adicionar (dias) ao prazo de entrega

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

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

• Tipo de Produto a ser transportado

Tipo de Produto a ser transportado, _(*94)

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

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

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

• Sigla do Estado de origem

Sigla do Estado de origem, _(*98)

Perguntas mais frequentes "FAQ"

Como conferir os valores dos fretes junto a transportada

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

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

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

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

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

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

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

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

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

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

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

ou, _(*108)

http://wsdlbrowser.com/soapclient?wsdl_url=http%3A%2F%2Fwww.jamef.com.br%2Fwebservice%2FJAMW0520.apw%3Fwsdl&function_name=JAMW0520_03

Simulação da requisição da consulta

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

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

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

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

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

Dados de contato - Jamef

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

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

TI - Jamef, _(*116)

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

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

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

ou acesse, _(*120)

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

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