> ## Documentation Index
> Fetch the complete documentation index at: https://muveya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sedes

> Crea, renombra, activa y desactiva las sedes de tu cuenta de clínica dental, y entiende qué depende de cada una.

Una **sede** es un lugar operativo de tu cuenta de clínica dental: una sucursal, una consulta o
cualquier lugar donde tu equipo usa insumos. Tu cuenta (la **Clínica dental** que eliges al iniciar
sesión) puede tener muchas sedes. La API y las referencias técnicas llaman a la sede `clinic` y a la
cuenta `tenant`; en la consola siempre verás **Sedes**.

Casi todo lo operativo depende de una sede:

* Las **bodegas express** pertenecen a exactamente una sede. Las bodegas centrales no pertenecen a
  ninguna y abastecen a todas. Consulta [Bodegas](/docs/es/locations/warehouses).
* Los **boxes y áreas** (boxes de atención y otros lugares donde se usan insumos) pertenecen a una
  sede. Consulta [Boxes y áreas](/docs/es/locations/destinations).
* Los **pedidos** se crean para una sede y se entregan en una de sus bodegas. Consulta
  [Crear y seguir pedidos](/docs/es/orders/create-and-track).
* El **acceso a sedes** define en qué sedes trabaja cada integrante del equipo. Consulta
  [Equipo](/docs/es/account/team).

```mermaid theme={null}
flowchart TD
  A["Cuenta de clínica dental"] --> L1["Sede: Clínica Norte"]
  A --> L2["Sede: Clínica Sur"]
  A --> C["Bodega central (abastece a todas las sedes)"]
  L1 --> E1["Bodega express"]
  L1 --> R1["Boxes y áreas"]
  L2 --> E2["Bodega express"]
  L2 --> R2["Boxes y áreas"]
```

## Quién puede hacerlo

| Acción | Quién |
| - | - |
| Abrir **Sedes** y el detalle de una sede | Todos los integrantes activos de la cuenta |
| Crear una sede | Propietarios y administradores, o integrantes con `settings.manage` |
| Renombrar una sede | Propietarios y administradores, o integrantes con `settings.manage` |
| Activar o desactivar una sede | Propietarios y administradores, o integrantes con `settings.manage` |
| Definir en qué sedes trabaja un integrante | Propietarios y administradores, o integrantes con `members.manage` (desde **Equipo**) |

En **Equipo**, `settings.manage` aparece como **Gestionar configuración de la clínica**. Los
propietarios y administradores lo tienen por su rol. Quien no lo tiene ve las mismas pantallas en
modo de solo lectura: sin el botón **Nueva sede**, con el nombre como texto y sin botón para activar
o desactivar. Consulta [Roles y permisos](/docs/es/account/roles-and-permissions).

## Dónde

Navegación principal, **Sedes** (`console.muveya.com/clinics`). Al seleccionar el nombre de una sede
se abre su detalle (`/clinics/` seguido del id de la sede).

## La lista de sedes

La lista muestra todas las sedes de la cuenta, en el orden en que se crearon.

| Columna | Qué muestra |
| - | - |
| **Nombre de la sede** | El nombre. Selecciónalo para abrir el detalle. |
| **Estado** | **Activa** o **Inactiva**. |

**Buscar sedes** filtra por nombre mientras escribes. No distingue mayúsculas, minúsculas ni tildes,
así que `clinica norte` encuentra "Clínica Norte".

Estados vacíos:

* Sin sedes: **Todavía no hay sedes**. Quien administra ve **Crea la primera sede para vincular sus
  bodegas e insumos.**; el resto ve **Pide a quien administra tu clínica que agregue una sede.**
* Una búsqueda sin resultados: **No hay coincidencias** y **Prueba con otra búsqueda.**

<Note>
  Esta lista no se filtra por el acceso a sedes. Todos los integrantes ven todas las sedes aquí; el
  acceso a sedes acota pedidos, aprobaciones y entregas, no esta lista.
</Note>

## Crear una sede

<Steps>
  <Step title="Abre el formulario">
    En **Sedes**, selecciona **Nueva sede**. Se abre un diálogo con el título **Nueva sede**.
  </Step>

  <Step title="Ponle nombre a la sede">
    Escribe el **Nombre de la sede**, por ejemplo `Clínica Norte`.
  </Step>

  <Step title="Guarda">
    Selecciona **Guardar sede**. El botón muestra **Guardando…** mientras se procesa. Al terminar, el
    diálogo se cierra y la sede aparece en la lista como **Activa**.
  </Step>
