# Empresas residentes

> As empresas que ocupam o coworking, com o contrato (tipo de residência, valor mensal, início e saída) e a equipe de cada uma. O admin da empresa convida colegas, que entram ao aceitar, e remove quem saiu; cada pessoa vê a própria empresa em Minha empresa, e a equipe da comunidade encerra a residência.

As **empresas residentes** são as empresas que ocupam o seu coworking: a startup da sala 3, o escritório de contabilidade da mesa fixa, a consultoria que usa só o endereço. Cada empresa tem um **contrato** (o tipo de residência, o valor mensal, o início e a saída) e uma **equipe**, as pessoas que trabalham nela. Uma delas pode ser **admin da empresa** e cuidar da própria equipe, sem depender da recepção.

A empresa **não é um membro**: não tem login, não aparece na lista de membros nem nas contagens. Quem entra na comunidade são as pessoas da equipe, cada uma com a sua conta.

## Para que serve

| Situação | Empresas residentes |
|---|---|
| Sala privativa | A recepção cadastra a empresa e convida a sócia; ela inclui os outros cinco funcionários |
| Mesa fixa | O contrato fica registrado com o valor e a data de saída, à vista de quem cuida do financeiro |
| Escritório virtual | A empresa existe no cadastro mesmo sem ninguém trabalhando no espaço todo dia |
| Troca de funcionário | O admin da empresa remove quem saiu e convida quem chegou, por e-mail |
| Fim da residência | A equipe encerra a empresa e decide, num clique, se todos saem junto |

## Como funciona

### Onde fica

- **Administração › Empresas**: a lista das empresas residentes, para a equipe da comunidade. É ali que se cadastra, edita, convida e encerra.
- **Minha empresa**, no menu da conta: a empresa em que você está e a equipe dela. O item só aparece para quem está na equipe de uma empresa.

### O contrato

Cada empresa guarda:

| Campo | O que é |
|---|---|
| **Nome da empresa** | Como ela aparece na lista e em **Minha empresa** |
| **Tipo de residência** | **Sala privativa**, **Mesa fixa** ou **Escritório virtual** |
| **Valor mensal** | Registro, sem cobrança, na moeda da comunidade. Pode ser zero |
| **Início** | A data em que o contrato começou |
| **Saída prevista** | Opcional. Não pode ser antes do início |

> [!NOTE]
> O contrato é um registro: a cobrança continua sendo a assinatura que a empresa compra. O **Valor mensal** não gera cobrança nem entra no extrato; ele serve para a equipe saber quanto cada empresa paga. Para cobrar, use um [plano](/monetizacao/planos) que a empresa assine.

