Este artigo explica, em um tutorial guiado, como ativar a integração entre sua conta Martz e sua loja na Magazord.
Solicitação de credenciais
Para integrar sua loja com a Martz, precisaremos de um token e uma senha de acesso.
Para consegui-los, você precisará abrir um chamado de suporte na plataforma da Magazord e solicitar o token e a senha de acesso para a API. Atualmente este processo é feito apenas através do time de suporte deles.
Em sua solicitação, informe que esse credenciamento precisa fornecer acesso às seguintes funcionalidades:
Consulta de preços - v1/listPreco
Tabela de preços - v2/site/tabelaPreco
Detalhes de pessoa - v2/site/pessoa/pessoaId
Listagem de pessoas - v2/site/pessoa
Categoria - v2/site/categoria
Carrinho - v2/site/carrinho
Detalhes de Carrinho por id - v2/site/carrinho/id
Criar Cupom de desconto - POST v2/site/cupomDesconto
Criar Cupom de Crédito - POST v2/site/cupomDesconto
Listagem de Produtos - v2/site/produtos
Detalhes de produto pelo código - v2/site/produto/codigo
Listagem de pedidos - v2/site/pedido
Detalhes de pedidos pelo código - v2/site/pedido/codigo
Além dessas credenciais, você irá precisar solicitar a eles o cadastro da sua url do webhook. Essa URL é a que foi obtida no primeiro passo deste tutorial.
Integrando com a Martz
Com as credenciais em mão e os devidos acessos concedidos, siga para o painel da Martz, e finalize sua integração. Para isso:
Acesse a área de Integrações, dentro do menu de Configurações, em seu painel da Martz
Na tela de integrações, dentro da seção de "E-commerces", encontre a Magazord e clique em "Integrar"
Preencha os campos solicitados no modal e clique em "Criar integração"
Pronto! Agora é só aguardar que nós começaremos a sincronizar as informações da sua loja com o seu painel da Martz. Essa sincronização pode demorar até 1 hora para ser iniciada. O tempo de término vai depender do tamanho da base da sua loja, ficando em média na faixa de algumas horas.
Configuração de webhooks
Etapa muito importante para melhor eficiência na comunicação com sua loja Magazord!
Esta etapa deverá ser realizada após a integração da loja com a Martz, conforme etapas anteriores deste tutorial.
Uma das formas mais eficientes de comunicarmos com a sua loja é através dos webhooks. Dessa forma, quando um evento ocorrer no seu e-commerce (uma nova venda, por exemplo), a própria Magazord nos informará e nós atualizaremos suas informações aqui na Martz.
Para utilizarmos desta estratégia, copie a URL disponibilizada em Configurações -> Chaves de acesso, no seu acesso da Martz.
Com a URL em mãos, será necessário abrir um novo chamado para o suporte da Magazord ([email protected]) solicitando o cadastro da sua url do webhook.