# Marcação de Ponto

## Visão Geral

A seção **Marcação de Ponto** permite visualizar e gerenciar todas as informações referentes às marcações de ponto realizadas pelos colaboradores através do sistema Codin Mobile.

Dentro desta seção existem sub-menus que permitem navegar entre diferentes visualizações das marcações. A tela inicial apresentada é a aba **Marcações de Ponto - Hoje**, que exibe as marcações do dia atual.

O sistema oferece três formas de visualização: marcações do dia (Hoje), colaboradores presentes no dia, e todas as marcações históricas. Para cada marcação, é possível visualizar detalhes completos incluindo foto, dispositivo, localização GPS e visualização no mapa.

## Configuração Inicial

1. Acesse o menu lateral e clique em *Marcação de Ponto*.
2. A tela inicial será a aba *Marcações de Ponto - Hoje*.
3. Visualize as marcações do dia atual em formato GRID.
4. Para ver detalhes de uma marcação específica, clique no nome do colaborador.
5. Utilize os sub-menus para navegar entre as diferentes visualizações:
   * **Marcações de Ponto - Hoje:** marcações do dia atual
   * **Usuários Presentes:** colaboradores com marcação no dia
   * **Marcações de Ponto - Todas:** histórico completo de marcações

**Atenção:** as marcações são coletadas automaticamente dos dispositivos mobile. Certifique-se de que os colaboradores estão utilizando o aplicativo corretamente.

## Guia Rápido de Uso

#### Marcações de Ponto - Hoje

Visualize as marcações de ponto do dia atual com filtro automático aplicado.

* **Visualização GRID:** lista em formato de tabela com informações resumidas.
* **Detalhes:** clique no nome do colaborador para ver informações completas.
* **Busca:** preencha o campo "busca" com a informação desejada e clique no botão de pesquisa.
* **Exportação:** escolha o formato (CSV ou PDF) no menu "Exportar" e clique no botão de exportar.
* **Navegação:** utilize os botões *Anterior* e *Próxima* para percorrer páginas.
* **Total de registros:** exibido ao lado dos botões de navegação.

<figure><img src="/files/5l4eZU5jJfc0EEbItsdu" alt=""><figcaption></figcaption></figure>

**Informações em Detalhes**

* Foto da marcação de ponto do colaborador
* Dispositivo utilizado para realizar a marcação
* Detalhes de posição global (GPS) do colaborador
* Visualização no mapa do local onde foi realizada a marcação

<figure><img src="/files/rwinWHCYbeteMnPo0yKh" alt=""><figcaption></figcaption></figure>

#### Usuários Presentes

Visualize os colaboradores que realizaram pelo menos uma marcação na data atual.

* **Filtro automático:** exibe apenas colaboradores com marcação no dia.
* **Busca:** utilize o campo de busca para localizar colaboradores específicos.
* **Exportação:** disponível nos formatos CSV e PDF.
* **Detalhes:** clique no nome do colaborador para ver informações completas da marcação.
* **Navegação:** botões *Anterior* e *Próxima* disponíveis.

<figure><img src="/files/f8G0uTQnhml5ICHqOR6m" alt=""><figcaption></figcaption></figure>

#### Marcações de Ponto - Todas

Visualize todas as marcações de ponto coletadas pelo sistema dos dispositivos mobile.

* **Histórico completo:** sem filtro de data, exibe todas as marcações.
* **Busca:** localize marcações específicas usando o campo de busca.
* **Exportação:** exporte relatórios em CSV ou PDF.
* **Detalhes:** acesse informações completas clicando no nome do colaborador.
* **Navegação:** percorra o histórico usando os botões de paginação.

<figure><img src="/files/mNEenGdQChpUzCrj2Lun" alt=""><figcaption></figcaption></figure>

#### Como Exportar Relatórios

1. Escolha o formato de exportação no menu "Exportar" (CSV ou PDF).
2. Clique no botão de exportar.
3. O arquivo será gerado e disponibilizado para download.

## Regras de Negócio

* As **Marcações de Ponto - Hoje** exibem apenas marcações realizadas na data atual do sistema.
* A aba **Usuários Presentes** filtra automaticamente colaboradores que possuem pelo menos uma marcação no dia atual.
* A aba **Marcações de Ponto - Todas** apresenta o histórico completo sem filtros de data.
* Cada marcação registra obrigatoriamente: foto, dispositivo, localização GPS e horário.
* A visualização em detalhes permite verificar a autenticidade da marcação através da foto e localização.
* Relatórios podem ser exportados em formato CSV (planilha) ou PDF (documento) para análise externa.
* A posição global (GPS) é capturada no momento da marcação e exibida no mapa para verificação.
* O sistema coleta automaticamente as marcações dos dispositivos mobile configurados.

## FAQ - Perguntas Frequentes

<details>

<summary><strong>Qual a diferença entre "Marcações de Ponto - Hoje" e "Usuários Presentes"?</strong></summary>

"Marcações de Ponto - Hoje" mostra todas as marcações do dia, enquanto "Usuários Presentes" lista apenas os colaboradores únicos que registraram pelo menos uma marcação no dia.

</details>

<details>

<summary> <strong>Como vejo os detalhes de uma marcação específica?</strong></summary>

Clique no nome do colaborador na coluna correspondente. Você será redirecionado para a tela de detalhes com foto, dispositivo, GPS e mapa.

</details>

<details>

<summary><strong>Posso exportar apenas as marcações de hoje?</strong></summary>

Sim. Na aba "Marcações de Ponto - Hoje", escolha o formato (CSV ou PDF) e clique em exportar. O relatório conterá apenas as marcações do dia atual.

</details>

<details>

<summary><strong>Como faço para buscar marcações de um colaborador específico?</strong></summary>

Utilize o campo de busca em qualquer uma das abas, digite o nome do colaborador e clique no botão de pesquisa.

</details>

<details>

<summary><strong>O que significa a visualização no mapa?</strong></summary>

O mapa exibe o local exato (coordenadas GPS) onde o colaborador realizou a marcação de ponto, permitindo verificar se estava no local autorizado.

</details>

<details>

<summary><strong>Posso ver marcações de datas anteriores?</strong></summary>

Sim. Acesse a aba "Marcações de Ponto - Todas" para visualizar o histórico completo de marcações sem filtro de data.

</details>

<details>

<summary><strong>Qual a diferença entre exportar em CSV e PDF?</strong></summary>

CSV gera um arquivo de planilha que pode ser aberto no Excel para análise de dados. PDF gera um documento formatado para impressão ou visualização.

</details>

<details>

<summary><strong>As marcações aparecem em tempo real?</strong></summary>

Sim. Assim que o colaborador registra a marcação no dispositivo mobile, ela é coletada pelo sistema e fica disponível para visualização.

</details>

<details>

<summary><strong>Posso ver qual dispositivo o colaborador usou para marcar ponto?</strong></summary>

Sim. Essa informação está disponível na tela de detalhes de cada marcação.

</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/dispositivos/codin-mobile/codin-mobile-admin-web/marcacao-de-ponto.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.