Base de precificação
Versões das bases Brasíndice, SIMPRO e CBHPM usadas no cálculo da análise.
1. Objetivo
Manter as versões das bases de valores (Brasíndice, SIMPRO e CBHPM) utilizadas na análise do faturamento.
2. Fluxo
Nova versão
- Escolher o tipo da base
- Enviar arquivo(s) CSV ou TXT
- Processamento em segundo plano
- Status da importação
- Status ConcluídoVersão “Atual”
- Demais statusNão substitui a versão atual
Atualização (SIMPRO e CBHPM)
- Escolher o tipo da base
- Selecionar “Atualização” em Tipo de cadastro
- Enviar um arquivo CSV ou TXT
- Processamento em segundo plano
- Arquivo adicionado à versão atual
- Importação concluída“Atualização adicionada”: arquivo passa a fazer parte da versão atual
- Demais status“Atualização não aplicada”: versão atual permanece inalterada
- Tipo sem versão atualOpção “Atualização (sem versão atual)” desabilitada
3. Telas e estados
Listagem
- Base de precificação/base-precificacao(abre em nova aba)
Lista de versões da base.
- Nenhuma base cadastrada/base-precificacao?estado=vazio(abre em nova aba)
Estado vazio da listagem.
- Nova versão/base-precificacao?estado=nova-versao(abre em nova aba)
Modal de envio de arquivos.
Detalhes da importação
- Concluído/base-precificacao/f3a4d467-3615-4207-99bb-9ac9d057be3f(abre em nova aba)
Importação com status concluído.
- Concluído com erros/base-precificacao/de533b01-3bc1-4724-bb2a-be45b3b317c9(abre em nova aba)
Importação com status concluído com erros.
- Formato inválido/base-precificacao/cd874b8b-2a1e-4d0e-b449-3f6fe98b26b0(abre em nova aba)
Importação com status formato inválido.
- Não suportado/base-precificacao/f911bc28-4c70-4e63-8ff9-abcfcd4bb852(abre em nova aba)
Importação com status não suportado.
- Falha na importação/base-precificacao/e9eda973-c7c4-4160-a438-80b46123b076(abre em nova aba)
Importação com status falha na importação.
4. Regras e comportamentos
Versões
- Tipos de base: Brasíndice, SIMPRO e CBHPM.
- Arquivos CSV ou TXT, até 10 MB. SIMPRO aceita vários arquivos por versão.
- Atualização incremental disponível apenas para SIMPRO e CBHPM.
- Somente uma importação com status Concluído torna a versão “Atual” do seu tipo.
- Se o envio de algum arquivo falhar, a versão inteira não é cadastrada.
- Página de detalhes segue a mesma estrutura do detalhe do contrato: breadcrumb Início > Base de precificação > <tipo>, título com o tipo da base (ex.: SIMPRO), descrição “Detalhes da base de precificação.” e “Voltar para bases de precificação” à direita.
- Card de resumo (sem “Tipo da base”, já presente no título): Data do cadastro, Status, Situação da versão, Quantidade de arquivos, Registros importados, Registros com erros (quando houver) e Cadastrado por.
- Aba Arquivos: colunas Arquivo, Data do cadastro, Registros e Ações. Nome do arquivo em destaque, com reticências e nome completo em tooltip no hover/foco. Ações: olho “Visualizar arquivo” (abre o arquivo original em nova aba) e download “Baixar arquivo”.
- Em Detalhes da importação, a tabela Registros vigentes tem a coluna “Arquivo de origem” com o nome do arquivo (largura limitada, com reticências e nome completo em tooltip no hover/foco) seguido do ícone de olho, que abre o arquivo de onde o registro veio em nova aba (mesmo padrão das regras do contrato). A coluna Preço é exibida em reais (ex.: R$ 89,90), alinhada à direita; o valor armazenado não muda.
Nova versão x Atualização
- Nova versão cria um novo registro no histórico da base; quando concluída, passa a ser a versão “Atual” do tipo. Brasíndice só aceita nova versão.
- Atualização (SIMPRO e CBHPM) não cria uma versão: adiciona um único arquivo à versão “Atual” do tipo escolhido. Só fica disponível quando o tipo já tem versão atual.
- Os arquivos anteriores da versão são preservados: nenhum arquivo é removido ou substituído; o novo arquivo é marcado como atualização e guarda a data em que foi adicionado.
- A atualização é processada junto com os arquivos já existentes da versão; se a importação não for concluída, o arquivo não é adicionado e a versão segue como estava.
- Os arquivos anteriores continuam disponíveis para visualização e download, garantindo consulta e rastreabilidade da origem de cada registro.
Abas após uma atualização
- Arquivos: lista todos os arquivos da versão na ordem de envio (originais e atualizações). Para atualizações, “Data do cadastro” mostra quando o arquivo foi adicionado; “Registros” mostra a quantidade lida de cada arquivo.
- Registros vigentes: apresenta o conjunto consolidado de todos os arquivos da versão. Quando um código já existente recebe novo valor em um arquivo posterior, prevalece o registro mais recente; a coluna “Arquivo de origem” passa a indicar o arquivo da atualização.
- Códigos que não aparecem na atualização permanecem vigentes com o valor e o arquivo de origem anteriores.
- O resumo (Quantidade de arquivos, Registros importados e Registros com erros) é recalculado considerando todos os arquivos da versão.
- A regra de consolidação compartilhada com a Análise de faturamento ainda não está definida (ver “A definir”); este comportamento descreve apenas a tela de Registros vigentes.
Listagem e download
- Colunas: Arquivo, Tipo da base, Cadastrado por, Data do cadastro, Status, Ações.
- Filtros: busca, Tipo da base, Status e Data do cadastro.
- Versão com um arquivo: “Baixar arquivo”; com vários: “Baixar arquivos (.zip)”.
5. Estados e validações
| Estado / situação | Onde ocorre | Comportamento esperado |
|---|---|---|
| Status da importação | Onde ocorre
| Comportamento esperado Concluído, Concluído com erros, Não suportado, Formato inválido, Falha na importação. |
| Arquivo inválido | Onde ocorre
| Comportamento esperado “Arquivo maior que 10 MB.” |
| Erros por linha | Onde ocorre
| Comportamento esperado Mensagens por linha, ex.: “O preço está vazio.”, “O código TISS está vazio.” |
| Processando | Onde ocorre
| Comportamento esperado “Processando base de precificação”; ao final “Base de precificação cadastrada” ou “Não foi possível processar a base”. |
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
A leitura dos arquivos e a decisão do status de cada linha são simuladas no navegador; no produto essas regras pertencem ao backend e a interface apenas exibe o resultado.
Controles para simular estado vazio e falha existem 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
- SIMPRO: qual identificador/chave relaciona o registro à cobrança (CD_SIMPRO, CODIGO_TUSS ou ambos).
- SIMPRO: se TIPO_PRECO faz parte da chave de unicidade.
- SIMPRO: como resolver códigos duplicados.
- SIMPRO: quais normalizações de código são permitidas.
- SIMPRO: como tratar registros sem CD_SIMPRO.
- SIMPRO: como validar CODIGO_TUSS (formato de 8 dígitos e/ou existência na terminologia TUSS).

