# TOTVS

## Visão Geral

Na tela de **Configuração da Integração**, são definidos os parâmetros responsáveis pelo mapeamento de informações (de/para) entre o **SURICATO** e o **TOTVS**, garantindo que os dados sejam corretamente validados e sincronizados entre os sistemas.

Nesta mesma tela, é possível habilitar ou desabilitar a integração conforme a necessidade da operação.

{% hint style="warning" %}
**Importante:** a integração com o **TOTVS** somente entrará em funcionamento se o serviço correspondente estiver devidamente instalado e em execução. Antes de utilizar a funcionalidade, verifique se o serviço está ativo.
{% endhint %}

## Como acessar a aba TOTVS

Acesse o menu **Configuração > Sistema.** Na tela de configurações do Sistema, clique no nome **TOTVS** para estender a tela com os campos a serem preenchidos.

<figure><img src="/files/biZHQWKoBMyuaqhjZR8j" alt=""><figcaption><p><em>Tela de configurações do Sistema</em></p></figcaption></figure>

**Atenção:** Integração TOTVS só vai entrar em funcionamento se o serviço da Integração TOTVS estiver corretamente iniciado. Verifique essa questão antes.

### Integração TOTVS

Depois de parametrizar tudo, clique em **Atualizar Registro** para salvar.

1. **Integração TOTVS:** Primeiro, habilite esse campo se o SURICATO realmente for se comunicar com o TOTVS. Ao ativar, outros campos da configuração serão liberados.
2. **Sistema:** Selecione exatamente qual sistema TOTVS será integrado. Esse ponto é importante porque a estrutura de dados pode variar conforme o sistema escolhido.
3. **URL:** Informe a URL correta do serviço do TOTVS. Aqui não é qualquer link: deve ser a URL do serviço de integração (endpoint), normalmente fornecida pelo time responsável pelo TOTVS.

#### Tolerâncias de Acesso

Esses campos definem quanto o sistema permitirá de variação antes ou depois do horário previsto.

1. **Tempo de Tolerância antes do acesso da faixa de entrada (Minutos)**\
   Define quantos minutos antes do horário de entrada o acesso será aceito.
2. **Tempo de Tolerância depois do acesso da faixa de entrada (Minutos)**\
   Define quantos minutos após o horário de entrada ainda será permitido acessar.
3. **Tempo de Tolerância antes do acesso da faixa de saída (Minutos)**\
   Define quanto tempo antes do horário de saída o acesso será permitido.
4. **Tempo de Tolerância depois do acesso da faixa de saída (Minutos)**\
   Define quanto tempo após o horário de saída o acesso ainda será válido.

{% hint style="warning" %}
**Atenção:** essas tolerâncias impactam diretamente na liberação ou bloqueio de acesso conforme a escala recebida do TOTVS.
{% endhint %}

#### Padrões enviados pela Integração

Esses campos são usados quando a informação não vier preenchida pelo TOTVS ou quando você quiser forçar um padrão.

1. **Organograma Padrão:** Será utilizado caso o colaborador não venha vinculado a um organograma válido.
2. **Local Padrão:** Define o local assumido como padrão na integração.
3. **Empresa Padrão:** Empresa que será considerada quando o dado não vier corretamente do TOTVS.
4. **Grupo de Acesso Padrão:** Grupo aplicado automaticamente quando não houver definição específica.
5. **Tipo de Situação Trabalhista Padrão:** Valor que será enviado/assumido como situação trabalhista padrão na integração.

#### Campos adicionais de Tolerância

1. **Tempo de Tolerância antes do acesso da faixa de entrada (Minutos)**\
   Mesmo conceito já explicado acima, respeite a lógica configurada pela sua operação.
2. **Tempo de Tolerância antes do acesso da faixa de saída (Minutos)**\
   Define a antecipação permitida para saída.
3. **Tipo de Tolerância**\
   Aqui você define como o sistema vai interpretar as tolerâncias (por exemplo, se considera apenas antes, depois ou ambos).
4. **Utiliza Tolerância**\
   Se desmarcar, todas as tolerâncias configuradas acima deixam de ter efeito.

#### Configurações de Turno e Refeição

1. **Turno Reduzido:** Ative apenas se sua operação trabalhar com turnos reduzidos e isso impactar a regra de acesso.
2. **Tipo de Controle de Refeição:** Define como o controle de refeição será tratado.\
   Se for utilizar **matriz de acesso** para alterar faixa de refeição, essa opção precisa estar configurada corretamente.
3. **Controlar Chave Externa Refeitório:** Ative se quiser que a integração valide e controle as chaves externas relacionadas ao refeitório.
4. **Faixa de Acesso Mandatório:** Define qual faixa será obrigatória para acesso principal.
5. **Faixa de Acesso Refeitório Mandatório:** Define qual faixa será obrigatória especificamente para refeição.

#### Escala e Identificadores

1. **Tag do Início da Escala:** Informe qual tag será considerada como referência para início da escala na integração.
2. **Chave Externa:** É o identificador que vincula os registros entre TOTVS e SURICATO. Esse campo precisa estar coerente com o que está configurado no TOTVS.

#### Tolerância de Refeição

1. **Tolerância Refeição (Saída):** Define se haverá tolerância aplicada na saída para refeição.
2. **Tolerância Refeição (Valor):** Se houver tolerância, informe aqui o tempo permitido.

#### Demais Configurações

1. **Controle de Refeições Mandatórios no Sistemas**\
   Define se o controle de refeição será obrigatório conforme regra do sistema.
2. **Configuração Padrão de Acesso, Refeição e Biometria**\
   Indica qual será o comportamento padrão adotado na integração para esses três pontos.

Depois de finalizar todas as configurações, clique em **Salvar** para gravar as alterações.

<figure><img src="/files/kPOoTWedvax7F2w5tbi9" alt=""><figcaption><p><em>Sub-Tópico Integração TOTVS</em></p></figcaption></figure>

## FAQ - Perguntas Frequentes

<details>

<summary>Se a Integração TOTVS estiver habilitada, mas o serviço não estiver em execução, os dados serão sincronizados quando ele for iniciado?</summary>

Não automaticamente. Enquanto o serviço estiver parado, não haverá comunicação. Após iniciar o serviço, a integração só ocorrerá conforme as regras e ciclos configurados, não havendo garantia de reprocessamento retroativo.

</details>

<details>

<summary>Ao alterar o Sistema TOTVS após a integração já estar ativa, os mapeamentos anteriores continuam válidos?</summary>

Não necessariamente. Como a estrutura de dados pode variar entre sistemas TOTVS, a troca pode invalidar parâmetros já configurados, exigindo revisão completa do de/para.

</details>

<details>

<summary>Se “Utiliza Tolerância” estiver desmarcado, mas os tempos de tolerância estiverem preenchidos, qual regra prevalece?</summary>

Prevalece a desativação. Com a opção desmarcada, todos os tempos configurados deixam de ter efeito na liberação de acesso.

</details>

<details>

<summary>Quando o TOTVS não envia Organograma ou Empresa, o sistema bloqueia a integração do colaborador?</summary>

Não, desde que os campos de padrão estejam configurados. O sistema assume automaticamente os valores definidos como padrão para concluir a integração.

</details>

<details>

<summary>Se a Chave Externa informada no SURICATO estiver diferente da configurada no TOTVS, o que ocorre?</summary>

O vínculo entre os registros não será reconhecido, podendo gerar falha na atualização ou criação de dados, já que a Chave Externa é o identificador principal entre os sistemas.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/manual-de-operacao/manual-do-suricato/processos-configuracoes-e-relatorios/configuracoes/sistema/totvs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.