HaisFaturamento

Base de precificação

Versões das bases Brasíndice, SIMPRO e CBHPM usadas no cálculo da análise.

Atualizado em Design System(abre em nova aba)

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

  1. Escolher o tipo da base
  2. Enviar arquivo(s) CSV ou TXT
  3. Processamento em segundo plano
  4. Status da importação
  • Status ConcluídoVersão “Atual”
  • Demais statusNão substitui a versão atual

Atualização (SIMPRO e CBHPM)

  1. Escolher o tipo da base
  2. Selecionar “Atualização” em Tipo de cadastro
  3. Enviar um arquivo CSV ou TXT
  4. Processamento em segundo plano
  5. 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

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

Status da importaçãoOnde ocorre
  • Listagem
Comportamento esperado

Concluído, Concluído com erros, Não suportado, Formato inválido, Falha na importação.

Arquivo inválidoOnde ocorre
  • Nova versão
Comportamento esperado

“Arquivo maior que 10 MB.”

Erros por linhaOnde ocorre
  • Detalhes
Comportamento esperado

Mensagens por linha, ex.: “O preço está vazio.”, “O código TISS está vazio.”

ProcessandoOnde ocorre
  • Aviso global
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

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).