</Steps>

Selecciona **Cancelar** para cerrar el diálogo sin crear nada. Mientras se guarda, el diálogo no se
puede cerrar.

### Campos y reglas

| Campo | Obligatorio | Reglas |
| - | - | - |
| **Nombre de la sede** | Sí | De 1 a 120 caracteres. Se quitan los espacios al inicio y al final. |

* Una sede solo tiene nombre y estado. No hay campo de código ni de dirección.
* No se verifica que los nombres sean únicos: dos sedes pueden llamarse igual. En todas las pantallas
  las sedes se eligen por nombre, así que dale a cada una un nombre distinto.
* Una sede nueva siempre empieza como **Activa**.

### Primera configuración desde Inicio

Cuando la cuenta todavía no tiene sedes, quien administra ve la tarjeta **Crea la primera sede** en
**Para empezar a operar**, en **Inicio**. Abre el mismo diálogo **Nueva sede**. Al guardarla, se abre
de inmediato el diálogo **Nueva bodega** con el nombre **Bodega principal** ya escrito:

* **Tipo de bodega** empieza en **Central**. Una bodega central abastece a todas las sedes.
* Si lo cambias a **Express**, la sede que acabas de crear ya está elegida en **Sede**, así que la
  bodega queda asociada a ella.

Cerrar cualquiera de los dos diálogos termina el recorrido. Siempre puedes crear bodegas después
desde [Bodegas](/docs/es/locations/warehouses).

## El detalle de la sede

Abre una sede desde la lista. El encabezado muestra su nombre y **Administra esta sede y su
disponibilidad.** Selecciona **Volver a sedes** para regresar. El detalle tiene tres partes:

1. **Nombre.** Quien administra ve el campo editable **Nombre de la sede** con **Guardar cambios**. El
   resto ve el nombre como texto.
2. **Estado.** Un título como **Estado: Activa** y, para quien administra, el botón
   **Desactivar sede** o **Activar sede**.
3. **Boxes y áreas.** Los boxes de atención y las áreas de la sede, con su control de stock y su
   punto de stock. Consulta [Boxes y áreas](/docs/es/locations/destinations).

El detalle no muestra las bodegas de la sede. Para verlas, abre **Bodegas**: la columna **Sede**
indica a qué sede pertenece cada bodega express.

## Renombrar una sede

<Steps>
  <Step title="Abre la sede">
    En **Sedes**, selecciona el nombre de la sede.
  </Step>

  <Step title="Cambia el nombre">
    Edita **Nombre de la sede**. Rigen las mismas reglas: obligatorio y con 120 caracteres como
    máximo.
  </Step>

  <Step title="Guarda">
    Selecciona **Guardar cambios**. Al terminar, aparece **Cambios guardados** bajo el botón.
  </Step>
</Steps>

Los registros apuntan a la sede, no a su nombre, así que las pantallas de la consola que la nombran
(pedidos, bodegas, boxes y áreas, acceso del equipo) muestran el nombre nuevo, también para lo
registrado antes del cambio.

## Estados

| Estado | Etiqueta | Significado |
| - | - | - |
| `active` | **Activa** | La sede puede recibir pedidos nuevos y bodegas express nuevas. |
| `inactive` | **Inactiva** | La sede se conserva con todo su historial, pero ya no se ofrece para trabajo nuevo. |

Para cambiarlo, abre la sede y selecciona **Desactivar sede** o **Activar sede**. El cambio se aplica
de inmediato y se puede revertir en cualquier momento. No hay paso de confirmación ni forma de
eliminar una sede.

### Qué hace desactivar una sede

| Ámbito | Efecto |
| - | - |
| Pedidos nuevos | La sede deja de ofrecerse en **Clínica** al crear un pedido. Si una pantalla desactualizada la envía de todos modos, el pedido se rechaza con **Esa clínica no está activa.** |
| Pedidos ya creados | No cambia nada. Siguen su curso de aprobación y entrega. |
| Bodegas express nuevas | La sede deja de ofrecerse en **Sede** al crear una bodega express. |
| Sus bodegas existentes | No cambia nada. Conservan su propio estado y sus existencias. Desactívalas por separado desde **Bodegas** si hace falta. |
| Sus boxes y áreas | No cambia nada. Siguen activos y se pueden elegir cuando salen existencias de una caja. Desactívalos por separado en el detalle de la sede. |
| Acceso del equipo | Los integrantes conservan su acceso a sedes. La sede sigue apareciendo, marcada como inactiva, al administrar el acceso en **Equipo**. |
| Historial y reportes | Todo lo registrado para la sede sigue visible y conserva su nombre. |

