Organizaciones subordinadas¶

Una organización subordinada es una organización que está debajo de la tuya: un cliente tuyo, si eres socio, o un departamento de tu propia organización. Esta página muestra cómo encontrarlas, crear una nueva, con plan o sin él, y cómo suspender, reanudar o eliminar una. Qué son las organizaciones y los socios está explicado en Personas y organizaciones.

En una organización subordinada trabajas con los roles que tienes en tu propia organización con alcance descendants, sin tener que ser miembro de ella (Socios). La abres como cualquier organización: todo lo que hay dentro, como sus ajustes, su identidad de marca, sus miembros y sus planes, lo administras en sus propias páginas.

Quién puede hacer qué¶

El botón Crear organización subordinada solo lo ves si puedes crear una. El menú de una fila solo muestra lo que puedes hacer con esa organización.

La lista¶

Abre Gestión de la organización y después Organizaciones subordinadas. Esta entrada aparece en el menú en cuanto tu organización tiene organizaciones subordinadas que ves, o en cuanto puedes crear una.

• Buscar por nombre conserva las organizaciones cuyo nombre contiene tu texto, con mayúsculas o sin ellas.
• También los niveles inferiores muestra también las organizaciones que están bajo tus organizaciones subordinadas, hasta el nivel más profundo. Así encuentras a un cliente por su nombre sin abrir antes a su socio.
• Cambiar a esta organización en el menú de una fila, o un clic en el nombre, abre esa organización.

Crear una organización subordinada¶

1. Elige Crear organización subordinada.
2. Rellena el Nombre. Es único bajo tu organización.
3. Elige quién será el primer administrador. Marca Seré yo el primer administrador para serlo tú, o rellena la Dirección de correo del primer administrador. Recibe el rol org-admin con alcance descendants.
4. Elige la Separación de los datos: Compartida, separada por organización (la predeterminada) o Un esquema propio. Queda fijada en cuanto la organización existe.
5. Añade Etiquetas si quieres: una etiqueta y un valor por fila. Las reglas sobre organizaciones las leen (Reglas).
6. Si puedes dar planes, elige un Plan y, para una prueba, la fecha en que termina (La prueba termina el). Sin plan, la organización recibe el servicio de tu propia organización.
7. Si puedes dar planes y quieres una demo, rellena Demo hasta. Después de ese día la organización se suspende y se elimina treinta días más tarde, salvo que la conviertas. Déjalo vacío para una organización normal.
8. Elige Crear organización subordinada.

OS crea la organización, la invitación y el plan de una sola vez: si el plan se rechaza, no se crea nada. Si eres tú el primer administrador, no hay invitación: eres miembro y administrador en cuanto la organización está preparada. Escribir tu propia dirección funciona igual, si está verificada en tu cuenta. Cualquier otra dirección recibe una invitación, y solo pasa a ser miembro cuando esa persona la acepta. La nueva organización aparece en la lista como En preparación hasta que está lista, y después como Activa.

Suspender, reanudar y eliminar¶

• Suspender esta organización la detiene, junto con todas las organizaciones que están debajo: las solicitudes en ellas se rechazan hasta que la reanudes.
• Reanudar esta organización vuelve a poner en marcha una organización suspendida.
• Eliminar esta organización pide primero una confirmación. Una organización con organizaciones subordinadas propias solo se elimina cuando estas ya no están. Después se borra y aparece como En eliminación en la lista hasta que termina.

Hacerse miembro y abandonar¶

No necesitas ninguna membresía para trabajar en una organización subordinada, pero puedes hacerte miembro de ella: entonces aparece en tu propia lista de organizaciones, trabajas en ella con sus propios derechos y sus administradores te ven entre sus miembros.

• Convertirse en miembro de esta organización en el menú de una fila te hace miembro, con el rol member y nada más. Tus roles de arriba siguen valiendo; lo que recibas de más en esa organización te lo dan sus propios administradores. Sus administradores reciben aviso de que te has unido.
• Abandonar esta organización en el menú de una fila donde eres miembro pide confirmación y luego termina tu membresía. Lo que creaste en ella se conserva. El último administrador de una organización no puede abandonarla; da primero org-admin a otro miembro.

No puedes volver a hacerte miembro así mientras un administrador tenga tu membresía desactivada, ni durante una sesión de soporte. Una organización que exige su inicio de sesión de empresa solo te admite si has iniciado sesión a través de él. Si te espera una invitación de esa organización, Convertirse en miembro de esta organización la acepta en el acto, con lo que contiene; para ello tu dirección debe estar verificada en tu cuenta.

