Ajustes de organización

Administra el perfil, los usuarios y las agencias de tu organización

La sección Ajustes de organización permite administrar el perfil, los usuarios, las agencias, las cuentas de servicio y el registro de auditoría de tu organización. Es la sección de administración central de Bundleport, accesible para usuarios con rol de organización.

El módulo se organiza en cuatro secciones: Perfil de organización, Usuarios, Agencias y Cuentas de servicio.

Acceder a Ajustes de organización

1. Entra en la plataforma de Bundleport.
2. En la parte inferior del menú lateral izquierdo, haz clic en tu nombre de usuario.
3. Selecciona Ajustes de organización.

Perfil de organización

Desde Perfil de organización puedes actualizar el nombre público y el logotipo de tu organización.

Campos editables:

• Logo: haz clic en Upload logo para subir la imagen de tu organización. Tamaño recomendado: 200×200 px. Formatos admitidos: PNG, JPG o SVG, hasta 2 MB.
• Organization name: nombre público de tu organización. Aparece en toda la plataforma y se sincroniza con el sistema de autenticación.

Campos de referencia (solo lectura):

• Organization code: código identificativo de la organización.
• Status: estado actual (por ejemplo, Active).
• Created at: fecha y hora de creación.
• Last updated: fecha y hora de la última modificación.

Haz clic en Save changes para guardar los cambios.

Usuarios

Desde Usuarios puedes gestionar todos los usuarios registrados en tu organización: consultar su información, asignar roles, invitar nuevos miembros y modificar su estado de acceso.

Buscar y filtrar usuarios

• Buscar usuarios: búsqueda por texto libre.
• Filter: filtros por estado (Active, Inactive) y por rol (Owner, Admin, Viewer, Agency Manager, Agency Agent).
• Inactive: acceso rápido a los usuarios inactivos, con contador.
• Ordenar por: ordena el listado por Name, Email, Created o Status, en orden ascendente o descendente.

El listado se divide en dos pestañas: Usuarios activos y Papelera, con un contador de usuarios en cada una.

Cada fila muestra: código identificativo, nombre completo, email, último acceso, fecha de creación, roles asignados y estado.

Acciones por usuario

• Info: abre el detalle completo del usuario (nombre, apellidos, email, tipo, roles, fechas y metadatos técnicos).
• Impersonate: inicia sesión como ese usuario para ver la plataforma desde su perspectiva.
• Roles: abre el panel de gestión de roles del usuario.
• Edit: cambia el estado del usuario entre Active e Inactive.
• Eliminar (icono de papelera): disponible para todos los usuarios excepto el propietario (Owner).

⚠️ Importante
Marcar un usuario como Inactive revoca su pertenencia a la organización y bloquea su acceso. No podrá iniciar sesión hasta que se reactive. Usa esta opción en lugar de eliminar si quieres conservar el historial del usuario.

Gestionar roles

Al hacer clic en Roles, se abre un panel con tres pestañas que cubren los distintos niveles de permisos. Los cambios se aplican de inmediato.

Roles de agencia: Se asigna un rol por cada agencia de la organización:

• Sin acceso: el usuario no tiene acceso a esa agencia.
• Gestor de Agencia: gestión completa de la agencia.
• Agente de Reservas: búsqueda y reserva de servicios.
• Cliente de Agencia: acceso limitado como cliente.

Roles de organización:

• Propietario: propietario único de la organización.
• Admin. Organización: gestiona configuración, usuarios, conexiones y precios.
• Visor: acceso de solo lectura a la organización.
• Gestor de Agencias (Org): gestiona todas las agencias y su personal, sin acceso a la configuración de la organización.

Roles de Connect:

• Admin Connect: control total sobre conectividad, márgenes y rappels.
• Visor Connect: acceso de solo lectura a conectividad y disponibilidad.

⚠️ Importante
Asignar el rol de Propietario a otro usuario transfiere la propiedad de la organización automáticamente. Esta acción es irreversible desde la interfaz. Solo debe haber un propietario a la vez.

Invitar usuarios

Haz clic en Invitar Usuario para desplegar las opciones de invitación:

Agency User: Invita a un usuario y asígnale un rol de agencia en un solo paso. Si el usuario no existe en la plataforma, se le enviará una invitación automáticamente.

• Email: dirección de correo del usuario.
• Default role for selected agencies: rol por defecto para las agencias seleccionadas (por ejemplo, Agent — Search and book). Puedes personalizar el rol por agencia.
• Agencies: selecciona las agencias a las que tendrá acceso.

Admin / Staff: Invita a un usuario con un rol a nivel de organización o de Connect.

• Email: dirección de correo del usuario.
• Role: Admin, Agency Admin, Viewer, Connect Admin o Connect Viewer.

Generic Invite: Envía una invitación básica (solo email). El código de usuario se genera automáticamente. Los roles se asignan después desde el panel de gestión de roles.

En los tres casos, haz clic en + Send Invitation para enviar, o en Cancel para descartar.

💡 Consejo
Usa Agency User cuando necesites dar acceso rápido a un agente de reservas: seleccionas las agencias, el rol y envías. Usa Generic Invite cuando aún no tengas claro qué permisos necesitará el usuario: primero le das acceso y luego ajustas sus roles.

Agencias

Desde Agencies puedes gestionar las agencias de tu organización: crear nuevas, editar su configuración, asignar conexiones y eliminarlas.

Listado de agencias

La pantalla se divide en dos pestañas: Active e Inactive. Puedes filtrar por texto libre, estado y entorno.

Cada fila muestra:

• Code: código identificativo (generado automáticamente).
• Name: nombre de la agencia.
• Status: Active o Inactive.
• Environment: Test o Production.
• Connections: número de conexiones asignadas.
• Created By: usuario que creó la agencia.
• Created: fecha de creación.
• Actions: asignar conexiones, editar o eliminar.

