Este artigo explica, em um tutorial guiado, como ativar a integração entre sua conta Martz e sua loja na Vnda.

Token de autenticação

O primeiro passo é obter o token de autenticação da sua loja Vnda. Para isso, siga os passos na documentação da própria Vnda, no link abaixo.

http://ajuda.vnda.com.br/pt-BR/articles/1506726-chave-token-de-api

OBS: o acesso à área de configurações, pelo admin do Vnda, fica no ícone de ⚙️ no canto inferior esquerdo da tela.

Nesse processo, será necessário escolher o escopo de acesso para esse token que está sendo criado. O escopo necessário para a integração com a Martz está listado abaixo.

Carrinhos

Obtem endereço de entrega de um carrinho
Listar personalizações de itens do carrinho
Listar itens de carrinhos
Obter dados de carrinhos
Listar carrinhos
Obter parcelas de pagamento
Obter recebedores dos carrinhos
Obter métodos de entrega disponíveis

Clientes

Lista endereços de um cliente
Lista os bônus de um cliente
Lista os endereços cadastrados pelo cliente
Obter detalhes de um cliente
Listar clientes
Lista os créditos de um cliente

Pedidos

Obtem endereço de entrega de pedidos
Listar pedidos do Feed de pedidos
Obter descontos dos pedidos
Obter os eventos dos pedidos
Conferir personalizações de itens de pedidos
Conferir itens de um pedido
Obter as informações de pagamento dos pedidos
Obter avaliações dos pedidos
Obter detalhes de pedido
Conferir os pedidos da loja
Obter os canais de pedidos
Conferir os estados de origem dos pedidos
Obter rastreamento de envio
Buscar pedidos
Obter detalhes de notas fiscais
Listar notas fiscais de pedidos
Conferir os pacotes dos pedidos

Cupons de desconto

Todos

Regras de desconto

Todos

Bônus

Todos

Promoções

Todos

Produtos

Obtém inventários de um produto
Listar imagens de variantes
Listar imagens de variante
Listar preços de produtos
Conferir o atrubuto "Tamanho" dos produtos
Conferir atributos de produtos
Obter detalhes do produto
Buscar produtos
Listar produtos
Obter detalhes de variantes de produto
Listar variantes de produtos

Rastreios

Listar os rastreios

Integrar no painel da Martz

De posse do token gerado no passo anterior, siga os passos a seguir para finalizar a integração na Martz.

No painel principal, clique no seu perfil no canto superior direito e vá em configurações
A seguir, acesse o painel de integrações
Nesse painel, você irá procurar pelo ícone e nome da Vnda, e clicar no botão INTEGRAR.
Ao clicar no botão, será exibido um modal indicando os passos necessários de serem executados na Vnda para realizar a integração, que são os passos descritos na seção anterior deste artigo. Caso ainda não tenha feito, siga os passos descritos na seção anterior.
Insira seu Token de autenticação no campo desse 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 Vnda!

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 Vnda é através dos webhooks. Dessa forma, quando um evento ocorrer no seu e-commerce (uma nova venda, por exemplo), a própria Vnda 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, vá para sua loja Vnda e, seguindo os passos do link abaixo, configure os webhooks para os seguintes eventos:

client-saved
cart-abandoned
order-canceled
package-sent
package-delivered
package-packed
order-confirmed
order-received
order-sent

Documentação da Vnda sobre a criação de webhooks: https://developers.vnda.com.br/docs/webhooks