Manual de Instalação do Módulo - userede.com.br · Manual de Instalação do Módulo 17 Índice...
Transcript of Manual de Instalação do Módulo - userede.com.br · Manual de Instalação do Módulo 17 Índice...
Clique nos hiperlinks para navegar no material do Manual de Instalação do Módulo.
Índ
Ice 01
020304
0506
Introdução ___________________________________ 3
Versão _______________________________________ 3
Requerimentos ________________________________ 3
Manual de instalação ___________________________ 4
4.1 Instruções iniciais __________________________ 4
4.2 Instalação e ativação do módulo ______________ 5
4.3 Configuração do módulo e-Rede no Magento ___ 9
4.4 Realizando uma compra com o módulo da Rede _____________________ 13
4.5 Acessando informações e logs dos pedidos ____ 17
4.6 Configurando um produto: o “risco produto” ___ 21
Removendo o módulo da Rede _________________ 22
Telas do ambiente e-Rede _____________________ 23
3Manual de Instalação do Módulo
Índice
01 Introdução
Este documento tem por finalidade apresentar o manual de instalação do módulo da Rede para a plataforma de E-commerce Magento. Será apresentado o passo-a-passo da instalação do módulo, considerando um ambiente do Magento já em funcionamento. Não será abordado neste documento o procedimento de instalação do mesmo.
02
03
Versão
Requerimentos
Este manual refere-se exclusivamente à versão 1.0 do módulo da Rede para Magento, que possui requerimentos específicos e que devem ser seguidos e verificados antes de instalá-lo em qualquer ambiente.
Para a instalação correta desta versão do módulo, os seguintes requisitos devem ser atendidos:
•InstalaçãodoE-commerceMagento: Versão 1.8.0.0; •AsbibliotecasSOAP e OpenSSL do PHP devem estar ativas na configuração do servidor web. •RequerimentosrelativosàversãodoPHP,MySQL,eservidorweb devem seguir as especificações da versão instalada do Magento.
4Manual de Instalação do Módulo
Índice
04 Manual de instalação
• Baixeoarquivoerede.zip,relativoaomóduloe-RedeparaMagento;
• Certifique-sedequeosseguintesdiretóriosdoambiente de instalação possuam permissão de escrita pelo servidor web (permissão 775):
– “app/code/community/”;– “app/design/adminhtml/default/”;– “app/design/frontend/base/default/”;– “app/etc/modules/”;– “app/locale/”;– “media/”;
4.1 Instruções iniciais
5Manual de Instalação do Módulo
Índice
Com o arquivo baixado, podemos seguir com a instalação propriamente dita do módulo.
UmavezautenticadonopaineladministrativodoMagento (geralmente no caminho: http://[siteURL]/index.php/admin), acessar o link “Magento connect > Magento connect Manager”:
4.2 Instalação e ativação do módulo
Figura 1: Tela de desinstalação do módulo
6Manual de Instalação do Módulo
Índice
Apósacessarolink,énecessárioentrarcomosmesmosdados de acesso ao administrador.
Figura 2: Tela de login do Magento Connect
7Manual de Instalação do Módulo
Índice
Em seguida, faça o upload do arquivo do módulo. Selecione-o em seu computador e clique em upload.
Figura 3: Upload do Módulo
8Manual de Instalação do Módulo
Índice
Apósfeitoouploaddoarquivo,éexibidaatelaabaixo:
Figura 4: Instalação feita com sucesso
9Manual de Instalação do Módulo
Índice
Seainstalaçãofoiconcluídacomsucesso,écriadaumaaba do módulo no menu superior do admin, com a possibilidade deconfiguraçãodomóduloevisualizaçãodelogs.
4.3 configuração do módulo e-Rede no Magento
Figura 5: Menu criado pelo módulo
11Manual de Instalação do Módulo
Índice
Natelaacima,énecessárioconfiguraromódulopreenchendocorretamenteoscamposassinalados.Aimagemmostraumexemplo de configuração correta do módulo. Para esta tela, algumas considerações devem ser levantadas:
• Oscampos“número do estabelecimento”, “cidade do estabelecimento”, “URL Webservice” e “URL Post” são obrigatórios e seus valores variam de acordo com cada cliente e/ou devem ser consultados junto à equipe responsável da Rede.
• Ocampo“URL de retorno” tambéméobrigatórioedevepossuir o seguinte valor: [siteURL]/index.php/erede/payment/response. Atenção:aURLdeveseguirestritamenteestaestrutura, caso contrário, o módulo não funcionará corretamente!
• Ocampo“Status novo Pedido” indica qual será o status de um pedido dentro do Magento após uma compra ser efetuada atravésdaRede.Apósacompraserrealizadacomsucesso, o Magento define o status como “Processando”.Aúnicaexceção seaplicaacomprasrealizadasatravésdeBoletoBancário,onde acomprafinalizadaésempremarcadacomo“Pendente”, atéquesejaconfirmadaealteradamanualmentepeloadministrador ou responsável pela loja. este campo é obrigatório.
12Manual de Instalação do Módulo
Índice
• Ocampo “Serviços” indica quais serão as formas de pagamento disponíveisnascomprasfeitasutilizando-seomóduloe-Rede. Oitem“Análise de Risco”,apesardenãoserummétodo depagamentoemsi,éutilizadonocasoemqueodonodaloja queira que os dados do comprador sejam passados por uma análise antes do fechamento da compra. este campo é obrigatório.
• Ocampo“Parcela Mínima” serve para indicar qual será o valor mínimo de cada parcela em uma compra. Independente da quantidade de parcelas selecionada no campo “Quantidade Parcelas”, este valor irá definir qual a quantidade máxima de parcelas em que uma compra poderá ser parcelada, baseado novalordamesma.Ocampo“Parcela Mínima” só deverá ser definido caso o campo “Quantidade Parcelas” tenha algum valor diferente de “À Vista” selecionado.
• Oscamposdestacadosemazulnaimagemacima sãoobrigatóriosapenasseométodo“Boleto Bancário” for selecionado no campo “Serviços”.
13Manual de Instalação do Módulo
Índice
AofecharmosumacompranoMagento, temos o opção de escolher qualseráométododepagamentoutilizado.Casoométodo de pagamento da Rede esteja devidamente configurado, será possível visualizá-lonateladeseleção:
4.4 Realizando uma compra com o módulo da Rede
Figura 7: Teladeescolhadométododepagamento
14Manual de Instalação do Módulo
Índice
Aoselecioná-lo,podemosveroresumodacompra, eobotãoparafinalizá-la:
Aoclicarnobotão“Place Order”,ocompradoréredirecionado à página da Rede, onde poderá efetuar o pagamento em ambiente seguro.Oqueaconteceapartirdaí,fogedoescopodestemanual,porém,nosinteressaoqueaconteceemseguida:seopedidofoi ou não processado.
Figura 8: Tela de finalização da compra
15Manual de Instalação do Módulo
Índice
Caso o sistema encontre algum erro no processamento do pedido, o módulo da Rede irá imprimir na tela a seguinte mensagem:
Figura 9: Tela de erro
16Manual de Instalação do Módulo
Índice
Caso a compra seja bem sucedida, uma tela de sucesso será exibida. Como exemplo, a tela de sucesso de uma compra feita com o módulo da Rede no Magento,utilizandooserviçodeBoletoBancário:
Figura 10: Tela de compra realizada com sucesso
17Manual de Instalação do Módulo
Índice
Com o módulo da Rede no Magento,épossívelobterinformaçõessobrecadapedidorealizadodeduasmaneiras:atravésdapágina de pedidos nativa do Magentoeatravésdeumapáginadelogsexclusiva do módulo.
ApáginadepedidoséacessadanormalmentenoMagento (sejanopaineladministrativo,ounafrentedosite).Aoacessá-la, épossívelverificarinformaçõesespecíficasdomódulodaRede referente ao pedido:
4.5 Acessando informações e logs dos pedidos
Figura 11: Teladevisualizaçãodopedidonoadmin
18Manual de Instalação do Módulo
Índice
Figura 12: Teladevisualizaçãodopedidopelocliente
Figura 13: EscolhadolinkLogs
Para acessar a página de logs do módulo da Rede, basta clicarmos no link “Logs” dentro da aba “e-Rede” na parte superior do painel de controle do Magento.
19Manual de Instalação do Módulo
Índice
Aoacessarmosapáginadelogsdomódulo,temosumalistagemcompletadetodososlogsqueforamarmazenadosdecadacomprafeita no MagentoutilizandoomódulodaRede.Casoqueiramos ver mais detalhes de um log específico, basta clicarmos em cima do registro desejado.
Figura 14: Tela de listagem dos logs
21Manual de Instalação do Módulo
Índice
QuandoomódulodaRedeéinstaladoeconfiguradonoMagento, ele cria um campo adicional às configurações dos produtos: o campo “Risco Produto”.Estecampo,utilizadopelaRedeparatratarcasos de análise de risco, tem, por padrão, o valor “Baixo”. Este,porém,podeseralteradopara“Médio” ou “Alto”.
Para modificar este valor, basta acessar a página de edição de um produto qualquer no Magento.OmódulodaRedeadiciona,em sua instalação, uma aba chamada “e-Rede”. Nesta aba, podemos modificar o valor do atributo “Risco Produto”.
4.6 configurando um produto: o “Risco Produto”
Figura 16: Tela de configuração do campo “Risco Produto”
22Manual de Instalação do Módulo
Índice
05 Removendo o módulo da Rede
Para desinstalar o módulo e-Rede, encontre o módulo na listagem, selecione “Uninstall” na caixa de seleção e clique em “commit changes” localizadonomenusuperiordaáreaadministrativa, encontrar o módulo na listagem e clicar no botão “desinstalar”.
Caso a desinstalação ocorra com sucesso, a tela abaixo será exibida.
Figura 17: Tela de desinstalação do Módulo
Figura 18: Desinstalação feita com sucesso
23Manual de Instalação do Módulo
Índice
06 Telas do ambiente e-Rede
Telasdoambienteseguroe-Rede,osbotõesCrédito,DébitoeBoletoaparecem, mas só ficam habilitados dependendo do que foi contratado com a Rede