Gerenciamento de faturas

A tela de Faturas (em /financeiro/faturas) concentra a cobrança das sessões: você gera as faturas do mês, acompanha o status de pagamento, recalcula valores quando algo muda na agenda, envia para o paciente e exporta tudo em PDF ou ZIP.

Visão geral da tela

No topo da página você encontra:

• Cartões de resumo: Vencidas, Vencem em 3 dias, Em aberto total e Recebido no mês selecionado, com o valor em R$ e a contagem de faturas.
• Aviso de inadimplência: quando há faturas vencidas, aparece uma faixa vermelha com o total em atraso e o botão Ver só vencidas.
• Barra de filtros: busca por paciente ou responsável, filtro por profissional (apenas para administradores), filtros de Status, NFS-e (Com / Sem) e Ordem (Nome ou Dia da semana).
• Tabela de faturas: uma linha por fatura (ou por grupo de sessões), com paciente, sessões, total, status, NF, vencimento, pagamento e ações.

O período (mês/ano) é controlado pelo seletor do módulo financeiro. Quando nenhum mês está selecionado, a lista mostra o ano inteiro — mas algumas ações (gerar, exportar) exigem um mês específico.

Gerar faturas do mês

A geração cria (ou atualiza) automaticamente uma fatura para cada paciente com agendamentos no mês de referência.

Apenas agendamentos do tipo consulta e reunião entram na fatura. O que o sistema faz por trás:

• Não cria fatura vazia: pacientes sem sessões cobráveis no mês são ignorados (contam como "mantidas").
• Não cobra duas vezes: agendamentos já incluídos em outra fatura são automaticamente excluídos.
• Respeita faturas já em andamento: uma fatura existente com status Pago, Enviado ou Parcial nunca é sobrescrita (conta como "mantida").
• Sessões de meses anteriores ainda não faturadas são puxadas para a fatura do mês atual.
• Créditos de sessão disponíveis (por exemplo, de uma falta com aviso prévio) são aplicados como desconto — desde que tenham origem em um mês anterior ao da fatura.
• Congela a regra de repasse: ao nascer, a fatura guarda o percentual de repasse do profissional que leva cada linha e o percentual de imposto da clínica naquele momento. Se você alterar esses percentuais depois, as faturas já criadas continuam com a regra da época — a mudança vale só para as próximas. O mesmo congelamento vale para itens lançados à mão numa fatura existente e para as faturas avulsas (por sessão): a linha nasce com o percentual vigente no momento em que é criada.

Criar fatura manual (Nova fatura)

Para cobrar algo fora do fluxo mensal — uma sessão avulsa, um relatório, uma avaliação — use Nova fatura, no canto superior direito.

Você é levado para a página da fatura recém-criada. Faturas manuais entram com status Pendente (ou Pago, se você marcou a opção). Como qualquer fatura nova, ela também congela o percentual de repasse do profissional responsável e o imposto da clínica — o mesmo vale para itens avulsos adicionados depois dentro da fatura.

Status das faturas

Toda fatura passa por um destes status:

Como mudar o status:

• Marcar como pago: na coluna Pagamento, clique no botão verde Pagar. Funciona para faturas Pendente, Enviado ou Parcial.
• Marcar pendentes como enviadas (em lote): menu Mais ações → Marcar pendentes como enviadas. Percorre as faturas pendentes visíveis e muda todas para Enviado.
• Trocar manualmente: abra a fatura (ícone de lápis) e use o seletor de status no cabeçalho.

Editar uma fatura

Clique no ícone de lápis (Editar fatura) na linha, ou no ícone de olho (Ver detalhes) para o modal rápido. Na página de edição você pode:

• Alterar o status e o vencimento (clique na data para editar).
• Editar a mensagem da fatura, ver o resumo (Total, Sessões, Créditos, Extras) e os pagamentos conciliados.
• Editar itens (quando a fatura está editável): mudar a descrição, a quantidade e o valor de cada item, ou remover itens. Ao remover um item de crédito, o crédito de sessão correspondente é liberado para reuso.
• Adicionar item manual: pelo botão + Adicionar item manual é possível incluir itens do tipo Sessão Extra, Reunião Escola ou Crédito (desconto).
• Registrar observações internas.
• Re-vincular itens sem data: se a fatura tiver itens órfãos (sem agendamento associado), aparece o botão Re-vincular N itens sem data, que tenta reconectá-los aos agendamentos do mês.

Recalcular

O recálculo regenera os itens automáticos de uma fatura com base no estado atual da agenda — útil quando você adicionou, removeu ou reagendou sessões depois de gerar a fatura.

• Uma fatura: clique no ícone de atualizar (Recalcular fatura) na linha, ou no botão Recalcular dentro da fatura.
• Um grupo de sessões: no cabeçalho de um grupo (faturas por sessão), clique no ícone de atualizar (Recalcular todas as sessões).

O que o recálculo preserva e regenera:

