Manual do Usuário

SIGO — Sistema Integrado de Gestão de Obras · Guia completo, do primeiro acesso até o fechamento de uma obra.

1 Login e Acesso

Como entrar no sistema pela primeira vez

Passo 1 Acesse sieafa.com.br/ssfob. Digite seu usuário e senha fornecidos pelo administrador.

Passo 2 No primeiro acesso, o sistema pede para trocar a senha padrão. Escolha uma senha com pelo menos 6 caracteres.

Passo 3 Pronto — você entra direto na lista de obras. A sessão fica ativa por 7 dias, então não precisa logar toda vez que abrir o sistema.

Esqueceu a senha? Peça para um administrador (👥 Usuários) resetar — ela volta para a senha padrão e o sistema pede troca no próximo login.

2 Página Inicial

Visão geral de todas as obras em andamento

A página inicial mostra um card por obra, com:

Nome da obra e status (Em andamento)
Número do contrato e empresa contratada
Valor total e percentual executado (barra de progresso)
Data da última atualização

Botões disponíveis

Botão	O que faz
Buscar obra	Filtra os cards pelo nome da obra digitado
⬇ Modelo de Planilha	Baixa a planilha padrão (.xlsx) no formato exato que o sistema espera — envie para a empresa preencher antes do upload
+ Nova Obra	Cria uma obra nova a partir do upload de uma planilha preenchida
📖 Manual	Abre este manual — disponível também dentro de cada obra, no cabeçalho
👥 Usuários	Só aparece para administradores — gerencia quem tem acesso ao sistema

Clique em qualquer card para entrar no sistema daquela obra.

3 Criar uma Nova Obra

Do zero: subindo a planilha e criando o registro no sistema

Passo 1 Baixe o Modelo de Planilha na página inicial e envie para a empresa contratada preencher (ou preencha você mesmo com a planilha orçamentária).

Passo 2 Clique em + Nova Obra, escolha o modo de cálculo do BDI (veja abaixo) e selecione o arquivo .xlsx preenchido.

Passo 3 O sistema lê automaticamente: título, número do contrato, BDI, BDI DIF e todos os itens da planilha orçamentária.

Passo 4 Confira o resumo da extração (quantidade de itens encontrados) e confirme a criação.

Modo de cálculo do BDI no upload

Antes de escolher o arquivo, você decide como o sistema trata o Valor Unit. c/BDI e o Subtotal de cada item:

Truncar em 2 casas decimais (padrão) — o sistema calcula sozinho, truncando, sem confiar no que já está na planilha.
Usar os valores como estão na planilha — confia nos valores já calculados no Excel, sem recalcular. Os itens importados assim ficam marcados como valor manual (veja seção 5) e não são recalculados nem quando o BDI da obra mudar depois.

IR e Desconto de Licitação não vêm mais da planilha — são preenchidos direto na aba Dados da Obra. Itens de aditivo e valores de medição também nunca vêm da planilha — são sempre lançados depois, direto no sistema.

Só a 1ª Medição vem criada automaticamente (com nome, período e previsto, se estiverem na planilha). As demais (2ª, 3ª...) você cria manualmente conforme a obra avança, em Medições → Gerenciar Medições → + Medição.

Depois de criada, complete os dados que a planilha não traz na aba Dados da Obra: representante da empresa, garantia, comissão de fiscalização, empenhos e datas.

4 Aba Resumo

Visão financeira geral da obra

Primeira tela ao abrir uma obra. Mostra:

Contrato Original e Total c/ Aditivos (valor atualizado somando os aditivos lançados)
Realizado Acumulado — soma de tudo já medido, com barra de progresso
Empenhos — total empenhado e percentual do contrato
Saldo Restante
Administração Local — se a obra tiver item(ns) de grupo 10 ou superior marcados para entrar na conta (veja 14.7), aparece aqui um card mostrando o quanto já foi calculado, de forma totalmente automática.

Gráfico de Avanço por Medição

Barras comparando Previsto x Realizado, mês a mês.

Histórico de Medições

Tabela com todas as medições lançadas: previsto, realizado, reajuste, Adm. Local, acumulado, percentuais e desvio (verde se adiantado, vermelho se atrasado).

A Administração Local é calculada proporcionalmente ao que foi executado no mês — você não precisa lançar esse valor manualmente em nenhum lugar.

