Glossário

Termos usados no Almare Nexus. Entender este vocabulário resolve a maior parte das dúvidas.

Plataforma e organizações

Organização (Tenant) : Cliente isolado da plataforma. Usuários, perfis, obras e demais dados de negócio pertencem a uma organização e não podem ser consultados por outra. A organização é a fronteira de segurança; uma SPE ou empresa legal continua sendo um conceito interno do cliente.

Administrador da plataforma / Operador ERP : Usuário com flag is_erp_admin (Operador ERP) e/ou permissões do recurso tenant na org plataforma (tenant:list, tenant:create, tenant:update, tenant:delete). Pode cadastrar, suspender e excluir organizações clientes e delegar memberships em todas as orgs ativas. Não dispensa membership e perfis para operar o ERP no dia a dia dentro de cada org.

Organização ativa : Organização disponível para acesso dos seus membros. Uma organização suspensa permanece cadastrada e preserva seus dados, mas deixa de poder ser selecionada pelos usuários.

Provisionamento da organização : Criação coordenada da organização e de seu acesso inicial. Inclui membership ativo, perfil Administrador, permissões e vínculo da identidade indicada; todas as etapas são confirmadas ou desfeitas juntas.

Membro (Membership) : Vínculo que autoriza uma identidade a acessar uma organização. Pode ser suspenso, reativado ou removido sem excluir a identidade e sem afetar outras organizações.

Perfil de acesso : Conjunto de permissões atribuído a um membro dentro de uma organização. Perfis e seus vínculos nunca atravessam a fronteira do tenant.

Recurso : Entidade ou área funcional do sistema (ex.: purchase_request, profile). Identificado por um nome técnico; agrupado por módulo na consulta de catálogo.

Ação : Operação sobre um recurso (ex.: create, list, approve). Combina-se ao recurso para formar uma permissão (recurso:acao).

Permissão : Par recurso + ação que libera uma operação específica na interface e na API. Vinculada a perfis dentro de cada organização.

Obras e estrutura

Obra (Projeto) : O empreendimento em si. Quase tudo no sistema é vinculado a uma obra.

EAP (Estrutura Analítica do Projeto) : A árvore que organiza a obra em partes (serviços/etapas). Os nós folha (sem filhos) são os únicos que recebem apontamento de insumos em um pedido. Exibida como código — nome (ex.: 01 — Serviços preliminares).

Insumo : Material, mão de obra ou serviço que pode ser comprado/apontado (ex.: "Cimento CP-II", "sc").

Fornecedor : Empresa ou pessoa que cota e vende insumos.

Compras

Pedido de compra : A necessidade de compra registrada por uma obra: quais insumos, em qual EAP, e a quantidade. É o ponto de partida do fluxo.

Orçamento (Cotação) : O convite a um fornecedor para precificar os itens de um pedido. Um pedido pode ter vários orçamentos (um por fornecedor). O fornecedor devolve preços e condições — é o retorno.

Retorno do orçamento : O preenchimento dos preços unitários e das condições comerciais (desconto, frete, impostos, condição de pagamento) informados pelo fornecedor.

Análise comparativa : A comparação, item a item, entre os orçamentos retornados, para escolher o(s) vencedor(es).

Ordem de Compra (OC) : O documento de compra efetiva gerado a partir dos vencedores da análise. Funciona como um retrato editável das condições enquanto está Emitida; após Enviada ao fornecedor, os dados comerciais ficam congelados.

Recebimento : O registro da entrega do material contra uma OC. Pode ser parcial (entregas em partes) ou total.

Condições comerciais

Desconto global : Desconto informado pelo fornecedor sobre o total do orçamento. Na análise, é rateado proporcionalmente entre os itens.

Frete : Pode ser Incluído (sem valor adicional), CIF (por conta do fornecedor) ou FOB (por conta do comprador), com um valor associado.

Impostos / taxas : Valor adicional de tributos informado no retorno.

Condição de pagamento : Como o pagamento será feito: À vista, N dias, Parcelado (Nx) ou Personalizado (cronograma de parcelas).

