Faturação da consulta

Para que serve

Este módulo trata do dinheiro de uma consulta. Tem duas formas de cobrar, que servem situações diferentes:

	Nota de pagamento	Fatura
O que é	Documento não fiscal, gerado automaticamente	Documento com várias linhas, feito à mão
Como se cria	Um clique. O sistema usa o procedimento da consulta e o preço de tabela	A receção escreve as linhas que quiser
Linhas	Uma só (o procedimento da consulta)	Várias (consulta, exames, materiais, texto livre)
Desconto / imposto	Não	Sim
Referência Multicaixa	Sim	Sim
Quando usar	Consulta simples, preço de tabela	Contas com vários itens, descontos ou impostos

Ambas partilham a mesma numeração, o mesmo recibo em PDF e a mesma referência Multicaixa.

Quando usar

• No fim da consulta, quando o paciente vai pagar ao balcão.
• Quando o paciente quer levar uma referência para pagar mais tarde no ATM.
• Quando é preciso cobrar mais do que a consulta (exames, materiais).
• Quando é preciso aplicar um desconto.
• Quando o paciente paga e é preciso registar o pagamento.
• Para reimprimir um recibo que o paciente perdeu.

Quem pode usar

Este módulo não tem entrada no menu. Chega-se sempre pela Agenda.

Ação	Permissão	Perfis que têm
Ver faturas	view-invoices	admin, superadmin, receção
Gerar/ver nota de pagamento e o seu PDF	view-invoices	admin, superadmin, receção
Criar e alterar faturas	manage-billing	admin, superadmin, receção
Marcar como paga	manage-billing	admin, superadmin, receção
Gerar referência Multicaixa	manage-billing	admin, superadmin, receção
Cancelar fatura	manage-billing	admin, superadmin, receção

Médicos, enfermeiros e laboratório não têm estas permissões. Se abrirem as opções de faturação, recebem um erro de acesso.

As referências Multicaixa dependem do plano contratado (a partir do plano Intermediário). Sem o plano, tudo o resto funciona — só não há referência.

Ecrãs e funcionalidades

Como chegar

1. Vá a Agenda → Calendario.
2. Clique no agendamento do paciente.
3. Na janela Informações do paciente, clique em Mais opções.
4. Escolha Nota de pagamento ou Faturação.

[CAPTURA: menu "Mais opções" aberto, com as entradas "Nota de pagamento" e "Faturação" destacadas]

1. Janela "Nota de pagamento"

[CAPTURA: janela Nota de pagamento com o número NP2026/12, a etiqueta Pendente e o bloco azul da referência Multicaixa]

A nota é gerada assim que abre a janela. Não há botão de criar.

Mostra:

• A etiqueta Nota de pagamento e o número (por exemplo, NP2026/12).
• Uma etiqueta de estado: Pendente, Paga, Cancelada ou Expirada.
• O bloco Pagamento por referência Multicaixa, com quatro dados: Entidade, Referência, Montante e Validade.
• A frase "Pague em qualquer ATM Multicaixa, Multicaixa Express ou Internet Banking."
• Botão Descarregar PDF.

A referência aparece em grupos de três dígitos (ex.: 123 456 789), e o montante no formato angolano (ex.: 1.500,00 Kz).

É idempotente: se abrir a janela outra vez para a mesma consulta, aparece sempre a mesma nota. Nunca são criadas notas duplicadas.

2. Janela "Faturação"

[CAPTURA: janela Faturação com uma fatura já emitida em cima e o construtor de nova fatura aberto em baixo]

Divide-se em duas partes.

Parte de cima — faturas existentes

Para cada fatura ligada a esta consulta (ou a este paciente):

• Número da fatura, etiqueta de estado e valor total.
• Se tiver referência: "Multicaixa · Entidade 00000 · Ref. 123456789".
• Botões: Recibo PDF, Marcar paga… e Referência Multicaixa.

Parte de baixo — criar fatura