5 Aba Planilha

Todos os itens do orçamento, organizados em árvore

Mostra a planilha orçamentária completa, na mesma hierarquia da numeração (grupo → subgrupo → item). Clique em qualquer linha para editar todos os campos daquele item.

Cores das linhas

Cor	Significado
Verde	Item com acréscimo de quantidade (aditivo)
Vermelho	Item com supressão de quantidade (aditivo)
Amarelo	Item totalmente novo, criado via aditivo

Busca e filtros

Campo de busca filtra por número do item, descrição ou código. O filtro de medição mostra só itens que tiveram evolução naquele mês. O checkbox Só com BDI DIF mostra só os itens marcados para usar o BDI diferenciado — esses itens também ganham um selo roxo BDI DIF do lado da descrição, visível mesmo com o filtro desligado.

🔍 Validar Numeração

Botão que confere duas coisas em cada item:

Se o sufixo do item (ex: (ELT), (HID), (ARQ)) bate com o grupo do Manual SEAP-18-30 — se não bater, o sistema sugere a numeração correta e você escolhe aceitar ou ignorar.
Se o item está numa seção que não existe (a maior seção cadastrada vai até 11) — nesse caso o sistema só avisa, porque não tem como saber sozinho qual é a seção certa; a correção é manual.

A validação é uma orientação, não uma regra absoluta — itens de demolição/remoção, por exemplo, legitimamente usam sufixo de outra especialidade. Você pode ignorar o aviso quando fizer sentido.

Editar valor manualmente

Dentro do editor de item (clique numa linha), existe o checkbox "Editar Valor Unit. c/BDI e Subtotal manualmente". Desmarcado (padrão), esses dois campos ficam calculados sozinhos e travados. Marcando, você digita o valor que quiser — o sistema para de recalcular esse item específico, mesmo que o BDI da obra mude depois.

+ Novo

Cria um item do zero direto na Planilha (fora do fluxo de aditivo).

⬇ CSV

Exporta a planilha inteira em formato CSV.

Rodapé de totais

Ao final da tabela: Total sem BDI (soma real de valor base × quantidade, item a item), BDI (valor correspondente aos itens em BDI padrão), BDI DIF (valor correspondente aos itens em BDI diferenciado — só aparece se a obra tiver algum item assim) e Total Contrato Original.

6 Aba Dados da Obra

Todos os dados administrativos da obra

Identificação

Objeto, nome da obra, contrato, contratada (nome, CNPJ, endereço), CNPJ e endereço do contratante, ordenador de despesas.

BDI

Percentual de BDI digitado diretamente em porcentagem — ex: digite 22.04 para 22,04% (não é mais fração).

BDI DIF (%) — percentual alternativo, opcional, usado só em itens específicos (ex: itens de cotação direta). Cada item escolhe se usa o padrão ou o DIF, no próprio editor do item.
Cálculo de V.Unit c/BDI e Subtotal — Truncar em 2 casas (padrão histórico) ou Arredondar (bate mais com planilhas Excel de referência, que arredondam o valor unitário em 2 casas antes de multiplicar pela quantidade).
🔄 Recalcular Todos os Itens — força o recálculo de todos os itens não-manuais com o BDI/modo atuais, mesmo sem mudar nenhum valor no formulário. Use depois de uma correção do sistema, ou se desconfiar que algum item ficou desatualizado.

Itens marcados como valor manual (seção 5) nunca são tocados pelo recálculo automático nem pelo botão acima.

Desconto da Licitação

Preencha Valor de Referência (Edital) e Valor da Proposta Vencedora — o percentual de desconto é calculado automaticamente (mas continua editável manualmente, se precisar ajustar por arredondamento).

Representante(s) Legal(is)

Pode cadastrar mais de um representante — clique em + Representante quantas vezes precisar. Cada um tem nome, cargo, RG, CPF, CREA e ART. No TAM e nos termos de Entrega da Obra, todos aparecem juntos na identificação da contratada, e cada um ganha sua própria linha de assinatura no final do documento.

Datas e Valores

Valor total, vigência, execução (início/fim) e Término Original — preencha só se houve prorrogação por aditivo; o sistema calcula os dias automaticamente e gera o texto de prorrogação no TAM.

