# Faturamento Manual

## Rota

- `/adm/faturamento-manual`
- `/empresa/faturamento-manual`
- `/unidade/faturamento-manual`

## O que e

Tela operacional para criar pedido financeiro avulso por paciente e, quando necessario, emitir a fatura na mesma jornada.

## Para que serve

- abrir um pedido manual sem depender de agendamento;
- registrar itens avulsos de servico, procedimento, produto, plano, taxa ou desconto;
- emitir a fatura logo apos a criacao do pedido;
- gerar cobranca de PIX ou boleto sem sair da tela quando o metodo permitir.

## Blocos principais

- card de contexto do paciente com carga por `patient_id`;
- card de itens do pedido com montagem manual e totalizador;
- card de fatura e cobranca com metodo, vencimento e provider opcionais;
- card de resultado com IDs criados e atalhos de continuidade.

## Botoes do topo

- `Voltar`: retorna ao detalhe do paciente quando a tela foi aberta com `patient_id`, ou para a lista de pacientes no fallback.

## Acoes da tela

- `Buscar paciente`: carrega nome e e-mail a partir do ID informado;
- `Adicionar item`: inclui mais uma linha financeira no pedido;
- `Criar pedido e seguir no financeiro`: cria o pedido, emite a fatura se marcado e pode gerar a cobranca na sequencia;
- `Limpar`: reinicia os itens e limpa o resultado atual.

## Observacoes

- a tela usa os endpoints `/adm/api/Orders/create`, `/adm/api/Orders/issueInvoice` e `/adm/api/Invoices/chargeNow`;
- o mesmo motor da pagina e reutilizado nas rotas de empresa e unidade;
- para cartao, a tela cria pedido e fatura, mas a cobranca imediata fica desabilitada nesta primeira versao;
- a entrada mais natural para o fluxo fica no detalhe do paciente e no detalhe de cliente do admin.

## Acesso e permissoes

- o botao tecnico `#permInspectorToggle` ajuda a conferir se a rota esta cadastrada em `telas`, `perm_tela_namespace` e kits;
- `/adm/faturamento-manual` fica registrada com o namespace `admin.faturamento-manual` e permissao legada `admin.faturamento_manual.view`;
- `/empresa/faturamento-manual` fica vinculada ao namespace `empresa.faturamento_manual` e liberada pelo `kit.empresa`;
- `/unidade/faturamento-manual` fica vinculada ao namespace `unidade.faturamento_manual` e liberada pelo `kit.assistente`;
- as rotas de `empresa` e `unidade` tambem ficam mapeadas em `perm_tela_kit_map`, mantendo o mesmo padrao de compatibilidade usado nas demais telas TIIX Health;
- os mapeamentos sao aplicados pela migration `sql/2026-04-17-faturamento-manual-acl-tiix-health.sql`.