Botão Nova fatura. Ao clicar abre o construtor, com:

• Uma tabela de linhas, com as colunas Descrição, Qtd. e Preço.
• Debaixo de cada linha, a lista — ou escolher procedimento —.
• Ligação adicionar linha.
• Campos Desconto e Imposto.
• O resumo: Subtotal, Desconto, Imposto e Total.
• Botões Cancelar e Emitir fatura.

Cada botão, o que faz

Na janela "Nota de pagamento"

Botão	O que faz
Descarregar PDF	Abre o recibo em PDF numa nova janela, com a marca da clínica

Na janela "Faturação"

Botão	O que faz	Condição
Recibo PDF	Abre o recibo em PDF	Sempre disponível
Marcar paga…	Lista de métodos de pagamento. Ao escolher um, a fatura fica Paga	Só em faturas não pagas e não canceladas
Referência Multicaixa	Gera (ou renova) a referência para pagamento em ATM	Só em faturas Pendentes ou Expiradas
Nova fatura	Abre o construtor de faturas	—
adicionar linha	Acrescenta mais uma linha à fatura	—
X (no fim de uma linha)	Apaga essa linha	Só aparece se houver mais de uma linha
Cancelar	Fecha o construtor e limpa tudo	—
Emitir fatura	Cria a fatura. Fica Pendente	Cinzento enquanto o subtotal for zero

Importante: ao marcar uma fatura como paga com um método de pagamento do tipo numerário (dinheiro), o valor entra automaticamente no caixa aberto. Confirme sempre que escolhe o método certo.

Cada campo do formulário

Construtor de faturas

Por cada linha:

Campo	Obrigatório	Regras
Descrição	Sim, se não escolher procedimento	Texto, até 255 caracteres
Qtd.	Não	Número inteiro, mínimo 1. Por omissão, 1
Preço	Não	Número, mínimo 0. Por omissão, 0
— ou escolher procedimento —	Não	Ao escolher, a Descrição e o Preço preenchem-se sozinhos com o nome e o preço de tabela

Da fatura inteira:

Campo	Obrigatório	Regras
Desconto	Não	Número, mínimo 0
Imposto	Não	Número, mínimo 0

Regras importantes:

• A fatura tem de ter pelo menos uma linha.
• Linhas completamente vazias (sem descrição e sem procedimento) são ignoradas — não é preciso apagá-las.
• O total calcula-se assim: Total = Subtotal − Desconto + Imposto (nunca abaixo de zero).
• Subtotal = soma de (Qtd. × Preço) de cada linha.

Estados de uma fatura ou nota

Estado	O que significa
Pendente	Emitida, ainda não paga
Paga	O pagamento foi registado
Cancelada	Anulada. Não conta para nada
Expirada	A referência Multicaixa passou do prazo

Numeração

Os números são atribuídos automaticamente, no formato NP{ano}/{número}: NP2026/1, NP2026/2, NP2026/3… A sequência recomeça em cada ano. Um número já emitido nunca é reutilizado, mesmo que o documento seja apagado.

Exemplo prático

Situação: a Sra. Ana Ferreira acabou a consulta. Além da consulta (8.000,00 Kz), fez um exsudado faríngeo no laboratório (3.500,00 Kz). A clínica dá 10% de desconto a funcionários públicos, o que dá 1.150,00 Kz. A Sra. Ana vai pagar em dinheiro. Quem atende é a rececionista Marta.

1. A Marta vai a Agenda → Calendario e clica no agendamento das 09:00 da Sra. Ana.
2. Clica em Mais opções e escolhe Faturação.
3. Não há faturas ainda. Clica em Nova fatura.
4. Na primeira linha, na lista — ou escolher procedimento —, escolhe Consulta de Clínica Geral (8.000,00 Kz). A Descrição e o Preço preenchem-se sozinhos. Deixa Qtd. a 1.
5. Clica em adicionar linha.
6. Na segunda linha, escreve na Descrição Exsudado faríngeo, deixa Qtd. a 1 e escreve 3500 no Preço.
7. No campo Desconto escreve 1150. Deixa Imposto a 0.
8. Confere o resumo:
   • Subtotal 11.500,00 Kz
   • Desconto − 1.150,00 Kz
   • Total 10.350,00 Kz