A empresa fica **Ativa** enquanto o contrato está em vigor. Com a saída prevista no passado, ela passa a **Encerrada** na lista, mas a equipe continua vinculada até alguém encerrar a empresa de fato (ver [Encerrar uma empresa](#encerrar-uma-empresa)).

### Quem vê o quê

| | Lista de empresas | Valor e datas do contrato | Cadastrar, editar e encerrar | Convidar e remover na equipe | Marcar o admin da empresa |
|---|---|---|---|---|---|
| **Proprietário** e **administrador** | Sim | Sim | Sim | Sim | Sim |
| **Financeiro** | Sim | Sim | Não | Não | Não |
| **Moderador** | Sim | Não | Não | Não | Não |
| **Admin da empresa** | Não (vê a sua em **Minha empresa**) | Não | Não | Sim, na própria empresa, enquanto ela está ativa (o convite depende do aceite) | Não |
| **Membro** | Não | Não | Não | Não | Não |

- O **financeiro** vê tudo, sem editar.
- O **moderador** vê a lista sem o valor e sem as datas do contrato: o cartão mostra *"Contrato visível só para a gestão"*.
- O **membro** não vê a lista. Se ele está na equipe de uma empresa, vê a própria em **Minha empresa**.
- O **admin da empresa** vê **Minha empresa** com a equipe, sem o contrato, e pode convidar e remover colegas enquanto a empresa está ativa.

### A equipe e o admin da empresa

A equipe de cada empresa mostra as pessoas com o selo **Admin da empresa** para quem é admin, e um selo de como entrou:

- **Entrou pela empresa**: a pessoa chegou à comunidade pelo convite da empresa.
- **Já era membro da comunidade**: a pessoa já estava na comunidade e só ganhou o vínculo com a empresa.

O proprietário ou o administrador marca um funcionário como admin da empresa com **Tornar admin** (e desfaz com **Tirar admin**). O admin da empresa **convida colegas por e-mail** e **remove** quem saiu. Ele não muda o contrato nem marca outro admin.

### Convite com aceite

O convite funciona de dois jeitos, conforme quem convida:

| Quem convida | O que acontece |
|---|---|
| **Proprietário** ou **administrador** da comunidade | Vincula na hora. Quem já é membro entra na equipe sem e-mail; quem ainda não é entra na comunidade como membro, recebe o convite por e-mail e já aparece na equipe |
| **Admin da empresa** | A pessoa recebe um convite por e-mail e **entra na equipe só quando aceitar**, mesmo que já seja da comunidade. Quem ainda não é membro também recebe o convite da comunidade e entra nela como membro |

Os convites do admin da empresa que ainda não foram respondidos aparecem em **Convites pendentes (N)**, cada um com o e-mail e *"Enviado em …"*. A lista mostra só o e-mail digitado, nunca se a pessoa já era da comunidade.

### Limites

- **Uma pessoa fica numa empresa só.** Quando o proprietário ou o administrador convida quem já está na equipe de outra empresa, o convite é recusado: *"Esta pessoa já está na equipe de outra empresa."* No convite do admin da empresa, a recusa só aparece para a própria pessoa, ao aceitar: *"Você já está na equipe de outra empresa; saia dela antes de aceitar este convite."*
- O convite **respeita o bloqueio da comunidade**: se ela não está aceitando novos membros, o convite é recusado (*"A comunidade não está aceitando novos membros agora."*).
- O convite **respeita quem recusou convites**: quem pediu para não participar da comunidade não recebe o e-mail (*"… pediu para não participar desta comunidade; o convite não foi enviado."*).
- O **admin da empresa** manda até **30 convites por hora**; acima disso, a tela pede para tentar mais tarde. O proprietário e o administrador da comunidade não têm esse limite.
- Uma empresa encerrada **não aceita convites**, e o admin dela não convida nem remove mais ninguém. O proprietário e o administrador da comunidade continuam podendo remover.

## Passo a passo

### Cadastrar uma empresa

*Proprietário ou administrador.*

1. Abra **Administração › Empresas** e clique em **Nova empresa**.
2. Preencha **Nome da empresa**, **Tipo de residência**, **Valor mensal** e **Início**. A **Saída prevista** é opcional.
3. Clique em **Cadastrar**. A empresa aparece na lista, ainda **sem equipe**.

Para mudar o contrato depois, abra a empresa e use **Editar**.

### Convidar para a equipe

*Proprietário, administrador ou o admin da empresa.*

1. Abra a empresa (em **Administração › Empresas**, ou em **Minha empresa** se você é o admin dela) e clique em **Convidar**.
2. Informe o **E-mail** e, se a pessoa ainda não tem conta, o **Nome**.
3. O proprietário e o administrador podem marcar **Admin da empresa** já no convite.
4. Clique em **Convidar**.

Convidando como **proprietário ou administrador**, quem ainda não é membro entra na comunidade como membro e recebe o convite por e-mail; ele já aparece na equipe (*"Convite enviado para …; a pessoa já está na equipe."*). Quem já é membro só entra na equipe, sem e-mail (*"… já era membro e entrou na equipe."*).

Convidando como **admin da empresa**, a tela avisa *"A pessoa recebe um convite por e-mail e entra na equipe só quando aceitar."* e, ao enviar, *"Convite enviado. A pessoa entra na equipe quando aceitar."* O convite fica em **Convites pendentes** até a pessoa responder.

### Aceitar ou recusar um convite

*A pessoa convidada pelo admin da empresa.*

1. Abra o link do e-mail (**Ver convite**). Ele leva a **Minha empresa**; sem estar conectado, a tela pede *"Entre para ver o seu convite"*.
2. O cartão mostra *"Você foi convidado para a empresa … por …"*, com *"Você só entra na equipe se aceitar."*
3. Clique em **Aceitar** ou **Recusar**.

Aceitando, aparece *"Você entrou na equipe da empresa …"* e a página passa a mostrar a empresa e a equipe. Recusando, *"Convite da empresa … recusado."*: a recusa é definitiva, e para entrar depois é preciso um convite novo. Um convite já respondido, ou aberto com outra conta, mostra *"Este convite não está mais disponível: ele já foi respondido ou é de outra conta."*

### Marcar o admin da empresa

*Proprietário ou administrador.*

1. Abra a empresa e encontre a pessoa em **Equipe**.
2. Clique em **Tornar admin**. Para desfazer, **Tirar admin**.

### Remover alguém da equipe

*Proprietário, administrador ou o admin da empresa.*

1. Na **Equipe**, clique em **Remover** ao lado da pessoa.
2. Leia o aviso e confirme.

O que acontece depende de como a pessoa entrou:

| Como entrou | O que acontece | Botão |
|---|---|---|
| **Entrou pela empresa** | Sai da equipe e também da comunidade, e perde o acesso | **Remover da empresa e da comunidade** |
| **Já era membro da comunidade** | Só perde o vínculo com a empresa e continua na comunidade | **Remover da empresa** |

Quem entrou pela empresa mas depois ganhou outro papel na comunidade (moderador, por exemplo) continua na comunidade e só perde o vínculo. A empresa e o resto da equipe continuam como estão.

> [!NOTE]
> Ao remover alguém da equipe, a cobrança da pessoa removida é suspensa; a assinatura fica registrada até o cancelamento. Para encerrá-la de vez, cancele em [Gestão de assinaturas](/pagamentos/gestao-de-assinaturas).

### Encerrar uma empresa

*Proprietário ou administrador.*

1. Abra a empresa e clique em **Encerrar**.
2. A opção **Remover todas as N pessoas da equipe** vem marcada. Desmarcada, a equipe continua vinculada à empresa encerrada, e dá para remover cada pessoa depois.
3. Clique em **Encerrar empresa**.

A empresa deixa de aceitar convites, e o admin dela não convida nem remove mais ninguém. O cadastro e o contrato continuam registrados, com a data em **Encerrada em**. Com a remoção marcada, vale a mesma regra de [remover alguém](#remover-alguem-da-equipe): quem entrou pela empresa sai também da comunidade; quem já era membro só perde o vínculo. Não há como reabrir uma empresa encerrada; para a mesma empresa voltar, cadastre de novo.

Quando a **Saída prevista** passa, a tela avisa *"O contrato terminou. Encerre a empresa para decidir o que acontece com a equipe."*: a data sozinha não tira ninguém.

### Ver a sua empresa

*Qualquer pessoa da equipe de uma empresa.*

Abra o menu da conta e clique em **Minha empresa**. A página mostra a empresa e a equipe. Se você é o admin dela, aparece *"Você é admin da empresa: pode convidar e remover pessoas da equipe."*, com os botões para isso e os **Convites pendentes**. Com a empresa encerrada, a página mostra **Empresa encerrada** e *"Não dá mais para convidar nem remover pessoas da equipe."*

Um convite pendente também aparece aqui, para a pessoa convidada aceitar ou recusar.

## Exemplos

**Startup na sala privativa.** O administrador cadastra *Acme Tecnologia*, **Sala privativa**, R$ 4.800 por mês, início em 1/11. Convida a sócia, `maria@memberfy.net`, com **Admin da empresa** marcado. Ela recebe o convite, entra e, em **Minha empresa**, convida os outros quatro funcionários. Cada um entra na equipe ao aceitar o convite.

**Funcionário que saiu.** A Maria remove o João da equipe. Ele tinha entrado pelo convite da empresa, então sai também da comunidade e perde o acesso.

**Fim do contrato.** A *Acme* se muda no fim do ano. O administrador abre a empresa, clica em **Encerrar** com **Remover todas as 5 pessoas da equipe** marcado e confirma. O contrato continua no histórico.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *"Esta pessoa já está na equipe de outra empresa."* | Remova a pessoa da outra empresa antes |
| *"Esta pessoa já está na equipe desta empresa."* | Nada a fazer: ela já está |
| *"A comunidade não está aceitando novos membros agora."* | A entrada de membros está fechada; reabra a comunidade ou espere |
| *"… pediu para não participar desta comunidade; o convite não foi enviado."* | A pessoa recusou convites desta comunidade; fale com ela por outro canal |
| *"Esta empresa está encerrada; não dá para convidar pessoas."* | Cadastre a empresa de novo, se ela voltou |
| *"Esta empresa foi encerrada; o convite não vale mais."* | A empresa foi encerrada depois do convite; nada a fazer |
| *"Você já está na equipe de outra empresa; saia dela antes de aceitar este convite."* | Peça ao admin da outra empresa, ou à gestão, para tirar você de lá |
| *"Este convite não está mais disponível: ele já foi respondido ou é de outra conta."* | Entre com a conta do e-mail convidado, ou peça um convite novo |
| *"A saída não pode ser antes do início."* | Corrija as datas do contrato |

## Perguntas frequentes

**O valor mensal é cobrado?** Não. É um registro, sem cobrança. A empresa paga pela assinatura que ela compra.

**A empresa conta como membro?** Não. Só as pessoas da equipe são membros.

**O admin da empresa vê o valor do contrato?** Não. Em **Minha empresa** ninguém vê o contrato; ele fica com o proprietário, o administrador e o financeiro.

**Uma pessoa pode trabalhar em duas empresas?** Não. Cada pessoa fica numa empresa só.

**Por que a pessoa que convidei não aparece na equipe?** Porque o convite do admin da empresa depende do aceite. Até ela responder, o convite fica em **Convites pendentes**.

**Encerrar a empresa apaga o histórico?** Não. O cadastro e o contrato continuam registrados.

## Pelo assistente

São 14 ferramentas: a equipe da comunidade lista e lê as empresas; o proprietário e o administrador cadastram, editam, encerram e marcam o admin da empresa; qualquer pessoa da equipe de uma empresa vê a própria, e o admin dela convida (com aceite) e remove colegas; a pessoa convidada vê, aceita e recusa os próprios convites. Encerrar, remover e recusar pedem confirmação. Ver [Ferramentas · Empresas residentes](/mcp/ferramentas-empresas-residentes) e a receita [Cadastrar uma empresa residente](/mcp/receitas#69-cadastrar-uma-empresa-residente).

## Na API

Com `X-CommunityId` no cabeçalho, a tag **Resident Companies** reúne as rotas em `/api/resident-companies`: listar e cadastrar (`GET` e `POST`), a sua empresa (`GET /mine`), ler e editar uma (`GET` e `PATCH /{id}`), encerrar (`POST /{id}/close`), a equipe (`GET` e `POST /{id}/members`), marcar o admin (`PATCH /{id}/members/{profileId}`), remover (`DELETE /{id}/members/{profileId}`), os convites pendentes da empresa (`GET /{id}/invitations`), os seus convites (`GET /invitations/mine`) e aceitar ou recusar (`POST /invitations/{invitationId}/accept` e `.../decline`). A referência completa, gerada da API, está em [Referência da API › Resident Companies](/api/referencia/resident-companies).

## Relacionados

- [Papéis e permissões](/conceitos/papeis-e-permissoes)
- [Convidar membros](/membros/convidar-membros)
- [Política de convites](/membros/politica-de-convites)
- [Gerenciar membros](/membros/gerenciar-membros)
- [Planos](/monetizacao/planos)
- [Gestão de assinaturas](/pagamentos/gestao-de-assinaturas)
- [Encomendas](/espacos/encomendas)