# Registrar ponto manual

## Visão Geral

A tela de **Registrar Ponto** é onde o colaborador realiza suas marcações de ponto através do aplicativo Codin Mobile. Quando processada com sucesso, a marcação é sincronizada automaticamente ao Codin Mobile ADM para contabilizar a presença e salvar no sistema.

Para que as marcações de ponto funcionem corretamente, o aplicativo precisa de **três permissões essenciais**: acesso ao GPS (localização), câmera e arquivos. Ao entrar na tela pela primeira vez, você será solicitado a conceder essas permissões.

O sistema permite marcações tanto **online** (com internet e GPS ativo) quanto **offline** (sem conexão). As marcações ficam visíveis no espelho de ponto da data atual, permitindo que o colaborador acompanhe seus registros do dia.

## Configuração Inicial

{% stepper %}
{% step %}

### Inicialização e permissões

Ao acessar a tela de *Registro de Ponto* pela primeira vez, você verá 3 solicitações de permissão.

Clique em **Permitir** para cada uma das 3 permissões:

* **GPS (Localização):** permite que o app acesse sua localização para registrar onde a marcação foi realizada
* **Câmera:** permite tirar foto durante a marcação como prova de que é o próprio colaborador registrando o ponto
* **Arquivos:** permite salvar a foto da marcação nas pastas do celular
  {% endstep %}

{% step %}

### Acesso à tela e verificação do espelho

Após conceder as permissões, a tela de registro de ponto será liberada.\
Você poderá visualizar suas marcações do dia no *Espelho de Ponto*.
{% endstep %}

{% step %}

### Posicionamento e modos de uso

Para registrar seu ponto, aguarde o GPS posicionar você no mapa (modo online) ou clique diretamente se estiver sem internet (modo offline).
{% endstep %}

{% step %}

### Registrar Ponto

Clique em *Registrar Ponto*, tire a foto quando solicitado, e sua marcação será processada.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Atenção: todas as 3 permissões são obrigatórias para o funcionamento correto do aplicativo. Sem elas, você não conseguirá registrar o ponto.
{% endhint %}

## Guia Rápido de Uso

### Entendendo as Permissões

#### GPS (Localização)

O aplicativo precisa de acesso ao GPS para utilizar os serviços de localização do seu celular e retornar sua posição no momento da marcação. Isso garante que você está no local autorizado para registrar o ponto.

<figure><img src="/files/bb5D1p63NluIe1QtTR3o" alt="" width="188"><figcaption></figcaption></figure>

#### Câmera

O aplicativo precisa registrar uma foto durante a marcação de ponto como forma de provar que é o próprio colaborador realizando a marcação, aumentando a segurança e confiabilidade do sistema.

<figure><img src="/files/iZadV818aRGyCFNLY1CC" alt="" width="188"><figcaption></figcaption></figure>

#### Arquivos

O aplicativo precisa de acesso às pastas do seu celular **APENAS** para salvar a foto da sua marcação e nada mais. Nenhum outro arquivo será acessado ou modificado.

<figure><img src="/files/13opCWZhxlz4dvVYnbcC" alt="" width="188"><figcaption></figcaption></figure>

### Registrar Ponto Online (Com Internet)

{% stepper %}
{% step %}

### Abrir tela e verificar posicionamento

Abra a tela de *Registro de Ponto*. Observe o mapa e verifique se o serviço Google te posicionou corretamente no local atual.
{% endstep %}

{% step %}

### Registrar e confirmar

Quando sua posição estiver correta no mapa, clique no botão *Registrar Ponto*.\
O sistema abrirá a câmera do seu celular automaticamente.
{% endstep %}

{% step %}

### Foto e sincronização

Tire a foto conforme solicitado.\
O sistema registrará o ponto e sincronizará com o servidor.\
A marcação aparecerá no espelho de ponto da data atual.
{% endstep %}
{% endstepper %}

<figure><img src="/files/VuaeZghViSDH8OHkmRas" alt="" width="213"><figcaption></figcaption></figure>

### Registrar Ponto Offline (Sem Internet)

{% stepper %}
{% step %}

### Verificação do mapa (offline)