9. Clica em Emitir fatura.
10. A fatura aparece na lista, com o número NP2026/13 e a etiqueta Pendente.
11. A Sra. Ana paga em dinheiro. A Marta abre a lista Marcar paga… e escolhe Dinheiro.
12. A etiqueta passa a Paga, e o valor entra no caixa aberto.
13. A Marta clica em Recibo PDF e imprime o recibo para a Sra. Ana.

Variante — a paciente quer pagar mais tarde no ATM:

11b. Em vez de marcar como paga, a Marta clica em Referência Multicaixa. 12b. A fatura passa a mostrar "Multicaixa · Entidade 00000 · Ref. 123456789". 13b. A Marta imprime o Recibo PDF, onde vem a referência, e entrega-o à Sra. Ana.

Fluxo completo

CONSULTA SIMPLES, PREÇO DE TABELA
  1. Agenda → clicar no agendamento
  2. Mais opções → Nota de pagamento
  3. A nota é gerada automaticamente (com referência, se o plano permitir)
  4. Descarregar PDF → imprimir e entregar

CONTA COM VÁRIOS ITENS OU DESCONTO
  1. Agenda → clicar no agendamento
  2. Mais opções → Faturação
  3. Nova fatura
  4. Preencher linha a linha (ou escolher procedimentos)
  5. adicionar linha, tantas vezes quantas precisar
  6. Preencher Desconto / Imposto, se houver
  7. Conferir Subtotal / Desconto / Imposto / Total
  8. Emitir fatura                    → estado: Pendente

COBRANÇA
  9a. Paga ao balcão → Marcar paga… → escolher o método
      (se for dinheiro, entra no caixa aberto)
  9b. Paga mais tarde → Referência Multicaixa → imprimir o recibo

SEMPRE
 10. Recibo PDF → imprimir e entregar ao paciente

Erros comuns e como resolver

O que vê	Porquê	O que fazer
"A consulta não tem procedimento associado — associe um procedimento antes de gerar a nota de pagamento."	O agendamento foi criado sem procedimento	Feche a janela, clique em Detalhes no agendamento e escolha um Procedimento. Depois volte a abrir a nota
"O procedimento não tem preço definido — defina o preço antes de gerar a nota de pagamento."	O procedimento existe mas está sem preço de tabela	Peça ao administrador para definir o preço do procedimento. Em alternativa, use Faturação e escreva o valor à mão
"Consulta não encontrada."	A consulta indicada não existe	Confirme que clicou no agendamento certo
"Consulta não encontrada para este agendamento."	O agendamento não tem consulta associada	Ao marcar, ligue sempre o interruptor Esta marcação é uma consulta (ver Agenda). Em alternativa, use Faturação, que não precisa de consulta
"Não foi possível gerar a nota de pagamento."	Erro inesperado	Tente novamente. Se persistir, contacte o suporte
Bloco amarelo "Referência Multicaixa indisponível"	As referências Multicaixa não estão incluídas no plano da clínica	A nota é criada na mesma, só sem referência. Cobre ao balcão, ou fale com o administrador sobre o plano
"As referências Multicaixa não estão incluídas no plano (a partir do Intermediário)."	Igual à anterior, ao clicar no botão na Faturação	Fale com o administrador
"Só faturas pendentes/expiradas geram referência."	Tentou gerar referência para uma fatura já paga ou cancelada	Não é necessário: a fatura já está resolvida
"Não foi possível gerar a referência Multicaixa." ou "…Tente novamente dentro de instantes."	O serviço externo de referências não respondeu	Aguarde um pouco e tente de novo. Entretanto, cobre por outro meio
Aviso "Referência de teste — não é pagável num ATM real."	O sistema está em modo de testes, sem ligação real ao serviço de pagamentos	Não entregue esta referência ao paciente. Avise o administrador
"Uma fatura paga não pode ser editada."	Tentou alterar uma fatura já paga	Não é possível corrigir. Cancele e emita uma nova
O botão Emitir fatura está cinzento	O subtotal é zero: todas as linhas estão sem preço ou sem quantidade	Preencha o Preço de pelo menos uma linha
"Não foi possível guardar a fatura."	Um campo não passou na validação	Confirme que há pelo menos uma linha com descrição ou procedimento, e que quantidades e preços não são negativos
"Operação falhou."	Erro genérico ao marcar como paga, gerar referência ou cancelar	Tente novamente. Se persistir, contacte o suporte
Não vejo Marcar paga… nem Referência Multicaixa	A fatura já está Paga ou Cancelada	Não há nada a fazer nessa fatura
A lista Marcar paga… está vazia	Não há métodos de pagamento configurados na clínica	Peça ao administrador para os criar em Administração → Cadastros
Erro de acesso ao abrir Faturação ou Nota de pagamento	O seu perfil não tem view-invoices / manage-billing	Peça à receção. Médicos e enfermeiros não faturam

