Instalação do Módulo
Contents
1. estamos todos ligados Introdu o Requerimentos _ Manual de instala o __ 4 4 1 Instru es iniciais 4 2 Instala o e ativa o do m dulo _ 4 3 Realizando uma compra com o m dulo da Rede __ Acessando informa es e logs 4 5 Configurando um produto o Ris Removendo o m dulo da Rede___ Telas do ambiente e Rede CAN Clique nos hiperlinks para navegar no material do Manual de Instala o do M dulo Manual de Instala o do M dulo 01 Introdu o Este documento tem por finalidade apresentar o manual de instala o do m dulo da Rede para a plataforma de ecommerce OSCommerce Ser apresentado o passo a passo da instala o do m dulo considerando um ambiente do OSCommerce j em funcionamento N o ser abordado neste documento o procedimento de instala o do mesmo 02 Vers o 03 ndice Este manual refere se exclusivamente vers o 1 0 do m dulo da Rede para OSCommerce que possui requerimentos especificos e que devem ser seguidos e verificados antes de instal lo em qualquer ambiente Requerimentos Para a instala o correta desta vers o do m dulo os seguintes requisitos devem ser atendidos Instala o do ecommerce OSCommerce Vers o 2 3 x As bibliotecas SOAP e OpenSSL do PHP devem estar ativas na configura o do servidor web Os requerimentos relativos a vers o do PHP MySQL e do servidor web devem2. Nome do Cliente Sobrenome do Cliente Endere os Cadastrados Principal Entrega e Cobran a E mail do Cliente IP do Cliente Telefone do Cliente Juros por Dia e Valor da Multa devem ser superiores a Zero Instru es do Boleto Data de Vencimento do Boleto Banco cedente do Boleto Boleto Raz o Social N mero do PV N mero do Pedido Valor do pedido Nome do Cliente Sobrenome do Cliente Endere os Cadastrados Principal Entrega e Cobran a Produto de Risco Obrigat rio Risco ndice Manual de Instala o do M dulo ndice Cart o de Cr dito Quantidade Parcelas define o n mero m ximo de 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 Bradesco 13 Banco do Brasil 14 HSBC 15 Santander 16 Caixa 2 d gitos num ricos Manual de Instala o do M dulo ndice Banco Cedente define o banco cedente do boleto Quantidade Dias Vencimento quantidade de dias para o vencimento do boleto devendo ser preenchido com valor num rico 1 99 Multa Atraso define o valor da multa em caso de atraso devendo ser preenchido como valor monet rio seguindo a m scara XX XX Juros por Dia define o valor de juros di rio em caso de atraso devendo ser preenchido como valor
3. m xima de parcelas em que uma compra poder ser parcelada baseado no valor da mesma O campo Parcela M nima s dever ser definido caso o campo Quantidade Parcelas tenha algum valor diferente de Vista selecionado ndice Manual de Instala o do M dulo Os campos destacados em azul na imagem abaixo s o obrigat rios apenas se o m todo Boleto Banc rio for selecionado no campo Servi os ii CANSEI ade op Order Status Drder status after being processed by Rede except for ants made using Bank Bet which wil always be Figura 5 Configurando o m dulo e Rede ndice Manual de Instala o do M dulo 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 define o nome utilizado para o meio de pagamento e deve estar preenchido com e Rede N mero Estabelecimento n mero do estabelecimento junto 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 us
4. fico ndice Manual de Instala o do M dulo 4 5 Configurando um produto o risco produto Quando o m dulo da Rede instalado e configurado no OSCommerce criado um campo adicional s configura es dos produtos o campo Risco Produto ou Product Risk na vers o em ingl s Este campo utilizado pela Rede para tratar casos 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 Risco Produto atrav s do menu lateral do e Rede na rea administrativa do OSCommerce selecionando o link Definir Risco Produto ou Set Product Risk na vers o em ingl s Ao acessar a p gina basta seguir selecionando os produtos desejados navegando por dentro de suas categorias como na visualiza o padr o de produtos no OSCommerce Na visualiza o do produto desejado basta escolher a op o do Risco Produto desejada Categories Products Moost intefildouse Explorers Moo ineilMioime Pro Categories O Produds 2 Figura 14 Configurando o Risco Produto ndice Manual de Instala o do M dulo 05 Removendo o m dulo da Rede Para desinstalar o m dulo da Rede primeiramente deve se acessar novamente a rea de gerenciamento de m dulos de pagamento descrita na se o 4 2 e indicada na figura 1 desse manual Na
5. includes languages portugues erede logs php deve ser extra do no diret rio do idioma portugu s da rea administrativa da sua instala o do OSCommerce normalmente em catalog admin includes languages portugues Oarquivo catalog admin includes languages english modules boxes erede php deve ser extra do no diret rio de boxes do idioma ingl s da rea administrativa da sua instala o do OSCommerce normalmente em catalog admin includes languages english modules boxes O arquivo catalog admin includes languages english modules boxes erede php deve ser extra do no diret rio de boxes do idioma portugu s da rea administrativa da sua instala o do OSCommerce normalmente em catalog admin includes languages portugues modules boxes ndice Manual de Instala o do M dulo 4 2 Instala o e ativa o do m dulo Com os arquivos do pacote de instala o do m dulo da Rede propriamente extra dos nos diret rios corretos basta acessar a p gina administrativa do OSCommerce geralmente no caminho http siteURL admin para seguir com a instala o Uma vez autenticado no painel administrativo do OSCommerce acessar o menu Modules gt Payment e clicar no bot o Install Module oscommerce Administration Online Catalog Support Site Catalog Store ao Y Modules Action Recorder Boxes Dashboard Header Tags Shani Socal Bookmar
6. inteiro na qual ser convertido para porcentagem exemplo 2 15 2 15 Instru es de Pagamento do Boleto informa es relevantes para o seu cliente e que ser o inseridas no Boleto Nota de Pagamento do Boleto informa es adicionais do boleto Ordem numero de inicio dos boletos Manual de Instala o do M dulo 4 3 Realizando uma compra com o m dulo da rede Ao fecharmos uma compra no OSCommerce temos o op o de escolher qual ser o m todo de pagamento utilizado Caso o m dulo de pagamento da e Rede esteja devidamente configurado ser poss vel enxerga lo na tela de sele o Payment Method Please select the preferred paymem method to use on fhis order Cash on Delivery Pay Pai inciudng Credit and Debit Cards Add Comments About Your Order Figura 6 Selecionar o m todo de pagamento e Rede ndice Manual de Instala o do M dulo Ao selecion lo podemos ver o sum rio da compra no carrinho de compras do site com a indica o de qual foi o m todo de pagamento escolhido Order Confirmation shiopina Inf Delivery Address Products 1 x MecrosoR intedliMouse E mplorer Modet PS 2 Shipping Metod Fiat R ate Best Way Sd Total SE4 95 fat Ra Gest Way S5 00 biw 559 95 Paymem Method Figura 7 Realizar checkout da compra ndice Manual de Instala o do M dulo Ao clicarmos no bot o de confirma o do pedido o comprador redireciona
7. listagem que exibida basta selecionar o e Rede e clicar na op o Remover M dulo Payment Instas Module 43 Authore met Credt Card MM Cash on Delivery e Rede PayPal Egress Checo Module De ectory Aarwwwredecad_eomme ce oscormene r ce doa tado frades mod esto yr Figura 15 Removendo o pacote do m dulo da Rede Aten o Esta desinstala o entretanto remove apenas a refer ncia do e Rede na lista de m dulos instalados no OSCommerce e algumas informa es no banco de dados Para a remo o completa do m dulo isto a remo o dos arquivos f sicos do mesmo no servidor as opera es descritas no item 4 1 deste manual devem ser desfeitas Ou seja os arquivos adicionados e os c digos inseridos devem ser removidos manualmente ndice Manual de Instala o do M dulo 06 Telas do ambiente e Rede Telas do ambiente seguro e Rede os bot es Cr dito D bito e Boleto aparecem mas s ficam habilitados dependendo do que foi contratado com a Rede Escolha o tipo de transa o desejada e clique nos bot es abaixo PR eo N Pedido afi9wqd5slhpv rog Voc est em um Fique tranquilo Estabelecimento Estabelecimento ambiente seguro e Valor R 1 00 certificado pela Rede Forma de Pagamento N Cart o SS visa Mg A bandeira do seu cart o ser selecionada automaticamente Validade do Cart o I 12 7 C digo de Seguran a Onde
8. seguir as especifica es da vers o instalada do OSCommerce Manual de Instala o do M dulo 04 Manual de instala o 4 1 Instru es iniciais ndice Fa a o download do arquivo erede oscommerce zip relativo ao m dulo e Rede para o OSCommerce Para a extra o do conte do iremos considerar que a raiz de sua loja encontra se dentro do diret rio catalog Caso a raiz esteja em outro diret rio considera lo ao inv s do definido aqui Para realizar a extra o dos arquivos as seguintes regras devem ser seguidas Os arquivos catalog erede checkout success php e catalog erede info php devem ser extra dos dentro do diret rio catalog ou o diret rio raiz de sua loja O arquivo catalog includes modules payment erede php deve ser extra do dentro do diret rio catalog includes modules payment Manual de Instala o do M dulo ndice Oarquivo catalog account history info erede php n o deve ser copiado para o seu diret rio do OSCommerce Ele deve ter seu conte do copiado e inserido dentro do arquivo account history info php no diret rio catalog de sua instala o na seguinte regi o aproximadamente linha 185 no arquivo original dc php TE DOWNLOAD ENABLED M irue anelude DIR NS MODULES cdonirbo ade ea Ee INSIRA O C DIGO NESTA REGI O lt div class buttonsSet gt Fiems echo tep draw button IMAGE BUTTON B
9. ACK triangle l w tep href link FILENAME ACCOUNT HISTORY tep getrok qse earams array orders CEM lt div gt lt div gt Aten o tenha uma c pia de seguran a do arquivo account history info php original antes de realizar o procedimento Manual de Instala o do M dulo ndice W M Os arquivos catalog admin erede_info php catalog admin erede_logs php catalog admin erede modules php e catalog admin erede riscoproduto php devem ser extra dos dentro do diret rio catalog admin O arquivo catalog admin includes boxes erede php deve ser extra do no diret rio catalog admin includes boxes O arquivo catalog admin includes functions erede php deve ser extra do no diret rio catalog admin includes functions O arquivo catalog admin includes local configure php n o deve ser copiado para o seu diret rio do OSCommerce Caso o arquivo chamado configure php n o exista na sua instala o em catalog admin includes local ele deve ser criado neste local e o c digo do arquivo configure php no pacote de instala o deve ser copiado para o arquivo do seu ambiente de prefer ncia no in cio do arquivo Aten o tenha uma c pia de seguran a do arquivo configure php original antes de realizar o procedimento Manual de Instala o do M dulo ndice Oarquivo catalog admin orders_erede php n o deve se
10. do p gina da Rede onde poder efetuar o pagamento em ambiente seguro O que acontece a partir da foge do escopo deste manual por m nos interessa o que acontece em seguida se o pedido foi ou n o processado Caso o sistema encontre erro de qualquer tipo no processamento do pedido ele ser cancelado no sistema do OSCommerce por m os itens permanecer o dispon veis no carrinho de compras para nova tentativa O m dulo da Rede ir imprimir na tela a seguinte mensagem Payment Information Error on processing your order Figura 8 Mensagem de erro do m dulo ndice Manual de Instala o do M dulo Caso a compra seja bem sucedida o status do pedido ser definido de acordo com as configura es do m dulo e uma tela de sucesso ser exibida Como exemplo a tela de sucesso de uma compra feita com o m dulo da Rede no OSCommerce utilizando o servi o de Boleto Banc rio Your Order Has Been Processed Your order has been successtully processed Your products wil arive at heir destinaton within 2 5 working days Please notify me of updates b fe produci Ihave selecded below You can view your order history by going to fre My Account page and by clicking on Hisbry Please drectarny questions you have to the store owner Thanks for shopping with us online Figura 8 Mensagem de sucesso no pagamento ndice Manual de Instala o do M dulo 4 4 Acessando informa es e logs dos pedi
11. dos Com o m dulo da Rede no OSCommerce poss vel obter de duas formas distintas informa es sobre cada pedido realizado atrav s da p gina de pedidos do OSCommerce e atrav s de uma p gina de logs exclusiva do m dulo e Rede A p gina de pedidos acessada normalmente no OSCommerce seja no painel administrativo ou na frente do site Ao acess la poss vel verificar informa es espec ficas do m dulo da Rede referente ao pedido Billing Information B ling Address Sub Total 51 004 87 Flat Re Bes Way 55 O Tot 1 009 87 rder Hi 01 16 2014 Pending 0116 2014 Pending Payment Information e Rede Payment Bank Pillet Prim Bank Billet Figura 9 P gina de um pedido na frente do site ndice Manual de Instala o do M dulo Orders Customer Payment Method eRede e Rede Token 355aSc b2 411 4706 0214 25 10404 96 1c8 Bark Bilet Figura 10 P gina de um pedido na rea administrativa ndice Manual de Instala o do M dulo Para acessar a p gina de logs do m dulo da Rede basta clicarmos no menu e Rede no lado esquerdo do painel de controle administrativo do OSCommerce e selecionarmos a op o Logs Como uma observa o vale destacar que o link Configura es tamb m dentro do menu e Rede apenas um atalho para a p gina de configura es do m todo de pagamento j descrita anteriormente oscommerce Administration Onlin
12. e Catalog Support Site Catalog Default Store 60000 afiada 40000 Configuration Logs Set Product Rk Localization Locations Taxes Modules Reports Tools Figura 11 Menu do m dulo da Rede no OSCommerce ndice Manual de Instala o do M dulo Ao acessar a p gina de logs do m dulo tem se uma listagem completa de todos os logs que foram armazenados de cada compra feita no OSCommerce utilizando o m dulo e Rede Para poder ver mais detalhes sobre um log espec fico basta clicar sobre o item que se deseja visualizar Log 0O Sats AS Logs Jan 22 2014 105 PM Transa o aprovada m Antke de Reco l com Jan 22 2014 10 25 28 PM ber t pa rema miy Ap hornmmere aed om DD maddioserace see optante sc wsdl Jan 20 2014 10 44 AM Tawai repestads pdo emesa Figura 12 Listagem dos logs oscommerce Administraton Online Catalog Support Site h Gainiog e Rede Logs Configura on Log Details Customers Log Date Jan 22 2014 10 26 30 PM v e Rede Order ID 176 Configuration Order Status Pending Logs Transaction Response Transa o aprovada na An lise de Risco Set Product REk Rede s communication status ACCEPTED o Rede s communication status e Rede Token 355a9cb2 d4 11 4706 b2f4 251 d da961c8 Payment Method Bank Billet Modules Bank Billet URL link Gateway Reference 3800900010026060 Locations Taxes Repons Figura 13 P gina de um log espec
13. encontrar o c digo de seguran a L Campos obrigat rios ndice Manual de Instala o do M dulo Escolha o tipo de transa o desejada e clique nos bot es abaixo E cesso RE N Pedido a1i9wqd5sIhpv4r09 Voc est em um Estabelecimento Estabelecimento ambiente seguro e Valor R 1 00 certificado pela Rede Fique tranquilo N Cart o Validade do Cart o 12 7 C digo de Seguran a Onde encontrar o c digo de seguran a Campos obrigat rios ndice Manual de Instala o do M dulo Escolha o tipo de transa o desejada e clique nos bot es abaixo O Boo Pagamento vista n o receber ap s o vencimento Fique tranquilo Voc est em um ambiente seguro e Estabelecimento Estabelecimento certificado pela Valor R 1 00 Rede Campos obrigat rios Gerar Boleto ndice Resolva tudo numa s liga o 001 4433 0800 728 4433 userede com br
14. erede com br ModuloWeb default aspx OBS As URLs Webservice e Post s o de teste ap s finalizar os seus testes entrar com as URLS de Produ o ndice Manual de Instala o do M dulo 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 status que ser atualizado ao finalizar uma compra com o meio de pagamento Rede variando entre Pendente ou Processando Servi os lista de servi os que o estabelecimento tem contratado com a Rede tais como Boleto Cr dito D bito e Risco Segue abaixo a lista de campos obrigat rios para cada servi o Manual de Instala o do M dulo Ao menos um servi o deve ser selecionado D bito Cr dito Boleto ou Risco Raz o Social N mero do PV N mero do Pedido Valor do pedido D bito Raz o Social N mero do PV N mero do Pedido Valor do pedido Cr dito Raz o Social N mero do PV N mero do Pedido Valor do pedido
15. ks Figura 1 Acessando o gerenciador de m dulos de pagamento ONI mms Action Cash on Delivery 0 gt 3 Edit Remove Module 0 o E Figura 2 O bot o Install Module nos leva p gina de instala o dos m dulos ndice Manual de Instala o do M dulo Na p gina de m dulos de pagamento selecione o m dulo e Rede na listagem que exibida e clique em Install Module Payment Authorize met Credit Card AIM Authorize net Credt Card SIM D Dverson 10 onte sans e cy P visit Rede s Website Figura 3 Sele o do m dulo e Rede e instala o Com o m dulo devidamente instalado o pr ximo passo ativ lo e configur lo Para isto na tela de listagem dos m dulos j instalados selecione o item e Rede e clique no bot o Edit Figura 4 Editando o m dulo e Rede Na tela de configura o que exibida em sequ ncia devemos preencher corretamente os campos para o funcionamento do m dulo Segue abaixo um modelo de configura o gen rico Para esta tela de configura o algumas considera es devem ser levantadas e Para que o m dulo seja ativado o campo Enable e Rede Checkout deve ser marcado como True e Os campos N mero do estabelecimento Cidade do Estabelecimento URL do Webservice e URL Post s o obrigat rios e seus valores variam de acordo com cada cliente e ou devem ser consultados junto equipe re
16. r copiado para o seu diret rio do OSCommerce Ele deve ter seu conte do copiado e inserido dentro do arquivo catalog admin orders php da sua instala o na seguinte regi o aproximadamente linha 157 no arquivo original lt tr gt lt td class main gt lt strong gt lt php echo ENTRY PAYMENT METHOD 2 gt lt strong gt lt td gt lt td class main gt lt php echo Sorder gt info payment method lt td gt SI er gt INSIRA O C DIGO NESTA REGI O Aten o tenha uma c pia de seguran a do arquivo orders php original antes de realizar o procedimento O arquivo catalog includes languages english modules payment erede php deve ser extra do no diret rio do idioma ingl s dos m dulos de pagamento da sua instala o do OSCommerce normalmente em catalog includes languages english modules payment Manual de Instala o do M dulo Oarquivo catalog includes languages portugues modules payment erede php deve ser extra do no diret rio do idioma portugu s dos m dulos de pagamento da sua instala o do OSCommerce normalmente em catalog includes languages portugues modules payment Oarquivo catalog admin includes languages english erede logs php deve ser extra do no diret rio do idioma ingl s da rea administrativa da sua instala o do OSCommerce normalmente em catalog admin includes languages english Oarquivo catalog admin
17. spons vel da Rede ndice Manual de Instala o do M dulo e O campo URL de retorno tamb m obrigat rio e deve possuir o seguinte valor http siteURL checkout process php considerando siteURL como sendo o endere o raiz da sua loja Aten o a URL deve seguir estritamente esta estrutura caso contr rio o m dulo n o funcionar corretamente e O campo Status do Pedido Processado indica qual ser o status de um pedido dentro do OSCommerce ap s uma compra ser efetuada e finalizada com sucesso atrav s da Rede O valor padr o desse campo Processando A nica exce o se aplica a compras realizadas atrav s de Boleto Banc rio onde a compra finalizada sempre marcada como Pendente at que seja confirmada e alterada manualmente pelo administrador ou respons vel pela loja e O campo Servi os indica quais ser o as formas de pagamento dispon veis nas compras feitas utilizando se o m dulo e Rede O item An lise de Risco apesar de n o ser um m todo de pagamento em si utilizado no caso em que o dono da loja queira que os dados do comprador sejam passados por uma an lise antes do fechamento da compra Este campo obrigat rio e O campo 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
Download Pdf Manuals
Related Search