Magento 2.x - IS Entrega
Documentação para integração Magento 2.x
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.
Cotação | Envio XML | Rastreamento |
|---|---|---|
Sim | Não | Sim, desde que NFs estejam preenchidas no portal |
- 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:
M2_ISEntrega_Delivery-1.0.1.zip
8KB
Binary
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
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
Campo | Valor |
|---|---|
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
É 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.
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:
Name | Email |
|---|---|
IS Entrega |
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
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:
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.
É 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: