Recursos, limites e cobrança

Tipo

Conceito

Para

Administrador do Tenant, Parceiro whitelabel, Engenharia de dados

Na tela

HEC › Recursos e Permissões › Recursos do Tenant › Gerenciar Recursos · HEC › Plano & Faturamento

Cada Tenant tem quatro recursos medidos, cada um com uma cota contratada: usuários, Processamento, Créditos de IA e linhas de Cadastro. Quando a cota acaba, alguns recursos bloqueiam e outros só passam a cobrar o excedente, conforme o tipo do Tenant. Os valores e os tamanhos de cota estão no contrato ou na tela do plano.

Os quatro recursos

Recurso	O que conta	Ao atingir a cota
Usuários	Pessoas ligadas ao Tenant. A Equipe do Cliente não entra na conta	Bloqueia cadastrar mais usuários
Processamento	GB gravados no mês mais a média armazenada. Veja Processamento	Bloqueia só em Tenant pré-pago
Créditos de IA	Consumo do Chat com Dados, Indicadores, Investigações e demais recursos de IA. Veja Créditos de IA	Bloqueia só em Tenant pré-pago
Cadastros (linhas)	Linhas de todos os Cadastros do Tenant somadas	Bloqueia criar, importar, clonar e restaurar linhas

Processamento e Créditos de IA são medidos por mês (no pré-pago, pelo ciclo da assinatura). Usuários e linhas de Cadastro valem pelo que existe agora.

Num Tenant corporativo, passar da cota de Processamento ou de Créditos de IA não para nada: o uso continua e o excedente entra na cobrança. Num Tenant pré-pago, a cota é o teto, e o recurso para até a cota aumentar ou o ciclo virar.

Quando a cota de usuários acaba

Cadastrar ou vincular mais uma pessoa mostra:

Limite de N usuário(s) atingido para este tenant. Use a tela de Gerenciar Recursos para aumentar a quota.

Quando a cota de linhas de Cadastro acaba

A cota é do Tenant inteiro, somando todos os Cadastros: um Cadastro grande consome o espaço dos outros. Entram na conta as linhas vivas, as que estão na lixeira de registros do Cadastro e as das versões substituídas que ainda estão na Lixeira. Excluir uma linha só libera espaço quando ela sai da lixeira.

Ao atingir a cota, criar linha, importar planilha, clonar e restaurar Cadastro param, com a mensagem Limite de linhas dos Cadastros atingido. Uma importação que passaria do limite é recusada inteira: nenhuma linha entra.

A cota de linhas é multiplicada pelo número de CNPJs do Tenant (veja CNPJs).

Processamento

O Processamento soma duas parcelas na mesma cota:

• Gravação: o tamanho do arquivo que cada execução de Dataflow grava no HorusDW, somado ao longo do mês. É o arquivo comprimido que chega ao destino, não o volume lido na origem.
• Armazenamento: a média de GB ocupados pelas tabelas e arquivos ao longo do mês.

As telas mostram as duas juntas, como Storage + Processamento.

As duas parcelas se comportam diferente. A gravação não volta atrás: byte gravado no mês está contado, e apagar a linha depois não devolve nada. O armazenamento acompanha o tamanho atual das tabelas: apagar histórico faz a média cair dali em diante.

Quando a cota esvazia em poucos dias, a causa quase sempre é a gravação, e quase sempre é um Dataflow regravando a mesma coisa várias vezes.

Como reduzir o consumo

Sintoma	O que fazer
Carga Total numa tabela grande, rodando várias vezes ao dia	Cada execução grava a tabela inteira. Troque para Incremental, com uma coluna de rastreio (updated_at ou ID sequencial) e Chave Única na tabela quando a linha pode mudar
A origem não tem coluna de rastreio	Use Janela, a mais estreita que a origem permitir, presa a uma data que não muda (emissão, criação)
Janela larga "para garantir"	Estreite até onde a origem deixa de corrigir ou apagar dado. Antes, confira se a consulta usa as datas da janela; se não usa, estreitar não muda nada
Agendamento a cada poucos minutos numa origem que quase não muda	Troque o gatilho por horário pelo gatilho de mudança de dados, que só dispara o Dataflow quando a origem mudou
SELECT * com colunas que ninguém usa	Tire primeiro as colunas com muitos valores diferentes (texto livre, UUID, timestamp com milissegundos). Coluna de poucos valores, como status ou filial, quase não pesa
Tabela de histórico que só cresce	Aqui pesa o armazenamento. Guarde menos histórico

Numa carga Total ou Janela, rodar o dobro de vezes grava o dobro. Numa carga Incremental, rodar mais vezes quase não muda o total, exceto quando a mesma linha muda várias vezes ao dia: aí cada execução regrava a linha.

