manual de instalação do módulo - máquina de cartão de ...€¦ · manual de instalação do...

22
Manual de Instalação do Módulo Módulo e-Rede Prestashop v1.0 estamos todos ligados

Upload: others

Post on 15-Aug-2020

6 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

Manual de

Instalação do Módulo

Módulo e-Rede Prestashop v1.0

estamos todos ligados

Page 2: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

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 ______________ 4

4.3 Configuração do módulo e-Rede no Prestashop __ 6

4.4 Realizando uma compra com o módulo da Rede ______________________ 9

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

4.6 Configurando um produto: o “Risco Produto” ___ 17

Removendo o módulo da Rede _________________ 18

Telas do ambiente e-Rede _____________________ 19

Page 3: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

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 Prestashop. Será apresentado o passo-a-passo da instalação do módulo, considerando um ambiente do Prestashop 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 Prestashop, 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-commercePrestashop: Versão 1.5.6.1;• 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 Prestashop.

Page 4: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

4Manual de Instalação do Módulo

Índice

04 Manual de instalação

• Façaodownloaddoarquivoerede.zip, relativo ao módulo e-Rede para Prestashop; • Extraiaoconteúdodoarquivodentrodapasta“modules” localizadanapastadeinstalaçãodoPrestashop.

4.1 Instruções iniciais

Com os arquivos extraídos no diretório corretamente, podemos seguir com a instalação propriamente dita do módulo.

UmavezautenticadonopaineladministrativodoPrestashop (geralmente no caminho: http://[siteURL]/adminXXXX onde XXXX éumnúmeroaleatóriogeradopeloPrestashop após a instalação), acesse a área “Módulos”:

4.2 Instalação e ativação do módulo

Figura 1: TeladeAdministraçãodoPrestashop

Page 5: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

5Manual de Instalação do Módulo

Índice

Em seguida, na tela de listagem dos módulos, encontre o módulo e-Rede e clique em “Instalar”.

Figura 2: Tela de listagem dos módulos

Page 6: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

6Manual de Instalação do Módulo

Índice

Se a instalação foi concluída com sucesso, é criada uma aba do módulo no menu superior do admin, com a possibilidade de configuração domóduloevisualizaçãodelogs.

4.3 configuração do módulo e-Rede no Prestashop

Figura 3: Tela de configuração do módulo

Page 7: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

7Manual de Instalação do Módulo

Índice

Na tela acima, é necessário configurar o módulo preenchendo corretamenteoscamposassinalados.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ório e deve possuir o seguinte valor: index.php?fc=module&module=erede&controller =paymentreturn. 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 Prestashop após uma compra ser efetuada atravésdaRede.Apósacompraserrealizadacomsucesso, o Prestashop define o status como “Processando”.Aúnicaexceção seaplicaacomprasrealizadasatravésdeBoletoBancário, ondeacomprafinalizadaésempremarcadacomo“Pendente”, até que seja confirmada e alterada manualmente pelo administrador ou responsável pela loja. este campo é obrigatório.

• Ocampo “Serviços” indica quais serão as formas de pagamento disponíveisnascomprasfeitasutilizando-seomóduloe-Rede. Oitem“Análise de Risco”, apesar de não ser um método depagamentoemsi,éutilizadonocasoemqueodonodaloja queira que os dados do comprador sejam passados por uma análise antes do fechamento da compra. este campo é obrigatório.

Page 8: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

8Manual de Instalação do Módulo

Índice

• Ocampo“Parcela Mínima” serve para indicar qual será o valor mínimo de cada parcela em uma compra. Independentemente 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.

• Oscamposdestacadosemazulnaimagemacimasãoobrigatóriosapenas se o método “Boleto Bancário” for selecionado no campo “Serviços”.

Page 9: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

9Manual de Instalação do Módulo

Índice

Aofecharmosumacomprano Prestashop, temos o opção deescolherqualseráométododepagamentoutilizado. Caso o método de pagamento da Rede esteja devidamente configurado,serápossívelvisualizá-lonateladeseleção:

4.4 Realizando uma compra com o módulo da rede

Figura 4: Tela de seleção da forma de pagamento

Page 10: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

10Manual de Instalação do Módulo

Índice

Aoselecioná-lo,podemosveroresumodacompra, com a indicação de qual foi o método de pagamento escolhido:

Figura 5: Tela de confirmação de compra

Page 11: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

11Manual de Instalação do Módulo

Índice

Aoclicarnobotão“confirmar compra”, o comprador é redirecionado à página da Rede, onde poderá efetuar o pagamento emambienteseguro.Oqueaconteceapartirdaí,fogedoescopo deste manual, porém, nos interessa o que acontece em seguida: se o pedido foi ou não processado.

Caso o sistema encontre algum erro no processamento do pedido, o módulo da Rede irá imprimir na tela a seguinte mensagem:

Figura 6: Tela de erro

Page 12: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

12Manual 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 Prestashop,utilizandooserviçodeBoletoBancário:

Figura 7: Teladecomprarealizadacomsucesso

Page 13: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

13Manual de Instalação do Módulo

Índice

Com o módulo da Rede no Prestashop, é possível obter informações sobrecadapedidorealizadodeduasmaneiras:atravésdapágina de pedidos nativa do Prestashop e através de uma página de logs exclusiva do módulo.

ApáginadepedidoséacessadanormalmentenoPrestashop (seja no painel administrativo, ou na frente do site). Aoacessá-la,épossívelverificarinformaçõesespecíficasdomódulo da Rede referente ao pedido:

4.5 Acessando informações e logs dos pedidos

Figura 8: Teladevisualizaçãodopedidonoadmin

Page 14: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

14Manual de Instalação do Módulo

Índice

Figura 9: Teladevisualizaçãodopedidonaáreadocliente

Page 15: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

15Manual de Instalação do Módulo

Índice

Figura 10: Tela de exibição dos links do módulo

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

Page 16: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

16Manual de Instalação do Módulo

Índice

Figura 11: Tela de listagem dos logs

Figura 12: Tela de detalhes do log

Aoacessarmosapáginadelogsdomódulo,temosumalistagemcompletadetodososlogsqueforamarmazenadosdecadacomprafeita no Prestashop utilizandoomódulodaRede.Casoqueiramos ver mais detalhes de um log específico, basta clicarmos no ícone .

Page 17: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

17Manual de Instalação do Módulo

Índice

QuandoomódulodaRedeéinstaladoeconfiguradonoPrestashop, 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, pode ser alterado para “Médio” ou “Alto”.

Para modificar este valor, basta acessar a página de edição de um produto qualquer no Prestashop.OmódulodaRedeadiciona,em sua instalação, uma aba chamada “e-Rede”. Nesta aba, podemos modificar o valor do atributo “Risco Produto”.

4.6 configurando o “Risco Produto”

Figura 13: Tela de configuração do “Risco Produto”

Page 18: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

18Manual de Instalação do Módulo

Índice

05 Removendo o módulo da Rede

Para desinstalar o módulo e-Rede, basta acessar o link “módulos” localizadonomenusuperiordaáreaadministrativa,encontraromódulona listagem e clicar no botão “desinstalar”.

Figura 14: Tela de desinstalação do módulo

Page 19: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

19Manual 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.

Page 20: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

20Manual de Instalação do Módulo

Índice

Page 21: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

21Manual de Instalação do Módulo

Índice

Page 22: Manual de Instalação do Módulo - Máquina de cartão de ...€¦ · Manual de Instalação do Módulo 4 Índice 04 Manual de instalação • Faça o download do arquivo erede.zip,

22Manual de Instalação do Módulo

Índice