# Empresas

O contêiner de equipe e faturamento: admins, membros, projetos associados e baixa reversível durante 30 dias.

Fonte: https://ardumaker.com/pt/docs/empresas/

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Uma conta ArduMaker com sessão iniciada; Para gerenciar membros: ser admin da empresa
- Ferramentas MCP (Só leem): `listar_empresas`, `ver_empresa`, `ver_estado_verificacion_empresa`, `listar_servicios_empresa`, `ver_consumo_periodo_empresa`

## O que permite fazer?

A empresa é o contêiner de tudo o que se contrata e paga na ArduMaker: VPS, domínios, correio, chaves de IA e projetos associados. Cada empresa tem **admins** e **membros**.

- Criar uma empresa: quem a cria fica como membro e como admin.
- Adicionar pessoas pelo nome de usuário, como membro ou como admin.
- Promover ou rebaixar alguém entre `admin` e `member`.
- Remover membros, ou sair da empresa.
- Dar de baixa a empresa e restaurá-la a partir da lixeira durante 30 dias.

## Quando convém usar?

- Para separar a faturamento de clientes ou negócios diferentes.
- Para dar acesso a uma equipe aos projetos associados a essa empresa.
- Para que um agente MCP descubra o `company_id` que outras ferramentas pedem.

## Como funciona na ArduMaker?

1. Ao criá-la, a ArduMaker valida o nome, adiciona quem a cria como membro e admin, e registra-a como cliente no processador de pagamentos. Tudo acontece em uma só transação: se o registro de pagamentos falhar, não fica uma empresa criada a meio.
2. Todo o admin é também membro: se alguém que não era membro for nomeado admin, é adicionado aos membros.
3. Só um admin adiciona pessoas, muda funções ou remove outros. Qualquer membro pode sair por conta própria.
4. A empresa nunca fica sem admin: rebaixar ou remover o último admin é rejeitado.

As empresas apagadas não são listadas, com uma exceção: as que foram dadas de baixa por falta de pagamento continuam visíveis para que o dono possa entrar e pagar.

## O que muda realmente?

- Criar: uma empresa nova com o criador como admin e o seu cliente no processador de pagamentos.
- Associar a empresa a um projeto dá acesso a esse projeto aos seus membros (nível `aportar`) e aos seus admins.
- Dar de baixa: primeiro tenta-se cobrar a dívida pendente; a empresa é marcada como apagada e fica 30 dias na lixeira. Os VPS que tinha são eliminados de verdade e não voltam ao restaurá-la.

## Esquema

**Criação de uma empresa**

```text
Pessoa (pede para criar a empresa)
  ↓
Validação (nome e dívidas noutras empresas)
  ↓
Empresa (criador como membro e admin)
  ↓
Processador de pagamentos (registro do cliente, na mesma transação)
```

## Resultado esperado

A empresa aparece na lista de quem a criou e dos seus membros, e fica disponível para associar a projetos e contratar serviços.

## Erros e resolução

| Mensagem | Causa |
| --- | --- |
| `name is required` | Tentou-se criar sem nome. |
| `Cannot create a new company while having 2 or more companies with pending debts` | A pessoa tem duas ou mais empresas com dívida acima do autorizado. Uma só não bloqueia. |
| `Only admins can add members` | Quem tenta adicionar alguém não é admin. |
| `At least one admin is required` | Tentou-se remover ou rebaixar o último admin. |
| `Cannot remove members while company has pending debts` | A empresa deve mais do que o autorizado. |
| `Company has pending debts and cannot be deleted` | A cobrança prévia à baixa não cobriu a dívida. |

> **PELIGRO:** Dar de baixa uma empresa elimina os seus VPS de forma definitiva. Restaurar a empresa não os recupera.

## Relação com MCP

Um agente MCP vê as empresas da pessoa que o autorizou, com campos de resumo. Todas as ferramentas são **só de leitura**: um agente não cria empresas, não adiciona membros nem dá baixa de nada.

- `listar_empresas`: id, nome, estado e função da pessoa em cada uma.
- `ver_empresa`: perfil, admins e membros, sem dados de cobrança.
- `ver_estado_verificacion_empresa`: se a empresa está verificada, sem os dados fiscais.
- `listar_servicios_empresa` e `ver_consumo_periodo_empresa`: serviços ativos e movimentos de saldo.

Referência completa de cada ferramenta: [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Gestão de membros](https://ardumaker.com/pt/docs/gestion-de-miembros/)
- [Saldo por empresa](https://ardumaker.com/pt/docs/saldo-por-empresa/)
- [Projetos e quadro kanban](https://ardumaker.com/pt/docs/proyectos-kanban/)
- [Modelos de projeto](https://ardumaker.com/pt/docs/plantillas/)
- [Lixo](https://ardumaker.com/pt/docs/papelera/)