# Integrações

Criado para documentar o modúlo integrações pelo gestor

# Configuração do Módulo Franquia

Documentação criada para registro interno com o intuito informativo.

##### 1. Acessando Integração no Gestor:

- Entre no **Sistema** e em seguinda clique no **Gestor.**

[![image 3.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/0icimage-3.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/0icimage-3.png)

- Clique em **integrações**, em seguida **Configuração do Modulo Franquia**.

[![image 3.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/SIXimage-3.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/SIXimage-3.png)

---

##### 2. Configuração:

- Para criar a configuração do Módulo Franquias iremos precisar preencher algumas informações como: 
    - **Endereço do Servidor:** Endereço da base Mãe.
    - **Chave Api Servidor:** Usuário integrador da base Mãe.
    - **Produto Grade (ID)**: Código ID SKU do último produto cadastrado na base Filho.
    - **Endereço do Cliente:** Endereço da base que vai integrar (base Filho).
    - **Chave Api Cliente:** Usuário administrativo da base filho.
    - **Limite de Registros:** Quantidade de registros que vão descer para a base quando a rotina rodar.

[![image 3.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/Lxaimage-3.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/Lxaimage-3.png)

- Abaixo um exemplo de preenchimento realizado na franquia de Balneário 
    - O Produto Grade(ID) foi preenchido com o código SKU do último produto cadastrado no módulo produto.
    - A chave Api Servidor foi retirada do usuário com grupo de usuário(Integrador) na base franquia.osklen.pdv.moda.(Mãe)
    - A chave Api Cliente foi retirada do usuário com grupo de usuário(Administrador) na balneario.franquia.osklen.pdv.moda.(Filha)

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/qqmimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/qqmimage.png)

- Com tudo preenchido, podemos salvar as configurações.

---

##### 3. Criando Agendador de Tarefa

- Vá em Biblioteca

[![image 3.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/dPkimage-3.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/dPkimage-3.png)

- Pesquise pelo nome da biblioteca, você irá precisar do Token e Classe.

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/iImimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/iImimage.png)

##### Seguimos pro Agendador de Tarefa:

- Clique em **Sistema**, em seguida em **Agendador de Tarefa**.

[![image 3.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/Nqyimage-3.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/Nqyimage-3.png)

- Clique em **incluir** e preencha os campos: 
    - **Rota:** Use a biblioteca e classe para preencher a rota conforme exemplo abaixo.
    - **Parâmetro de execução:** Diga se vai ser uma vez a cada 1 hora, semanas, etc.
    - **Próxima execução:** Será o dia que vai iniciar a rotina.
    - **Limite de execução:** Normalmente deixamos em branco.
    - **Última execução:** O sistema preenche sozinho pois vai aparecer quando executar a tarefa.

[ ![image 3.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/PiRimage-3.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/PiRimage-3.png)

<div id="bkmrk-rotina-para-atribuir">- Rotina para atribuir ao **Agendador**.

</div>[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/8bWimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/8bWimage.png)

---

##### 4. Finalizando o Processo de Configuração:

- Após a configuração do Agendador de Tarefas, retorne ao Gestor e force o sincronismo. Isso fará com que o sistema integre 50 registros. Em seguida, o agendador de tarefas assumirá a rotina, integrando novos registros a cada hora, se houver.

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2025-07/scaled-1680-/MyLimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-07/MyLimage.png)