# Integração TOTVS

## Visão Geral

Nesta tela de consulta, é possível visualizar as informações relacionadas à integração entre os sistemas TOTVS e SURICATO. 

O ambiente permite o acompanhamento detalhado do status, dos dados integrados e das configurações envolvidas, garantindo a rastreabilidade da comunicação entre as plataformas.

### Onde encontro esta tela?

Seja pelo menu superior ou lateral, o caminho é: Estrutura ➜ Integração TOTVS.

* **Na Versão 3.1 (Nova):** Clique no ícone de menu à esquerda para expandir.

{% hint style="info" icon="lightbulb-on" %}
**Dica Ágil:** Pressione a lupa no topo e digite "Integração TOTVS" para ir direto, sem cliques extras. *v3.1.0*
{% endhint %}

## Regras de Negócio

* **Consulta Flexível:** Não existem campos obrigatórios para a realização da consulta; todos os filtros são de uso opcional.
* **Exibição Global:** A ausência de filtros aplicados resulta na exibição completa de todos os registros de integração disponíveis no banco de dados.
* **Sincronização:** O sistema apresenta a movimentação de transferência de dados cadastrais enviada especificamente do sistema TOTVS para o SURICATO.

## Filtro - Integração TOTVS

A área de filtro permite refinar a visualização dos dados de integração entre o **TOTVS** e o **SURICATO**. **Não há campos obrigatórios**; todos os filtros são opcionais.

<figure><img src="/files/TC53rLN82NMkeyiWqqsq" alt=""><figcaption><p><em>Filtro Integração TOTVS</em></p></figcaption></figure>

### Campos disponíveis

1. **Tabela**: informe o nome da tabela da qual deseja visualizar as informações.  \
   \&#xNAN;*Exemplo: TBCARGO*.
2. **Chave Externa**: informe a chave externa enviada pelo sistema TOTVS.
3. **Última Execução (Operação)**: selecione o tipo de operação referente à última execução da integração.  *Exemplo: insertOrUpdate*.
4. **Última Execução (Data)**: informe uma data específica para visualizar as execuções realizadas nesse dia.
5. **Chave Interna**: informe a chave interna do registro, ou seja, o **ID da tabela no SURICATO**.
6. **Objeto**: informe o nome do objeto integrado.  *Exemplo: reducedTitleOffice*.

#### Observação

* Ao clicar em **Pesquisar** com todos os campos em branco, o sistema exibirá **toda a movimentação de transferência de dados cadastrais** enviada do **TOTVS para o SURICATO**.

## Relatório – Integração TOTVS

Após aplicar os filtros, o **SURICATO** exibirá todos os registros que atendam aos critérios informados.

<figure><img src="/files/zh1DojA1sWCdqfIWN6xP" alt=""><figcaption><p><em>Exemplo - Relatório Integração TOTVS</em></p></figcaption></figure>

## FAQ - Perguntas Frequentes <a href="#faq-perguntas-frequentes" id="faq-perguntas-frequentes"></a>

<details open>

<summary>Por que a consulta exibe tantos registros quando faço a pesquisa sem filtros?</summary>

Quando nenhum filtro é informado, o sistema retorna todo o histórico de movimentações de integração entre o TOTVS e o SURICATO, exibindo todos os registros disponíveis.

</details>

<details open>

<summary>Qual filtro devo usar para localizar um registro específico enviado pelo TOTVS?</summary>

O mais indicado é utilizar a Chave Externa, pois ela identifica de forma única o dado enviado pelo TOTVS. Caso conheça o ID no SURICATO, também é possível usar a Chave Interna.

</details>

<details open>

<summary>Como identificar qual foi a última operação realizada em um registro integrado?</summary>

Utilize o filtro Última Execução (Operação) ou observe a informação apresentada na coluna correspondente, que indica se a ação foi, por exemplo, um insertOrUpdate.

</details>

<details open>

<summary>Posso consultar apenas as integrações realizadas em um determinado dia?</summary>

Sim. Basta preencher o campo Última Execução (Data) para visualizar apenas as integrações executadas na data informada.

</details>

<details open>

<summary>O que significa o campo Objeto na consulta de integração?</summary>

O campo Objeto indica o nome do objeto ou entidade integrada entre os sistemas, facilitando a identificação do tipo de informação que foi enviada do TOTVS para o SURICATO.

</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/estrutura-e-equipamentos/estrutura/integracao-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.