Garantia

Seguradora, apólice, valor e vigência do seguro-garantia.

Comissão de Fiscalização

Portaria de designação e os membros (nome, posto, especialidade, função, número de ordem, CPF).

Empenhos

Lista de notas de empenho com número e valor.

Sempre clique em 💾 Salvar depois de editar qualquer campo desta aba — as alterações não são salvas automaticamente.

O botão Gerenciar Medições não fica mais aqui — ele foi para a aba Medições.

7 Aba Medições

Lançar os valores realizados mês a mês

Selecione a medição no menu suspenso — um banner azul mostra qual medição está sendo visualizada, o período e o total já lançado (incluindo Administração Local).

📋 Gerenciar Medições Botão na barra de ferramentas desta aba (não fica mais em Dados da Obra). Abre um modal para cadastrar cada medição: nome, período (início e fim), data da medição e valor previsto. O realizado é calculado automaticamente pelo sistema.

Como lançar uma medição Clique em qualquer item da lista. O modal simplificado mostra Quantidade Medida, Valor c/BDI (calculado automaticamente), % Execução e Peso.

Preenchimento rápido

Enter nos campos Quantidade, % Execução ou Peso salva direto, sem precisar clicar no botão.
Digite a Quantidade Medida e o % Execução se calcula sozinho (com base na quantidade contratada do item: original − supressão + aditivo). Digite o % primeiro e a quantidade se calcula no caminho inverso — e o Valor c/BDI é recalculado junto.

Se apagar a quantidade e salvar, o valor também é zerado automaticamente — não precisa abrir de novo para limpar.

Itens com valor negativo (ex: retirada de um item já medido antes) aparecem normalmente na lista.

Cores das linhas

Igual à Planilha: itens de aditivo aparecem verde (acréscimo), vermelho (supressão) ou amarelo (item novo).

Botões da toolbar

Botão	Função
📋 Gerenciar Medições	Cadastra/edita as medições da obra (nome, período, previsto)
📄 Gerar TAM	Abre o Termo de Aceitação de Medição da medição selecionada — veja a seção 14
⬇ Planilha	Baixa um Excel formatado só com os itens medidos naquela medição
🖨 PDF	Abre uma versão para impressão/PDF da medição

O reajuste não é mais aplicado por aqui. Ele agora tem sistema próprio, com apuração automática e lançamento de pagamento por medição — veja a aba Reajuste.

8 Aba Aditivos

Lançar acréscimos, supressões e itens novos por termo aditivo

Cada aditivo (1º, 2º, 3º...) tem seu próprio bloco, com cabeçalho fixo (não precisa rolar a tela pra ver o total ou adicionar item) e tabela editável direto na linha.

Colunas da tabela

Qtd Sup. (fundo vermelho) — quantidade suprimida. O sistema já subtrai automaticamente, não precisa digitar o sinal negativo.
Qtd Acr. (fundo verde) — quantidade acrescida, soma normalmente.
Classificação — Acréscimo em item existente / Supressão / Item novo (preço atualizado ou sujeito a reajuste)

+ Item Adiciona uma linha nova dentro do aditivo atual. Preencha o número do item seguindo a numeração correta — ele cai automaticamente na posição certa da Planilha.

+ Novo Aditivo Cria um novo bloco (2º Aditivo, 3º Aditivo...) para separar por termo aditivo contratual.

💾 Salvar Tudo Salva todos os itens de todos os aditivos de uma vez.

Busca automática (autocomplete)

Ao digitar no campo Nº Item, Código ou Descrição de uma linha nova, o sistema sugere itens já existentes na planilha original. Se encontrar uma correspondência exata, preenche sozinho o resto da linha (banco, unidade, valor unitário) — útil pra lançar acréscimo/supressão num item que já existe, sem digitar tudo de novo.

Itens novos de aditivo aparecem em amarelo na Planilha assim que criados, mesmo antes de preencher o número — mas o sistema só consegue posicioná-los no lugar certo da árvore depois que o número for digitado.

9 Aba Reajuste

Apuração automática e pagamento do reajuste contratual, e reequilíbrio econômico-financeiro

Como a apuração funciona

Você não escolhe o tipo de reajuste — o sistema decide sozinho, comparando dois acumulados até a Data-Base:

