---
title: Estados da empresa
description: >-
  Referência operacional dos estados documentados de uma empresa e de seus
  efeitos sobre a operação normal no GovFrame.
audiencia: Administrador | Superadministrador | Administrador de plataforma
roles: >-
  Superadministrador ou Administrador de plataforma autorizado para gestão
  global; Administrador para revisar o impacto em sua empresa
modulo: Administração da empresa
revision: '2026-10-19'
section: seguridad
order: 20
sources:
  - CONTEXT.md
  - ARCHITECTURE.md
  - AGENTS.md
  - Módulosydependencias.md
  - 'Roles,capacidadesyalcance.md'
locale: pt-br
---
# Estados da empresa

No GovFrame, uma empresa cliente é modelada como uma empresa isolada dentro do serviço. Seu estado operacional faz parte do controle de acesso: junto com a associação, o papel, a capacidade, o escopo e os módulos, determina se uma pessoa pode realizar operações normais. A condição da empresa não é obtida de um identificador enviado pelo navegador nem pode ser contornada alterando uma rota.

Esta página se limita aos **estados documentados para a empresa**. Não define estados para workflows, solicitações, objetos de catálogo nem outros registros. Tampouco pressupõe uma sequência de transição, aprovações, prazos ou telas específicas que não estejam documentados publicamente.

## Antes de começar

- **Papel:** a gestão global de empresas cabe ao Superadministrador ou ao Administrador de plataforma quando o procedimento autorizado permitir. O Administrador da empresa pode avaliar o impacto de uma alteração sobre pessoas, módulos e operações, mas não deve presumir atribuições globais fora de sua empresa.
- **Módulo:** use as capacidades de administração da empresa e da plataforma que estiverem disponíveis para a empresa e para seu perfil. A condição da empresa é diferente de ativar ou desativar um módulo de negócio.
- **Pré-condições:** identifique sem ambiguidade a empresa de destino e confirme que está atuando em seu contexto autorizado. Antes de solicitar ou executar uma alteração, revise as associações, os escopos, os módulos e as dependências que poderiam afetar a continuidade do trabalho.

## Estados documentados

| Estado da empresa | Interpretação operacional documentada |
|---|---|
| `provisioning` | A empresa está em fase de preparação. Não deve ser tratada como habilitada para a operação normal: somente `active` permite operações normais. |
| `active` | É o único estado que permite as operações normais da empresa, desde que sejam atendidos os requisitos de associação, papel, capacidade, escopo e módulos habilitados. |
| `suspended` | A empresa não deve operar normalmente. Uma associação ou um papel não restabelece essa operação enquanto esse estado for mantido. |
| `disabled` | É um estado documentado da empresa e não habilita operações normais, pois estas são reservadas a `active`. A documentação disponível não prescreve uma tela, transição ou tratamento adicional específico. |
| `deprovisioned` | É um estado documentado da empresa e não habilita operações normais. Não deve ser interpretado, por si só, como uma ordem para apagar dados, restaurar acessos ou alterar configurações: esses efeitos exigiriam um procedimento documentado. |

## Percurso recomendado

1. **Identifique a necessidade e a autoridade competente.** Diferencie um incidente de acesso de uma decisão sobre a condição de toda a empresa. Se o escopo for global, encaminhe-o ao Superadministrador ou ao Administrador de plataforma autorizado. Não tente resolver o problema alterando identificadores, scopes ou parâmetros no navegador.

2. **Revise o contexto operacional.** A empresa efetiva é resolvida na sessão e, normalmente, com base no hostname normalizado. Uma pessoa Superadministradora pode selecionar uma empresa que permita operações normais para uma tarefa global. Essa seleção não transforma o papel de plataforma em uma permissão ilimitada sobre os objetos da empresa: permanecem as verificações de associação, capacidade, escopo e módulo.

3. **Avalie o impacto funcional sem presumir automatismos.** Quando a empresa não estiver em `active`, não devem ser realizadas operações normais. Verifique quais pessoas, tarefas e processos ficarão sem continuidade operacional e comunique o efeito pelo canal autorizado. As fontes não estabelecem um cronograma automático de suspensão, reativação, exclusão, restauração ou notificação; portanto, não planeje esses efeitos como se estivessem habilitados por padrão.

4. **Separe o estado da empresa dos módulos.** Um módulo desativado oculta ou bloqueia sua própria operação, e o serviço rejeita seus procedimentos, mas essa configuração não equivale a alterar o estado da empresa. Por outro lado, o fato de um módulo estar habilitado não permite operar se a empresa não estiver em `active`. Segundo a documentação disponível, os dados de um módulo desativado não são excluídos automaticamente.

5. **Verifique o acesso após a decisão autorizada.** Para uma empresa em `active`, a operação normal continua dependendo dos demais controles. Para os outros estados documentados, não trate a existência de uma sessão anterior, um link salvo ou um menu visível como autorização. Alterações sensíveis na conta, no papel ou no escopo podem invalidar sessões conforme a política de segurança.

> **Exemplo sintético:** a empresa fictícia “Norte Exemplo” está registrada como `suspended`. Embora uma pessoa mantenha uma sessão anterior e tenha o papel de Administrador, não deve continuar com tarefas normais. A equipe autorizada deve avaliar o motivo e seguir seu procedimento de administração; este guia não inventa uma transição nem um formulário para alterar o estado.

## Resultado esperado

A equipe identifica os cinco valores documentados, sabe que somente `active` habilita operações normais e diferencia essa condição dos módulos, dos papéis e dos escopos. Qualquer alteração é tratada como uma decisão de administração autorizada, com avaliação de impacto e sem presumir automatizações ou efeitos sobre dados que não estejam documentados.

Para revisar o escopo dos objetos e as responsabilidades antes de avaliar um impacto, consulte [Modelo de objetos e relações](/pt-br/explicaciones/modelo-de-objetos-y-relaciones/), [Como ler o mapa de relações](/pt-br/guias/como-leer-mapa-de-relaciones/), [Papéis, capacidades e escopo](/pt-br/referencia/roles-capacidades-y-alcance/) e [Módulos e dependências](/pt-br/referencia/modulos-y-dependencias/).