Magento 1.9 - IS Entrega

Documentação para integração Magento 1.9

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 1.9. 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 1.9.x.

  • PHP 5.6 disponível em seu servidor para integração do módulo ao webservice.

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 (/html) 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, deve-se limpar o cache e as sessões. Para isso remova todo o conteúdo das pastas var/cache e var/session presentes na raiz da instalação do software Magento.

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 System-> Configuration, submenu Sales-> Shipping Methods. Dentro do quadro selecione a opção IS Entrega - Configurações, 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

Habilitar

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;

Frete URL

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

Loja CEP

Preencher com o CEP da sua empresa (somente números)

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

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 fre

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

Nome do Atributo de Comprimento do Produto

Corresponde ao atributo do produto que armazena o comprimento em centímetros. Caso sua loja não possua esse atributo, preencha com o valor padrão isentrega_length. (Na próxima seção do manual explica-se como utilizar esse atributo na configuração dos produtos).

Nome do Atributo de Largura do Produto

Corresponde ao atributo do produto que armazena a largura em centímetros. Caso sua loja não possua esse atributo, preencha com o valor padrão isentrega_width. (Na próxima seção do manual explica-se como utilizar esse atributo na configuração dos produtos)

Nome do Atributo de Altura do Produto:

Corresponde ao atributo do produto que armazena a altura em centímetros. Caso sua loja não possua esse atributo, preencha com o valor padrão isentrega_height. (Na próxima seção do manual explica-se como utilizar esse atributo na configuração dos produtos).

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

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

Atributos para armazenar dimensões dos produtos

Todos os produtos devem possuir 3 atributos que serão utilizados para calcular o volume em centímetros cúbicos (cm3).

Caso os produtos da loja já possuam as suas respectivas dimensões armazenadas em centímetros basta informar os respectivos nomes dos atributos que armazenam comprimento, largura e altura na tela dos parâmetros iniciais não sendo necessária a criação de outros atributos.

Criar novos atributos

Para criar os atributos necessários acesse o menu Catalog-> Attributes > Manage Attributes. Serão necessários criar 3 novos atributos: isentrega_length, isentrega_width e isentrega_height. A seguir seguirá exemplo de criação do atributo isentrega_length. Os demais atributos são criados da mesma maneira.

Na página de gerenciamento de atributos clique em "Add New Attribute" e preencha as seguintes informações no quadro "Attribute Properties".

CampoValor

Atribute Code

Preencher com a identificação do atributo. Por exemplo: isentrega_length.

Scope

Todas as lojas (ou Global).

Catalog Input Type for Store Owner

Text field

Default Value

Deixar em branco

Unique Value

Não

Values Required

Sim

Input Validation for Store Owner

Decimal Number

Apply To

All Product Types

Não é necessário alterar as propriedades do quadro "Frontend Properties"

Clicando em salvar o sistema vai exibir a tela de gerenciamento de títulos do atributo (Manage Titles). Nesse passo é necessário preencher ao menos o título referente ao "Admin". Sugerimos manter como título o mesmo código do atributo. No exemplo é isentrega_length.

Preencha o campo "Admin" e clique em "Save Attribute" para finalizar a criação.

Utilizar novos atributos

Para utilizar os novos atributos criados anteriormente, é necessário gerenciar os grupos de atributos. Para isso deve-se acessar o menu Catalog-> Attributes-> Manage Attribute Sets. O sistema vai exibir uma lista de atributos, deve-se escolher o grupo "Padrão" ou Default.

Os atributos recém criados aparecem em "Unassigned Attributes" . Deve-se clicar e arrastar os atributos criados (isentrega_length, isentrega_width e isentrega_height.) para o grupo "General" e depois clicar em "Save Attribute Set".

Após adicionar os atributos ao grupo padrão, eles deverão aparecer no cadastro, de produtos.

Importante: é necessário recriar os índices do sistema para refletir as alterações.

Nota: ao editar produtos já existentes os novos atributos podem não aparecer. Nesse caso, é necessário utilizar a rotina de atualização de atributos através do menu Catalog-> Manage Products: marque os produtos que devem ser atualizados e escolha a ação atualizar atributos.

Habilitar Web Services

Para que seja possível integrar os serviços de coleta e rastreio da IS Entrega é necessário criar uma Role e um User no modulo de configuração de web services.

Criando Role para a IS Entrega

Acessar o menu "System-> Web Services-> SOAP/XML-RPC - Roles" e em seguida clicar em "Add New Role"

Para adicionar a nova regra será necessário preencher o campo "Role Name" com a descrição isentrega_role, após feito isto é necessário clicar em "Role Resources" para selecionar os objetos que serão necessários conceder acesso

Após preencher o campo Role Name, clique em Role Resources e selecione o campo Resource Access como Custom

Uma vez selecionado o acesso tipo Custom é necessário realizar as marcações conforme imagem abaixo.

Após fazer a seleção basta clicar em "Save Role" para que as configurações sejam salvas.

Criando User para a IS Entrega

Acessar o menu "System-> Web Services-> SOAP/XML-RPC - Users" e em seguida clicar em "Add New User"

Em User Info preencher as seguintes informações:

CampoValor

UserName

isentrega

First Name

IS Log

Last Name

Serviços

Email

tecnologia@isentrega.com.br

Api Key

Nos podemos fornecer a chave para este campo ou fica a critério do cliente cadastrar uma chave e nos encaminhar para podermos fazer a integração.

This account is

Active

Preenchida as informações acima é necessário clicar em "User Role" para selecionar a role criada anteriormente, feito isto basta clicar em "Save User".

Feito isso, seu plugin já estará pronto para o uso.

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

pageManual de utilização - Magento 1.9

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:

pageInicio

Last updated