Integração com WooCommerce

Este artigo é para você, que tem um eCommerce e quer que seu cliente possa utilizar o cupom emitido no Beni Club diretamente no Carrinho de Compras dele.

O processo todo é bem simples e vamos, passo a passo, guiar você para mostrar como fazer essa maravilha funcionar sem problemas!

A primeira coisa que você vai precisar é do nosso plugin. Você pode baixar a versão mais atual dele clicando aqui.

Depois disso você vai Cadastrar uma Promoção. Uma vez que ela esteja cadastrada você vai copiar o Código dela e ir até o Admin do seu site WordPress.

Lá você vai ir até o menu Plugin > Adicionar Novo

Acesse a opção em azul à direita em seu painel WordPress

Chegando lá você vai encontrar, no canto superior direito perto do título, um botão escrito Enviar Plugin e clicar nele. Ao fazer isso a tela vai ficar parecida com a do print abaixo:

Agora você vai clicar no Enviar Arquivo e selecionar o arquivo do plugin que você baixou aqui nesta página.

Selecione o arquivo e clique no *Instalar agora*

Você vai, então, no menu Plugins > Plugins Instalados e encontrar na lista o nosso amiguinho, que ainda estará desativado.

Você vai clicar em Ativar e pronto, o plugin estará pronto para trabalhar!

Nota: nenhuma configuração ou alteração do arquivo é necessária para o funcionamento do plugin. Em caso de dúvidas entre em contato com nossa equipe de desenvolvimento através do e-mail desenvolvimento@beni.ws .

Configurando o Cupom no WooCommerce

Nosso intuito não é ensinar você à utilizar o WooCommerce, mas temos que explicar como a coisa funciona.

No seu WordPress acesse o menu WooCommerce > Cupons . Lá encontre a opção de Adicionar Cupom e clique nela.

Na tela que segue muitas informações e variáveis podem ser configuradas, mas para nós a mais importante é o Código do cupom, pois é aqui que você vai colar o Código da sua promoção do Beni Club!

Agora alguns pontos importantes para serem salientados aqui:

Nenhuma dessas informações é compartilhada com o aplicativo, portanto é importante que você configure o cupom para que ele funcione de acordo com o que estiver descrito nas regras de uso da Promoção.
O aplicativo não compartilha detalhes do cupom com o WooCommerce, por isso não é possível criar limitações de horário de emissão de cupom.
Cadastrar no WooCommerce a Data de expiração do cupom não impede que ele seja emitido no aplicativo depois desta.
As informações e regras descritas na promoção do aplicativo e no cupom do WooCommerce são de responsabilidade do Estabelecimento.

Uma vez salvo o cupom é importante que você não divulgue o código dele. Se este cupom for utilizado todos os cupons gerados posteriormente poderão não funcionar! Além disso o Código deste cupom é a chave de acesso para que a API receba as informações de emissão, e o vazamento desta informação pode ser comparado ao vazamento de uma senha.

Configurando no Painel

Ufa, chegamos no último passo, a configuração final no Painel do Beni Club.

Você vai acessar o menu de Estabelecimento e, dentro do cadastro do seu Estabelecimento, localizar os campos relativos à integração, que estão próximos às informações de contato.

Você vai selecionar o Tipo de Integração de Cupom como Envio para Webservice e, no campo da URL de integração, colar uma URL que vai ser formada assim:

https://ENDERECO_DO_SEU_SITE.COM/wp-admin/admin-ajax.php?action=beniclubcouponintegration

Você vai substituir ENDERECO_DO_SEU_SITE.COM pela URL do seu site, sem alterar nenhuma outra parte da URL. Depois disso você vai salvar seu cadastro e tudo estará pronto!

Considerações técnicas

Para funcionar este plugin copia o cupom originalmente criado no WooCommerce e duplica o mesmo, alterando o Código do cupom. Por conta disso alterações no cupom original podem impactar de forma imprevisível na criação dos novos cupons.

Outro ponto importante é que ele utiliza a integração de AJAX do WordPress através do canal não autenticado ( mais informações em wp_ajax_nopriv_{$action} | Hook | WordPress Developer Resources ), o que não necessariamente a torna insegura mas que denota certo cuidado. Desta forma é imprescindível que seu site tenha ativado o SSL para utilização de protocolo HTTPS. O Beni Club não exige este protocolo para o funcionamento da integração, mas o não uso do mesmo é de responsabilidade do cliente.