Este guia mostra como conectar sua conta Framework360 ao Smartygest e ativar os fluxos de sincronização de dados.
1. Conexão Inicial via API Key
Para iniciar a sincronização, é necessário autenticar o Framework360 usando a chave API fornecida pelo Smartygest.
Procedimento
1. Acesse seu sistema Smartygest e recupere sua Api Key.
2. No painel de controle do Framework360, navegue até a seção de configuração do plugin Smartygest (geralmente em Integrações ou Plugins).
3. No campo rotulado Api Key, cole a chave que você recuperou do Smartygest.
4. Clique no botão para confirmar a autenticação. O sistema realizará uma verificação automática (check()) para garantir que a chave seja válida.
Se a conexão for bem-sucedida, o Framework360 salvará as credenciais e você poderá prosseguir com a configuração dos fluxos de sincronização.
2. Configuração das Definições de Sincronização (Webhook)
Depois de estabelecer a conexão, você deve especificar quais dados devem ser sincronizados e em qual direção.
Por que fazer isso
Ativar os Webhooks garante que os dados sejam trocados automaticamente entre os dois sistemas (Framework360 e Smartygest).
Procedimento
1. Dentro das configurações do plugin Smartygest no Framework360, navegue até a seção Sincronização ou Webhook.
2. Você encontrará várias categorias de dados que podem ser sincronizadas. Para cada uma, você pode ativar o fluxo de entrada (IN) ou saída (OUT).
A. Sincronização de Pedidos
Esta seção gerencia a transferência dos pedidos.
| Tipo de Sincronização | Descrição | Ação |
|---|---|---|
| Framework360 => Smartygest | Cria uma cópia dos pedidos recebidos no Framework360 também no Smartygest. | Ative a opção para sincronização de saída (OUT). |
> Nota: A sincronização dos pedidos é unidirecional (OUT) e é ativada apenas para pedidos pagos ou com método de pagamento "contrassegno".
B. Sincronização de Produtos
Esta seção gerencia a atualização dos produtos.
| Tipo de Sincronização | Descrição | Ação |
|---|---|---|
| Smartygest => Framework360 | Sincroniza os produtos do Smartygest para o Framework360. | Ative a opção para sincronização de entrada (IN). |
> Nota: A sincronização dos produtos é bidirecional, mas o fluxo de atualização automática (Webhook) atualmente suporta apenas a importação do Smartygest para o Framework360 (IN). O sistema Framework360 também executa um fetch periódico para recuperar os produtos atualizados a cada 5 minutos.
3. Depois de selecionar as opções desejadas (ativando as sincronizações IN/OUT necessárias), clique no botão Salvar (ou equivalente) para aplicar as alterações.
Uma vez salvas as configurações, a sincronização automática estará ativa. O sistema usará uma fila interna (queue) para gerenciar as trocas de dados eficientemente.
