Magento 1.9 - IS Entrega
Documentação para integração Magento 1.9
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.
.gif?alt=media&token=696d9e32-fc9f-4b55-aa85-1e54080fd1fa)
Cotação | Envio XML | Rastreamento |
|---|---|---|
Sim | Não | Sim, desde que NFs estejam preenchidas no portal |
- Magento versão 1.9.x.
- PHP 5.6 disponível em seu servidor para integração do módulo ao webservice.
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.
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
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.
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:
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: