Links

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ção
Envio XML
Rastreamento
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

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

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
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

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:
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

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: