> 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/manual-de-operacao-do-suricato/manual-do-suricato/entrada-controle-e-veiculos/controle/comando/comandos-para-equipamentos.md).

# Comandos para Equipamentos

CONTROLE | COMANDO | COMANDOS PARA EQUIPAMENTOS

Visão Geral

Gerencie o envio de comandos on-line para equipamentos CODIN. Esta funcionalidade permite realizar manutenções, atualizações, coletas de dados, gerenciamento de listas e consulta de status operacional diretamente nos dispositivos integrados ao sistema.

#### Onde encontrar esta tela?

Caminho: Controle ➜ Comando ➜ Comandos para Equipamentos

* **Versão 3.1 (Nova Interface):** Clique no ícone de menu à esquerda para expandir e siga o caminho indicado.

{% hint style="info" icon="lightbulb-on" %}
**Dica Ágil:** Pressione a lupa no topo e digite "Acesso" para localizar a opção diretamente na versão v3.1.0.
{% endhint %}

## Regras de Negócios

* **Status do Equipamento:** O dispositivo deve estar cadastrado, ativo e on-line no momento do envio.
* **Vínculos de Estrutura:** Planta, Gateway e Código do CODIN devem estar corretamente relacionados.
* **Pré-requisito de Listas:** Para o envio de listas, estas devem ser geradas previamente no sistema e ser compatíveis com o modelo do equipamento.
* **Serviços de Comunicação:** Os serviços GerServ e ConexREP devem estar ativos. Se estiverem inativos, o equipamento aparecerá como "OFF" e os comandos ficarão retidos na fila de transmissão.

### Filtro de Comandos do Acesso On-Line

Por ser uma tela de formulário direto, o fluxo de execução segue as etapas abaixo:

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FPdXp9gHdV1i6g9UtnHRM%2Fimage.png?alt=media&amp;token=bfe4dba1-de80-4e80-af4f-13a084d5969c" alt=""><figcaption><p><em>Comando de Acesso On-line</em></p></figcaption></figure>

### Como filtrar o Equipamento que receberá o Comando

1. No filtro inicial, preencha a [Planta](/suricato-docs/manual-de-operacao-do-suricato/manual-do-suricato/estrutura-e-equipamentos/estrutura/planta.md), o [Gateway](/suricato-docs/manual-de-operacao-do-suricato/manual-do-suricato/estrutura-e-equipamentos/dispositivos/gateway.md) e o [Código do Codin](/suricato-docs/manual-de-operacao-do-suricato/manual-do-suricato/estrutura-e-equipamentos/dispositivos/equipamento-codin.md).
2. Clique em Confirmar Dados.
3. Você será direcionado para a tela de comandos.

#### Tela de Comandos de Acesso On-Line

1. Na tela Tipo de Comando, selecione a categoria desejada (ex: Aplicativo, Coleta, REP, Listas ou Status).
2. Selecione o subtipo específico do comando (ex: Incluir Lista de Biometria, Coletar AFD por Data, etc.) e clique em OK.
3. O sistema abrirá uma página com as seguintes abas operacionais:&#x20;
4. **Aba Coletores:** Selecione o equipamento desejado através do *checkbox* e clique em **Salvar** Selecionados. Neste momento, o comando é enviado para a fila.
5. **Aba Comandos:** Acompanhe o status do envio, verificando a data, hora, planta, codin e a mensagem de retorno enviada pelo equipamento.&#x20;
6. **Atenção:** Se identificar um erro antes do envio final, você pode excluir o comando da fila clicando no botão **DEL**.&#x20;
7. Caso precise retornar à tela principal para selecionar outro tipo de comando sem encerrar a aplicação, utilize a opção **Voltar para aplicação anterior**.

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FIlZV2r0bN3IyTv5hgvrI%2Fimage.png?alt=media&amp;token=1132cded-77d6-4c1b-a89b-fd3a3f50d551" alt=""><figcaption><p><em>Tela de Coletores (seleção de equipamento para envio de comando) [4]</em></p></figcaption></figure>

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2Fpn98W3e6VlIPrmuHwNij%2Fimage.png?alt=media&amp;token=2d118f89-70ee-4e73-95d0-636c24bb29b0" alt=""><figcaption><p><em>Tela de histórico de comandos enviados com status [5]</em></p></figcaption></figure>

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2F7vlYLAXx0pln3HH2wPTk%2Fimage.png?alt=media&amp;token=e0324739-bf9c-47c4-a62c-534ace65b524" alt=""><figcaption><p><em>Botão Del [6]</em></p></figcaption></figure>

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FSpWkmWfuIbJSUjMxD2Am%2Fimage.png?alt=media&amp;token=ba30cf4a-b059-4f0f-83da-71d730d2cc3d" alt=""><figcaption><p><em>Botão de voltar para aplicação anterior [7]</em></p></figcaption></figure>

{% hint style="warning" %}
**Observação importante:**&#x20;

* O equipamento **precisa estar on-line** para receber comandos.&#x20;
* Cada equipamento pode ter requisitos específicos de serviço, versão ou configuração para ficar on-line
  {% endhint %}

## Glossário

* **AFD**: Arquivo Fonte de Dados do REP.
* **NSR**: Número Sequencial de Registro do REP.
* **Anti-dupla**: regra que impede que a mesma pessoa registre duas entradas consecutivas sem saída (ou vice-versa).
* **MRP**: Módulo Registrador de Ponto do REP.

## **FAQ – Perguntas Frequentes**

<details open>

<summary>Por que meu comando ficou em fila e não foi enviado?</summary>

Provavelmente o equipamento está **OFF** ou os serviços **GerServ/ConexREP estão inativos**.

</details>

<details open>

<summary>Como sei se o equipamento está on-line?</summary>

Verifique o **Status do Equipamento** no SURICATO antes de enviar o comando.

</details>

<details open>

<summary>Enviei uma lista e nada aconteceu. O que pode ser?</summary>

* A lista pode não ter sido gerada previamente;
* O tipo de lista pode não ser compatível com o equipamento;
* O equipamento pode estar offline.

</details>

<details open>

<summary>Posso cancelar um comando depois de enviar?</summary>

Sim. Enquanto estiver na fila, é possível excluir usando o botão **DEL** na aba Comandos.

</details>

<details open>

<summary>Preciso enviar os comandos um por um?</summary>

Sim. Os comandos são enviados individualmente por equipamento selecionado.

</details>

<details open>

<summary>O REP recebe todos os tipos de comando?</summary>

Não. O REP recebe **apenas comandos específicos de REP** (ex.: AFD, empregador, biometria, face, etc.).

</details>

<details open>

<summary>Posso voltar e enviar outro comando sem sair da tela?</summary>

Sim. Use **Voltar para aplicação anterior** e selecione um novo comando.

</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 dynamically by asking a question.

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

```
GET https://software-telematica-com.gitbook.io/suricato-docs/manual-de-operacao-do-suricato/manual-do-suricato/entrada-controle-e-veiculos/controle/comando/comandos-para-equipamentos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.