Multi-empresa

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:

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:

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 [email protected].

Relacionado

• Autenticación — cómo funcionan las keys
• Para coding agents — reglas multi-empresa para agentes