> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ponto.vittagestao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Controle de Pontos

É a área destinada à consulta e acompanhamento das marcações de ponto dos colaboradores.

Nessa tela, é possível selecionar um **período**, uma **filial** e um ou mais **profissionais** para visualizar as jornadas e as marcações realizadas em cada dia.

A consulta permite acompanhar as informações de forma organizada, facilitando a conferência da jornada dos colaboradores por semana.

<Note>
  **Importante:** As informações apresentadas na tela são organizadas de acordo com os filtros selecionados. Por isso, antes de analisar as marcações, confirme se o período, a filial e o profissional selecionados correspondem à consulta que deseja realizar.
</Note>

# Filtros

Antes de visualizar as marcações, utilize os filtros disponíveis no topo da tela para definir quais informações deseja consultar.

A tela possui três critérios principais:

<AccordionGroup>
  <Accordion title="Período">
    O campo determina o intervalo de datas que será apresentado na consulta.

    Por padrão, o sistema apresenta um período semanal, exibindo os dias correspondentes ao intervalo selecionado.

    #### Como alterar o período?

    Existem três formas de navegar pelo período:

    **← Anterior:** Retorna para o período anterior.

    **Calendário:** Permite selecionar diretamente o período desejado. Utilize a opção **Última semana**, quando desejar retornar rapidamente à semana anterior.

    **→ Próximo:** Avança para o próximo período.

    <Frame>
      <img src="https://mintcdn.com/vitta-ponto/kTCIn3nbl5dFZ1Hv/images/image-11.png?fit=max&auto=format&n=kTCIn3nbl5dFZ1Hv&q=85&s=218b5c78b589a1fc2e4121c5473efa1c" alt="Image" width="219" height="503" data-path="images/image-11.png" />
    </Frame>
  </Accordion>

  <Accordion title="Filial">
    O campo permite definir qual unidade da empresa será considerada na consulta.

    Clique no campo **Filial** e selecione a unidade desejada.

    Essa seleção é necessária, pois permite concentrar a consulta nos colaboradores vinculados àquela unidade.

    <Frame>
      <img src="https://mintcdn.com/vitta-ponto/kTCIn3nbl5dFZ1Hv/images/image-12.png?fit=max&auto=format&n=kTCIn3nbl5dFZ1Hv&q=85&s=c4e6c4fb615f3a052cad07d102d269bf" alt="Image" width="1445" height="41" data-path="images/image-12.png" />
    </Frame>

    <Warning>
      **Atenção:** Certifique-se de selecionar a filial correta antes de realizar a pesquisa.
    </Warning>
  </Accordion>

  <Accordion title="Profissionais">
    O campo  permite selecionar quais colaboradores terão suas marcações apresentadas.

    Ao abrir o campo, o sistema disponibiliza a relação dos profissionais cadastrados na filial selecionada.

    É possível:

    * Selecionar um profissional específico;
    * Selecionar mais de um profissional;
    * Utilizar a opção **Selecionar todos** para consultar todos os profissionais disponíveis.
          <Frame>
            <img src="https://mintcdn.com/vitta-ponto/lDra1j91NaUXZB3b/images/image-44.png?fit=max&auto=format&n=lDra1j91NaUXZB3b&q=85&s=1a1acd07eb1c43fc355feda206dd2805" alt="Image" title="Image" style={{ width:"78%" }} width="230" height="394" data-path="images/image-44.png" />
          </Frame>

    <Tip>
      **Dica:** Quando a consulta for direcionada a um colaborador específico, selecione apenas esse profissional. Isso deixa a visualização mais objetiva e facilita a conferência da jornada.
    </Tip>
  </Accordion>
</AccordionGroup>

Após definir os critérios desejados, clique em **Filtrar** para atualizar os resultados. Eles serão apresentados em tabela.

<Frame>
  <img src="https://mintcdn.com/vitta-ponto/lDra1j91NaUXZB3b/images/image-45.png?fit=max&auto=format&n=lDra1j91NaUXZB3b&q=85&s=a74485f2365ddd8607347e3ce2028223" alt="Image" width="1136" height="535" data-path="images/image-45.png" />
</Frame>

### Nenhuma jornada prevista?

Essa mensagem indica que **não há uma jornada vinculada ao cadastro daquele profissional para o período consultado**.

<Frame>
  <img src="https://mintcdn.com/vitta-ponto/lDra1j91NaUXZB3b/images/image-46.png?fit=max&auto=format&n=lDra1j91NaUXZB3b&q=85&s=589de7b7404d104ff9ec5964bcd190ec" alt="Image" title="Image" className="mx-auto" style={{ width:"98%" }} width="1094" height="405" data-path="images/image-46.png" />
</Frame>

#### O que verificar?

Caso essa mensagem seja apresentada para um profissional que deveria possuir uma jornada cadastrada, verifique:

1. Se o profissional possui uma jornada cadastrada;
2. Se o plano de jornada está corretamente vinculado ao profissional;
3. Se a jornada vinculada corresponde à filial correta;
4. Se a jornada possui vigência para o período que está sendo consultado.

<Warning>
  **Atenção:** A mensagem **“Nenhuma jornada prevista” não significa, necessariamente, que o profissional não trabalhou ou não realizou marcações.** Ela indica que o sistema não encontrou uma jornada vinculada ao profissional para aquele período.
</Warning>

#### Como corrigir?

<Steps>
  <Step title="Acesse Segurança > Usuários" />

  <Step title="Localize o profissional que apresenta a inconsistência" />

  <Step title="Acesse as opções do usuário e selecione Editar" />

  <Step title="Verifique a jornada vinculada ao profissional">
    Confirme se o plano de jornada está correto e corresponde à filial do colaborador

    <Frame>
      <img src="https://mintcdn.com/vitta-ponto/9fOUuxox1S0VLLQO/images/image-15.png?fit=max&auto=format&n=9fOUuxox1S0VLLQO&q=85&s=6768fd59d13ac27517cc47e9b1692dab" alt="Image" width="1256" height="179" data-path="images/image-15.png" />
    </Frame>
  </Step>

  <Step title="Caso não exista uma jornada vinculada ou a jornada esteja incorreta, realize a correção">
    <Frame>
      <img src="https://mintcdn.com/vitta-ponto/9fOUuxox1S0VLLQO/images/image-16.png?fit=max&auto=format&n=9fOUuxox1S0VLLQO&q=85&s=8fb79497f83daab27fcc71a4474c7614" alt="Image" width="1245" height="230" data-path="images/image-16.png" />
    </Frame>
  </Step>

  <Step title="Salve as alterações" />

  <Step title="Retorne ao Controle de Pontos e realize uma nova consulta" />
</Steps>

<Warning>
  **Atenção:** A jornada deve estar corretamente vinculada ao usuário para que o sistema consiga apresentar a **jornada prevista** no Controle de Pontos. A existência de um plano cadastrado em **Planos de Jornada**, por si só, não significa que ele esteja vinculado ao profissional.
</Warning>

# Marcação

Quando existem registros de ponto, eles são apresentados dentro da coluna correspondente ao dia.

Cada marcação apresenta a **data e o horário** em que o registro foi realizado.

<Frame>
  <img src="https://mintcdn.com/vitta-ponto/kTCIn3nbl5dFZ1Hv/images/Controle.png?fit=max&auto=format&n=kTCIn3nbl5dFZ1Hv&q=85&s=429315a43d1702de0bd5ab95ed0ebb2a" alt="Controle" width="207" height="484" data-path="images/Controle.png" />
</Frame>

Nesse exemplo, é possível identificar quatro marcações realizadas na segunda-feira:

1. Entrada;
2. Saída para intervalo;
3. Retorno do intervalo;
4. Saída.

A quantidade e os horários apresentados devem ser analisados de acordo com a jornada cadastrada para o profissional.

### Como conferir a jornada?

A visualização permite comparar as marcações realizadas ao longo do dia visualmente.<br />Além de, identificar entrada em verde e saída em vermelho.

Essa conferência pode auxiliar na identificação de situações como:

* Marcações ausentes;
* Quantidade inesperada de marcações;
* Horários registrados fora do padrão esperado;
* Intervalos registrados;
* Diferenças entre a jornada prevista e as marcações realizadas.

<Tip>
  **Dica:** Ao identificar uma inconsistência, confira primeiro a jornada cadastrada para o colaborador e as regras de cálculo aplicáveis antes de realizar qualquer alteração.
</Tip>

### Como ver o total de horas?

Na parte inferior de cada coluna de dia, o sistema apresenta o total de horas calculado para aquele período.

Esse campo permite acompanhar o total de horas considerado pelo sistema para cada dia da jornada.

<Frame>
  <img src="https://mintcdn.com/vitta-ponto/kTCIn3nbl5dFZ1Hv/images/Controle1.png?fit=max&auto=format&n=kTCIn3nbl5dFZ1Hv&q=85&s=d78de0e4e4186b68922888945300b94a" alt="Controle1" width="1443" height="44" data-path="images/Controle1.png" />
</Frame>

<Note>
  **Importante:** A interpretação do total de horas considera a jornada cadastrada e as regras de cálculo configuradas no sistema.
</Note>

# Correção

Realize ajustes nas marcações registradas quando for identificada alguma inconsistência nos horários apresentados.