Previsto Acumulado = soma do valor previsto (cronograma) de todas as medições até a Data-Base Executado Acumulado = soma do valor realmente medido até a Data-Base Saldo a Reajustar = Contrato Original − MAIOR dos dois acumulados acima Valor Apurado = Saldo a Reajustar × Índice

Sempre descontando o maior dos dois acumulados, o saldo a reajustar fica sempre no menor valor possível — que é o princípio que deve prevalecer. Isso resulta automaticamente em dois cenários:

Situação	O que acontece
🔴 Atraso	Previsto > Executado (obra atrasada) → desconta o Previsto
🟢 Adiantado	Executado > Previsto (obra adiantada) → desconta o Executado

+ Novo Reajuste Preencha Descrição, Índice (ex: 6,71 = 6,71%) e Data-Base. Cada campo salva sozinho ao editar, sem precisar de um botão "Salvar" geral.

🧮 Apurar

Recalcula o valor na hora, com os dados atuais do sistema, mostrando os dois acumulados, qual tipo foi usado, e o valor apurado. Se for a primeira apuração, aparece um botão para confirmar e salvar. Se já existia um valor salvo e ele mudou (por exemplo, porque uma medição anterior à Data-Base foi corrigida depois), aparece um alerta comparando o valor antigo com o novo, e você escolhe atualizar ou manter o que já estava salvo.

A apuração nunca muda sozinha sem você ver — sempre pede confirmação quando o valor diverge do que já estava salvo.

Pagamentos por Medição

Depois de apurado, você decide como pagar: tudo de uma vez numa medição, ou dividido entre várias. Em + Lançar Pagamento, escolha a medição e o valor pago ali. A tela mostra sempre Total Apurado, Total Pago e Saldo a Pagar, por reajuste e somado no card do topo.

Reequilíbrio Econômico-Financeiro

Seção separada, mais abaixo na mesma aba. Registra alteração de preço unitário de um item a partir de uma data.

+ Novo Reequilíbrio Escolha o item, o novo preço (o preço atual vira automaticamente o "preço anterior" registrado) e a data de vigência.

O novo preço só passa a valer nas medições a partir da vigência — as anteriores mantêm o preço antigo intocado. Não tem limite de quantos reequilíbrios um item pode ter ao longo do contrato; o histórico completo fica registrado, com preço anterior e novo preço de cada um.

↻ Aplicar Reaplica o novo preço nas medições já lançadas a partir da data de vigência — use depois de cadastrar um reequilíbrio, se já houver medição no período afetado.

10 Aba Documentações

Arquivos e projetos da obra organizados por categoria

+ Nova Categoria Digite o nome (ex: "Documentos do Edital", "Segurança", "Projetos") e escolha se quer organizar em subpastas.

Se marcar "Organizar em subpastas", você digita os nomes livremente — ou usa o modelo pronto 📐 Projetos Técnicos, que preenche automaticamente: Arquitetura, Estruturas, Hidráulica, Elétrica, Mecânica, Incêndio, Topografia, Outros.

Cada categoria ou subpasta tem botão + Arquivo para upload. Tipos aceitos: PDF, DWG, DXF, Word, Excel, PowerPoint, imagens, ZIP/RAR, SKP, RVT — até 50MB por arquivo.

Pode criar quantas categorias e subpastas quiser, a qualquer momento — não precisa definir tudo de uma vez ao criar a obra.

11 Diário de Obra

Linha do tempo de anotações e eventos da obra

Uma linha do tempo vertical com tudo que acontece na obra — anotações que você escreve manualmente, misturadas automaticamente com eventos que o sistema já sabe (medição gerada, pagamento de reajuste lançado).

Categorias disponíveis

Categoria	Uso
📋 LDO — Livro Diário de Obra	Formulário próprio: dia da obra, condição climática, nº de colaboradores, serviços executados, comunicação COMFIS e comunicação da contratada
⚠️ Ocorrência/Problema	Atraso, defeito, imprevisto
👷 Segurança do Trabalho	Acidente, quase-acidente, EPI
🌧️ Condição Climática	Chuva parando a obra, etc
📐 Decisão Técnica	Mudança de projeto, especificação
📸 Registro Fotográfico	Fotos com legenda
🔍 Visita/Vistoria	Quem veio, o que observou
💬 Comunicação	Ofício, e-mail importante, reunião
✅ Marco Importante	Data que merece destaque

