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.

porNatã Giertyas

Merchant ID Cielo : Aprenda a localizar as credenciais merchant ID e merchant key na API Cielo 3.0

Credenciais Merchant ID e Merchant Key

As credenciais são códigos ou chaves com as quais você vai conseguir configurar a ferramenta Cielo 3.0. É através dessas duas credenciais que se realiza a integração entre a API Cielo 3.0 e o seu e-commerce.

Merchant ID Cielo

O Merchant ID Cielo é um código identificador único. Sua função é identificar a loja virtual nas operações relacionadas à Cielo.

Merchant Key Cielo

O Merchant Key é um código que funciona como uma chave de segurança da API Cielo.

Como acessar as credenciais Merchant ID e Merchant Key na Cielo 3.0?

Ao abrir uma conta na Cielo e realizar a confirmação do cadastro no e-commerce API Cielo 3.0, você receberá um e-mail de boas vindas com um link para entrar no estabelecimento e acessar as credenciais Merchant ID Cielo e Merchant Key.

Por isso, a fim de que você conheça exatamente o caminho para chegar às credenciais de produção da sua loja virtual, preparamos este pequeno guia, que vai ajudá-lo neste problema. Siga as instruções abaixo para obter a sua Merchant ID e a Merchant Key:

 

    • Primeiramente, clique no link, presente no e-mail de boas vindas, para acessar a página da Cielo e entrar na sua conta.
    • Na página da Cielo, clique no botão Acessar minha conta e insira os seus dados de login para entrar no seu perfil.

    • Já no seu perfil da Cielo, acesse o menu superior e clique na opção E-commerce e Dentro da página de e-commerce, vá até a seção API e-commerce Cielo e clique no botão Acessar.

  • Em seguida, você será redirecionado à página do Admin Cielo. Dentro dela, no menu superior, vá no item Cielo.
  • O item Cielo do menu superior possui vários subitens, clique no último deles; o subitem Credenciais.

Logo em seguida será aberta uma página contendo o Merchant ID Cielo, que você conseguirá ver normalmente; e o Merchant Key, que estará oculto. Para conseguir visualizá-lo, clique no botão Visualizar Merchantkey.

  • Clicando em Visualizar Merchantkey, uma pequena janela será aberta com 3 passos que devem ser seguidos e você terá acesso a Marchant Key.
porNatã Giertyas

Produto

Neste Post será abordado como utilizar a planilha “Arquivo_atualizacao_estoque” disponível também para download no nosso arquivo com todas as planilhas de migração, caso não tenha baixado, pode realizar o download clicando aqui.

 

Está planilha é a única que não é importada pelo migrador, mas sim por dentro do próprio sistema administrativo, o local de utilização da mesma é encontrado no menu Logística -> estoque -> documentos de estoque, para saber mais sobre esta tela, pode acessar o manual da mesma clicando aqui.

A utilização dela é bem simples, mas requer alguns cuidados:

A primeira coluna “Codigo_barras” , pode ser preenchida tanto com o código de barras propriamente tido, como preenchida com o id do produto, pois o sistema entende o id como um código de barras, quanto a coluna “Quantidade” se refere a quantidade de estoque propriamente dita do produto, como no exemplo acima, o produto de id 1(um) receberia 12 de estoque.

 

MUITO IMPORTANTE!!!

  • O que essa planilha faz é soma de estoque, ou seja, se dentro do sistema um produto X ja tem 5 de estoque e eu preencher com 10 na quantidade, vai ser somado e o produto vai ficar com 15, caso queira utiliza-la como “correção de estoque”, primeiramente deve zerar o estoque no sistema, e depois sim importar a planilha.

OBS: Esta importação de estoque pode demorar BASTANTE TEMPO, recomendamos importa-la em um período que não vá atrapalhar o cliente.

porNatã Giertyas

AnyMarket Produtos

Produtos (F4)

Botão de Produtos

Na tela de produtos é possível Incluir, Alterar, Excluir e Atualizar produtos da Loja.

O produto tem diferentes situações:

  • Atualizado: Produto está atualizado conforme os dados do sistema.
  • Inclusão Pendente: Produto ainda não foi incluso na Loja.
  • Atualização Pendente: Alguma alteração no cadastro do produto não foi atualizada na loja.

Tela de Produtos

Incluindo Produto “Incluir (F1)”

Pressionando o botão de inclusão você vai ter acesso a todos os produtos cadastrados do sistema.

Dessa forma basta selecionar os desejados e clicar em “Selecionar”.

Selecionando os Produtos

Alterar o Cadastro do Produto “Alterar (F2)”

