Manual Geral VASI
Guia operacional com telas ficticias, rotinas por modulo, conferencias de seguranca e explicacoes para usuarios, suporte, consultores e administradores.
Como usar este manual
Este manual explica o VASI por processo. Ele nao substitui regra interna da empresa, mas ajuda o usuario a entender onde clicar, o que conferir e quando pedir permissao ou suporte.
Usuarios novos
Comecem por Portal, modulo desejado e Central de Ajuda. Usem este manual para entender o fluxo completo.
Supervisores
Usem os checklists para validar cadastros, financeiro, producao, agenda, ponto e contratos.
Suporte
Peçam sempre empresa, usuario, modulo, tela, horario do erro e acao que o usuario tentou executar.
Administradores
Revisem permissoes, backups, logs, parametros e cadastros mestres antes de liberar operacao.
Perfis de usuario e responsabilidades
Operacional
- Usa apenas modulos liberados.
- Cadastra rotinas do dia.
- Nao altera parametros criticos.
Supervisor
- Confere lancamentos e excecoes.
- Acompanha produtividade e relatorios.
- Aprova ajustes quando permitido.
Administrador
- Gerencia usuarios, empresas e permissoes.
- Configura modulos e parametros.
- Cuida de backup, logs e auditoria.
Suporte / consultor
- Orienta uso correto.
- Investiga erros com dados objetivos.
- Valida conhecimento do Assistente VASI.
Portal e navegacao
O Portal mostra os modulos liberados para a empresa e para o usuario logado. Use-o como ponto de partida quando nao souber onde uma rotina fica.
- Confira a empresa no topo da tela.
- Pesquise pelo nome do processo: venda, paciente, contrato, ponto, ERP ou backup.
- Abra o card do modulo desejado.
- Use as abas internas para chegar ao processo correto.
Financeiro, Fluxo de Caixa e DRE
Controle receitas, despesas, vencimentos, anexos, fluxo previsto/realizado e demonstrativo gerencial.
- Em Lancamentos, escolha receita ou despesa.
- Preencha descricao, valor, vencimento, categoria, status, forma de pagamento e anexos.
- Use Fluxo de Caixa para comparar entradas, saidas e saldo acumulado.
- Use DRE para analisar resultado por periodo.
- Revise categorias para melhorar relatórios e leitura gerencial.
Vendas, pedidos e VASI Commerce
O Commerce cobre venda de balcao, pedidos sob encomenda, sinal, producao, lista de compras, estoque, financeiro comercial, fiscal, XML e WhatsApp.
- Use Nova venda para venda imediata.
- Use Pedidos para encomendas com data futura, sinal e saldo.
- Acompanhe Producao para saber o que esta atrasado, liberado, pronto ou entregue.
- Use Lista de compras e Estoque antes de confirmar producao.
- No fechamento mensal, confira fiscal e exporte XML.
Manual especifico: Manual VASI Commerce com 19 telas ficticias.
VASI Contabil
Organize competencias, movimentacoes, documentos, extratos, conferencias e auditoria com isolamento por empresa.
- Defina em Configuracoes se vendas sem nota fiscal entram na importacao comercial.
- Anexe XML, PDF, imagem, TXT ou CSV e revise os campos extraidos automaticamente.
- Confirme os dados antes da contabilizacao e conclua a conferencia da competencia.
CRM e relacionamento
Use o CRM para contatos, oportunidades, funil, follow-up, historico do cliente e mensagens.
- Cadastre contatos com origem, telefone, email e observacoes.
- Crie oportunidades com etapa, valor estimado, responsavel e previsao.
- Use WhatsApp apenas com revisao da mensagem.
- Consulte historico antes de abordar cliente antigo.
PEP, evolucoes, agenda e GED
O Prontuario Eletronico organiza paciente, evolucoes, agenda, documentos, procedimentos, producao assistencial e indicadores.
- Pesquise o paciente antes de cadastrar.
- Preencha dados pessoais, contato, responsavel e observacoes.
- Registre evolucao com resumo, conduta, orientacoes e profissional.
- Use agenda para sessoes futuras e GED para documentos.
- Cadastros assistenciais alimentam faturamento e TISS.
Faturamento PEP, Convenios e TISS
Use esta area para faturar producoes assistenciais, validar guias, criar lotes, registrar retornos e acompanhar glosas.
- Confira producoes pendentes por periodo, paciente, profissional e procedimento.
- Gere faturamento apenas depois de revisar valores, convenio e competencia.
- Cadastre convenio, beneficiario, profissional e procedimento antes de gerar guia.
- Valide inconsistencias antes de faturar ou exportar lote TISS.
- Registre retorno e glosa para manter rastreabilidade.
Contratos e ficha cadastral
O modulo acompanha o ciclo contratual desde rascunho ate ativo, incluindo modelos, ficha cadastral, aprovacao e assinatura futura.
- Crie contrato com dados do contratante, objeto, servico, valor, vigencia e responsaveis.
- Use modelos para padronizar clausulas.
- Gere link de ficha quando o cliente precisa preencher dados externos.
- Avance status apenas apos revisao.
Gestao de Jornada e Controle de Ponto
Controle cargos, jornadas, escalas, batidas, apuracao, banco de horas, faltas, ferias, afastamentos e fechamento.
- Configure parametros antes de apurar.
- Cadastre jornada e escala do colaborador.
- Analise ocorrencias, atrasos, faltas e banco.
- Aprove ajustes e abonos com justificativa.
- Feche o periodo apenas apos conferencia.
Suprimentos, estoque e compras
Controle produtos, fornecedores, locais de estoque, movimentacoes, pedidos de compra e recebimentos.
- Cadastre produtos com unidade, custo, estoque minimo e categoria.
- Registre entradas, saidas e ajustes com motivo.
- Use pedidos de compra para formalizar compras e recebimentos.
- Confira estoque antes de vendas e producoes.
Conversor Inteligente de PDF e CBHPM
O Conversor PDF prepara a leitura de tabelas enviadas pela empresa, com modo especializado para CBHPM e modo padrao para transformar tabelas comuns em planilhas.
- Selecione CBHPM / tabela hospitalar para CBHPM completa, com valores, resumida, convenio, tabela propria, hospitalar adaptada ou layouts SulAmerica.
- Selecione Padrao - tabelas para XLSX para converter tabelas de PDF digital, TXT, CSV, XLSX, DOCX ou PPTX sem aplicar regras CBHPM.
- No modo CBHPM, confira colunas detectadas, ordem, regras de cabecalho, descricoes quebradas, rodapes e capitulos/grupos.
- Registre amostras revisadas para melhorar a confianca media do perfil CBHPM.
- Mantenha codigos como texto, preserve a extracao original e use abas separadas quando o arquivo tiver tabelas distintas.
- Quando a confianca for baixa, revise manualmente antes da conversao final.
Assistente Inteligente VASI
Use o Assistente VASI para orientacao, suporte, treinamento, textos, SQL consultivo e perguntas tecnicas por especialidade.
- Use especialidade Automatico para roteamento inteligente.
- Escolha SPData, CRM, Vendas, PEP, Contratos, Ponto ou Suporte quando souber o contexto.
- Copie respostas, SQLs ou textos gerados e revise antes de usar.
- Marque resposta como util ou nao util.
- Administradores podem validar conhecimento oficial.
Dados ERP, SPData e dashboards
Consulte indicadores importados do SPData, status de coleta, dicionario tecnico e informacoes hospitalares. O Centro de Inteligencia acrescenta analises executivas sem substituir os paineis tradicionais.
- Confira configuracao do cliente e status do conector.
- Solicite atualizacao manual quando necessario.
- Use Centro de Inteligencia para prioridades, riscos financeiros, projecoes e indicadores operacionais rastreaveis.
- Use visao geral para internacoes, atendimentos, faturamento, glosas e permanencia.
- Use dicionario SPData para tabelas, campos, relacoes e consultas tecnicas.
Inteligencia operacional
Ocupacao, rotatividade, intervalo de substituicao, permanencia prolongada, reinternacao e gargalos usam apenas fontes confirmadas.
Rastreabilidade
Abra o detalhe para conferir formula, componentes, periodo, fonte, evidencia e filtros aplicados.
Dados pendentes
Quando a coleta nao possui a fonte necessaria, o sistema informa integracao pendente em vez de apresentar zero ficticio.
Permissoes
Valores financeiros e informacoes sensiveis permanecem protegidos pelas permissoes da empresa e do usuario.
Usuarios, permissoes, logs e backup
Usuarios
Cadastre usuarios por empresa, defina perfil e revise permissoes por modulo e por acao.
Permissoes
Libere apenas o necessario. Acesso a dados sensiveis deve seguir funcao real do usuario.
Logs
Audite acoes sensiveis, usuario, modulo, data, valor anterior e valor novo quando disponivel.
Backup
Execute antes de manutencoes, importacoes, mudancas de parametros e alteracoes administrativas relevantes.
Downloads e conectores
Downloads
Baixe o APK Android e o conector SPData sempre pela versao mais recente liberada.
Conector SPData
Instale no ambiente que acessa o Firebird/SPData. Configure token, teste comunicacao e acompanhe coleta.
Suporte
Ao abrir chamado, informe o que tentou fazer, mensagem exibida, horario, empresa logada e usuario conectado.
Regra de atualizacao dos manuais
Todo modulo novo ou alteracao funcional publicada no VASI deve atualizar a Ajuda e os manuais correspondentes. Essa regra vale para telas, botoes, permissoes, status, fluxos, parametros, relatorios, acoes operacionais e comportamentos visiveis ao usuario.
Modulo existente
Revise o topico da Ajuda, a secao do Manual Geral e qualquer manual especifico relacionado.
Modulo novo
Crie topico na Ajuda, secao no Manual Geral, tela ficticia, passo a passo e cuidados de permissao.
Vendas / Commerce
Quando a mudanca afetar vendas, pedidos, estoque, producao, fiscal ou WhatsApp, revise tambem o Manual VASI Commerce.
Publicacao oficial
Entre por SSH na VPS, acesse a pasta da aplicacao e rode ./deploy.sh producao. De fora da VPS, use SSH para acionar o mesmo script remoto.
Teste obrigatorio
Rode npm test. O teste de cobertura acusa modulo visivel sem cobertura declarada de manual.
Checklists operacionais
Antes de vender
- Cliente correto.
- Produtos e quantidades revisados.
- Estoque disponivel.
- Pagamento e nota conferidos.
Antes de faturar PEP/TISS
- Paciente e convenio corretos.
- Procedimento e profissional conferidos.
- Valores e competencia validados.
- Inconsistencias resolvidas.
Antes de fechar ponto
- Escalas corretas.
- Ajustes analisados.
- Ferias e afastamentos aplicados.
- Banco de horas revisado.
Antes de assinar contrato
- Dados cadastrais completos.
- Objeto e vigencia revisados.
- Valores corretos.
- Aprovacao registrada.
Erros comuns e como orientar
Modulo nao aparece
Verifique permissao do usuario, modulo liberado para empresa e perfil atual.
Venda bloqueada
Confira estoque, permissao de desconto/acrescimo, regra fiscal e forma de pagamento.
Pedido nao libera producao
Confira sinal minimo, cliente VIP, dispensa autorizada ou status do pagamento.
Faturamento nao fecha
Revise producoes, convenio, procedimento, profissional, competencia e inconsistencias.
Ponto divergente
Confira jornada, escala, batidas, feriados, ajustes e afastamentos.
ERP sem dados novos
Confira conector SPData, token, rede, Firebird e ultima coleta enviada ao VASI.