Cronograma de parcelas (Personalizado) : Lista de parcelas com tipo (percentual ou valor fixo), valor e vencimento (na emissão da OC, X dias após a emissão, no recebimento ou manual). Regra: a soma dos percentuais deve ser 100%, ou a soma dos valores fixos deve igualar o total.

Geral

Status : O estado atual de um registro no seu fluxo (ex.: um orçamento em Aguardando retorno). Ver Status do módulo Compras.

Histórico (auditoria) : Registro de quem alterou o quê e quando, disponível em vários cadastros.

Comercial e financeiro

CUB (Custo Unitário Básico) : Índice de custo da construção usado para precificar cotas e corrigir parcelas. Cada obra usa uma região CUB; os índices mensais têm mês de referência e mês de utilização.

Cota / Unidade comercial : Fração do empreendimento vendida (apartamento, sala etc.). Identificada por código (torre + número). Status: Disponível → Reservada → Vendida.

Tabela de cotas : Precificação mensal das unidades disponíveis, publicada após atualização do CUB. Versões anteriores ficam no histórico.

Reserva : Antecipação vinculada à unidade; o valor abate da 1ª entrada na venda.

Venda (termo de adesão) : Contrato que congela CUB, percentuais e plano de pagamento. Pode ter vários cotistas com participação percentual.

Cotista : Comprador (pessoa física ou jurídica) participante de reservas e vendas.

Distrato : Encerramento da venda com tipo de devolução (integral, parcial ou nenhuma); libera a unidade.

Conta a receber : Cobrança gerada a partir do plano, com valor indexado pelo CUB e baixa de pagamentos.

Ver Fluxo Comercial e Status do módulo Comercial.

Portal do Cotista

Termos da área de autoatendimento do comprador. Ver O Portal do Cotista.

Portal do Cotista : Aplicativo de autoatendimento onde o cotista consulta documentos, extrato, boletos, envia personalização e acompanha o avanço da obra. Vê apenas as próprias cotas (isolamento por cotista) e apenas lê os dados comercial/financeiro existentes.

Cotista (no portal) : A pessoa (física ou jurídica) que comprou cotas e acessa o portal. A identidade é unificada pelo e-mail; a mesma pessoa pode ter cadastros de cotista em várias SPEs sob o mesmo login.

Cota (unidade adquirida) : A venda efetivada de uma unidade. É o objeto central do portal — reúne documentos, extrato, boletos, plantas e personalização. Pode ter co-titulares.

SPE / obra : A Sociedade de Propósito Específico do empreendimento, com CNPJ próprio (usado no primeiro acesso). Uma cota pertence sempre a uma SPE.

Co-titularidade : Cota com mais de um titular. Os co-titulares compartilham arquivos, extrato, boletos e o processo de personalização da cota.

Fase de personalização : Janela de prazo (início e fim) em que a SPE aceita o envio de plantas de personalização. Fases podem se sobrepor; a submissão vale para a combinação fase + cota.

Submissão de personalização : Envio de arquivo(s) do cotista para uma fase aberta. Estados: PENDENTE, APROVADO ou REPROVADO (com justificativa e novo prazo). Ver Referência do portal.

Extrato indexado ao CUB : Demonstrativo das parcelas da cota, com valores corrigidos pelo CUB: por parcela, valor base, quantidade de CUBs, valor atualizado e valor pago, com totais.

Boleto (2ª via) : Cobrança já emitida que o cotista pode rebaixar (2ª via) e pagar por linha digitável ou PIX. O portal não gera cobranças novas.

Notificação (in-app) : Aviso dentro do portal sobre eventos relevantes (ativação, aprovação/reprovação, prazos, avanços, novos documentos). O usuário marca lida/não lida; o histórico é retido.

App Password (senha de app) : Senha específica gerada na conta Google para autenticar o envio de e-mail por SMTP, sem usar a senha principal. Ver Configurar o e-mail SMTP do Google.