Links

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

M1.9_ISEntrega_Delivery-1.0.12.zip
26KB
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 (/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.
System -> Configuration
System -> Configuration-> Sales-> Shipping Methods
System -> Configuration-> Sales-> Shipping Methods -> IS Entrega
Preenchendo os parâmetros de configuração
Campo
Valor
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.
Catalog-> Attributes-> Manage Attributes
Na página de gerenciamento de atributos clique em "Add New Attribute" e preencha as seguintes informações no quadro "Attribute Properties".
Campo
Valor
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.
Marcar propriedades do objeto Catalog
Marcar propriedades do objeto Custom Options
Marcar propriedades do objeto Sales
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:
Campo
Valor
UserName
isentrega
First Name
IS Log
Last Name
Serviços
Email
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: