> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/relatorios/relatorio-de-agendamentos.md).

# Relatório de Agendamentos

### Finalidade

Mede a operação da agenda: quantos agendamentos, quantos foram concluídos, quantos o cliente faltou, quanto isso representa em valor — por profissional, por serviço e por dia.

**Caminho:** menu lateral → Relatórios → **Relatório de Agendamentos**

Depende dos desfechos registrados na Agenda (**Concluído** / **Não compareceu**). Sem marcar desfecho, tudo fica como "Em aberto".

\[\[FOTO]]

***

### Filtros

| Filtro       | Uso                                                           |
| ------------ | ------------------------------------------------------------- |
| Período      | Intervalo de datas. Padrão: mês corrente até hoje             |
| Profissional | Um responsável específico                                     |
| Serviço      | Um serviço específico                                         |
| Cliente      | Busca por nome/telefone (mínimo 2 letras)                     |
| Situação     | Em aberto · Concluído · Não compareceu · Cancelado · Expirado |
| Origem       | Manual · Página pública · Chatbot                             |

\[\[FOTO]]

***

### Indicadores do topo

| Indicador              | O que significa                             |
| ---------------------- | ------------------------------------------- |
| **Agendamentos**       | Total no filtro                             |
| **Concluídos**         | Marcados como Concluído                     |
| **Não compareceu**     | Marcados como falta                         |
| **Cancelados**         | Cancelados por você ou pelo cliente         |
| **Em aberto**          | Ainda sem desfecho                          |
| **Valor previsto**     | Soma de **todos** os agendamentos do filtro |
| **Valor realizado**    | Soma **apenas dos concluídos**              |
| **Ticket médio**       | Valor realizado ÷ concluídos                |
| **Taxa de conclusão**  | Concluídos ÷ total                          |
| **Taxa de falta**      | Faltas ÷ total                              |
| **Horas agendadas**    | Duração do serviço + folga, somadas         |
| **Clientes atendidos** | Contatos distintos no período               |

**Por que dois valores:** "quanto entrou" e "quanto está agendado" são perguntas diferentes. Cancelamentos e faltas continuam contando nas quantidades — que é justamente o que você quer medir — mas nunca entram no realizado.

\[\[FOTO]]

***

### Visualizações

| Bloco                     | Conteúdo                                                                                             |
| ------------------------- | ---------------------------------------------------------------------------------------------------- |
| Distribuição por situação | Rosca com as situações que têm ocorrência                                                            |
| Agendamentos por dia      | Agendados × concluídos ao longo do período                                                           |
| Por serviço               | Quantidade, concluídos e valor realizado                                                             |
| Por profissional          | Quantidade, concluídos e valor realizado                                                             |
| Tabela                    | Linha a linha, com data, cliente, telefone, serviço, profissional, duração, valor, origem e situação |

**Exportar** gera um Excel com quatro abas: Resumo, Agendamentos, Por serviço e Por profissional.

\[\[FOTO]]

***

### Regras importantes

* **O valor vem do preço atual do serviço.** O agendamento não guarda o valor cobrado na época — se você reajustar o preço, os relatórios de períodos anteriores passam a mostrar o valor novo. A tela avisa isso.
* Os valores aparecem **sem símbolo de moeda**, só o número.
* Origem **Manual** cobre tanto a Agenda quanto criações via API (Typebot/n8n), que não informam origem própria.
* Agendamentos criados pelo chatbot **antes** desta funcionalidade aparecem como Manual.
* Datas respeitam o **fuso do tenant** — o agrupamento por dia usa a data local, não UTC.

***

### Mensagens e erros

* Sem dados no filtro → cards zerados e gráficos vazios.
* Falha de carregamento → notificação de erro; tente novamente.
* Exportar fica desabilitado quando não há linhas.
