Fontes oficiais
Importação do SICRO por competência, localidade, regime e revisão, sem sobrescrever publicações anteriores.
Comece aqui
O que o SGO resolve
O SGO organiza o caminho completo entre uma fonte de preços e um orçamento. Uma referência oficial informa quanto determinado serviço ou insumo custava em uma competência e localidade. A base própria registra como a empresa realmente trabalha. O orçamento utiliza uma fotografia desses dados para que seus valores continuem auditáveis no futuro.
Bases próprias
Itens selecionados em uma ou várias fontes, itens manuais e composições com dependências preservadas.
Orçamento profissional
Venda e execução, etapas, múltiplas fontes de itens, snapshots, BDI, descontos, aprovação e revisões.
Vocabulário
Três coisas diferentes
1
Base oficial
Fonte externa, como SICRO ou SINAPI. Deve permanecer fiel ao documento publicado e nunca ser editada para refletir decisões internas.
2
Base própria
Conhecimento da empresa. Pode combinar referências oficiais, cotações, produtividade própria e itens criados manualmente.
3
Orçamento
Aplicação dos itens e composições a quantidades de um empreendimento, com regras comerciais e uma fotografia da origem.
Princípio principal
Copiar um item oficial não cria um vínculo vivo de preço. O SGO registra um snapshot. Uma atualização futura da fonte poderá ser comparada, mas nunca alterará silenciosamente a base própria.
Mapa mental
Como as informações fluem
Fontes oficiaisSICRO, SINAPI, ORSE, fornecedores e outras referências.
→
Catálogo e bases própriasSeleção, associação, itens manuais, composições e preços da
empresa.
→
OrçamentosQuantidades, etapas, BDI, preço de venda, aprovação e
histórico.
No futuro, bibliotecas de empreendimento — condomínio de casas, edifício residencial, galpão — e padrões construtivos poderão selecionar subconjuntos da base própria sem duplicar o catálogo inteiro.
Aprendizado interativo
Tutoriais que acompanham suas ações
No cabeçalho do sistema, clique em ◎ Tutorial para abrir a Central de tutoriais. Escolha uma atividade e siga o destaque luminoso: a tela escurece ao redor do elemento correto, apresenta a orientação e aguarda o clique, a digitação, a seleção ou o envio esperado antes de avançar.
Orientação contextual
O tutorial localiza o controle certo mesmo quando a tela muda durante a navegação.
Espera pela ação
Etapas podem aguardar clique, texto, seleção de arquivo, marcação de item ou envio de formulário.
Controle do usuário
É possível voltar, pular uma etapa ou encerrar a qualquer momento com o botão ou a tecla Esc.
Estão disponíveis roteiros para conhecer o SGO, consultar e importar bases oficiais, montar bases próprias, cadastrar itens, entender associações, percorrer o fluxo comercial, montar um orçamento com múltiplas fontes e transformar a venda aprovada em orçamento executivo. Atividades de cadastro utilizam dados reais: inicie esses roteiros quando desejar realizar a operação.
Fluxo contínuo
Cadastros rápidos de dependências
Quando uma operação precisa de um cadastro anterior, o SGO abre automaticamente um formulário rápido e retoma o ponto em que você estava depois de salvar. Os dados já digitados no formulário principal são preservados.
1
Oportunidade sem cliente
Cadastre o cliente no modal auxiliar. Em seguida, a nova oportunidade será aberta com o cliente selecionado.
2
Orçamento sem oportunidade
O sistema conduz cliente, oportunidade e orçamento na ordem necessária, sem mensagens de bloqueio.
3
Associação sem item interno
Cadastre um insumo ou composição do tipo compatível e continue diretamente na associação.
Botão “+ Cadastrar”
Os campos de seleção que dependem de outro cadastro possuem esse botão. Use-o para incluir uma nova opção sem fechar ou perder o formulário atual; o registro recém-criado será selecionado automaticamente.
Perguntas com consequência explicada
Decisões importantes não usam mensagens genéricas do navegador. O SGO apresenta as alternativas em um modal próprio, explica o efeito de cada escolha, destaca a recomendada e mantém sempre a opção de cancelar e voltar. Isso vale para dependências de composições e publicação de revisões.
Fonte externa
Importar uma edição oficial do SICRO
Uma edição representa uma combinação específica de competência, localidade e regime. Os arquivos oficiais entram completos para preservar a rastreabilidade.
Crie ou abra a base oficial
Acesse Bases oficiais. Use uma base por fonte publicadora, por exemplo, SICRO.
Cadastre a edição
Informe competência, localidade, regime e revisão. Confirme se os arquivos são com ou sem desoneração.
Selecione os cinco relatórios
Composições sintético e analítico; materiais, equipamentos e
mão de obra sintéticos. Envie exatamente os cinco arquivos
.xlsx.
Valide e publique
Depois da validação, publique a edição. Publicações são imutáveis e ficam disponíveis para consulta e cópia seletiva.
Arquivos com desoneração
Equipamentos e mão de obra devem pertencer ao mesmo regime informado na edição. Misturar relatórios de regimes diferentes bloqueia a carga.
Antes de publicar
Conferir uma competência na Central de validação
Após a importação, abra Bases oficiais, gerencie a fonte e clique em Abrir edição. A Central substitui a antiga consulta separada de itens e compara a carga com a competência anterior da mesma base, localidade e regime. Quando não existe competência anterior, todos os registros são tratados como novos.
A edição é organizada em Composições, Materiais, Equipamentos e Mão de obra. Dentro de cada área você pode consultar todos os registros ou filtrar novos, alterados, removidos e sem associação. Ocorrências continuam disponíveis como uma visão transversal da importação.
Integridade
Total importado, erros bloqueantes, avisos e situação do processamento determinam se a edição pode ser publicada.
Diferenças
Itens novos, alterados e removidos são apresentados em listas paginadas. Alterações exibem valores anteriores e variação de preço.
Cobertura
O painel informa quantos vínculos foram herdados e qual percentual dos códigos oficiais possui associação confirmada com o catálogo interno.
Resolva erros
Abra Ocorrências e corrija relatórios inválidos antes de tentar publicar.
Analise alterações
Confira unidade, descrição e variações relevantes de custo em relação à competência anterior.
Trate itens sem associação
Associe individualmente ou selecione até 100 itens e use Revisar sugestões. O sistema compara código, descrição, unidade e tipo e informa o grau de confiança antes da confirmação.
Publique
Quando a edição estiver íntegra, use Publicar edição. O conteúdo ficará imutável e disponível para bases próprias e orçamentos.
Associação assistida, não automática
Sugestões de alta confiança normalmente possuem código idêntico, descrição compatível e a mesma unidade. Você pode trocar o item interno sugerido ou escolher Não associar agora. Somente as linhas revisadas e confirmadas são gravadas; o lote inteiro é revertido se alguma associação apresentar conflito.
Tutorial interativo
No cabeçalho, abra ◎ Tutorial e escolha “Conferir a Central de validação”. O guia destacará cada indicador e aguardará suas ações na tela.
Conhecimento da empresa
Montar uma base própria
Acesse Nossas bases. O sistema já fornece a “Base Própria Geral”, mas novas bases podem ser criadas para finalidades ou equipes diferentes.
| Campo | Como usar |
|---|---|
| Nome | Identificação estável, como “Base Própria Geral” ou “Infraestrutura Rodoviária”. |
| Descrição | Explique escopo, responsável e critério de uso. |
| Competência | Mês de referência dos preços daquela revisão. |
| Localidade | Área de aplicação; use GERAL quando não houver regionalização. |
| Regime | Com desoneração, sem desoneração, não aplicável ou ainda a confirmar. |
Comece simples
Use uma base corporativa geral e evolua para bibliotecas de tipologia e tabelas regionais. Evite duplicar todos os itens apenas para representar “alto padrão” ou “condomínio”.
Importação seletiva
Copiar um item ou um grupo
Abra uma revisão em rascunho
Somente rascunhos aceitam novos itens. Clique em Importar das bases oficiais.
Escolha uma fonte e uma edição publicada
Você pode alternar entre fontes sem perder a seleção já realizada.
Marque itens
Selecione individualmente, use “Selecionar página” ou
pesquise por código e descrição. A busca filtra
automaticamente enquanto você digita, ignora acentos e
combina partes separadas; por exemplo,
aco 25 encontra descrições que contenham “aço”
e “25”, mesmo em posições diferentes.
Adicione outras fontes, se necessário
O contador mantém a seleção acumulada de diferentes bases e competências.
Copie para a base própria
Confirme se composições devem incluir dependências. O sistema registra fonte, edição, código e preço original.
Cadastro próprio
Lançar um item manualmente
Na revisão em rascunho, clique em Item manual. Informe um código interno único, tipo, categoria, descrição, unidade e custo base.
Insumo
Material, mão de obra, equipamento, transporte, percentual ou outro recurso elementar.
Composição
Serviço formado por insumos ou outras composições. A edição detalhada dos componentes próprios será ampliada nas próximas entregas.
Código interno
Use uma convenção estável e legível. Não reutilize o mesmo código para itens tecnicamente diferentes.
Engenharia de custos
Composições e dependências
Uma composição descreve os recursos necessários para executar uma unidade de serviço. Ao importar uma composição oficial, o SGO pode percorrer sua árvore e copiar automaticamente materiais, equipamentos, mão de obra e composições auxiliares.
Composição selecionadaEx.: concreto estrutural executado.
→
DependênciasEquipe, equipamento, materiais e serviços auxiliares.
→
Snapshot próprioCoeficientes, ordem, seção e custos preservados na
revisão.
Se um componente já estiver associado a um item interno, ele será reutilizado. Isso reduz duplicidades e melhora a consistência entre composições.
Consulta disponível em todo o fluxo
Sempre que um registro for uma composição, o botão Ver componentes abre sua memória de cálculo sem retirar você da tela atual. A consulta está disponível nas referências oficiais, Central de validação, catálogo interno, bases próprias, seletores de importação e itens do orçamento. O visor apresenta seção ou tipo, código, descrição, unidade, coeficiente, valor unitário e subtotal.
No orçamento, os componentes exibidos pertencem ao snapshot da versão. Assim, uma alteração posterior no catálogo não modifica a memória de cálculo já registrada na proposta.
Equivalência técnica
Associar referências a itens internos
Uma associação declara que um item externo corresponde a um item conhecido pela empresa. Ela não altera a fonte oficial.
| Natureza | Quando usar |
|---|---|
| Equivalência | O item interno representa tecnicamente a mesma coisa, considerando o fator de conversão. |
| Alternativa executiva | O item interno é uma solução diferente que atende ao mesmo objetivo técnico. |
Informe sempre fator de conversão e justificativa. A cópia seletiva cria uma equivalência confirmada quando ainda não há associação, preservando a rastreabilidade.
Associação permanente entre competências
O vínculo pertence à base, ao tipo e ao código oficial — não à competência nem ao estado. Quando o mesmo código aparece em uma nova competência ou localidade da mesma base, a associação é herdada automaticamente. Preços e descrições continuam versionados em cada edição.
Governança e produtividade
Assistência por inteligência artificial
A IA é opcional e atua somente na revisão de sugestões de associação. O SGO primeiro aplica regras de tipo, categoria, unidade, código e descrição; depois, no modo híbrido, solicita uma análise semântica dos melhores candidatos.
| Onde configurar | O que pertence ali |
|---|---|
| Parâmetros gerais | Ativar ou desativar, escolher o modo, limitar o lote e definir a confiança mínima. |
| Ambiente da API | OPENAI_API_KEY, OPENAI_MODEL e, opcionalmente, OPENAI_BASE_URL. Segredos nunca ficam no banco nem aparecem na tela. |
Decisão humana obrigatória
A IA apresenta confiança, justificativa e riscos, mas não grava vínculos. Cada sugestão precisa ser revisada e confirmada na Central de validação. Se o serviço estiver indisponível, o SGO conclui a análise usando somente as regras técnicas e informa o fallback ao usuário.
Prepare o servidor
Configure a chave e o modelo no ambiente da API e reinicie o processo. Não coloque a chave no navegador, em documentação ou no repositório.
Defina a política
Abra Parâmetros gerais, escolha Regras + IA semântica, ajuste os limites e ative a assistência.
Revise na Central
Em Sem associação, selecione os itens e use Analisar sugestões. Confira o motor utilizado, a confiança, o parecer e os riscos antes de confirmar.
Aplicação comercial
Como funciona um orçamento
Um orçamento pertence a uma oportunidade e possui versões. Na lista de orçamentos, use Abrir para acessar a área de trabalho, consultar o histórico e montar a proposta.
Crie a primeira versão de venda
A versão começa como rascunho. Enquanto estiver nesse estado, sua estrutura e seus preços podem ser alterados.
Organize a EAP por etapas
Divida a obra em serviços preliminares, fundação, estrutura, instalações e acabamento. Etapas podem possuir subetapas e acumulam os valores delas.
Adicione os itens dentro da etapa
Em cada etapa, clique em + Item nesta etapa, escolha catálogo interno, base própria ou base oficial e informe quantidade, preço unitário, BDI e desconto. O vínculo com a etapa é automático.
Confira e aprove
O painel calcula o total com arredondamento HALF_UP. Cada etapa mostra seu total acumulado. A aprovação protege a versão contra alterações; qualquer evolução posterior deve ser feita em uma nova revisão.
Edição controlada
Etapas e itens podem ser editados ou excluídos somente enquanto a versão estiver em rascunho.
Snapshot
Código, descrição, unidade, custo, fonte e componentes são preservados no momento da inclusão.
Histórico
Versões aprovadas e canceladas não podem ser apagadas. Uma revisão copia a estrutura anterior e mantém a trilha de auditoria.
Catálogo unificado
Escolher itens e preços
Uma proposta pode combinar itens de origens diferentes. A escolha acontece item a item e não modifica a fonte original.
| Origem | Quando usar | O que fica registrado |
|---|---|---|
| Catálogo interno | Item já conhecido pela empresa, inclusive composições próprias. | Identidade interna, custo atual, código, unidade e componentes. |
| Base própria | Preço corporativo publicado e validado para uma competência ou região. | Nome da base, revisão, item interno e custo daquela revisão. |
| Base oficial | Preço direto do SICRO ou de outra edição governamental publicada. | Fonte, edição, competência, referência oficial e eventual associação confirmada. |
Pesquisa enquanto digita
Em qualquer aba, digite partes do código ou da descrição. Os termos podem estar separados e a pesquisa ignora acentos. A lista mostra o preço disponível antes da escolha.
Preço de referência não é sentença
O custo da fonte preenche o preço unitário inicial, mas o responsável pode ajustá-lo, aplicar BDI e desconto. O valor original continua preservado no snapshot para auditoria.
Venda aprovada
Do comercial ao orçamento executivo
Depois que uma versão de venda é aprovada, o botão + Orçamento executivo fica disponível. O SGO copia etapas, itens, quantidades, preços, componentes e snapshots para um novo rascunho executivo.
1
Linha de base
A execução começa exatamente com o conteúdo vendido, sem redigitação e sem alterar a proposta aprovada.
2
Teto de venda
O total comercial aprovado torna-se o teto visível do executivo. A aprovação é bloqueada se o planejamento ultrapassá-lo.
3
Evolução independente
O executivo pode ajustar quantidades e preços em rascunho e gerar suas próprias revisões, mantendo o vínculo com a venda de origem.
4
Responsável técnico
Registre nome, função, conselho profissional, número do registro, UF e contatos. Esses dados pertencem à revisão executiva e são preservados no histórico.
O executivo não é uma segunda proposta
A venda registra o compromisso assumido com o cliente. O executivo é a visão interna usada para detalhar como a empresa entregará a obra dentro desse valor. Por isso, os dois possuem versões e aprovações independentes, mas permanecem ligados.
Responsável técnico não é sinônimo de elaborador
O profissional que responde tecnicamente pela versão pode ser diferente de quem levantou quantitativos, elaborou preços ou fez a aprovação interna. O cadastro atual identifica o responsável técnico; perfis separados de elaboração e aprovação podem ser incorporados à governança futura.
Entrega e conferência
Exportar o orçamento em Excel e PDF
Abra a versão desejada e use os botões Excel ou PDF no cabeçalho. O arquivo sempre representa a versão que está na tela; assim, uma proposta comercial e um orçamento executivo nunca são misturados acidentalmente.
Excel para análise
A planilha contém uma aba de resumo e outra com os itens por etapa. Quantidades, preços, BDI, descontos e totais são exportados como números, permitindo filtros e fórmulas.
PDF para apresentação
O relatório é paginado e identifica cliente, oportunidade, tipo, número e situação da versão. No executivo, também informa o teto originado pela venda.
Rastreabilidade
Gere o arquivo novamente após qualquer alteração no rascunho. Versões aprovadas permanecem imutáveis e podem ser reproduzidas a qualquer momento.
Planejamento integrado
Conceito de planejamento da obra
Planejar não é apenas informar quantos dias a obra dura. É transformar a EAP do orçamento em uma rede executável de atividades, com sequência, recursos, calendário e metas. O orçamento responde o que será executado e quanto custa; o planejamento responde quando, em que ordem, por quem e com qual avanço esperado.
EAP do orçamentoEtapas, subetapas, serviços, quantidades e custos.
→
CronogramaAtividades, duração, predecessoras, equipes e
calendário.
→
ControleLinha de base, caminho crítico, medições e curva
físico-financeira.
| Conceito | Como funciona | Aplicação no SGO |
|---|---|---|
| EAP | Decompõe a obra em entregas e pacotes controláveis. | As etapas e subetapas já formam essa estrutura; seus itens permanecem dentro delas. |
| Atividade | Trabalho programável com início, fim e duração. | A primeira versão cria uma atividade para cada etapa da EAP. O detalhamento por serviço será uma evolução posterior. |
| Duração | Resultado de quantidade, produtividade, equipe disponível e calendário. | Exemplo: 1.000 m² ÷ 100 m²/dia = 10 dias úteis, sujeito à equipe e às restrições. |
| Dependência | Define a sequência lógica: término-início, início-início, término-término e defasagens. | As relações já podem ser registradas e ciclos são bloqueados. O cálculo automático de datas e caminho crítico será a próxima evolução. |
| Linha de base | Fotografia aprovada do cronograma para comparar planejado e realizado. | Cada replanejamento preservará histórico, como já ocorre nas versões do orçamento. |
| Curva físico-financeira | Distribui avanço físico e custos no tempo. | Usará os valores das etapas para prever desembolso, medição e necessidade de caixa. |
Decisão de arquitetura
O cronograma possui versões próprias ligadas ao orçamento executivo. Assim uma mudança de data não altera o preço aprovado, e uma revisão de custo não apaga a linha de base do planejamento.
Por que os itens ficam na etapa
Quantidade, custo, equipe e produtividade precisam apontar para o mesmo pacote de trabalho. Esse vínculo permite calcular duração, consolidar subtotais, medir avanço e comparar planejado versus realizado por etapa.
Segurança e histórico
Rascunho, publicação e revisão
| Estado | Significado | Pode editar? |
|---|---|---|
| Rascunho | Base em preparação e validação. | Sim |
| Publicada | Versão aprovada para uso e auditoria. | Não |
| Arquivada | Versão histórica fora do uso corrente. | Não |
Para atualizar uma publicação, crie uma nova revisão. Por padrão, todos os itens, origens e componentes da revisão anterior são copiados para o novo rascunho.
Qualidade
Boas práticas recomendadas
Não edite a verdade externa
Uma divergência da fonte deve virar ocorrência ou nova revisão, nunca alteração silenciosa.
Explique associações
Registre por que dois itens são equivalentes e qual fator converte suas unidades.
Publique somente após conferir
Revise preços, unidades, dependências e localidade antes de fechar a versão.
Evite bases combinatórias
Prefira catálogo compartilhado, bibliotecas de empreendimento, padrões e tabelas regionais.
Diagnóstico
Solução de problemas
“API indisponível”
Confirme se api-orcamento está online no PM2 e
se a porta 3338 está acessível.
Arquivo não reconhecido
Utilize os relatórios oficiais em XLSX, mantenha seus nomes descritivos e selecione os cinco tipos exigidos.
Pacote duplicado
O mesmo conjunto de arquivos não pode ser importado novamente em uma revisão equivalente.
Base própria não aceita item
Verifique se a revisão ainda está em rascunho e se o código interno não está sendo usado.
Consulta rápida
Glossário
- Competência
- Mês ao qual os preços se referem.
- Desoneração
- Regime de encargos que influencia custos de mão de obra e equipamentos.
- Insumo
- Recurso elementar consumido por um serviço.
- Composição
- Serviço calculado a partir de coeficientes e componentes.
- Coeficiente
- Quantidade de um componente necessária para uma unidade da composição.
- Snapshot
- Fotografia dos dados e preços no momento de uma operação.
- Rastreabilidade
- Capacidade de identificar fonte, edição e decisões que produziram um valor.
- BDI
- Bonificação e despesas indiretas aplicadas na formação do preço de venda.