A7Pharma:Como utilizar Clique e Retire no Ecommerce Convertize?

De MediaWiki
Ir para navegação Ir para pesquisar

Problema / Pergunta

Como utilizar o Clique e Retire no E-commerce Convertize?

Ambiente

A7Pharma

Solução / Resposta

Necessário que a integração Convertize, esteja habilitada na loja.

O Clique e Retire é uma forma de entrega que está sendo disponibilizada para compras com o Ecommerce Convertize visando diminuir o tempo de espera por um item e ainda gerar uma economia com o valor de entrega.

Configurações no Backoffice da Convertize

Antes de realizar as configurações necessárias dentro do A7Pharma é preciso acessar o Backoffice da Convertize e realizar a configuração da API de Frete. Para isso basta acessar o menu Logística > API de Frete, clicar no botão "+" e preencher as informações necessárias seguindo o exemplo:

Titulo: Clique Retire Alpha7

Prazo adicional no frete: 0 (já definido por padrão, não alterar)

Ambiente: Produção

URL: Seguir as orientações abaixo para monta-la

AppKey: Seguir os passos abaixo para gera-la

AppToken: Seguir os passos abaixo para gera-lo

Orientações:

  • URL:

Exemplo link completo a ser definido com as informações passadas pela loja:

http://omitidoNoKb.com.br:8181/webapi/api/convertize

Composição do link:

-IP ou DNS:

A url deve apontar para o servidor da unidade configurada como matriz, sendo assim, devera alinhar com o cliente se o IP Externo é estático ou fixo, caso seja fixo, ira apenas utiliza-lo para montar a URL. Em casos onde o mesmo é dinâmico, cliente devera verificar a possibilidade de fixa-lo ou adquirir e configurar um DNS para a rede.

-PORTA:

O mesmo deverá abrir uma porta no IP Externo ou DNS e realizar o redirecionamento para o IP Interno do servidor matriz. Ex: 8080, 8181, 8443.

-RESTANTE DO LINK:

/webapi/api/convertize

  • ApiKey:

Devera estar gerando um hash em sha256 baseado na data/hora e criptografa-lo no mesmo método.

  1. Execute o comando abaixo, lembrando de alterar o valor dentro das aspas simples para a data e hora atual.
    1. echo -en ‘2024-10-22 12:34:55’ | sha256sum OBS: O valor obtido pelo comando acima devera ser reservado, pois sera utilizado para configurar o backoffice da convertize.
  2. Obter o hash gerado acima e executar o comando novamente, setando ele como valor nas aspas.
    1. echo -en ‘hashGeradoAcima’ | sha256sum OBS: Obter o valor gerado e utiliza-lo para definir na configuração avançada abaixo, apenas no servidor definido como matriz. IntegracaoExterna.eCommerce.Convertize.IntegracaoPedido.CliqueRetire.HashAppKey
  • AppToken:
  1. Execute o comando abaixo, lembrando de alterar o valor dentro das aspas simples para a data e hora atual.
    1. echo -en ‘2024-10-22 12:34:55’ | sha256sum OBS: O valor obtido pelo comando acima devera ser reservado, pois sera utilizado para configurar o backoffice da convertize.
  2. Obter o hash gerado acima e executar o comando novamente, setando ele como valor nas aspas.
    1. echo -en ‘hashGeradoAcima’ | sha256sum OBS: Obter o valor gerado e utiliza-lo para definir na configuração avançada abaixo, apenas no servidor definido como matriz. IntegracaoExterna.eCommerce.Convertize.IntegracaoPedido.CliqueRetire.HashAppToken

Configurações no A7Pharma

Para utilizar o Clique e Retire é necessário acessar a interface Configurações Avançadas da Unidade de Negócio e realizar a configuração das seguintes chaves:

  • Convertize.IntegracaoPedido.CliqueRetire.HashAppKey: Mesmo hash obtido no passo anterior (AppKey).
  • Convertize.IntegracaoPedido.CliqueRetire.HashAppToken: Mesmo hash obtido no passo anterior (AppToken).
  • Convertize.IntegracaoPedido.CliqueRetire.PickupStoreID: Sendo um ID para cada unidade. Cliente devera estar acessando o backoffice da convertize, no menu **Logística > Pontos de Retirada** e realizar o cadastro de cada uma das unidades que irão receber pedidos de retirada. **OBS:** Cliente devera estar identificando e deixando a qual loja o cadastro se refere. Possuindo o campo Código de referência no ERP onde devera estar definindo o código da unidade de negócio.
  • Convertize.IntegracaoPedido.CliqueRetire.ConsiderarEstoqueUnidadesNegocioEspecificas: Define se deve ser considerado o estoque de uma ou mais Unidades de Negócio no Clique e Retire. A configuração é composta pelos ID's das unidades de negócio em que o estoque será considerado separados por vírgula. Exemplo: "1,2,3".
  • Convertize.IntegracaoPedido.CliqueRetire.ConsiderarEstoqueTodasUnidadesNegocio: Define se deve ser considerado o Estoque de TODAS as Unidades de Negócio Ativas e que Movimentam Estoque no Clique e Retire ao invés enviar apenas o Estoque da Unidade de Negócio atual.
  • Convertize.IntegracaoPedido.CliqueRetire.PrazoPreparacao: Define o tempo estimado em horas para retirada do pedido da modalidade Clique Retire. Será exibido ao cliente na Convertize da seguinte forma: "Clique e Retire - Grátis - Até (x) Horas". Preencha com o valor numérico correspondente das horas; caso não seja preenchido, o valor padrão será de 2 horas.
  • Convertize.IntegracaoPedido.Central: Define a Unidade de Negócio atual como centralizadora. Quando habilitada, os pedidos que possuem entrega (realizada tanto por terceiros ou pela loja), serão integrados por esta Unidade de Negócio. OBS: Dentre todas as Unidades de Negócios de uma rede, somente uma pode estar com esta chave habilitada.

IMPORTANTE: ⁣

É obrigatório utilizar uma das chaves avançadas (Convertize.IntegracaoPedido.CliqueRetire.ConsiderarEstoqueUnidadesNegocioEspecificas ou Convertize.IntegracaoPedido.CliqueRetire.ConsiderarEstoqueTodasUnidadesNegocio) na unidade "Central", responsável pelo envio do estoque das lojas participantes do Clique e Retire.

Causa

Necessidade de implementar o tipo de entrega Clique e Retire.

Palavras-Chave

E-commerce, Convertize, Clique Retire, PickupStore. HashAppKey, HashAppToken

Este conteúdo foi útil para você?
Então curta esse artigo!

2


Disponível em “https://kbnovo.a7.net.br/index.php?title=A7Pharma:Como_utilizar_Clique_e_Retire_no_Ecommerce_Convertize%3F&oldid=51568”