> For the complete documentation index, see [llms.txt](https://software-telematica-com.gitbook.io/suricato-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/instalacao-do-suricato/integracao-suricato-totvs.md).

# Integração SURICATO TOTVS

Integração SURICATO + TOTVS

A Integração SURICATO e TOTVS é a ponte tecnológica que une o seu controle de acesso e ponto ao sistema de gestão de RH (ERP) da TOTVS. 

Na prática, ela elimina a necessidade de cadastrar a mesma pessoa em dois lugares diferentes e garante que as marcações de ponto feitas na catraca cheguem sozinhas à folha de pagamento.

### O que ela garante na prática?

* [x] **Fim do Retrabalho:** Quando você contrata alguém na TOTVS, os dados (nome, cargo, turno) são enviados automaticamente para o SURICATO.
* [x] **Ponto Automatizado:** As batidas de ponto registradas nos equipamentos são coletadas pelo SURICATO e enviadas para o módulo de automação de ponto da TOTVS.
* [x] **Sincronia Total:** Mudanças de horários, demissões ou trocas de crachá refletem nos dois sistemas sem intervenção manual.
* [x] **Segurança de Dados:** A troca de informações utiliza protocolos modernos (WebServices SOAP e REST), garantindo que os dados não sejam desviados ou perdidos no caminho.

## Arquitetura da Integração

A integração conecta os ERPs RM, Datasul ou Protheus aos serviços do Suricato através de três pilares principais:

<table data-header-hidden><thead><tr><th width="233.4444580078125"></th><th width="297.00006103515625"></th><th></th></tr></thead><tbody><tr><td><strong>Serviço</strong></td><td><strong>Função Principal</strong></td><td><strong>Detalhes Técnicos</strong></td></tr><tr><td>Suricato-TOTVS-WS</td><td>Recebe dados cadastrais (Pessoas/Cargos).</td><td>Porta 5000 / SOAP XML / Java 1.8</td></tr><tr><td>Suricato-TOTVS-MA</td><td>Traduz as permissões (Matriz de Acesso).</td><td>Windows Service</td></tr><tr><td>Suricato-TOTVS-Marcacao</td><td>Envia as batidas de ponto para a TOTVS.</td><td>Coletor de Marcação</td></tr></tbody></table>

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FHLtQWeHCEHo7nnCVr47J%2Fimage.png?alt=media&amp;token=c6822443-7ed3-4cac-8111-8349c0af385d" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="lightbulb-on" %}
**Dica de Valor:** Ao implementar essa integração, você transforma o SURICATO em uma ferramenta de estratégia de RH, e não apenas um controle de acesso e ponto.
{% endhint %}

Precisa configurar um desses módulos agora? Escolha abaixo por onde deseja começar:

* [WebService Suricato TOTVS](/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/instalacao-do-suricato/integracao-suricato-totvs/webservice-suricato-totvs.md)
* [SURICATO Matriz de Acesso](broken://pages/mcOqaQN6wuV7zLbCQlPn)
* [Coletor de Marcação](broken://pages/HRG3BixaP0fcD0OFM7qd)
* [Suricato REST](broken://pages/OipqMT7DKBLwmp4dL8Pj)

### FAQ - Perguntas Frequentes

<details>

<summary>Isso funciona em servidores na nuvem (Cloud)?</summary>

Sim. A integração é preparada para ambientes locais (*On-premises*) ou em nuvem, utilizando conexões seguras.

</details>

<details>

<summary>Se o servidor da TOTVS cair, o acesso para?</summary>

Não. O SURICATO guarda as regras localmente. Assim que a conexão volta, ele sincroniza o que aconteceu no período.

</details>

<details>

<summary>Quais dados são integrados?</summary>

Basicamente tudo o que o RH precisa: Colaboradores, Grupos de Acesso, Turnos, Funções e as Marcações de Ponto.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/instalacao-do-suricato/integracao-suricato-totvs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.