Manual de Instalação do Módulo - userede.com.br · Manual de Instalação do Módulo 3 Índice...

Manual de

Instalação do Módulo

Módulo e-Rede Magento v1.0

estamos todos ligados

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

4.5 Acessando informações e logs dos pedidos ____ 22

4.6 Configurando um produto: o “risco produto” ___ 26

Removendo o módulo da Rede _________________ 27

Telas do ambiente e-Rede _____________________ 28

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.


Í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


Í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


Índice

Apósacessarolink,énecessárioentrarcomosmesmosdados de acesso ao administrador.

Figura 2: Tela de login do Magento Connect


Í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


Índice

Apósfeitoouploaddoarquivo,éexibidaatelaabaixo:

Figura 4: Instalação feita com sucesso


Í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


Índice

Figura 6: Tela de configuraçã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.


Í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”.


Índice

Para o correto funcionamento de seu plug in os seguintes parâmetros devem estar preenchidos:

Habilitado: ativa/desativa o módulo e deve estar preenchido com ‘SIM’.

Título:defineonomeutilizadoparaomeiodepagamentoe deve estar preenchido com ‘e-Rede’.

Número Estabelecimento:númerodoestabelecimentojunto à Rede com 9 dígitos (ex: 012345678).

Cidade Estabelecimento: cidade de cadastro do estabelecimento junto à Rede.

TESTE:

Url WebService: endereço para o qual serão enviadas as informações da compra para que sejam validadas no ambiente Rede: https://scommerce.userede.com.br/ModuloService/SetupPluginFE.svc

Url Post: após a conclusão da compra, seu cliente será redirecionado automaticamente para o ambiente seguro Rede: https://scommerce.userede.com.br/ModuloWeb/default.aspx

OBS:AsURLsWebserviceePostsãodeteste,apósfinalizarosseustestesentrarcomasURLSdeProdução.


Índice

PRODUÇÃO:

Url WebService: endereço para o qual serão enviadas as informações da compra para que sejam validadas no ambiente Rede: https://ecommerce.userede.com.br/ModuloService/SetupPluginFE.svc

Url Post: após a conclusão da compra, seu cliente será redirecionado automaticamente para o ambiente seguro: https://ecommerce.userede.com.br/ModuloWeb/default.aspx

Url Back: ao final do fluxo de pagamento, seu cliente será retornado à página de confirmação do módulo Rede: http://www.loja.com.br/ecommerce/payment/response

Status Novo Pedido: statusqueseráatualizadoaofinalizaruma compra com o meio de pagamento Rede variando entre“Pendente”ou“Processando”.

Serviços: lista de serviços que o estabelecimento tem contratadocomaRede,taiscomo:Boleto,Crédito,Débitoe Risco. Segue abaixo a lista de campos obrigatórios para cada serviço:


Índice

Ao menos um serviço deve ser selecionado (Débito,Crédito,BoletoouRisco).

Débito

RazãoSocial;NúmerodoPV;NúmerodoPedido;Valor do pedido.

Crédito

RazãoSocial;NúmerodoPV;NúmerodoPedido;Valor do pedido.

Boleto

RazãoSocial;NúmerodoPV;NúmerodoPedido;Valor do pedido;Nome do Cliente;Sobrenome do Cliente;Endereços Cadastrados (Principal, Entrega e Cobrança);E-mail do Cliente;IP do Cliente;Telefone do Cliente;JurosporDiaeValordaMultadevemsersuperioresaZero;InstruçõesdoBoleto;DatadeVencimentodoBoleto;BancocedentedoBoleto.

Risco

RazãoSocial;NúmerodoPV;NúmerodoPedido;Valor do pedido;Nome do Cliente;Sobrenome do Cliente;Endereços Cadastrados (Principal, Entrega e Cobrança);ProdutodeRiscoObrigatório.


Índice

Cartão de Crédito:

Quantidade Parcelas:defineonúmeromáximode quantidade de parcelas, para isso verifique o seu contrato junto à Rede.

Parcela Mínima: o valor mínimo de uma parcela, seguindo a seguinte máscara (xx.xx)

Boleto: opções de bancos disponíveis:

11=Itaú12=Bradesco13=BancodoBrasil14=HSBC15 = Santander 16 = Caixa

2dígitosnuméricos


Índice

Banco Cedente: define o banco cedente do boleto.

Quantidade Dias Vencimento: quantidade de dias para o vencimento do boleto, devendo ser preenchido comvalornumérico(1-99)

Multa Atraso: define o valor da multa em caso de atraso, devendo ser preenchido como valor monetário seguindoa máscara (XX.XX)

Juros por Dia: define o valor de juros diário em caso de atraso, devendo ser preenchido como valor inteiro na qual será convertido para porcentagem; exemplo: 2.15 = 2,15%

Instruções de Pagamento do Boleto: informações relevantes paraoseuclienteequeserãoinseridasnoBoleto.

Nota de Pagamento do Boleto: informações adicionais do boleto

Ordem: numero de inicio dos boletos


Í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


Í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


Í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


Í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


Í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


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


Í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


Índice

Figura 15: Tela de detalhes do log


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


Í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çãofeitacomsucesso


Í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


Índice

Manual de Instalação do Módulo - userede.com.br · Manual de Instalação do Módulo 3 Índice...

Documents

Transcript of Manual de Instalação do Módulo - userede.com.br · Manual de Instalação do Módulo 3 Índice...