Magento 2.x - IS Entrega

Documentação para integração Magento 2.x

Introdução

Este guia foi criado com o objetivo de ajudá-lo a instalar, configurar e utilizar a integração da IS Entrega em sua plataforma e-commerce Magento 2.x. Nele, você encontrará instruções detalhadas e passo a passo para integrar o serviço de frete da IS Entrega à sua loja virtual e oferecer aos seus clientes opções de entrega eficientes e seguras.

Funcionalidades

CotaçãoEnvio XMLRastreamento

Sim

Não

Sim, desde que NFs estejam preenchidas no portal

Compatibilidade

  • Magento versão 2.x

  • PHP a partir da versão 7.1 disponível em seu servidor para integração do módulo

Para maiores detalhes consultar a documentação do link abaixo:

Instalação

Certifique-se que o software Magento está instalado em local seguro em seu computador/servidor. Para a instalação deve-se baixar e descompactar o arquivo zip e copiar o conteúdo da pasta diretamente na pasta raiz (/app) do software Magento.

Durante a extração dos arquivos o sistema pode acusar que alguma pasta já existe. Nesses casos deve-se aceitar que elas sejam sobre escritas.

Após a cópia dos arquivos, execute os comandos abaixo para registrar o módulo ISEntrega_ISEshipping

bin/magento module:enable Vendor_CustomShipping
bin/magento setup:upgrade

Para maior segurança (ou por outros motivos), o servidor pode ser configurado para que a instalação dos módulos seja feita por um usuário específico. Neste caso, ao executar comandos do console:

php composer.phar <command>
php bin / magento <command>

Pode haver relatos de direitos insuficientes. Você pode tentar executar os mesmos comandos em nome de outro usuário ou simplesmente do administrador. Por exemplo:

sudo -u <nome de usuário> php bin / magento <comando>

Ou

sudo php bin / magento <comando>

Além disso, você pode precisar de direitos totais para algumas pastas. Por exemplo, ao instalar módulos, você pode não ter acesso a alguns arquivos do diretório app / etc.

chmod 777 app / etc
chmod 644 app / etc / *. xml

Ou para a pasta var contendo muitos arquivos temporários e os direitos aos quais devem ser distribuídos a todos os subdiretórios (o parâmetro -R é recursivo).

chmod -R 777 var /

Após a instalação o modulo deve aparecer em no menu Store > Configuration > Sales > Shipping Methods

Configuração

Parâmetros iniciais

Para configurar os parâmetros iniciais da extensão acesse a configuração do Admin a partir do menu superior Store > Configuration > Sales> Shipping Methods. Dentro do quadro selecione a opção IS Entrega, feito isto é necessário preencher os campos das Configurações do serviço para requisição de coleta.

Preenchendo os parâmetros de configuração

CampoValor

Enabled

Para que o serviço de frete e coleta estejam disponíveis é necessário que esta opção esteja marcada como Yes.

Api User

Identificação de cliente fornecida pela IS Entrega após a assinatura do contrato.

Api Key

Chave de autorização fornecido pela IS Entrega após a assinatura do contrato.

API Endpoint

Endereço do serviço para cotação do frete, a mesma será fornecida após a assinatura do contrato.

Tracking URL

Endereço para rastreamento do pedido. Será exibido para o seu cliente na tela de resumo de pedido. Valor padrão: https://rastreamento.is/#/?t=

Prazo em dia(s) para a separação do pedido

Corresponde a quantidade de dias reservados para a separação do pedido que serão somados ao prazo da entrega.

Aplicar % do seguro na cotação de frete

Corresponde ao percentual de seguro que será aplicado ao frete referente ao valor total do pedido.

Após o preenchimento de todas as informações basta clicar em Save Config

*Todos os campos são de preenchimento obrigatórios

Configuração de CNPJ e CEP

É necessário verificar se a loja possui CNPJ e CEP cadastrados, para isto é necessário acessar o menu Stores > Configuration

Após realizar o acesso, na seção Store Information verifique se os campos Zip Code e VAT Number estão preenchidos.

Habilitação da integração

Para que seja possível integrar os serviços de coleta e rastreio da IS Entrega é necessário adicionar uma nova integração no Magento para acesso a API. Para isto, siga os passos abaixo:

Criando nova integração

Acessar o menu System > Integrations e em seguida clicar em Add New Integration.

No formulário de nova integração na aba Integration Info deve ser preenchido os campos:

NameEmail

IS Entrega

tecnologia@isentrega.com.br

Após o preenchimento das informações acima é necessário navegar até a aba API e selecionar as configurações conforme imagens abaixo, após a seleção clique em "Save"

No passo seguinte é necessário ativar a integração criada clicando em Activate

Ao ativar a integração é necessário confirmar os acessos selecionados anteriormente, para isto clique em Allow

Após a confirmação acima o sistema vai mostrar os tokens que foram habilitados, é necessário encaminhar para nos a chave gerada no campo Access Token

Envio de informação para IS Entrega

Envio de informação

Após a realização de todos os passos anteriores você deve preencher o formulário com as seguintes informações:

  • Access Token

Para conferir detalhes sobre a utilização Magento 2.x, acesse o nosso Manual de utilização Magento 2.x ou clique no link abaixo:

FAQ

Não estou recebendo o e-mail com número de rastreamento, entro em contato com a IS?

Se você não está recebendo o e-mail com o número de rastreamento, é importante entrar em contato com a plataforma de e-commerce ou o sistema ERP que está sendo utilizado. A IS Entrega não é responsável pelo envio desse e-mail e, portanto, não tem acesso a informações sobre o motivo da ausência do mesmo. Recomendamos entrar em contato com a plataforma ou o sistema responsável pelo envio do e-mail para obter mais informações e solucionar o problema.

Por que a modalidade de entrega não aparece no site?

É possível que a versão do módulo instalado não seja a mais recente. Nesse caso, é altamente recomendado que você instale a última versão do plugin correspondente, que pode ser encontrada no manual online.

Ao utilizar a versão mais recente do plugin, você terá acesso às funcionalidades mais atualizadas e às correções de possíveis bugs presentes nas versões anteriores. Isso pode garantir um melhor desempenho e maior estabilidade do sistema.

Para mais informações, consulte a nossa documentação:

Inicio

Last updated