Abra a tela de *Registro de Ponto*.\
Observe que o mapa está com a mensagem "Sem acesso à internet" ao invés do seu posicionamento.
{% endstep %}

{% step %}

### Registrar mesmo sem conexão

Clique no botão *Registrar Ponto* mesmo sem conexão.\
O sistema abrirá a câmera do seu celular.
{% endstep %}

{% step %}

### Foto e armazenamento local

Tire a foto conforme solicitado.\
O sistema registrará o ponto localmente no dispositivo. Quando a internet estiver disponível, a marcação será sincronizada automaticamente.
{% endstep %}
{% endstepper %}

### Visualizar Espelho de Ponto

Na tela de registro, você pode acompanhar suas marcações realizadas no dia através do **Espelho de Ponto**, que exibe todas as marcações da data atual.

<figure><img src="/files/1vOChtMCQuCWpEvRgKiA" alt="" width="188"><figcaption></figcaption></figure>

## Regras de Negócio

* São necessárias **3 permissões obrigatórias** para registrar ponto: GPS, Câmera e Arquivos.
* Cada marcação de ponto registra automaticamente:
  * Data e hora da marcação
  * Localização GPS (quando disponível)
  * Foto do colaborador
  * Informações do dispositivo
* O sistema funciona em **modo online** (com internet e GPS) e **modo offline** (sem conexão).
* Marcações online são sincronizadas imediatamente com o Codin Mobile ADM.
* Marcações offline são armazenadas localmente e sincronizadas automaticamente quando a conexão for restabelecida.
* O **Espelho de Ponto** exibe apenas as marcações da data atual.
* A foto tirada durante a marcação serve como comprovação de que o próprio colaborador realizou o registro.
* A localização GPS garante que a marcação foi feita dentro da área autorizada (cerca virtual).
* As permissões de arquivos são usadas exclusivamente para salvar fotos das marcações.

## FAQ - Perguntas Frequentes

<details>

<summary>Por que o aplicativo pede tantas permissões?</summary>

As 3 permissões (GPS, Câmera e Arquivos) são essenciais para o funcionamento do registro de ponto: localização para verificar onde você está, câmera para comprovar sua identidade, e arquivos para salvar a foto da marcação.

</details>

<details>

<summary>Posso registrar ponto sem internet?</summary>

Sim. O sistema funciona em modo offline. A marcação ficará armazenada no dispositivo e será sincronizada automaticamente quando a internet estiver disponível.

</details>

<details>

<summary>O que acontece se eu negar alguma permissão?</summary>

Sem as 3 permissões, você não conseguirá registrar o ponto. Todas são obrigatórias para o funcionamento correto do aplicativo.

</details>

<details>

<summary>Como sei se minha marcação foi registrada?</summary>

Após tirar a foto, o sistema confirmará o registro. Você também pode verificar no Espelho de Ponto da data atual.

</details>

<details>

<summary>Preciso estar conectado ao Wi‑Fi para registrar ponto?</summary>

Não. Você pode usar dados móveis ou registrar offline. Marcações offline serão sincronizadas quando houver conexão.

</details>

<details>

<summary>O aplicativo acessa outros arquivos do meu celular?</summary>

Não. A permissão de arquivos é usada APENAS para salvar as fotos das marcações de ponto, nada mais.

</details>

<details>

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

O Espelho de Ponto na tela de registro mostra apenas marcações da data atual. Para ver histórico completo, consulte outras seções do sistema.

</details>

<details>

<summary>E se o GPS não conseguir me localizar?</summary>

Você ainda pode registrar o ponto em modo offline. A localização será capturada quando o GPS estiver disponível, ou a marcação será sincronizada sem GPS preciso.

</details>

<details>

<summary>Posso alterar uma marcação após registrar?</summary>

Não. As marcações são definitivas. Se houver erro, você precisará solicitar ajuste através do sistema de justificativas.

</details>

<details>

<summary>Quantas vezes posso registrar ponto por dia?</summary>

Depende da configuração do seu horário de trabalho. Geralmente são 4 marcações (entrada, saída para almoço, retorno do almoço, saída final), mas pode variar.

</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-app/home/registrar-ponto-manual.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.