Al activar la sede otra vez, vuelve a estar disponible para pedidos nuevos y bodegas express nuevas.

## Qué registra el sistema

* Crear una sede guarda su nombre y el estado `active` en tu cuenta. Renombrarla o cambiar su estado
  actualiza ese mismo registro.
* Estos cambios no son movimientos de existencias y nunca tocan el registro de movimientos.
* muveya no escribe un registro de auditoría aparte al crear, renombrar o cambiar el estado de una
  sede.
* Las sedes nunca se eliminan, así que cada pedido y registro que menciona una sigue mostrando su
  nombre.

## Acceso a sedes del equipo

Cada integrante tiene **Acceso a sedes**: **Todas las sedes de esta cuenta** (incluye las que se creen
después), **Sedes seleccionadas** o **Ninguna sede**. Define de qué sedes ve pedidos, aprobaciones y
entregas, y para qué sedes puede crear pedidos. Con **Ninguna sede** no ve nada de eso. El acceso se
administra desde **Equipo**; consulta [Equipo](/docs/es/account/team).

<Tip>
  Si el acceso de un integrante enumera sedes específicas, las sedes que crees después no se agregan
  solas. Abre al integrante en **Equipo** y agrega la sede nueva.
</Tip>

## Desde la API y MCP

* La API pública lista las sedes con `GET /v1/clinics` (scope `clinics:read`). Cada elemento trae
  `clinicId`, `name` y `status`. La API no puede crear ni modificar sedes. Consulta
  [Scopes](/docs/es/api-reference/scopes).
* La herramienta MCP `clinics.list` lista sedes y bodegas con sus ids, nombres y estados. Consulta
  [Herramientas MCP](/docs/es/mcp/tools).

## Qué puede salir mal

| Mensaje | Por qué | Qué hacer |
| - | - | - |
| **Ingresa un valor.** | **Nombre de la sede** está vacío o solo tiene espacios. | Escribe un nombre. |
| **Este valor es demasiado largo.** | El nombre tiene más de 120 caracteres. | Acórtalo. |
| **Tu cuenta no tiene permiso para esta acción.** | No eres propietario ni administrador y no tienes `settings.manage` (`tenants.insufficient_role`). | Pide el cambio a un propietario o administrador, o que te otorgue **Gestionar configuración de la clínica**. |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | La sede no existe en la cuenta en la que estás trabajando (`clinics.not_found`), por ejemplo un enlace copiado de otra cuenta. | Revisa qué **Clínica dental** está elegida en la consola y abre la sede desde la lista. |
| **Revisa los datos ingresados antes de volver a intentar.** | La solicitud no era válida (`common.invalid_request`), por ejemplo un enlace a una sede que está incompleto. | Vuelve a **Sedes** y abre la sede desde la lista. |
| **La cuenta de clínica dental activa cambió. Recarga la página antes de volver a intentar.** | Cambiaste de cuenta en otra pestaña con esta pantalla abierta (`tenants.context_changed`). | Recarga la página y revisa la cuenta antes de reintentar. |
| **No pudimos confirmar la operación. Revisa tu conexión y la lista antes de volver a intentar.** | La conexión se cortó antes de que muveya respondiera. | Revisa la lista: el cambio puede estar guardado. Reintenta solo si no lo está. |
| **No pudimos completar la solicitud. Intenta nuevamente.** | Cualquier otra falla. | Selecciona **Reintentar** o repite la acción. Si sigue fallando, escribe a [team@muveya.com](mailto:team@muveya.com). |
| **Esa clínica no está activa.** | Se envió un pedido para una sede inactiva o fuera de tu acceso a sedes (`orders.clinic_unavailable`). | Activa la sede, elige otra o pide acceso a un administrador. |

Si la lista o el detalle no cargan, el error aparece junto a un botón **Reintentar**.

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Bodegas" icon="warehouse" href="/docs/es/locations/warehouses">
    Bodegas centrales y express, y cómo las usan los pedidos y el inventario.
  </Card>

  <Card title="Boxes y áreas" icon="door-open" href="/docs/es/locations/destinations">
    Dónde se usan los insumos dentro de una sede.
  </Card>

  <Card title="Equipo" icon="users" href="/docs/es/account/team">
    Da a cada integrante acceso a las sedes y bodegas correctas.
  </Card>

  <Card title="Crear y seguir pedidos" icon="cart-shopping" href="/docs/es/orders/create-and-track">
    Pide insumos para una sede.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.