Crear una agencia

Haz clic en Añadir agencia. El formulario solicita:

• Name: nombre de la agencia.
• Environment: Test o Production.
• Status: Active por defecto.

El código se genera automáticamente. Haz clic en Create para confirmar.

⚠️ Importante
El entorno determina qué conexiones puede usar la agencia: las agencias de Test solo admiten conexiones de Test, y las de Production solo conexiones de Production. Para cambiar el entorno de una agencia existente, debe no tener conexiones asignadas o todas sus conexiones deben ser del entorno destino.

Editar una agencia

Haz clic en el icono de edición en la columna Actions. Puedes modificar el nombre, el estado y el entorno (con las restricciones indicadas arriba). La organización a la que pertenece la agencia no se puede modificar una vez creada.

Asignar conexiones

Haz clic en el icono de conexiones en la columna Actions. Se abrirá un panel con todas las conexiones disponibles del mismo entorno que la agencia. Marca las conexiones que quieras asignar y haz clic en Save.

Eliminar una agencia

Haz clic en el icono de papelera en la columna Actions. Esta acción elimina la agencia de forma definitiva.

Cuentas de servicio

Desde Cuentas de servicio puedes gestionar las cuentas de servicio utilizadas para la autenticación de integraciones sistema a sistema (API). Cada cuenta genera una API Key vinculada a un entorno específico.

Buscar y filtrar

• Buscar por nombre o código: búsqueda por texto libre.
• All Status: filtra por Active, Inactive o Expired.
• All Environments: filtra por Production, Staging o Test.

Listado de cuentas

Cada cuenta muestra:

• Código: código identificativo (formato org.code-XXXXXX).
• Nombre: nombre descriptivo de la cuenta.
• Entorno: Test, Staging o Production.
• Estado: Active, Inactive o Expired.
• Vista previa de Api key: vista parcial de la API Key, con opción de copiarla al portapapeles.
• Última rotación: fecha de la última rotación de la clave.
• Expira el: fecha de expiración, o No expiration si no tiene caducidad.
• Acciones: rotar clave, editar o eliminar.

Crear una cuenta de servicio

Haz clic en Crear cuenta de servicio. El formulario solicita:

• Name: nombre descriptivo (por ejemplo, Production API Integration). El código se genera automáticamente.
• Environment: Test, Staging o Production.
• Expiration (days): periodo de validez (por ejemplo, 1 year). Configúralo conforme a tu política de seguridad.

Haz clic en Create Account para confirmar.

ℹ️ Información
Las API Keys de entorno Test deben usar el gateway test-api.bundleport.com. Las de Production usan el gateway principal.

Rotar, editar y eliminar cuentas

Rotar clave: Haz clic en el icono de rotación en la columna Actions para generar una nueva API Key. La clave anterior dejará de funcionar de forma inmediata.

⚠️ Importante
Rotar una API Key invalida la clave anterior al instante. Todas las integraciones que usen la clave anterior dejarán de funcionar hasta que se actualicen con la nueva clave. Coordina la rotación con tu equipo técnico.

Editar: Haz clic en el icono de edición para modificar el nombre, el estado o la expiración de la cuenta.

Eliminar: Haz clic en el icono de papelera para eliminar la cuenta de forma definitiva. La API Key asociada dejará de funcionar.

FAQs

¿Qué roles están disponibles y qué permite cada uno?

Hay tres niveles de roles: Agencia (Sin acceso, Gestor de Agencia, Agente de Reservas, Cliente de Agencia), Organización (Propietario, Admin, Visor, Gestor de Agencias) y Connect (Admin Connect, Visor Connect). Un usuario puede tener roles en los tres niveles simultáneamente.

¿Puedo transferir la propiedad de la organización a otro usuario?

Sí. Asigna el rol Propietario al nuevo usuario desde el panel de roles. La propiedad se transfiere automáticamente y tu rol de propietario se revoca.

¿Qué diferencia hay entre desactivar y eliminar un usuario?

Desactivar un usuario (Inactive) bloquea su acceso pero conserva su historial y configuración. Eliminar un usuario lo envía a la Papelera de forma definitiva. Recomendamos desactivar en lugar de eliminar siempre que sea posible.

¿Qué diferencia hay entre una agencia de Test y una de Production?

Las agencias de Test solo pueden usar conexiones de Test (entorno de pruebas). Las de Production usan conexiones reales con proveedores. Usa Test para pruebas y formación, Production para operativa real.

¿Puedo cambiar una agencia de Test a Production?

Sí, si la agencia no tiene conexiones asignadas o todas sus conexiones son del entorno destino. Primero desvincula las conexiones de Test y luego cambia el entorno a Production.

¿Qué es "Impersonate" y cuándo usarlo?

Permite iniciar sesión como otro usuario para ver la plataforma desde su perspectiva. Es útil para diagnosticar problemas de permisos o verificar que un usuario ve lo que debería ver.

¿Cuándo debo rotar una API Key?

Rota la clave si sospechas que ha sido comprometida, cuando un miembro del equipo con acceso a la clave deja la organización, o como parte de tu política de rotación periódica de credenciales.

¿Qué pasa si una API Key expira?

La cuenta de servicio pasa a estado Expired y la clave deja de funcionar. Crea una nueva cuenta de servicio o edita la expiración de la existente para restaurar el acceso.

¿Puedo asignar un usuario a varias agencias con roles diferentes?

Sí. Desde el panel de roles, la pestaña Agencia permite asignar un rol distinto por cada agencia de la organización. Un usuario puede ser Gestor en una agencia y Agente de Reservas en otra.