Arquivo mensal 06/02/2023

porNatã Giertyas

Integração WooCommerce – Problema ao enviar imagem para a Loja Virtual.

Os sites WooCommerce precisam de uma configuração adicional para o sistema conseguir fazer o envio da imagem do produto para site. Se o site for fornecido e configurado pela Moderniza essas configurações já serão feitas por nossa conta. Caso o site for de um fornecedor terceiro, ele deverá ser feita para o funcionamento do envio de imagens.

Por que é necessário essas configurações?

O WooCommerce aceita somente imagens através de um link, ou seja, não é possível enviar arquivo de imagens. Desse modo precisamos enviar a imagem pelo WordPress que é o construtor do site WooCommerce. O WordPress aceita o envio de arquivos, porém pra isso precisamos fazer algumas configuração para conseguir fazer o envio do arquivo. E também essa configuração implementa a autenticação via Json Web Token que torna mais seguro o envio da imagem.

1 – Instalação de Plugins 

Plugin obrigatório. A sua responsabilidade é a ativação de API do WordPress que é por onde será enviada a imagem posteriormente.

WordPress REST API (Version 2)

Plugin obrigatório. A sua responsabilidade é a ativação da autenticação por token de acesso para conseguirmos comunicar com a API e enviar a imagem.

IMPORTANTE: Dependendo da versão do PHP do seu site você irá precisar usar a versão antiga desse plugin que você pode obter através desse link

JWT Authentication for WP REST API

Plugin opcional. Em caso de ativação esse plugin tem a responsabilidade de identificar todas as requisições feitas para o site, desse modo conseguimos testar e visualizar o que está chegando de informação no site.

REST API Log

IMPORTANTE: Para a realização dos passos 2 e 3, você precisará acesso ao servidor de arquivos da Loja Virtual, conhecido também como FTP do site. O FTP é onde possuí os arquivos de instalação e configuração do site, além de possuir todo o conteúdo do site, como páginas, plugins e afins. 

RECOMENDADO: ANTES DE FAZER QUALQUER ALTERAÇÃO DE QUALQUER ARQUIVO REALIZE UM BACKUP DOS MESMOS, POIS ESSES SÃO ARQUIVOS DE CONFIGURAÇÃO DO SITE E QUALQUER ALTERAÇÃO INCORRETA PODERÁ IMPACTAR NA DISPONIBILIDADE DO SITE.

2 – Configuração no arquivo wp-config.php no FTP

Acessando o FTP do site, você irá navegar até a pasta do site, normalmente ele se chamará public_html. Nessa pasta, você terá acesso ao arquivo wp-config.

Você precisará editar o arquivo com um editor de texto e adicionar algumas variáveis para configuração do site

define('AUTH_KEY', '2>clCCVok+)8N0D$ecRv(H,m}(T=gMnU+H`ne]U6d~g+K8M?3O`:Lbj-x?@QLg`{');
define('SECURE_AUTH_KEY', '-7^m|jDY4&ys1U:IK-2|-{c=n7]Kgmwtl*+cr,%2Apk?gBm0 %IAvx2Y}@.F|y3x');
define('LOGGED_IN_KEY', 'eMoF:Yk.{{L (g+.Tns]#7Ng FI`{5pc&c6S!lbLM_]GZaA1amy+mW?~hHc;7M-5');
define('NONCE_KEY', 'BZnXx@_4o!{j-1J(GtRuT<<t@_(5n~76/09>TQZ(+vupeN8kT-B>v-eXO?+!^Ol1');
define('AUTH_SALT', 'y,-b)->Nf7+gEOxc<LDiia?#6N9q,Uy6dqo{|@qV}H2vS3P[T31Sg+Mk#{{8v~@#');
define('SECURE_AUTH_SALT', 'u:`97t|<1`@C%3zPAkP:rpZ{_b+|d&76oLOgE]yk=X*KOK^wc8<*V?q|OrpZn7KA');
define('LOGGED_IN_SALT', '&qhXE-EId2/#eC|}*+|a;zo@+k2BxMbGJ}dm|: br`j0:h~@8aDxi0Ny62byiO&9');
define('NONCE_SALT', 'KRg9l%C#Kpv,1$[nzxFMR=+O8I.+!XX:Gv~xOW+&pj7kwz;djDQZ5f(Q0$wi[>RD');