+ Nova Anotação Abre o formulário. Ao escolher LDO, o sistema já sugere sozinho o "Dia X/Y" da obra, calculado a partir das datas de execução cadastradas em Dados da Obra — você pode ajustar manualmente se precisar.

Cada anotação pode ter fotos anexadas e ser vinculada a uma medição específica.

Eventos automáticos

Toda vez que uma medição é gerada ou um pagamento de reajuste é lançado, uma entrada aparece sozinha na timeline, marcada como "automático" — não pode ser editada nem excluída, é só um reflexo do que já existe no sistema.

Filtros e exportação

Filtro por categoria (incluindo "só eventos automáticos")
Busca por texto no título ou descrição
Opção de ocultar os eventos automáticos, se quiser ver só suas anotações
🖨 Exportar PDF — gera o Livro de Ordem no padrão oficial (cabeçalho, brasão, tabela de Fiscais e Contratada, campos de assinatura), respeitando os filtros ativos

12 Aba Entrega da Obra

TERP e TERD — termos de recebimento provisório e definitivo

Guarda os dados que só existem no fechamento da obra e não têm lugar em nenhuma outra aba: Processo COMAER, Registro DIRINFRA, prazos de execução/contratual, especificações e projetos, Comissão de Fiscalização do Contrato e Comissão de Recebimento (com sua portaria).

Os demais dados usados nos termos (empresa, contrato, endereço, Comissão de Fiscalização Técnica, representantes) são buscados automaticamente da aba Dados da Obra — você não precisa duplicar nada aqui.

📄 Gerar TERP

Abre um modal só com os campos específicos daquela emissão: deficiências levantadas (se houver), prazo de verificação e recebimento, e data de assinatura. Gera um arquivo .doc no padrão oficial do Termo de Recebimento Provisório.

📄 Gerar TERD

Mesma lógica, só pede a data de assinatura. Gera o Termo de Recebimento Definitivo.

Toda vez que um TERP ou TERD é gerado, o sistema manda um e-mail de notificação automático (com o resumo, sem anexar o documento) e registra a emissão no histórico desta aba e no Log de Auditoria.

13 Aba Auditoria

Quem alterou o quê e quando, nesta obra

Mostra as últimas 100 alterações feitas na obra: contrato, itens da planilha, diário de obra, documentos e emissões de TERP/TERD. Cada linha mostra quando, quem fez, o que foi (criar/editar/excluir + a entidade) e um resumo legível do que mudou — no caso de edição de campo, mostra o valor antes e depois.

Não cobre ações administrativas do sistema (gestão de usuários, categorias globais de documentos) — só o que acontece dentro desta obra específica.

Botão Atualizar recarrega a lista, útil se outra pessoa estiver mexendo na mesma obra ao mesmo tempo.

14 Gerar o TAM

Termo de Aceitação de Medição — documento oficial

Na aba Medições, selecione a medição e clique em 📄 Gerar TAM. O sistema monta automaticamente:

Brasão da República e identificação do contratante e contratada (usando os dados da aba Dados da Obra) — se houver mais de um representante cadastrado, todos aparecem na identificação e cada um ganha sua própria linha de assinatura
Vigência, execução e ordem de serviço
Garantia financeira
Cronograma físico-financeiro com todas as medições, já somando a parcela de Administração Local (se houver)
Seção de aditivo (aparece automaticamente se houver aditivo lançado)
Tabela de reajuste liquidado nesta medição — mostra o valor apurado do reajuste e quanto foi pago especificamente nesta medição (aparece se houver algum pagamento de reajuste lançado para ela)
Comissão de fiscalização e conclusão
Gráficos de Previsto x Realizado e Execução Acumulada

🖨️ Imprimir / PDF Abre a visualização de impressão do navegador — use "Salvar como PDF".

⬇ Baixar .doc Baixa um arquivo Word editável, com os gráficos já convertidos para imagem (compatível com o Word de verdade).

Valores importantes no TAM aparecem por extenso automaticamente, ex: "R$ 88.893,82 (oitenta e oito mil, oitocentos e noventa e três reais e oitenta e dois centavos)".

15 Fluxo Completo de uma Obra

Do início ao fim, passo a passo