Ajustes por organización subordinada¶

En una pantalla ancha ajustas algunas cosas de cada organización en su fila, como en Artific Platform. Quien no puede cambiar un valor lo ve como una etiqueta.

• Demo: elige otra fecha de fin, o quítala con la cruz. Quitarla convierte la demo en una organización normal (La fecha de fin de una demo).
• Visión de costes: lo más lejos que la organización puede mostrar los costes y el uso de tokens. Ella sigue eligiendo quién los ve, pero nunca más allá, y eso vale también para las organizaciones que tiene debajo. Con Nadie, allí nadie ve los costes, aunque sus administradores eligieran otra cosa; su elección se guarda para cuando lo amplíes.
• Registros de sesión: desactivado significa que nadie en esa organización, ni sus administradores, puede leer los chats de otra persona con un asistente, digan lo que digan sus reglas. Cada uno ve entonces solo sus propios chats en los registros de sesión. Vale también para las organizaciones que tiene debajo y para quien llama a Core directamente. Mientras esté desactivado, OS rechaza una regla o un rol que lo volvería a abrir.
• Planes: marca un plan para darlo desde ahora y desmárcalo para retirarlo. Un plan que dio una organización por encima de ti queda marcado y bloqueado: solo ella puede retirarlo. Una prueba muestra su fecha de fin.
• Restricciones para administradores en el menú de una fila: lo que los administradores de esa organización no pueden hacer por sí mismos, es decir Ver el consumo, Ver el registro de auditoría y Gestionar claves. OS lee el valor actual al abrir la ventana.

Cada cambio queda en el registro de auditoría de esa organización, con quién lo hizo, y nunca con el valor.

Mediante la API¶

Los ejemplos usan $OS, $TOKEN y $ORG como en Administrar grupos.

curl -s "$OS/api/v1/organisations/$ORG/organisations?scope=descendants&q=acme" \
    -H "Authorization: Bearer $TOKEN"

{"items": [{"id": "org_...", "name": "Acme", "parent_id": "org_...", "status": "active",
            "child_count": 2, "reach": "from_above", "plans": ["Basic"],
            "primary_colour": "#287deb", "may_join": true,
            "parent_allowed_actions": ["see", "write", "delete"],
            "child_allowed_actions": ["see", "write", "delete"]}],
 "next_cursor": null}

• scope es children (la predeterminada: solo las que están directamente debajo) o descendants (todos los niveles).
• q conserva los nombres que contienen el texto; status conserva un solo estado.
• La lista está ordenada por nombre y llega en páginas: pasa next_cursor como cursor para la siguiente. Una página puede tener menos filas que limit mientras next_cursor continúa.
• reach es member o from_above; plans está vacío si no puedes ver el servicio de esa organización. parent_allowed_actions dice si puedes suspenderla y reanudarla (write) y eliminarla (delete).
• child_allowed_actions está en cada organización: si contiene write, puedes crear una organización debajo de ella.
• primary_colour es el color de la lista, null para el color propio de la plataforma; may_join indica si puedes hacerte miembro.

Crear una organización, con un plan para una prueba:

curl -s -X POST "$OS/api/v1/organisations/$ORG/organisations" \
    -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
    -d '{"name": "Acme", "first_admin_email": "admin@acme.example",
         "plan_id": "pln_...", "plan_ends_at": "2026-12-31T00:00:00Z"}'

Envía "first_admin_self": true en lugar de first_admin_email para ser tú el primer administrador; uno de los dos es obligatorio. isolation (shared o schema) y labels son opcionales. Los planes que puedes dar se leen con GET /api/v1/organisations/$ORG/assignable-plans (Planes y excepciones). Suspender, reanudar y eliminar son POST …/organisations/{id}/suspend, POST …/resume y DELETE /api/v1/organisations/{id}. Hacerse miembro es POST …/organisations/{id}/join y abandonar POST …/organisations/{id}/leave.

Para crear una demo, envía "demo_ends_at": "2027-01-31T00:00:00Z" al crearla. Cada fila de la lista tiene también demo_ends_at, cost_visibility_limit, session_logs_readable, plan_assignments (cada plan con id, ends_at y may_take_back) y service_parent_actions. La visión de costes y los registros de sesión se leen con GET /api/v1/organisations/{id}/limits y se cambian con PATCH, junto al tope de costes y admin_restrictions:

curl -s -X PATCH "$OS/api/v1/organisations/$CLIENTE/limits" \
    -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
    -d '{"cost_visibility_limit": "off", "session_logs_readable": false}'

Cuando OS rechaza¶