Essa função deve ser utilizada quando houver necessidade de **corrigir um horário de ponto**, seja por uma marcação registrada incorretamente ou por uma situação que exija ajuste no registro.

### Como excluir uma batida?

Durante a conferência do Controle de Ponto, pode ser necessário corrigir registros realizados de forma incorreta ou em quantidade diferente da jornada prevista.

A edição deve ser utilizada para **ajustar o registro de ponto à jornada efetivamente realizada pelo colaborador**, sempre considerando as informações e justificativas fornecidas pela empresa.

<Frame>
  <img src="https://mintcdn.com/vitta-ponto/HbUDyCxygywI7Oxm/images/image-18.png?fit=max&auto=format&n=HbUDyCxygywI7Oxm&q=85&s=96b085f8c7b5df5b33fcdad9c14d76b7" alt="Image" width="209" height="501" data-path="images/image-18.png" />
</Frame>

Na imagem de exemplo, o período da tarde apresenta:

**13:12 → Entrada**<br />**14:19 → Saída**<br />**14:20 → Entrada**<br />**16:29 → Saída**<br />**18:04 → Entrada**

Nesse caso, existem **batidas em excesso e registros que não representam a jornada efetivamente realizada**, sendo necessário corrigir os horários antes do fechamento.

<Warning>
  **Atenção:** Antes de excluir uma batida, valide o que realmente ocorreu no período. Uma alteração incorreta pode impactar o cálculo das horas trabalhadas, horas extras e demais informações do fechamento da jornada.
</Warning>

<Steps>
  <Step title="Passe o mouse por cima do horário errado">
    Será aberto um X no canto superior direito do horário registrado.

    <Frame>
      <img src="https://mintcdn.com/vitta-ponto/HbUDyCxygywI7Oxm/images/image-19.png?fit=max&auto=format&n=HbUDyCxygywI7Oxm&q=85&s=ad6453a1c9323d567d6b457243db461e" alt="Image" width="194" height="207" data-path="images/image-19.png" />
    </Frame>
  </Step>

  <Step title="Clique">
    O horário será apagado.
  </Step>
</Steps>

### Como adicionar uma batida?

Além de excluir registros incorretos, também é possível **adicionar uma batida** quando um registro de entrada ou saída não foi realizado ou não foi registrado corretamente no sistema.

Essa função deve ser utilizada quando houver uma **batida ausente**, mas for necessário registrar o horário efetivamente realizado pelo colaborador.

<Steps>
  <Step title="Identifique o período">
    Identifique o período da jornada em que o registro está ausente.
  </Step>

  <Step title="Clique no botão +">
    <Frame>
      <img src="https://mintcdn.com/vitta-ponto/HbUDyCxygywI7Oxm/images/image-20.png?fit=max&auto=format&n=HbUDyCxygywI7Oxm&q=85&s=ef6739092264d2a187ffad9fb0f054b4" alt="Image" title="Image" style={{ width:"78%" }} width="211" height="462" data-path="images/image-20.png" />
    </Frame>
  </Step>

  <Step title="Informe o horário da batida que deverá ser registrado">
    <Frame>
      <img src="https://mintcdn.com/vitta-ponto/HbUDyCxygywI7Oxm/images/image-21.png?fit=max&auto=format&n=HbUDyCxygywI7Oxm&q=85&s=d075d8506028e2a4e3dd5902ebad3679" alt="Image" title="Image" style={{ width:"83%" }} width="498" height="310" data-path="images/image-21.png" />
    </Frame>

    Clique sob a data para configurar horário
  </Step>

  <Step title="Clique em Salvar" />

  <Step title="Confira">
    Após o lançamento, confira novamente a sequência de batidas e o total de horas apresentado para o dia.
  </Step>
</Steps>

<Warning>
  **Atenção:** Antes de adicionar uma batida, confirme o horário efetivamente realizado pelo colaborador. O lançamento deve representar o registro real da jornada, evitando ajustes baseados apenas no horário previsto.
</Warning>

### Quando usar cada ação?

<AccordionGroup>
  <Accordion title="Falta uma entrada ou saída">
    Adicionar batida
  </Accordion>

  <Accordion title="Existe uma batida registrada por engano">
    Remover batida
  </Accordion>

  <Accordion title="Existem batidas em excesso">
    Remover as batidas indevidas após validação
  </Accordion>

  <Accordion title="O horário registrado está incorreto">
    Remover o registro incorreto e adicionar o horário correto
  </Accordion>

  <Accordion title="A jornada prevista não aparece">
    Verificar o cadastro do usuário e a vinculação da jornada
  </Accordion>
</AccordionGroup>
