# Multi-empresa

> Cómo operar varias empresas con Simplo — una API key por empresa hoy, credenciales de plataforma en el roadmap.

## Hoy: una API key por empresa

Una API key de Simplo está ligada a exactamente una empresa — la credencial
*es* la empresa. Para operar varias empresas, mantén una key por empresa y crea
un cliente por empresa:

```ts
import Simplo from '@simplohq/sdk';

const clients = new Map(
  [
    ['acme', process.env.SIMPLO_API_KEY_ACME!],
    ['globex', process.env.SIMPLO_API_KEY_GLOBEX!],
  ].map(([name, apiKey]) => [name, new Simplo({ apiKey })]),
);

const dte = await clients.get('acme')!.dtes.emit({ /* ... */ });
```

Este modelo es simple y seguro: una key filtrada expone una sola empresa, las
keys son revocables por empresa, y no existe forma de apuntar al tenant
equivocado pasando un ID incorrecto.

No multiplexes mutando un cliente compartido: un cliente por empresa, cada uno
con su key.

## En el roadmap: cuentas de plataforma con `companyId`

Para plataformas que administran muchas empresas bajo una sola credencial, el
SDK ya trae un selector de empresa — la opción de cliente `companyId` y su
override por request — que se envía como el header `X-Company-Id`:

```ts
const simplo = new Simplo({ apiKey, companyId: 'co_default' });

await simplo.dtes.emit(params, { companyId: 'co_other' });
```

**Estado real:** la opción está **reservada**. Las credenciales de plataforma
que aceptan `X-Company-Id` están en el roadmap y aún no disponibles; hoy la
API ignora el header por completo — la key sigue fijando la empresa, así que
no dependas de `companyId` para seleccionar un tenant. Si estás construyendo
una plataforma sobre Simplo y necesitas esto, escribe a
[hola@simplo.cl](mailto:hola@simplo.cl).

## Relacionado

- [Autenticación](/comienza/autenticacion/) — cómo funcionan las keys
- [Para coding agents](/agentes/para-coding-agents/) — reglas multi-empresa
  para agentes

---

Versión HTML: https://docs.simplo.cl/comienza/multi-empresa/ · Índice para agentes: https://docs.simplo.cl/llms.txt