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 URL de webhook da Martz, explicada na seção Configuração de webhooks deste artigo.
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.
Passo 01 — Informações de conexão
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 Nome da conta (o nome da sua conta na Magazord), Token da aplicação e Senha da aplicação (o token e a senha fornecidos pela Magazord) e clique em Iniciar integração
Passo 02 — Verificação das permissões
A Martz confere se as credenciais dão acesso a todas as funcionalidades necessárias. Se algum item falhar, peça à Magazord a liberação correspondente e clique em Verificar novamente. Com tudo certo, clique em Continuar.
Passo 03 — Configurações adicionais
Em Selecione as lojas que serão sincronizadas na Martz, escolha as lojas da sua conta Magazord que devem vir para a Martz. Se não selecionar nenhuma, a integração é feita com todas as lojas da conta. Clique em Finalizar 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.
Depois de integrar, use o botão verificar integração no card da Magazord para conferir, a qualquer momento, se todas as permissões de acesso estão funcionando.
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, na seção URLs de notificações, 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.