1. Baixar modelo

→

2. Empresa preenche

→

3. Criar obra

→

4. Completar Dados da Obra

5. Cadastrar medições

→

6. Lançar valores mensais

→

7. Gerar TAM

8. Lançar aditivos (se houver)

→

9. Apurar reajuste (se houver)

→

10. LDO diário + Repetir 5-7 até o fim

11. Gerar TERP

→

12. Período de verificação

→

13. Gerar TERD

Antes da obra começar: baixe o modelo de planilha e envie para a empresa vencedora da licitação preencher com o orçamento aprovado.
Criação: faça upload da planilha preenchida em "+ Nova Obra" — já vem com a 1ª medição pronta.
Complete a aba Dados da Obra: representante(s), garantia, comissão de fiscalização, empenhos, desconto de licitação. Vá criando as demais medições em Medições → Gerenciar Medições conforme a obra avança.
A cada mês: vá na aba Medições, lance a quantidade executada de cada item, e gere o TAM daquela medição para assinatura da comissão.
Se houver termo aditivo: lance na aba Aditivos os acréscimos, supressões e itens novos, referenciando o número do aditivo correspondente.
Se houver reajuste contratual: cadastre na aba Reajuste com o índice e a data-base, apure, e lance o pagamento na(s) medição(ões) correspondente(s).
Se houver reequilíbrio de preço: cadastre o novo preço e a data de vigência na mesma aba Reajuste.
Diário de Obra: lance o LDO diariamente (ou com a frequência que fizer sentido) e registre ocorrências relevantes conforme forem acontecendo.
Documentos: vá anexando projetos, ARTs, relatórios de segurança e demais documentos na aba Documentações conforme forem chegando.
No fim da obra: gere o TAM da última medição, confira que o percentual acumulado bate 100%, gere o TERP em Entrega da Obra, aguarde o prazo de verificação, e gere o TERD para encerrar.

16 Cálculos do Sistema

Como cada número do SIGO é calculado, com fórmula e exemplo

Esta seção existe para dar transparência: todo valor financeiro do sistema pode ser conferido manualmente com as fórmulas abaixo. Os nomes entre código são os campos internos, caso precise localizar algo no suporte técnico.

16.1 — Valor unitário com BDI

Todo item da planilha tem um valor base e um valor "oficial" (o que entra nos cálculos), que já embute o BDI do contrato — padrão ou diferenciado (BDI DIF), conforme o item.

Dados usados: valor_unit (valor unitário base, sem BDI), bdi e bdi_dif do contrato, já em percentual (ex: 22.04 = 22,04%), e usa_bdi_dif do item

BDI Aplicável = bdi_dif, se o item usar BDI DIF — senão bdi Valor Unit. c/ BDI = Valor Unit. Base × (1 + BDI Aplicável ÷ 100)

Exemplo: item com valor base R$ 100,00 e BDI de 22,04% → 100 × 1,2204 = R$ 122,04/unidade. Se esse item usasse BDI DIF de 14,96%: 100 × 1,1496 = R$ 114,96/unidade.

O modo de cálculo (Truncar ou Arredondar, configurável em Dados da Obra) define como esse valor é fechado em 2 casas — truncando ou arredondando. Itens marcados como valor manual não passam por esse cálculo, o valor digitado é usado direto.

16.2 — Total sem BDI, BDI e BDI DIF (R$) da Planilha

No rodapé da aba Planilha, o total geral é decomposto de volta em base + BDI, separado por grupo (padrão e diferenciado), somando item a item — nunca dividindo o total por um único percentual, porque isso erra quando há BDI DIF misturado.

Dados usados: valor_unit × qtd_original e subtotal_orig de cada item-folha (com unidade preenchida), separados conforme usam BDI padrão ou DIF

Total sem BDI (grupo) = Σ (valor_unit × qtd_original), só os itens daquele grupo Total c/ BDI (grupo) = Σ subtotal_orig, só os itens daquele grupo BDI do grupo (R$) = Total c/ BDI (grupo) − Total sem BDI (grupo) Total Contrato Original = Total c/ BDI (padrão) + Total c/ BDI (DIF)

