> ## 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.
# Bodegas
> Crea bodegas centrales y express, actívalas o desactívalas, y entiende cómo las usan los pedidos, el inventario y las entregas.
Una **bodega** es un lugar donde los insumos se guardan y se cuentan. Cada caja de existencias está en
exactamente una bodega, cada pedido se entrega en una bodega y cada movimiento de existencias indica de qué
bodega salió o a cuál llegó. La API también la llama `warehouse`.
## Bodegas centrales y express
| Tipo | Etiqueta | Pertenece a | Uso habitual |
| - | - | - | - |
| `central` | **Central** | Ninguna sede. Abastece a toda la cuenta de clínica dental. | La bodega principal o el centro de distribución que abastece a todas las sedes. |
| `express` | **Express** | Exactamente una sede. | Las existencias que se guardan en una sede, incluido el punto de stock de un box contado. |
La regla de pertenencia es estricta:
* Una bodega express siempre pertenece a una sede, que se elige al crearla.
* Una bodega central nunca pertenece a una sede.
* El tipo y la sede de una bodega no se pueden cambiar después de crearla.
```mermaid theme={null}
flowchart LR
C["Bodega central"] -->|abastece| E1["Bodega express de Clínica Norte"]
C -->|abastece| E2["Bodega express de Clínica Sur"]
E1 --- L1["Sede: Clínica Norte"]
E2 --- L2["Sede: Clínica Sur"]
```
## Quién puede hacerlo
| Acción | Quién |
| - | - |
| Abrir **Bodegas** | Todos los integrantes activos de la cuenta |
| Crear una bodega | Propietarios y administradores, o integrantes con `settings.manage` |
| Activar o desactivar una bodega | Propietarios y administradores, o integrantes con `settings.manage` |
| Ver y mover existencias en una bodega | Integrantes con los permisos de inventario y acceso a esa bodega. Consulta [Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves). |
| Definir en qué bodegas 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**. Quien no lo
tiene ve la lista en modo de solo lectura: sin el botón **Nueva bodega** y sin la columna
**Acciones**. Consulta [Roles y permisos](/docs/es/account/roles-and-permissions).
## Dónde
Navegación principal, **Bodegas** (`console.muveya.com/warehouses`).
## La lista de bodegas
La lista muestra todas las bodegas de la cuenta, en el orden en que se crearon.
| Columna | Qué muestra |
| - | - |
| **Nombre de la bodega** | El nombre. |
| **Tipo de bodega** | **Central** o **Express**. |
| **Sede** | **Todas las sedes** para una bodega central. Para una bodega express, el nombre de su sede, o **Sede no disponible** si esa sede no se puede mostrar. |
| **Estado** | **Activa** o **Inactiva**. |
| **Acciones** | Solo para quien administra: **Activar** o **Desactivar**. |
**Buscar bodegas** filtra por el nombre de la bodega, sin distinguir mayúsculas, minúsculas ni tildes.
Estados vacíos:
* Sin bodegas: **Todavía no hay bodegas**. Quien administra ve **Crea una bodega central o vincula
una bodega express a una sede.**; el resto ve **Pide a quien administra tu clínica que agregue una
bodega.**
* Una búsqueda sin resultados: **No hay coincidencias** y **Prueba con otra búsqueda.**
Esta lista no se filtra por el acceso a bodegas: todos los integrantes ven todas las bodegas aquí. El
acceso a bodegas define qué existencias puede ver y mover cada integrante en **Inventario**, no lo que
muestra esta lista.
## Crear una bodega
En **Bodegas**, selecciona **Nueva bodega**. Se abre un diálogo con el título **Nueva bodega**.
Escribe el **Nombre de la bodega**, por ejemplo `Bodega Central Santiago` o `Stock Clínica Norte`.
En **Tipo de bodega**, elige **Central** (la opción predeterminada) o **Express**.
Si elegiste **Express**, aparece el campo **Sede**. Abre **Elige una sede** y selecciona la sede a
la que pertenece la bodega. Solo se ofrecen sedes activas.
Selecciona **Guardar bodega**. Al terminar, el diálogo se cierra y la bodega aparece en la lista
como **Activa**.
Selecciona **Cancelar** para cerrar sin crear nada.
### Campos y reglas
| Campo | Obligatorio | Reglas |
| - | - | - |
| **Nombre de la bodega** | Sí | De 1 a 120 caracteres. Se quitan los espacios al inicio y al final. No se verifica que el nombre sea único. |
| **Tipo de bodega** | Sí | **Central** o **Express**. No se puede cambiar después. |
| **Sede** | Solo para **Express** | Una sede activa de esta cuenta. No se puede cambiar después. Una bodega central nunca tiene sede. |
* Si la cuenta no tiene ninguna sede activa, el formulario muestra **Crea una sede activa antes de
agregar una bodega express.** Primero crea o activa una sede. Consulta [Sedes](/docs/es/locations/clinics).
* Una bodega nueva siempre empieza como **Activa**.
* No se puede renombrar, cambiar de tipo o de sede, ni eliminar. Si una bodega quedó mal creada,
crea la correcta, traslada allí sus cajas (consulta
[Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves)) y desactiva la anterior.
### Bodegas que se crean automáticamente
* **Primera configuración desde Inicio.** La tarjeta **Crea la primera sede** crea una sede y luego
abre **Nueva bodega** con el nombre **Bodega principal** ya escrito. Si la cuenta ya tiene una sede
pero ninguna bodega, la tarjeta **Crea una bodega** abre el mismo diálogo con el mismo nombre.
Consulta [Sedes](/docs/es/locations/clinics).
* **Punto de stock de un box contado.** Cuando creas un box o área con **Stock contado** y dejas
**Crear automáticamente**, muveya crea una bodega express de esa sede con el mismo nombre del box.
Aparece en esta lista como cualquier otra bodega express. Consulta
[Boxes y áreas](/docs/es/locations/destinations).
## Estados
| Estado | Etiqueta | Significado |
| - | - | - |
| `active` | **Activa** | La bodega puede recibir existencias nuevas y pedidos nuevos. |
| `inactive` | **Inactiva** | La bodega y su historial se conservan, pero no recibe existencias nuevas ni pedidos nuevos. |
Para cambiarlo, selecciona **Desactivar** o **Activar** en la fila de la bodega. El cambio se aplica
de inmediato, se puede revertir y no tiene paso de confirmación.
### Qué hace desactivar una bodega
| Ámbito | Efecto |
| - | - |
| Recepción de existencias | La bodega deja de ofrecerse al recibir. Si una pantalla desactualizada la envía de todos modos, se rechaza (`inventory.warehouse_inactive`) y no se registra nada. |
| Traslado de cajas hacia ella | Deja de ofrecerse como destino de un traslado, y un traslado hacia ella se rechaza de la misma forma. |
| Cajas que ya están dentro | Se quedan donde están, con sus cantidades. Todavía se pueden consumir o trasladar a una bodega activa. |
| Pedidos nuevos | Deja de ofrecerse en **Entregar en la bodega** y en **Tomar existencias de**. Si una pantalla desactualizada la envía de todos modos, se rechaza con **Esa bodega no está activa.** |
| Pedidos ya creados | No se vuelve a verificar nada. Siguen su curso, y una recepción confirmada se abona de todos modos en esta bodega. |
| Filtros de existencias e historial | La bodega sigue apareciendo en los filtros de existencias y en cada movimiento que la nombra. |
| Box contado | Si es el punto de stock de un box, el box sigue apuntando a ella y ya no se pueden llevar cajas a ese box. Considera desactivar también el box. |
Desactivar una bodega nunca mueve, elimina ni ajusta existencias, y no escribe nada en el registro de
movimientos.
## Cómo se usan las bodegas
### Pedidos
Al crear un pedido (consulta [Crear y seguir pedidos](/docs/es/orders/create-and-track)):
* **Entregar en la bodega** lista las bodegas express activas de la sede elegida en **Clínica**,
limitadas a las bodegas de tu acceso. Si la sede no tiene ninguna, la pantalla dice **Esta clínica
todavía no tiene una bodega activa. Crea una en Bodegas primero.** Si tiene, pero ninguna está en
tu acceso, dice **No tienes asignada ninguna bodega de esta clínica. Pide a un administrador que te
dé acceso.**
* **Tomar existencias de** ofrece **Cualquier bodega central** o una bodega central activa específica.
Con **Cualquier bodega central**, el pedido no indica bodega de origen. Al reservar existencias para
él, muveya busca cajas utilizables de cada insumo sin limitar la búsqueda a una bodega, así que las
cajas pueden venir de cualquier bodega que tenga ese insumo, no solo de las centrales. Elige una
bodega central específica cuando las existencias deban salir de ella.
### Inventario
* Cada caja pertenece a una bodega. La lista de existencias se puede filtrar por **Bodega**.
* La recepción deja las cajas nuevas en una bodega activa a la que tengas acceso. Consulta
[Recibir existencias](/docs/es/inventory/receive).
* Trasladar una caja cambia su bodega y deja el traslado en el registro de movimientos. Consulta
[Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves).
* El mínimo de existencias y la reposición se definen por insumo y bodega. Consulta
[Reposición y alertas](/docs/es/inventory/replenishment-and-alerts).
* Los conteos se hacen por bodega. Consulta [Conteos](/docs/es/inventory/counts).
* Cuando salen existencias de una caja hacia un box o área, la bodega de la caja define qué boxes se pueden
elegir: desde una bodega central, los boxes de todas las sedes; desde una bodega express, solo los
boxes de su propia sede. Consulta [Boxes y áreas](/docs/es/locations/destinations).
### Entregas
Las cajas reservadas para un pedido se preparan y despachan desde la bodega en la que están. Cuando se
confirma la recepción, las cajas aceptadas se abonan en la bodega de destino del pedido y las cajas en
disputa vuelven a la bodega de la que salieron. Consulta
[Resumen de entregas](/docs/es/deliveries/overview) y
[Confirmar la entrega, recibir y cerrar](/docs/es/deliveries/delivery-and-receipt).
## Cómo el acceso a bodegas acota lo que ve cada integrante
Cada integrante tiene **Acceso a bodegas**: **Todas las bodegas de esta cuenta** (incluye las que se
creen después), **Bodegas seleccionadas** o **Ninguna bodega**. Se administra desde **Equipo**;
consulta [Equipo](/docs/es/account/team).
| Con acceso a una bodega, un integrante puede | Sin acceso |
| - | - |
| Ver sus cajas y saldos en **Inventario** | Las cajas quedan ocultas y se comportan como si no existieran |
| Recibir en ella, trasladar cajas hacia o desde ella, consumir desde ella (con el permiso correspondiente) | Esas acciones se rechazan |
| Elegirla en **Entregar en la bodega** al crear un pedido | No se ofrece |
| Ver el uso registrado desde ella en **Uso por box o área** | Esas salidas no se muestran |
Un integrante con **Ninguna bodega** ve **No tienes bodegas asignadas. Pide a un administrador que te
dé acceso.** en **Inventario**.
Cuando el acceso de un integrante enumera bodegas específicas, las bodegas nuevas no se agregan
solas. Esto incluye el punto de stock que muveya crea para un box contado. Abre al integrante en
**Equipo** y agrega la bodega nueva; si no, no podrá llevar cajas a ella ni consumir desde ella.
## Qué registra el sistema
* Crear una bodega guarda su nombre, su tipo, su sede (solo express) y el estado `active`. Cambiar el
estado actualiza ese mismo registro.
* Estos cambios nunca escriben movimientos de existencias y no generan un registro de auditoría aparte.
* Las bodegas nunca se eliminan, así que los movimientos y las cajas que nombran una siguen
apuntando a ella.
## Desde la API y MCP
* La API pública lista las bodegas con `GET /v1/warehouses` (scope `clinics:read`). Cada elemento trae
`warehouseId`, `name`, `kind`, `status` y, solo en las bodegas express, `clinicId`. La API no puede
crear ni modificar bodegas. Consulta [Scopes](/docs/es/api-reference/scopes).
* La herramienta MCP `clinics.list` lista sedes y bodegas. Consulta
[Herramientas MCP](/docs/es/mcp/tools).
## Qué puede salir mal
| Mensaje | Por qué | Qué hacer |
| - | - | - |
| **Ingresa un valor.** | **Nombre de la bodega** 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. |
| **Elige una sede activa.** | Elegiste **Express** sin sede. | Elige una sede en **Sede**. |
| **Crea una sede activa antes de agregar una bodega express.** | La cuenta no tiene ninguna sede activa. | Crea o activa una sede en **Sedes**. |
| **Revisa los datos ingresados antes de volver a intentar.** | muveya rechazó los datos (`common.invalid_request`), o la sede elegida ya no existe en esta cuenta (`warehouses.clinic_required`). | Vuelve a abrir el formulario, elige la sede otra vez y reintenta. |
| **Tu cuenta no tiene permiso para esta acción.** | No eres propietario ni administrador y no tienes `settings.manage` (`tenants.insufficient_role`). | Pídelo a un propietario o administrador. |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | La bodega no existe en la cuenta en la que estás trabajando (`warehouses.not_found`). | Revisa qué **Clínica dental** está elegida y recarga la lista. |
| **El registro cambió o ya existe. Revísalo antes de volver a intentar.** | Intentaste recibir en una bodega, o trasladar una caja hacia ella, y la bodega se desactivó mientras tanto (`inventory.warehouse_inactive`). | Recarga la pantalla y elige una bodega activa. |
| **Esa bodega no está activa.** | Un pedido indicó una bodega inactiva (`orders.warehouse_unavailable`). El mismo mensaje aparece si la bodega está fuera de tu acceso a bodegas o pertenece a otra sede. | Elige otra bodega, o pide a un administrador que la active o te dé acceso. |
| **La cuenta de clínica dental activa cambió. Recarga la página antes de volver a intentar.** | Cambiaste de cuenta en otra pestaña (`tenants.context_changed`). | Recarga la página. |
| **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 antes de reintentar: el cambio puede estar guardado. |
| **No pudimos completar la solicitud. Intenta nuevamente.** | Cualquier otra falla. | Selecciona **Reintentar**. Si sigue fallando, escribe a [team@muveya.com](mailto:team@muveya.com). |
## Páginas relacionadas
Las sedes a las que pertenecen las bodegas express.
Boxes contados y sus puntos de stock.
Registra consumos y traslada cajas entre bodegas.
Asigna el acceso a bodegas de cada integrante.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.