# Empresas residentes

> As empresas que ocupam o coworking, com o contrato (tipo de residência, valor mensal, início e saída) e a equipa 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 A minha empresa, e a equipa 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 **equipa**, as pessoas que trabalham nela. Uma delas pode ser **admin da empresa** e cuidar da própria equipa, 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 equipa, cada uma com a sua conta.

## Para que serve

| Situação | Empresas residentes |
|---|---|
| Sala privativa | A recepção regista a empresa e convida a sócia; ela inclui os outros cinco funcionários |
| Mesa fixa | O contrato fica registado com o valor e a data de saída, à vista de quem cuida do financeiro |
| Escritório virtual | A empresa existe no registo mesmo sem ninguém a trabalhar 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 equipa 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 equipa da comunidade. É ali que se regista, edita, convida e encerra.
- **A minha empresa**, no menu da conta: a empresa em que está e a equipa dela. O item só aparece para quem está na equipa de uma empresa.

### O contrato

Cada empresa guarda:

| Campo | O que é |
|---|---|
| **Nome da empresa** | Como ela aparece na lista e em **A minha empresa** |
| **Tipo de residência** | **Sala privativa**, **Mesa fixa** ou **Escritório virtual** |
| **Valor mensal** | Registo, 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 registo: 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 equipa 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 equipa 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 | Registar, editar e encerrar | Convidar e remover na equipa | 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 **A 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 apenas para a gestão"*.
- O **membro** não vê a lista. Se ele está na equipa de uma empresa, vê a própria em **A minha empresa**.
- O **admin da empresa** vê **A minha empresa** com a equipa, sem o contrato, e pode convidar e remover colegas enquanto a empresa está ativa.

### A equipa e o admin da empresa

A equipa 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 equipa sem e-mail; quem ainda não é entra na comunidade como membro, recebe o convite por e-mail e já aparece na equipa |
| **Admin da empresa** | A pessoa recebe um convite por e-mail e **entra na equipa 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 a …"*. 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 equipa 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: *"Já está na equipa 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** envia até **30 convites por hora**; acima disso, o ecrã 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

### Registar 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 **Registar**. A empresa aparece na lista, ainda **sem equipa**.

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

### Convidar para a equipa

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

1. Abra a empresa (em **Administração › Empresas**, ou em **A minha empresa** se for 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 equipa (*"Convite enviado para …; a pessoa já está na equipa."*). Quem já é membro só entra na equipa, sem e-mail (*"… já era membro e entrou na equipa."*).

Convidando como **admin da empresa**, o ecrã avisa *"A pessoa recebe um convite por e-mail e só entra na equipa quando aceitar."* e, ao enviar, *"Convite enviado. A pessoa entra na equipa 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 **A minha empresa**; sem estar conectado, o ecrã pede *"Inicie sessão para ver o seu convite"*.
2. O cartão mostra *"Foi convidado para a empresa … por …"*, com *"Só entra na equipa se aceitar."*
3. Clique em **Aceitar** ou **Recusar**.

Aceitando, aparece *"Entrou na equipa da empresa …"* e a página passa a mostrar a empresa e a equipa. Recusando, *"Convite da empresa … recusado."*: a recusa é definitiva, e para entrar mais tarde é preciso um convite novo. Um convite já respondido, ou aberto com outra conta, mostra *"Este convite já não está disponível: 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 equipa

*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 equipa 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 equipa continuam como estão.

> [!NOTE]
> Ao remover alguém da equipa, a cobrança da pessoa removida fica suspensa; a subscrição continua registada até ser cancelada. 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 equipa** vem marcada. Desmarcada, a equipa 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 registo e o contrato ficam guardados, com a data em **Encerrada em**. Com a remoção marcada, vale a mesma regra de [remover alguém](#remover-alguem-da-equipa): 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, registe de novo.

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

### Ver a sua empresa

*Qualquer pessoa da equipa de uma empresa.*

Abra o menu da conta e clique em **A minha empresa**. A página mostra a empresa e a equipa. Se for o admin dela, aparece *"É admin da empresa: pode convidar e remover pessoas da equipa."*, com os botões para isso e os **Convites pendentes**. Com a empresa encerrada, a página mostra **Empresa encerrada** e *"Já não é possível convidar nem remover pessoas da equipa."*

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

## Exemplos

**Startup na sala privativa.** O administrador regista *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 **A minha empresa**, convida os outros quatro funcionários. Cada um entra na equipa ao aceitar o convite.

**Funcionário que saiu.** A Maria remove o João da equipa. 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 equipa** 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; contacte-a por outro canal |
| *"Esta empresa está encerrada; não dá para convidar pessoas."* | Registe 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 |
| *"Já está na equipa de outra empresa; saia dela antes de aceitar este convite."* | Peça ao admin da outra empresa, ou à gestão, para o retirar de lá |
| *"Este convite já não está disponível: já foi respondido ou é de outra conta."* | Inicie sessão 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 registo, sem cobrança. A empresa paga pela assinatura que ela compra.

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

**O admin da empresa vê o valor do contrato?** Não. Em **A 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 equipa?** 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 registo e o contrato ficam guardados.

## Pelo assistente

São 14 ferramentas: a equipa da comunidade lista e lê as empresas; o proprietário e o administrador registam, editam, encerram e marcam o admin da empresa; qualquer pessoa da equipa 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).

## Na API

Com `X-CommunityId` no cabeçalho, a tag **Resident Companies** reúne as rotas em `/api/resident-companies`: listar e registar (`GET` e `POST`), a sua empresa (`GET /mine`), ler e editar uma (`GET` e `PATCH /{id}`), encerrar (`POST /{id}/close`), a equipa (`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)