Para geração dessas chaves você precisa abrir esse link https://api.wordpress.org/secret-key/1.1/salt/

Além disso você precisa adicionar mais uma variável que é a seguinte:

     define('JWT_AUTH_SECRET_KEY', 'SUSBSTITUIRPELACHAVE');

Essa chave tem um detalhe. Você precisa trocar o valor SUSBSTITUIRPELACHAVE por algum valor do site https://api.wordpress.org/secret-key/1.1/salt/

Exemplo: Abra o site e copie qualquer valor e troque pelo texto

Nova chave

     define('JWT_AUTH_SECRET_KEY', 'dO*r+Pbp0,RN=gPhe|vU;L|=)-+9)xGo7[BC@C@ZO<rH(TFaES51u:z#SiBX/N)k'); 

Agora você precisa colocar tudo isso no seu arquivo wp-config.php ficando dessa forma

3 – Configuração no arquivo .htaccess no FTP

No arquivo .htaccess precisamos habilitar o HTTP Authorization Header
Para habilitá-lo é necessário editar o arquivo .htaccess e adicionar as seguintes linhas.

RewriteEngine on
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule ^(.*) - [E=HTTP_AUTHORIZATION:%1]

Ele deve ficar da seguinte forma:

 

Qualquer dificuldade durante a configuração podem entrar em contato com o suporte que auxiliaremos e em caso do fornecedor do site não poder realizar as configurações podemos acompanhar e auxiliar na mesma, porém precisamos de um acesso Administrador do site e também do acesso ao FTP do site para manipulação dos arquivos. 

porNatã Giertyas

Configuração PIX Dinâmico ModerBank

1 – Configuração da conta ModerBank e da chave PIX

IMPORTANTE: Antes de realizar esse processo é necessário ter uma conta ModerBank cadastrada e sincronizada com o sistema conforme as orientações desse manual

Com a sua conta bancária do Moderbank cadastrada e sincronizada com o sistema, você precisará informar  no cadastro da mesma qual a chave PIX que deseja usar para geração do QrCode dinâmico.

No sistema navegue até Financeiro -> Bancos -> Contas Bancárias. Seleciona a conta do Moderbank e clique em Alterar

Alterando o cadastro da sua conta, o último campo será designado para informar chave PIX que esteja cadastrada para a sua conta ModerBank. Se você não souber quais as chaves estão disponível para a sua conta ModerBank, você pode clicar no botão chaves que o sistema irá consultar e lhe apresentar quais estão disponíveis para uso.

IMPORTANTE: Para informar a chave PIX, existe uma permissão de acesso, caso não aparece a opção de informar a chave PIX, verifique se o seu perfil possui essa permissão.

2 – Uso do PIX no Faturamento ou PDV

Com o PIX configurado para poder fazer o uso é necessário selecionar finalizador Transferência Bancária tipo PIX. Dessa forma você precisara selecionar a conta bancária que está configurada o PIX e clicar em confirmar para gerar o Qr Code.

Após clicar em confirmar o sistema irá gerar o QrCode e irá ficar verificando se o pagamento do PIX foi realizado com sucesso.

Após o cliente pagar o PIX e o sistema identificar que o pagamento foi feito aparece um aviso de pagamento e confirmar e ao clicar em OK, o sistema adiciona o meio de pagamento da venda e finalizada a mesma.

IMPORTANTE: O Sistema só irá deixar prosseguir com a venda se o mesmo identificar o pagamento do PIX.  Após a geração do PIX o sistema aguarda 14 segundos para iniciar a verificação e após isso ele verifica 20 vezes em com um intervalo de 2 segundos em cada tentativa. Se o pagamento não foi identificado durante esse período o sistema irá pedir ao usuário se o mesmo deseja verificar a transação novamente ou cancelar a operação.

porNatã Giertyas

Conciliação de Boletos ModerBank

Conciliação de Boletos

