A importação é o ponto de entrada do simulador. Ao receber a Curva ABC, o sistema:Documentation Index
Fetch the complete documentation index at: https://docs.znit.ai/llms.txt
Use this file to discover all available pages before exploring further.
- Parseia os itens (código, descrição, quantidade, unidade, custo)
- Classifica cada item em uma família (Material, Mão-de-obra, Equipamento, etc.)
- Mapeia automaticamente os materiais a fatores de emissão
- Cria um Cenário Base com as emissões calculadas
- Redireciona você para a tela de Itens
Antes de começar
Você precisa de pelo menos um arquivo obrigatório:- Curva ABC (
.xlsxou.xlsm) — exportada do iTwo. Deve conter as colunas:CostCode,Descrição,Quantidade,Unidade,Custo Total.
- Cost Code (catálogo iTwo) — dicionário oficial dos códigos da sua empresa
- Relatório Proof — decomposição de cada cost code em composições (RN → Assembly)
Passo a passo
Crie um projeto
No Painel, clique em Novo projeto. Preencha:
- Nome do projeto (ex:
Raízen VRO R8) - Cliente (ex:
Raízen) - Endereço (opcional)
- Área total em m² (importante para o KPI de intensidade kgCO₂e/m²)
- Tipo de obra (Industrial, Residencial, Comercial, etc.)
Selecione o modo
Escolha o modo na barra superior:
- Cenário Completo — para Itens + Insumos (decomposição via composições SECAGEM)
- Curva ABC — para um único arquivo da Curva ABC (mais comum)
- Conexões API — em breve (iTwo, AltoQI, Sienge, OrçaFascio, Vigha)
Suba o arquivo principal
Arraste o
.xlsx/.xlsm para a área de upload ou clique em Selecionar arquivo.Adicione arquivos opcionais (recomendado)
Após o upload do principal, clique em + Adicionar arquivos opcionais para aumentar cobertura e suba:
- Catálogo Cost Code do iTwo
- Relatório Proof (decomposição de cost codes)
O que acontece nos bastidores
Durante o processamento, o sistema:| Etapa | O que faz |
|---|---|
| Parse | Extrai os itens da planilha, normaliza unidades (m², kg, h…), classifica em Pareto P1/P2/P3 por custo acumulado |
| Classificação | Identifica o tipo de cada item (A: Material, B: Mão de obra, C: Item agrupado, D: Material embutido, E: Equipamento, F: Administrativo) |
| Auto-exclusão | Marca como excluídos itens que não geram emissão direta de Scope 3 materiais (mão-de-obra, equipamento, subcontratos) — com justificativa registrada |
| Auto-mapeamento | Busca fator de emissão para cada item Tipo A em: Factor Rules → GHG Protocol → CECarbon → EPD (com GWP) → Ecoinvent |
| Cenário Base | Cria automaticamente o cenário inicial calculado a partir desses fatores |
A regra de hierarquia (EPD → GHG → Ecoinvent) reflete o padrão de inventário de carbono em construção: priorizamos fatores certificados e brasileiros sempre que disponíveis.
Erros comuns na importação
'Cabeçalho não detectado'
'Cabeçalho não detectado'
O parser procura colunas com nomes parecidos com
CostCode, Descrição, Quantidade, Unidade, Custo Total. Se seu arquivo usa outros nomes:- Renomeie a primeira linha de cabeçalho para combinar com o padrão iTwo
- Ou exporte novamente do iTwo (que já vem com os nomes corretos)
'Formato inválido. Use .xlsx ou .xlsm'
'Formato inválido. Use .xlsx ou .xlsm'
O sistema aceita apenas planilhas Excel modernas. Converta arquivos
.xls (formato 97/2003) para .xlsx antes de subir.Itens importados mas todos pendentes
Itens importados mas todos pendentes
Significa que o auto-mapeamento não conseguiu casar nenhum item com fatores. Verifique:
- O arquivo realmente é uma Curva ABC válida?
- As descrições estão em português e fazem sentido (não estão truncadas)?
- Você pode subir o Cost Code + Relatório Proof e reprocessar para melhorar a cobertura.
Processamento muito lento (> 5 min)
Processamento muito lento (> 5 min)
Projetos com mais de 500 itens podem demorar. Se passar de 10 minutos, é provável que tenha dado timeout. Tente importar novamente. Se persistir, abra suporte.