Dicas e boas práticas

• Comece pela Nota de pagamento. Para a consulta normal, com preço de tabela, é um clique e está feito.
• Use a Faturação quando houver mais do que a consulta, ou quando houver desconto.
• Escolha o procedimento da lista em vez de escrever a descrição à mão. O preço vem certo da tabela e evita enganos.
• Confirme sempre o Total antes de clicar em Emitir fatura. Depois de paga, a fatura não pode ser alterada.
• Escolha o método de pagamento correto. Se marcar dinheiro, o valor entra no caixa; se o pagamento foi por outro meio, o caixa fica errado ao fecho.
• Entregue sempre o recibo em PDF ao paciente, mesmo quando paga em dinheiro.
• Se o paciente vai pagar mais tarde, gere a Referência Multicaixa e imprima o recibo — a referência vem lá.
• Se uma referência expirar, volte a clicar em Referência Multicaixa: é emitida uma nova e a fatura volta a Pendente.
• Ao marcar a consulta na Agenda, ligue sempre o interruptor "Esta marcação é uma consulta" e preencha o Procedimento. Sem isso, a nota de pagamento automática não funciona.

Por confirmar

• Cancelar uma fatura. Existe a operação no servidor (/faturas/{id}/cancelar), mas não foi encontrado nenhum botão que a execute no ecrã de Faturação. Não foi possível confirmar como se cancela uma fatura pela interface.
• Editar uma fatura pendente. Existe a operação no servidor (substituir linhas, desconto, imposto e notas), mas também não foi encontrado nenhum botão para a executar. O que se confirmou é que uma fatura paga não pode ser editada.
• Campo "Notas" da fatura. O servidor aceita um campo de notas, mas o ecrã de Faturação não o mostra.
• Lista de faturas por paciente. A janela de Faturação, aberta a partir de um agendamento, mostra as faturas desse agendamento. Não foi confirmado onde se vê a lista completa de faturas de um paciente ou da clínica; o módulo não tem entrada no menu.
• Métodos de pagamento. A lista vem dos cadastros da clínica. Não foi documentado o ecrã onde se criam nem como se marca um método como "numerário".
• Ligação ao caixa. Confirmou-se que um pagamento em numerário entra no caixa aberto. Não se documentou o que acontece se não houver caixa aberto no momento.
• Faturação a convénios. Existe um módulo separado, no menu Financeiro (Faturação convénio, Remessas, Recebimentos, Tabela de preços, Glosas). Não faz parte deste capítulo.
• Validade da referência Multicaixa. O campo Validade aparece no ecrã, mas não foi possível confirmar o prazo utilizado.