{"v":{"area":"admin","slug":"faturamento-manual","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/faturamento-manual.md","relative_path":"docs/readme/admin/faturamento-manual.md","title":"Faturamento Manual","html":"<h1>Faturamento Manual</h1><h2>Rota</h2><ul><li><code>/adm/faturamento-manual</code></li><li><code>/empresa/faturamento-manual</code></li><li><code>/unidade/faturamento-manual</code></li></ul><h2>O que e</h2><p>Tela operacional para criar pedido financeiro avulso por paciente e, quando necessario, emitir a fatura na mesma jornada.</p><h2>Para que serve</h2><ul><li>abrir um pedido manual sem depender de agendamento;</li><li>registrar itens avulsos de servico, procedimento, produto, plano, taxa ou desconto;</li><li>emitir a fatura logo apos a criacao do pedido;</li><li>gerar cobranca de PIX ou boleto sem sair da tela quando o metodo permitir.</li></ul><h2>Blocos principais</h2><ul><li>card de contexto do paciente com carga por <code>patient_id</code>;</li><li>card de itens do pedido com montagem manual e totalizador;</li><li>card de fatura e cobranca com metodo, vencimento e provider opcionais;</li><li>card de resultado com IDs criados e atalhos de continuidade.</li></ul><h2>Botoes do topo</h2><ul><li><code>Voltar</code>: retorna ao detalhe do paciente quando a tela foi aberta com <code>patient_id</code>, ou para a lista de pacientes no fallback.</li></ul><h2>Acoes da tela</h2><ul><li><code>Buscar paciente</code>: carrega nome e e-mail a partir do ID informado;</li><li><code>Adicionar item</code>: inclui mais uma linha financeira no pedido;</li><li><code>Criar pedido e seguir no financeiro</code>: cria o pedido, emite a fatura se marcado e pode gerar a cobranca na sequencia;</li><li><code>Limpar</code>: reinicia os itens e limpa o resultado atual.</li></ul><h2>Observacoes</h2><ul><li>a tela usa os endpoints <code>/adm/api/Orders/create</code>, <code>/adm/api/Orders/issueInvoice</code> e <code>/adm/api/Invoices/chargeNow</code>;</li><li>o mesmo motor da pagina e reutilizado nas rotas de empresa e unidade;</li><li>para cartao, a tela cria pedido e fatura, mas a cobranca imediata fica desabilitada nesta primeira versao;</li><li>a entrada mais natural para o fluxo fica no detalhe do paciente e no detalhe de cliente do admin.</li></ul><h2>Acesso e permissoes</h2><ul><li>o botao tecnico <code>#permInspectorToggle</code> ajuda a conferir se a rota esta cadastrada em <code>telas</code>, <code>perm_tela_namespace</code> e kits;</li><li><code>/adm/faturamento-manual</code> fica registrada com o namespace <code>admin.faturamento-manual</code> e permissao legada <code>admin.faturamento_manual.view</code>;</li><li><code>/empresa/faturamento-manual</code> fica vinculada ao namespace <code>empresa.faturamento_manual</code> e liberada pelo <code>kit.empresa</code>;</li><li><code>/unidade/faturamento-manual</code> fica vinculada ao namespace <code>unidade.faturamento_manual</code> e liberada pelo <code>kit.assistente</code>;</li><li>as rotas de <code>empresa</code> e <code>unidade</code> tambem ficam mapeadas em <code>perm_tela_kit_map</code>, mantendo o mesmo padrao de compatibilidade usado nas demais telas TIIX Health;</li><li>os mapeamentos sao aplicados pela migration <code>sql/2026-04-17-faturamento-manual-acl-tiix-health.sql</code>.</li></ul>"},"exp":1780849740}