mozgbrasil/magento2-jamef-php56

Integração a Jamef

dev-master 2016-09-02 14:30 UTC

README

![valid XHTML][checkmark] [checkmark]: https://raw.githubusercontent.com/mozgbrasil/mozgbrasil.github.io/master/assets/images/logos/Red_star_32_32.png "MOZG" [url-method]: http://www.jamef.com.br/ [requirements]: http://mozgbrasil.github.io/requirements/ [contact-jamef]: http://www.jamef.com.br/jamef/ecp/comunidade.do?app=portal&pg=20004&view=faleconosco [tickets]: https://cerebrum.freshdesk.com/support/tickets/new [preco]: http://www.cerebrum.com.br/preco/ [github-boxpacker]: https://github.com/mozgbrasil/magento-boxpacker-php56#mozgboxpacker [getcomposer]: https://getcomposer.org/ [uninstall-mods]: http://devdocs.magento.com/guides/v2.1/install-gde/install/cli/install-cli-uninstall-mods.html

Mozg\Jamef

Sinopse

Integração a [Jamef][url-method]

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][tickets], relatando o motivo da ocorrência o mais detalhado possível e anexe o print da tela para nosso entendimento

Preço

[Clique aqui][preco]

Recursos

  • Definir dimensões para os produtos

  • Definir dimensões, peso e valor da Embalagem/Caixa

  • Opção para embalar os produtos separadamente ou combinar na mesma Embalagem/Caixa

  • Embalagem do produto inteligente, exibe como os produtos serão agrupados e calcula o peso dimensional fazendo o envio fracionado se necessário

  • Armazenamento das requisições em Cache

- Definir como diferentes combinações de produtos são embalados em conjunto # TODO

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

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 de suas embalagens e regras de como empacotar diferentes combinações de produtos em conjunto.

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 Caixa/Embalagem][github-boxpacker], 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 pacote é feito um acesso ao WebService 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

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

Este módulo destina-se a ser instalado usando o [Composer][getcomposer]

Antes de executar os processos, [clique aqui][requirements] e leia os pré-requisitos e sugestões

--

Para instalar o módulo execute o comando a seguir no terminal do seu servidor

composer require mozgbrasil/magento2-jamef-php56 && php bin/magento setup:upgrade

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

composer update && php bin/magento setup:upgrade

--

Para [desinstalar][uninstall-mods] o módulo execute o comando a seguir no terminal do seu servidor

bin/magento module:uninstall --remove-data --backup-code --backup-media --backup-db Mozg_Jamef

composer remove mozgbrasil/magento2-jamef-php56 && composer clear-cache && composer update && php bin/magento setup:upgrade

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

Enviar para países aplicáveis

Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países "

Enviar para países específicos

Você deve selecionar os países que o método deve ser funcional

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.

Sigla do Estado de origem

Sigla do Estado de origem

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

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

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

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

lucas@bhz.jamef.com.br - Suporte TI

vagnero@bhz.jamef.com.br - Suporte TI

rejaine@bhz.jamef.com.br - Suporte TI

andreluiz@bhz.jamef.com.br - Gerente de TI

brunoferreira@bhz.jamef.com.br, lucas@bhz.jamef.com.br, vagnero@bhz.jamef.com.br, rejaine@bhz.jamef.com.br, andreluiz@bhz.jamef.com.br

ou acesse

Para entrar em contato com a [Jamef][contact-jamef]

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&

Contribuintes

Equipe Mozg

License

[Comercial License] (LICENSE.txt)

Badges

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

🐈