# Empresas

El contenedor de equipo y facturación: admins, miembros, proyectos asociados y baja reversible por 30 días.

Fuente: https://ardumaker.com/docs/empresas/

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Una cuenta de ArduMaker con sesión iniciada; Para gestionar miembros: ser admin de la empresa
- Herramientas MCP (Solo leen): `listar_empresas`, `ver_empresa`, `ver_estado_verificacion_empresa`, `listar_servicios_empresa`, `ver_consumo_periodo_empresa`

## ¿Qué permite hacer?

La empresa es el contenedor de todo lo que se contrata y se paga en ArduMaker: VPS, dominios, correo, claves de IA y proyectos asociados. Cada empresa tiene **admins** y **miembros**.

- Crear una empresa: quien la crea queda como miembro y como admin.
- Sumar personas por nombre de usuario, como miembro o como admin.
- Subir o bajar a alguien entre `admin` y `member`.
- Quitar miembros, o salir uno mismo de la empresa.
- Dar de baja la empresa y restaurarla desde la papelera durante 30 días.

## ¿Cuándo conviene usarlo?

- Para separar la facturación de clientes o de negocios distintos.
- Para dar acceso a un equipo a los proyectos asociados a esa empresa.
- Para que un agente MCP descubra el `company_id` que piden otras herramientas.

## ¿Cómo funciona en ArduMaker?

1. Al crearla, ArduMaker valida el nombre, agrega a quien la crea como miembro y admin, y la da de alta como cliente en el procesador de pagos. Todo ocurre en una sola transacción: si el alta de pagos falla, no queda una empresa a medio crear.
2. Todo admin es también miembro: si se nombra admin a alguien que no era miembro, se lo agrega a los miembros.
3. Solo un admin suma gente, cambia roles o quita a otros. Cualquier miembro puede salir por su cuenta.
4. La empresa nunca se queda sin admin: bajar o quitar al último admin se rechaza.

Las empresas borradas no se listan, con una excepción: las que se dieron de baja por falta de pago siguen visibles para que su dueño pueda entrar a pagar.

## ¿Qué cambia realmente?

- Crear: una empresa nueva con su creador como admin y su cliente en el procesador de pagos.
- Asociar la empresa a un proyecto da acceso a ese proyecto a sus miembros (nivel `aportar`) y a sus admins.
- Dar de baja: primero se intenta cobrar la deuda pendiente; la empresa se marca como borrada y queda 30 días en la papelera. Los VPS que tenía se eliminan de verdad y no vuelven al restaurarla.

## Esquema

**Alta de una empresa**

```text
Persona (pide crear la empresa)
  ↓
Validación (nombre y deudas en otras empresas)
  ↓
Empresa (creador como miembro y admin)
  ↓
Procesador de pagos (alta del cliente, en la misma transacción)
```

## Resultado esperado

La empresa aparece en el listado de quien la creó y de sus miembros, y queda disponible para asociarla a proyectos y contratar servicios.

## Errores y resolución

| Mensaje | Causa |
| --- | --- |
| `name is required` | Se intentó crear sin nombre. |
| `Cannot create a new company while having 2 or more companies with pending debts` | La persona tiene dos o más empresas con deuda por encima de lo autorizado. Una sola no frena. |
| `Only admins can add members` | Quien intenta sumar a alguien no es admin. |
| `At least one admin is required` | Se intentó quitar o bajar al último admin. |
| `Cannot remove members while company has pending debts` | La empresa debe más de lo autorizado. |
| `Company has pending debts and cannot be deleted` | El cobro previo a la baja no cubrió la deuda. |

> **PELIGRO:** Dar de baja una empresa elimina sus VPS de forma definitiva. Restaurar la empresa no los recupera.

## Relación con MCP

Un agente MCP ve las empresas de la persona que lo autorizó, con campos de resumen. Todas las herramientas son de **solo lectura**: un agente no crea empresas, no suma miembros ni da de baja nada.

- `listar_empresas`: id, nombre, estado y rol de la persona en cada una.
- `ver_empresa`: perfil, admins y miembros, sin datos de cobro.
- `ver_estado_verificacion_empresa`: si la empresa está verificada, sin los datos fiscales.
- `listar_servicios_empresa` y `ver_consumo_periodo_empresa`: servicios activos y movimientos de saldo.

Referencia completa de cada herramienta: [/mcp/docs](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [Gestión de miembros](https://ardumaker.com/docs/gestion-de-miembros/)
- [Saldo por empresa](https://ardumaker.com/docs/saldo-por-empresa/)
- [Proyectos y tablero kanban](https://ardumaker.com/docs/proyectos-kanban/)
- [Plantillas de proyecto](https://ardumaker.com/docs/plantillas/)
- [Papelera](https://ardumaker.com/docs/papelera/)