Para alterar o cadastro do produto, pela tela de gerenciamento dos itens da loja, ou através do cadastro de produtos em Logística > Produtos. O procedimento é o mesmo em ambos caminhos, basta selecionar o Produto e clicar em alterar.

Tela de produtos

 Por essa tela também é possível alterar todo o cadastro do produto.

Alterando cadastro do produto

Depois de fechar a tela do cadastro do produto sistema volta para a tela de produtos da Loja e agora os status dos produtos vão estar como pendente.

Itens pendentes de atualização

Atualizar (F4)

Após realizar todas as modificações, é necessário atualizar elas no site da loja. Clicando no botão de atualizar, o sistema manda as informações editadas para a Loja virtual.

Atualizar Lojas

OBS.: esse procedimento pode demorar um pouco, dependendo da quantidade de alterações feitas.

Sincronização da loja virtual

No fim da sincronização, as situações dos produtos vão ser atualizadas.

Nova situação dos produtos

Excluir(F3)

Não é possível excluir produtos com a situação Atualizada ou Atualização Pendente da integração com a Anymarket.

Categorias(F5)

Categorias

Na tela de Categorias é possível Incluir, Alterar, Excluir e Alterara mesma. As categorias da loja são as hierarquias do sistema.

As categorias têm diferentes situações:

  • Atualizado: Categoria está atualizada conforme os dados do sistema
  • Inclusão Pendente: Categoria ainda não foi inclusa na Loja.
  • Atualização Pendente: Alguma alteração no cadastro da Categoria não foi atualizada na loja.

Incluir (F1)

Para incluir uma categoria, é necessário clicar no botão de inclusão, ou pressionar a tecla de atalho. Após o sistema irá abrir a tela de hierarquias cadastradas do sistema, selecione as desejadas e clique em incluir.

Seleção de Hierarquias

Alterar(F2)

Selecionado uma hierarquia e clicando em alterar e aberto o cadastro da hierarquia, onde é possível estar alterando o mesmo e clicando em confirmar para salvar as modificações feitas.

Edição de Hierarquia

Excluir(F3)

A exclusão de uma hierarquia e feita através da seleção da mesma e pressionar botão de excluir.

Exclusão de Categoria

Atualizar(F4)

A função atualizar, sincroniza as informações das hierarquias com a loja virtual.

porNatã Giertyas

Integração AnyMarket

A AnyMarket é um HUB de integração entre Marketplaces, com essa plataforma é possível vender em alguns dos mais famosos marketplaces como Mercado Livre, Magazine Luiza, Amazon entre outros. Com a integração do Moderniza Loja com a essa plataforma, é possível enviar informações produtos, hierarquias, marcas de produtos, estoque para a AnymMarket e com esses dados lá é possível anunciar nos marketplaces  selecionados.

Como Funciona?

O Parceiro deve entrar em contato com o Comercial para instrução de como contratar o serviço, pois no processo da AnyMarket é realizado uma análise de adesão do cliente no qual é um processo feito em conjunto com a AnyMarket.

Após passar por essa etapa o cliente irá receber um acesso ao painel da AnyMarket. Com acesso a esse painel vamos configurar a integração no sistema.

Como Integrar no Moderniza?

O primeiro passo é acesso o painel da AnyMarket no link http://app.anymarket.com.br/ com  suas credenciais. Feito o login no painel.

  • Passo 1: Criar uma Loja Virtual do tipo Anymarket:
  • Acesse o menu Comercial do seu Moderniza, opção Loja Virtual.
  • Inclua uma nova Loja Virtual, selecionando o “Tipo Integração” como “AnyMarket”.
    • Mesmo que já exista uma Loja Virtual do tipo WooCommerce deve ser adicionada uma nova loja, não editar a já existente do tipo WooCommerce.
  • Informe os dados de Descrição para identificar o nome dessa loja no sistema Moderniza.
  • No campo URL informe: http://api.anymarket.com.br/v2
  • Gumga Token do seu ambiente na AnyMarket. Para obter esse Token você irá acessar o painel no menu de Minha Conta ou solicitar ao seller.
  • Os demais campos ficam em branco.
  • Passo 2: Configurar a URL para envio de imagens:
  • Acesse o menu Configurações, opção Empresas.
  • Selecione a Empresa e utilize o botão Filiais.
  • Selecione a Filial qual foi cadastrada a configuração para Loja Virtual do tipo AnyMarket.
  • Utilize o botão inferior “Configurações”, acesse a aba “Integrações”.
  • Informe o seguinte endereço para “Url Imagens AWS”: https://1zt23k38d1.execute-api.sa-east-1.amazonaws.com/dev/image-upload

Com essas configurações feitas é necessário enviar os produtos, hierarquias, marcas para a AnyMarket seguindo os manuais a seguir.