Para validar o pagamento do boleto, você irá ir em Financeiro -> Boletos -> Ler Retorno.

Nessa tela, você irá selecionar o banco, a conta bancária e também a data de emissão do boleto para verificar quais boletos foram pagos e onde eles vão realizar a baixa financeira dentro do sistema. Após preencher essas informações você irá clicar em Ler Retorno(F1)

O sistema irá verificar quais os boletos foram emitidos nesse dia e também vai fazer a validação se foram pagos ou não. Se o boleto for pago o sistema já realiza a baixa automaticamente do título dentro do sistema e também faz as movimentações financeiros necessárias.

porNatã Giertyas

Emissão de Boleto com ModerBank

IMPORTANTE: Antes de realizar esse processo é necessário ter uma conta ModerBank cadastrada e sincronizada com o sistema conforme as orientações desse manual

Emissão de Boleto

O processo de emissão de boletos pelo Moderbank ocorre da mesma forma que nos outros bancos que já possuímos homologação. A única diferença é que o boleto já será registrado no banco logo após a emissão. Para emitir um boleto, você irá ir em Financeiro -> Documentos a Receber. Nessa tela é preciso selecionar uma documento a receber e clicar em Boleto(F8) -> Gerar Boleto

Ao clicar em Gerar Boleto, você irá ir para a tela de seleção de configuração do Boleto. Nessa tela será preciso selecionar a configuração que pertence ao ModerBank

Após o sistema irá fazer a geração do boleto de acordo com as informações do documento a receber.

porNatã Giertyas

Configuração de boleto com ModerBank

Configuração de Boleto

IMPORTANTE: Antes de realizar esse processo é necessário ter uma conta ModerBank cadastrada e sincronizada com o sistema conforme as orientações desse manual

Para efetuar as configurações de boleto, clique no menu Financeiro -> Boletos -> Configuração.

Nessa tela, você irá ir em Incluir(F1) para cadastrarmos uma nova Configuração para emissão de boleto.

Na tela de cadastro da configuração de Boleto, você irá selecionar o banco ModerBank e a conta cadastrada anteriormente, você pode também definir as configurações de juros e multa, além de uma Instrução de até 50 caracteres. No campo de instrução, não precisa adicionar as expressões para fazer o cálculo de juros e multa no boleto já vem como padrão. Após informar os dados você precisa clicar em Confirmar(F1).

porNatã Giertyas

Como sincronizar a sua conta Moderbank com o Moderniza Loja

Sincronização da Conta ModerBank com o Moderniza Loja

1 – Cadastro do Banco

Para emitir boletos com o Moderbank, você precisa cadastrar o banco dentro do sistema, para isso você deve ir em Financeiro -> Bancos

Em bancos você precisa cadastrar um novo, selecionando a opção Incluir (F1)

Após irá abrir a tela para o cadastro do banco e você devera preencher com as seguintes informações

Banco: 655

Descrição: Moderank

IMPORTANTE: O campo banco precisa ser 655 pois esse é o código de identificação do Moderbank.

Após é necessário clicar em Confirmar(F1). Com o cadastro do banco feito o próximo passo é cadastrar a conta bancária e sincronizar com o Moderbank

2 – Cadastro da Conta bancária

Para cadastrar a conta bancária você precisar selecionar o Banco cadastrado e selecionar a opção Contas bancárias(F4)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Na tela de contas bancárias, você irá precisar incluir uma nova conta.

No cadastro da conta, você precisará selecionar a Filial no qual o seu CNPJ é o mesmo da conta do Moderbank. Com a Filial Selecionada, você irá clicar no botão Moderbank e irá fazer login no Internet Banking para sincronizar cadastrar a sua conta bancária dentro do Moderniza Loja.

 

Você irá informar o seu CPF e Senha para acesso ao Internet Banking e irá  realizar o login.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Após realizar o Login, o sistema irá preencher as informações da conta de acordo com as Informações do ModerBank.  E você só precisa informar uma descrição de clicar em confirmar para salvar o cadastro

 

Após salvar a sua conta ModerBank estará sincronizada e pronta para fazer operações ligadas ao banco.