Análise de faturamento
Análise de documentos de faturamento contra o contrato da operadora e a base de precificação.
1. Objetivo
Analisar documentos de faturamento (Fatura ou Prontuário (PEP)) para identificar divergências entre os valores cobrados e os valores previstos no contrato da operadora e na base de precificação.
2. Fluxo
Nova análise
- Selecionar operadora
- Escolher tipo de documento
- Enviar arquivo
- Processamento em segundo plano
- Resultado da análise
- Arquivo já analisado para a operadoraArquivo duplicado
- Falha“Tentar novamente”
3. Telas e estados
Listagem
- Análise de faturamento/analise-faturamento(abre em nova aba)
Lista de análises.
- Nenhuma análise realizada/analise-faturamento?estado=vazio(abre em nova aba)
Estado vazio da listagem.
- Nova análise/analise-faturamento?estado=nova-analise(abre em nova aba)
Modal de envio do documento.
Detalhes da análise
- Concluído/analise-faturamento/aa1ef555-88b2-405d-80bc-a99567a5d8db(abre em nova aba)
Análise com status concluído.
- Concluído parcialmente/analise-faturamento/9ae32a95-704a-458c-b838-098a7587c5e8(abre em nova aba)
Análise com status concluído parcialmente.
- Arquivo inválido/analise-faturamento/6b9f7890-5ce6-47bf-a1f9-6d1e71ecf5b2(abre em nova aba)
Análise com status arquivo inválido.
- Arquivo duplicado/analise-faturamento/bead70e5-6ada-4748-8c3e-7b0aa35a0325(abre em nova aba)
Análise com status arquivo duplicado.
- Falha no processamento/analise-faturamento/fe801000-07ae-4187-8069-c64bfe0717a6(abre em nova aba)
Análise com status falha no processamento.
Resultado
4. Regras e comportamentos
Envio
- Campos obrigatórios: Operadora (operadoras cadastradas), Tipo de documento (Fatura, Prontuário (PEP) ou XML, escolha única, sem opção pré-selecionada) e arquivo.
- A área de upload aparece desde a abertura do modal (rótulo “Arquivo”); após escolher o tipo, rótulo e texto acompanham o tipo escolhido. Trocar o tipo mantém o arquivo selecionado.
- Formatos aceitos para Fatura e Prontuário (PEP) ainda não definidos; a área de upload não exibe indicação de formato ou limite.
- Análises feitas a partir de XML (opção “XML” no modal, incluindo as anteriores) são identificadas como “XML TISS” no histórico.
- “Analisar” fica desabilitado até Operadora, Tipo de documento e arquivo estarem preenchidos.
- O contrato da operadora precisa ter regras extraídas: “O contrato desta operadora ainda não possui dados extraídos.”
- O mesmo arquivo não pode ser analisado duas vezes para o mesmo contrato da operadora.
- O arquivo original fica disponível somente para download; não há visualização.
Classificação dos itens
- Conforme: diferença entre valor faturado e esperado dentro da tolerância de R$ 0,005.
- Divergência: diferença acima da tolerância.
- Não analisado: item sem regra ou preço para comparação.
- Cada item exibe a memória de cálculo do valor esperado.
Listagem
- Busca por arquivo, prestador ou operadora.
- Colunas: Arquivo, Tipo de documento (Fatura, Prontuário (PEP) ou XML, conforme o cadastro da análise), Data da análise, Status, Resultado, Ações. A operadora não aparece na tabela, mas fica no detalhamento da análise; a busca continua encontrando por operadora.
- Filtros combináveis: Busca, Tipo de documento (Todos os tipos, Fatura, Prontuário (PEP), XML — mesmos nomes do modal “Nova análise”), Status, Resultado e Data da análise (de/até). “Limpar filtros” redefine todos, inclusive Tipo de documento.
- Filtro de resultado: Todos, Com divergências, Com itens não analisados, Sem divergências.
- Filtros em duas linhas no desktop: Busca (largura dupla), Tipo de documento e Status na primeira; Resultado, Data da análise (largura dupla) e “Limpar filtros” na segunda. No tablet ficam em duas colunas e no celular empilhados, recolhidos atrás do botão “Filtros”.
- Tabela a partir de 1536 px de largura; abaixo disso a listagem vira cards com Status, Resultado, nome do arquivo, Tipo de documento, Data da análise e Ações. Em 1280 px, mesmo com espaçamentos reduzidos, as seis colunas não cabem ao lado do menu lateral sem rolagem horizontal ou sem reduzir demais a coluna Arquivo.
- Nome do arquivo truncado na tabela, com o nome completo em tooltip.
- Prestador ou operadora ausentes no XML aparecem como “Não identificado”.
5. Estados e validações
| Estado / situação | Onde ocorre | Comportamento esperado |
|---|---|---|
| Status | Onde ocorre
| Comportamento esperado Na fila, Processando, Concluído, Concluído parcialmente, Arquivo inválido, Falha no processamento, Arquivo duplicado. |
| Arquivo não selecionado | Onde ocorre
| Comportamento esperado “Selecione o arquivo.” |
| Sem itens | Onde ocorre
| Comportamento esperado “Nenhum item faturado foi encontrado no arquivo.” |
| Erro | Onde ocorre
| Comportamento esperado “Não foi possível concluir a análise” com “Tentar novamente”. |
| Resultado | Onde ocorre
| Comportamento esperado Itens agrupados por status; os conformes podem ser exibidos ou ocultados. |
6. Responsividade
- MobileA tabela é substituída por uma lista de cartões com os mesmos campos; o menu lateral vira gaveta aberta pelo botão no topo.
7. Observações para desenvolvimento
Atenção — comportamento do protótipo
O botão que gera uma análise com falha de processamento existe só para testes.
Os links com ?estado= em Telas e estados existem só para documentação e validação: abrem diretamente um modal ou estado que, no produto, é alcançado pelo fluxo normal.
Os links de detalhes e resultado em Telas e estados apontam para registros de exemplo do protótipo; se forem removidos, o link deixa de abrir o estado.
A definir
- Formatos e limite de tamanho aceitos para Fatura e Prontuário (PEP).
- Regras de cruzamento com a SIMPRO (chave, unicidade, duplicidade, normalização, registros sem CD_SIMPRO e validação de CODIGO_TUSS), definidas na Base de precificação.