Trocar o hardware do Agente ETL, o driver da conexão ou a compressão do banco de origem deixa a execução mais rápida, mas não muda o que é gravado nem o que é cobrado.

Trocar para Incremental tem um custo: linha apagada na origem não sai do destino. Leia Tipos de carga e Exclusões na origem antes de mudar.

CNPJs

O número de CNPJs do Tenant multiplica as cotas (no mínimo um). Ele aparece em Gerenciar Recursos, com Editar e Resincronizar. Quem edita é a Equipe HorusBI e a Equipe do Cliente nos níveis Superadministrador, Implantador e Operador. Quando o Tenant sincroniza os CNPJs automaticamente, ninguém edita à mão.

Onde contratar mais

Tenant	Tela
Corporativo	HEC › Recursos e Permissões › Recursos do Tenant › Gerenciar Recursos, com as abas Recursos e Limites e Inteligência Artificial
Pré-pago	HEC › Plano & Faturamento

Usuários e GB de Processamento se contratam de um em um. Créditos de IA e linhas de Cadastro vêm em Pacotes de 1 milhão. O plano pré-pago contrata só usuários, Processamento e Créditos de IA.

Aumento vale na hora. Redução vale a partir do próximo ciclo.

Quem pode contratar:

• A Equipe do Cliente nos níveis Superadministrador, Implantador e Operador. O nível Suporte só quando tem a permissão de contratar recursos.
• O administrador do Tenant, ou quem tem a função Autoatendimento de Recursos, quando o Cliente libera a compra pelo próprio Tenant ou quando o Tenant é pré-pago.

Os papéis estão em Papéis.

Acompanhar o consumo

A Home do HEC, para administradores, mostra o Dashboard de Consumo, com um card por recurso: Usuários, Storage + Processamento, Créditos de IA e Cadastros (Writeback). A tela tem seletor de período; confira qual está marcado antes de ler o número.

O detalhe do gasto de IA abre pelo link Detalhes do bloco IA e Comunicação, na mesma tela. O que consome crédito está em Créditos de IA.

Alertas de uso

A cada 4 horas o Lumo confere o consumo de usuários, Processamento, Créditos de IA e linhas de Cadastro. Ao passar de 80% da cota, avisa; ao chegar a 100%, avisa de novo. O mesmo aviso não se repete em menos de 24 horas para o mesmo recurso e a mesma faixa. Tenant pré-pago recebe ainda um aviso aos 85% de usuários, Processamento ou Créditos de IA, uma vez por ciclo, para os administradores.

Tenant	Quem recebe
De um Cliente (parceiro, revenda)	A Equipe do Cliente. O nível Suporte só se pode contratar recursos
Avulso	Os administradores do Tenant

O aviso chega no sino de notificações. Veja Notificações.

Suspender e encerrar

Um Tenant pode estar Ativo, Em Trial, Trial Expirado, Suspenso ou Cancelado. A regra de cobrança de cada status depende do tipo do Tenant.

Tenant corporativo

Quem muda o status é a Equipe HorusBI ou o parceiro, em Tenants. Tenant em trial não é cobrado.

Suspender tranca o acesso de todos os usuários. A cobrança para a partir do mês seguinte: o mês em que a suspensão acontece é cobrado inteiro. Desativar o Tenant pela API tem o mesmo efeito na cobrança. O contrato pode prever um valor mínimo mesmo com o Tenant parado.

WARNING

Tenant inativo perde as tabelas do HorusDW. Uma limpeza diária, às 05:20, apaga as tabelas de todo Tenant inativo, sem carência: o pós-pago suspenso pelo HEC, qualquer Tenant desativado pela API (ativo: false) e o excluído. Suspender um pré-pago pelo HEC não apaga. Ao reativar, a estrutura volta vazia e o dado só retorna com uma carga nova. O detalhe, com o que fica de fora, está em Tenants.

Tenant pré-pago

O status segue a cobrança do cartão, e a tela Plano & Faturamento mostra qual é.

Situação	O que acontece
A cobrança do ciclo falhou	O status vira Pagamento pendente e o Tenant tem 15 dias para regularizar. Os usuários continuam entrando e vendo os Dashboards, mas Dataflows, cargas no HorusDW e recursos de IA param
Passaram os 15 dias	A assinatura é encerrada e o Tenant fica Suspenso, sem acesso. O dado carregado pelos Dataflows pode ser apagado; ele volta numa nova carga das fontes
Suspenso ou cancelado	Por 90 dias, o administrador pode retomar a assinatura e baixar os Cadastros e os arquivos enviados, em Baixar meus dados. Depois disso, esses dados são removidos

Pagar a pendência dentro dos 15 dias reativa o Tenant.