# Suricato REST

## O que é Suricato Rest (Cloud)?

O Suricato Cloud é a solução desenvolvida para viabilizar a comunicação entre o sistema Suricato e ecossistemas de gestão (ERP) em ambiente de nuvem. 

Utilizando a arquitetura REST (Transferência de Estado Representacional), o serviço realiza chamadas via protocolo HTTP para garantir o tráfego de dados remoto com alta disponibilidade.

#### O que ele faz?

Este serviço elimina a necessidade de infraestruturas físicas locais para a integração, permitindo:

* **Acesso Remoto:** Comunicação com sistemas em nuvem de qualquer local via Internet.
* **Interoperabilidade:** Execução de chamadas REST necessárias para a integração entre plataformas.
* **Escalabilidade:** Utilização de processamento e armazenamento compartilhados, seguindo os princípios da computação em grade.

## Regra de Negócio

Para garantir a integridade da comunicação REST em ambiente Cloud, o ambiente deve atender obrigatoriamente aos seguintes critérios:

| **Categoria** | **Requisito Geral de Funcionamento**                                                          |
| ------------- | --------------------------------------------------------------------------------------------- |
| Dependência   | O sistema SURICATO deve estar previamente instalado.                                          |
| Conectividade | As configurações de conexão com o banco de dados devem estar preenchidas conforme o ambiente. |
| Persistência  | O arquivo `application.properties.xml` deve estar configurado corretamente.                   |
| Instalação    | Após qualquer alteração de configuração, o serviço deve ser reinstalado via `bat install`.    |

#### Especificações por Integração

**Integração TOTVS** (SURICATO-TOTVS-Rest)

* **Diretório:** O módulo `SURICATOTotvsRest` deve existir no diretório padrão de instalação.
* Arquivo JAR: O arquivo `SURICATO-totvs-rest.jar` deve estar acessível para edição e configuração.

**Outras Integrações**

* Documentação de módulos Cloud para outros fornecedores em processo de atualização.

## Guia de Implementação

*Selecione o procedimento técnico necessário:*

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span><mark style="color:$primary;"><strong>Integração TOTVS Cloud</strong></mark></td><td>Como editar o arquivo <code>application.properties.xml</code> e preparar o JAR para chamadas REST.</td></tr><tr><td><mark style="color:$primary;"><strong>⚙️ Instalação do Suricato Rest</strong></mark></td><td>Procedimento para execução da <code>bat install</code> e validação da comunicação via Internet.</td></tr><tr><td><mark style="color:$primary;"><strong>🌐 Novas Conexões</strong></mark></td><td>Módulos de integração Cloud para outros sistemas estarão disponíveis em breve.</td></tr></tbody></table>

{% hint style="info" icon="lightbulb-on" %}

#### Dica: Ciclo de Atualização

Como o Suricato Cloud depende de chaves e endereços que podem mudar em ambientes de nuvem, nunca esqueça: qualquer pequena alteração no arquivo `application.properties.xml` exige que você execute novamente a `bat install`.&#x20;

Sem esse passo, o serviço continuará tentando utilizar as credenciais antigas que estão "presas" na instalação anterior.
{% endhint %}

***

### 📖 Glossário Rápido

* **Cloud Computing:** Processamento e armazenamento remoto via Internet.
* **REST:** Estilo de arquitetura de software que utiliza o protocolo HTTP para comunicação entre sistemas.


---

# 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/comece-por-aqui/servicos-do-suricato/suricato-rest.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.