Exemplo: obra com 312 itens em BDI padrão (20,04%) somando R$ 2.370.814,87 com BDI, e 34 itens em BDI DIF (14,96%) somando R$ 1.614.429,96 com BDI → Total Contrato Original = R$ 3.985.244,83, com as duas linhas de BDI mostradas separadamente no rodapé.

16.3 — Valor de um item numa medição

Ao lançar a quantidade executada de um item numa medição, o sistema grava o valor com BDI. Se houver reequilíbrio de preço vigente para a data daquela medição, o preço reequilibrado é usado no lugar do original — sem alterar as medições anteriores à vigência.

Dados usados: qtd (quantidade lançada), valor_unit_bdi (valor unitário já com BDI, ou o preço do reequilíbrio vigente), preco_adit (subtotal de itens de aditivo, se houver)

Vlr. c/ BDI (preco_bdi) = Qtd × Valor Unit. c/ BDI (ou preço reequilibrado vigente) Valor Total do item na medição = Vlr. c/ BDI + preco_adit

Exemplo: 10 unidades a R$ 122,04 (já c/ BDI) → R$ 1.220,40.

16.4 — Realizado de uma medição (aba Medições / gráficos)

O "Realizado" de uma medição é a soma do Valor Total (16.3) de todos os itens da planilha naquela medição.

Realizado da Medição = Σ Valor Total do item, para todos os itens

16.5 — Apuração e pagamento de reajuste

Ver a explicação completa e o exemplo em Aba Reajuste (seção 9). Resumo da fórmula:

Saldo a Reajustar = Contrato Original − MAIOR(Previsto Acumulado, Executado Acumulado) até a Data-Base Valor Apurado = Saldo a Reajustar × Índice Total Pago = Σ valor de todos os pagamentos lançados desse reajuste, em qualquer medição Saldo a Pagar = Valor Apurado − Total Pago

A apuração é sempre recalculada "ao vivo" — não fica congelada. Se mudar em relação ao último valor salvo, o sistema avisa antes de sobrescrever.

16.6 — Reequilíbrio Econômico-Financeiro

Não tem fórmula de cálculo automático — é um registro de mudança de preço unitário, efetivo a partir de uma data.

Preço do item numa medição = preço do reequilíbrio mais recente com data_vigencia ≤ data da medição (se não houver nenhum, usa o valor_unit_bdi normal do item)

16.7 — Administração Local (Grupo 10 e superiores)

A Adm. Local é rateada proporcionalmente ao quanto já foi executado do contrato (sem contar os itens de Adm. Local), medição a medição — automaticamente, sem lançamento manual.

Entram na conta os itens numerados a partir do grupo 10 (10, 11, ou qualquer grupo acima) que estiverem com o checkbox "Incluir na Administração Local" marcado — vem marcado por padrão, editável item a item no editor.

Vlr. Adm. Local Atual = Σ subtotal_orig (itens de Adm. Local marcados) + Σ subtotal_aditivo (itens de Adm. Local marcados) + Reajuste projetado sobre esses itens

Rateio por medição:

Adm. Local da Medição = Vlr. Adm. Local Atual × (Realizado da Medição, sem Adm. Local ÷ Total do contrato, sem Adm. Local)

Exemplo: Adm. Local de R$ 316.299,87, contrato (sem Adm. Local) de R$ 3.668.944,96. Numa medição em que foi executado R$ 33.234,12 (sem Adm. Local): proporção aplicada resulta em Adm. Local daquela medição de R$ 2.001,35.

Depois que um reajuste é liquidado (tem pagamento lançado numa medição), o saldo do contrato e da Adm. Local são recalculados a partir dali — o rateio já pago antes não muda.

16.8 — Realizado Acumulado, Empenhos e Saldo Restante (aba Resumo)

Total c/ Aditivos = Contrato Original + Σ subtotal_aditivo (todos os itens) Realizado Acumulado = Σ (Realizado da Medição + Pagamento de Reajuste da Medição + Adm. Local da Medição), para todas as medições Saldo Restante = Total c/ Aditivos − Realizado Acumulado % Realizado = Realizado Acumulado ÷ Total c/ Aditivos % Empenhado = Σ valor dos Empenhos ÷ Total c/ Aditivos

16.9 — % Mês, % Acumulado e Desvio (Histórico de Medições)

