> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://suporte.fidelizarmais.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Integração +fidelidade x Magazord

## Nesse artigo mostraremos como fazer a integração da Magazord com +fidelidade

Uma chave de API é como uma senha que permite que diferentes sistemas se comuniquem entre si de forma segura. Para e-commerces, ela é usada para conectar sua loja online a outros serviços, como plataformas de pagamento, ferramentas de marketing e o **nosso programa de fidelidade**. Com essa chave, automatizamos processos, como o pontuação de clientes e cadastro de clientes, facilitando a administração do seu programa e a experiência do cliente. Para saber como gerar, siga os passos seguintes.

#### Passo 1 - Para conseguir sua chave de API, abra um chamado/ticket na Magazord com esse texto:

> "*Olá! Gostaria de realizar uma nova integração, preciso de uma API que me permita:*
>
> * *Consumir clientes*
> * *Consumir vendas*
> * *Consumir produtos*
> * *Criar cupons*
> * *Listar cupons*
>
> *Os dados necessários são:*
>
> * *URL Base*
> * *Usuário (Token)*
> * *Senha*
>
> *Esses itens precisam estar liberados:*
>
> *v2/site/loja*
> *v2/site/pedido/{obj.Id}*
> *v2/site/pedido*
> *v2/site/cupomDesconto (CRUD completo)*
> *v2/site/pessoa*
> *v2/site/cliente/{obj.Id}*
> *https://{Subdominio}.painel.magazord.com.br/api*
>
> *A empresa responsável é a Fidelizar+, o e-mail para recebimento das informações é:* *suporte@fidelizarmais.com.br**.*"

⚠️**Atenção:** Assim que o time da Magazord confirmar a criação das chaves, comunique o suporte da Fidelizar+.

#### Passo 2 - Com as chaves em mãos, no painel do +fidelidade, Clique em Mais > Configurações.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/9/0/3/890341bdc8bad000/09b6c1a3-06a5-4dbf-ab92-60b695_1wiiew7.png)

#### Passo 3 - Clique em Integração, no canto inferior esquerdo, em seguida selecione a plataforma de e-commerce Magazord.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/3/d/7/d3d72d25bba41800/17f56653-6f0d-4035-ae7c-7120fe_64hfca.png)

#### Passo 4 - Preencha os campos necessários.

* **API token (API KEY) :** Aqui você cola a chave de API que copiou no e-mail enviado pela Magazord ou fornecido por eles.
* **Senha:** Aqui você cola a senha que copiou no e-mail enviado pela Magazord ou fornecido por eles
* **Alias:** Complete a URL do painel com a URL fornecida pela equipe Magazord.
* **Informe o site de sua loja:** Coloque o link do site da sua loja, garanta que ele esteja certo, ele será usado nos disparos de e-mail.
* **Informe a URL (link) para cadastro de clientes de sua loja:** Forneça o URL de cadastro do site da sua loja. Isso é crucial se sua loja estiver no plano que inclui o widget enterprise, pois, se o cliente não conseguir realizar o cadastro no programa, ele será redirecionado para esse link.
* **Informe o XML de produtos Google Shopping de sua loja:** Importante para lojas que queiram produtos como prêmios de forma automatizada, ou seja, que os prêmios resgatados virem cupons. Coloque o XML da sua loja com o Google Shopping (obrigatoriamente do Google Shopping, pois é somente esse que o sistema reconhece).
* **Os cupons expiram em quanto tempo?:** Após os clientes resgatarem um prêmio que gere cupom, um novo código é gerado na sua plataforma de e-commerce (***exceto Jet e Bis2Bis***). Quanto tempo esse código deve ser válido para a utilização (em dias)? O padrão é 365 dias.
* **Informe os SKU's/IDs dos produtos que deseja com o prêmio:** Este campo é para ser utilizado caso não queria que todo o seu catálogo de produtos fique disponível como prêmio.
* **Qual é o último status do pedido após ser entregue ao cliente?** Aqui você informa qual são os status que o programa deverá pontuar os clientes. Você deve selecionar mais de um. Esses status são capturados direto da Loja Integrada.
* ***Loja para importação de dados:*** Indique a loja cadastrada na sua conta Magazord da qual as importações devem ser realizadas.

#### Passo 5 - Ative a integração.

Apenas **ative o cadastro de vendas se você não possui nenhum ERP integrado** no programa.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/5/f/9/55f9401467e71400/907c626a-580c-4eb7-8299-a21eb0_xkikf.png)

**💡 Importante:** Se selecionar o botão de Ativar Integração, o sistema irá começar a disparar e-mails aos seus clientes. Por isso só ative depois que concluir todas as configurações do seu programa de fidelidade.

Pronto! Agora suas vendas e seus clientes serão cadastrados no programa em até 72h após o cadastro no e-commerce.