• Mantém itens manuais e observações que você adicionou.
• Regenera os itens automáticos de sessões e reaplica os créditos disponíveis.
• Atualiza o vencimento conforme o dia de vencimento do paciente/clínica.
• Recalcula totais (valor, número de sessões, créditos, extras).
• Reprecifica cada sessão pela ordem de preço atual (valor da sessão → preço do paciente no serviço → valor padrão do serviço → valor de sessão do cadastro) e atualiza o serviço e a isenção de imposto gravados no item. É a forma de fazer valer a correção do serviço de uma sessão já faturada: antes o recálculo corrigia o valor e deixava a isenção antiga, o que mantinha o repasse errado.
• Não mexe na regra de repasse congelada. Nem o imposto da fatura, nem o percentual de repasse dos itens: cada linha regerada herda o percentual congelado da linha equivalente que ela substitui (o casamento é pelo agendamento da sessão e, nas linhas sem agendamento, pelo tipo e descrição). Só uma linha genuinamente nova — uma sessão que ainda não estava na fatura — congela o percentual vigente hoje. Assim, recalcular a fatura de março de uma profissional que passou de 60% para 70% em maio não faz março passar a dever a diferença.

Enviar para o paciente

O botão Enviar WhatsApp foi removido. Ele registrava o envio e avisava "Fatura enviada via WhatsApp", mas nenhuma mensagem saía — não há provedor de WhatsApp ligado. Voltará quando o envio por WhatsApp for ativado de verdade.

Hoje há dois caminhos para entregar a fatura ao paciente:

• Cobrar — gera o link de pagamento e o envia por e-mail. É o caminho recomendado, porque o pagamento volta conciliado sozinho. Veja Cobrança com Stripe.
• Copiar a mensagem da fatura e mandar você mesmo, pelo canal que preferir.

A mensagem usa o modelo de fatura do paciente, ou o da clínica, ou o modelo padrão — com o nome do paciente, valor, vencimento, número de sessões e o detalhamento dos itens. Ela continua sendo gerada normalmente; só o envio automático por WhatsApp é que não existe.

Se a mensagem estiver vazia, recalcule ou regenere a fatura.

Cancelar e excluir

• Cancelar: troque o status da fatura para Cancelado. Ela sai dos totais em aberto e cobranças abertas são expiradas.
• Excluir: na página da fatura, Excluir Fatura. A exclusão é permanente; os créditos consumidos pela fatura são liberados de volta.

PDF e ZIP

Cada fatura tem o seu PDF, e há exportações em lote para fechar o mês.

O cabeçalho do PDF

O topo do relatório traz o logo da sua clínica, quando houver um enviado em Dados da clínica (ou na tela final do assistente de configuração inicial). Sem logo, o cabeçalho sai com o selo do sistema ao lado do nome da sua clínica — o documento nunca leva a marca de outra clínica. Abaixo do logo aparecem o telefone, o e-mail e o endereço que estiverem cadastrados.

O logo é encaixado num espaço de tamanho fixo, seja qual for a proporção do arquivo enviado: uma imagem alta é reduzida para caber, sem esticar e sem empurrar o resto do relatório para baixo. Para o melhor resultado, use uma imagem mais larga do que alta.

PDF individual

• Na linha da fatura, clique no ícone de download (Baixar PDF).
• Dentro da fatura, use o botão Baixar PDF.

PDF de um grupo

No cabeçalho de um grupo de sessões, o ícone de download (Baixar PDF do grupo) gera um único PDF com uma página por sessão, ordenadas por vencimento.

Exportações em ZIP

O menu Exportar (exige um mês selecionado e ao menos uma fatura) reúne:

Os arquivos do ZIP de relatórios são nomeados por mês, primeiro nome do profissional e nome do paciente (ex.: Jun-Ana-Joao-Silva.pdf).

Os dois pacotes de NFS-e trazem uma contagem antes de baixar e marcam cada nota como baixada só depois que o arquivo chega ao seu navegador — assim o download do dia 10 não repete as notas do dia 05. O detalhe de cada recorte está em Emissão de NFS-e.

Agrupamento

A forma como as faturas aparecem na tabela depende do agrupamento configurado (na clínica ou por paciente):

• Mensal (consolidado): uma fatura por paciente no mês, somando todas as sessões. Aparece como uma linha na tabela.
• Por sessão: uma fatura para cada sessão. Na tabela elas aparecem agrupadas por paciente numa linha-resumo recolhível — clique para expandir e ver cada sessão individual. O status mostrado no grupo é derivado das faturas: se há pagas e não pagas juntas, o grupo fica Parcial.

Além disso, há o desdobramento por profissional: se o paciente é atendido por mais de um profissional e está marcado para dividir a fatura, cada profissional recebe a sua própria fatura. Caso contrário, tudo é consolidado sob o profissional de referência do paciente.

Quando as sessões da fatura foram feitas por outro profissional que não o técnico de referência — a psicopedagoga atendendo um paciente cuja referência é a psicóloga —, a fatura continua no nome do técnico de referência e o documento ganha a linha "Atendido por <nome>" acima das sessões. Vale no PDF e na tela da fatura, e é a mesma leitura que uma sessão de grupo conduzida por outro profissional já dava. Com dois ou mais profissionais na mesma fatura, cada um ganha a sua seção "Atendido por".

Quem pode acessar

O módulo exige a permissão de finanças. Quem tem acesso de leitura vê e exporta; quem tem acesso de escrita gera, edita, recalcula, envia e cancela. Profissionais (não administradores) veem e operam apenas as próprias faturas; administradores enxergam a clínica inteira e podem filtrar por profissional.