% Mês = (Realizado da Medição + Pagamento de Reajuste da Medição) ÷ Total c/ Aditivos % Acumulado = Acumulado até a Medição ÷ Total c/ Aditivos Desvio = Realizado da Medição − Previsto da Medição

O Desvio aparece em verde quando ≥ 0 (adiantado ou em dia) e em vermelho quando negativo (atrasado em relação ao Cronograma Físico-Financeiro).

16.10 — % de execução de cada item (aba Planilha)

Previsto do item = subtotal_orig + subtotal_aditivo Realizado do item = Σ Valor Total do item, em todas as medições % Execução do item = Realizado do item ÷ Previsto do item

Os selos coloridos (badges) seguem a mesma escala em toda a tela: < 25% 25–50% 50–90% ≥ 90%.

16.11 — Valores por extenso (TAM e Entrega da Obra)

No TAM e nos termos TERP/TERD, valores em reais são escritos por extenso automaticamente, separando a parte inteira (reais) da parte decimal (centavos) e convertendo cada uma para texto em português.

Reais = parte inteira do valor Centavos = arredondamento((valor − Reais) × 100) Texto = "R$ valor (Reais por extenso) real(is)" + [" e " + Centavos por extenso + " centavo(s)", se Centavos > 0]

Exemplo: R$ 88.893,82 → "R$ 88.893,82 (oitenta e oito mil, oitocentos e noventa e três reais e oitenta e dois centavos)".

17 Gestão de Usuários

Só para administradores

Na página inicial, administradores veem o botão 👥 Usuários.

+ Novo Usuário — cria com senha padrão, o sistema pede troca no primeiro acesso
✏ Editar — altera nome, usuário e se é administrador
🔑 Reset — volta a senha para o padrão
🗑 — exclui o usuário (não é possível excluir a si mesmo)

18 Desfazer Ações

Botão ↩ Desfazer no topo da tela

Cobre os salvamentos das abas Planilha, Medições, Dados da Obra e Aditivos — guarda até 3 ações anteriores.

Reajuste e Reequilíbrio não entram no Desfazer — cada ação nessas duas seções (criar, editar, apurar, lançar pagamento) já grava direto no banco assim que confirmada. Confira bem antes de salvar/apurar/lançar.

Ações com pop-up de confirmação (excluir item, excluir categoria, excluir reajuste, excluir reequilíbrio) já pedem "tem certeza?" antes — essas também não entram no desfazer, pois já são deliberadas.

19 Dúvidas Frequentes

Errei um item na planilha, como corrijo?

Clique no item na aba Planilha (modo completo) e edite qualquer campo.

Como sei se uma medição está em atraso?

Na aba Resumo, a coluna Desvio do histórico fica vermelha quando o realizado está abaixo do previsto.

Quando devo usar BDI DIF num item?

Em itens de cotação direta (materiais/equipamentos comprados prontos, sem composição SINAPI), que costumam ter uma taxa de bonificação diferente dos itens de serviço/mão de obra. Marque o checkbox no editor do item — o BDI DIF da obra precisa estar preenchido em Dados da Obra primeiro.

Por que meu item ficou com "🔒" e não recalcula mais o valor?

Provavelmente o checkbox "Editar Valor Unit. c/BDI e Subtotal manualmente" está marcado nesse item. Desmarque para o sistema voltar a calcular sozinho.

O reajuste mudou de valor sozinho quando eu apurei de novo — é bug?

Não — a apuração é sempre recalculada com os dados mais atuais. Se uma medição anterior à Data-Base foi editada depois da última apuração, o valor muda de verdade, e o sistema avisa antes de sobrescrever o que estava salvo.

O que acontece se eu excluir uma categoria de documentos?

Todos os arquivos e subpastas dentro dela são excluídos junto — o sistema pede confirmação antes.

Posso ter mais de um aditivo na mesma obra?

Sim — use "+ Novo Aditivo" para criar quantos blocos precisar (1º, 2º, 3º...).

O sistema calcula a Administração Local sozinho?

Sim, totalmente automático, proporcional ao percentual executado da obra em cada medição — desde que os itens de Adm. Local (grupo 10 ou superior) estejam com o checkbox de inclusão marcado.

Preciso preencher IR e Desconto de Licitação na planilha antes de subir?

Não — esses dois campos saíram da planilha modelo. Preencha direto na aba Dados da Obra depois de criar a obra.