> ## 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.

# Inicio rápido

> Pon en marcha una clínica dental de punta a punta: configuración, primeras existencias, primer pedido, entrega, recepción y reporte de consumo

Este recorrido lleva una clínica dental nueva desde una cuenta vacía hasta un insumo que se recibió, se pidió, se aprobó, se entregó, se recibió en una sede y se consumió. Cada paso nombra la pantalla (tal como la muestra la consola), el permiso que necesita y la página con los detalles.

El ejemplo usa una sede, **Clínica Norte**, una bodega central llamada **Bodega Central**, que guarda las existencias, y una bodega express llamada **Bodega Norte**, que pertenece a Clínica Norte y recibe los pedidos. El insumo son guantes de nitrilo, SKU `GLV-NIT-M`, que se compran en cajas de 100.

## Antes de empezar

<Warning>
  **Los roles no otorgan permisos operativos.** Como propietario puedes gestionar sedes, bodegas, el catálogo y el equipo desde el primer minuto, porque el rol de propietario incluye `settings.manage`, `catalog.manage`, `catalog.read` y `members.manage`. Ver el inventario, recibir existencias, crear pedidos, aprobarlos, preparar y recibir entregas y leer reportes requieren permisos que se otorgan de forma explícita, **también al propietario**. El paso 2 se encarga de eso.
</Warning>

<Note>
  **No puedes aprobar tu propio pedido.** Quien hizo un pedido nunca puede decidirlo. Para ver el paso de aprobación necesitas una segunda persona con `approvals.decide` (la invitas en el paso 6), o una política de aprobación que apruebe cada pedido por sí sola (paso 7).
</Note>

| Permiso | Se usa en este recorrido para |
| - | - |
| `settings.manage` | Sedes, bodegas, boxes y áreas (incluido en los roles de propietario y administrador) |
| `catalog.manage` | Categorías, insumos, presentaciones y códigos (incluido en los roles de propietario y administrador) |
| `members.manage` | Invitar personas y editar su acceso (incluido en los roles de propietario y administrador) |
| `inventory.read` | Ver **Inventario**, cajas, alertas y conteos |
| `inventory.receive` | Recibir existencias |
| `inventory.consume` | Registrar lo que se consumió |
| `orders.create` | Crear y enviar pedidos |
| `approvals.policy.manage` | Publicar la política de aprobación |
| `approvals.decide` | Decidir pedidos (siempre alguien distinto de quien pidió). Lo necesitas tú para ofrecerlo en una invitación. |
| `fulfillment.pick`, `fulfillment.dispatch` | Preparar y despachar el pedido |
| `delivery.confirm` | Confirmar la entrega |
| `receipt.confirm`, `fulfillment.read` | Recibir el pedido caja por caja |
| `fulfillment.close` | Cerrar el pedido |
| `reports.read` | Abrir **Reportes** |

## Recorrido

<Steps>
  <Step title="Crea tu cuenta y tu clínica dental">
    Abre `https://console.muveya.com`, elige **Crear una clínica dental** y completa **Tu nombre**, **Correo electrónico** y **Nombre de la clínica dental**. Abre el enlace de verificación del correo, define tu contraseña en **Elige tu contraseña** e inicia sesión. También puedes elegir **Continuar con Google** y confirmar el nombre de tu clínica dental.

    Quedas como **Propietario** de la nueva clínica dental, con acceso a todas las sedes y bodegas, incluidas las que crees después. La consola abre **Inicio**, donde **Para empezar a operar** lista lo que todavía falta.

    Permiso: ninguno. Detalles: [Inicia sesión y crea tu cuenta](/docs/es/account/sign-in).
  </Step>

  <Step title="Otórgate los permisos que vas a usar">
    Ve a **Equipo**, abre tu propia fila, marca en **Permisos** los permisos de la tabla anterior y elige **Guardar permisos**. Los permisos marcados como **Incluido en el rol** ya son tuyos. Incluye `approvals.decide` si vas a invitar a un aprobador: una invitación solo puede ofrecer permisos que tú tienes. Tenerlo no te permite decidir tus propios pedidos.

    Permiso: `members.manage`. Detalles: [Roles y permisos](/docs/es/account/roles-and-permissions).
  </Step>

  <Step title="Agrega tus sedes">
    Ve a **Sedes**, elige **Nueva sede**, escribe el **Nombre de la sede** (por ejemplo, Clínica Norte) y elige **Guardar sede**. Desde **Inicio**, la tarjeta **Crea la primera sede** abre el mismo formulario y luego ofrece la bodega principal de la sede.

    Abre una sede para agregar sus **Boxes y áreas** (boxes de atención y otras áreas) si quieres que cada consumo diga dónde ocurrió.

    Permiso: `settings.manage`. Detalles: [Sedes](/docs/es/locations/clinics), [Boxes y áreas](/docs/es/locations/destinations).
  </Step>

  <Step title="Agrega tus bodegas">
    Ve a **Bodegas** y elige **Nueva bodega**. Ponle un **Nombre de la bodega**, elige el **Tipo de bodega** y elige **Guardar bodega**:

    * **Central**: sirve a toda la clínica dental y no pertenece a ninguna sede. Crea así **Bodega Central**.
    * **Express**: pertenece a una sola **Sede**. Crea así **Bodega Norte**, asociada a Clínica Norte.

    La consola entrega un pedido en una bodega que pertenece a la sede que pide, así que cada sede que pide necesita una bodega express.

    Permiso: `settings.manage`. Detalles: [Bodegas](/docs/es/locations/warehouses).
  </Step>

  <Step title="Configura el catálogo">
    **A mano.** Ve a **Catálogo** y abre **Categorías** para crear al menos una categoría (**Nueva categoría** y luego **Guardar categoría**). De vuelta en **Catálogo**, elige **Nuevo insumo**, completa **SKU**, **Nombre del insumo**, **Categoría**, **Unidad** y **Criticidad**, elige qué controlar (**Controlar lotes**, **Controlar números de serie**, **Controlar vencimientos**) y elige **Crear insumo**. Un insumo nuevo empieza como **Borrador**. Ábrelo y elige **Activar y fijar unidad**: desde la consola solo se reciben y se agregan a pedidos los insumos activos.

    En el insumo, dentro de **Presentaciones**, elige **Agregar presentación** (por ejemplo, "Caja de 100" con **Unidades base que contiene** en 100) y luego **Agregar código** para registrar el código de barras impreso en el empaque, así la recepción puede escanearlo.

    **Desde un archivo.** Elige **Importar CSV** y sube un archivo con las columnas `sku`, `name`, `categoryId`, `unitOfMeasure` y `criticality` (hasta 5 MB y 10.000 filas de datos). Los insumos importados se crean como borradores, así que actívalos después. El servidor solo acepta importaciones de un propietario o un administrador.

    Permiso: `catalog.manage` (CSV: rol de propietario o administrador). Detalles: [Insumos del catálogo](/docs/es/catalog/items), [Presentaciones y códigos](/docs/es/catalog/presentations-and-codes), [Importar y exportar](/docs/es/catalog/import-export).
  </Step>

  <Step title="Invita a tu equipo y define su acceso">
    Ve a **Equipo** y elige **Invitar persona**. Escribe el correo, elige el **Rol** (**Miembro**, o **Administrador** si eres propietario), marca los **Permisos** que la persona necesita (solo puedes otorgar accesos que tienes), elige su **Acceso a sedes** y su **Acceso a bodegas**, elige el **Idioma del correo** y elige **Crear invitación**. Para este recorrido, invita al menos a un aprobador con `approvals.decide` y acceso a Clínica Norte.

    Cuando la persona se una, ábrela en **Equipo** para cambiar sus **Permisos** (**Guardar permisos**) o sus **Sedes y bodegas** (**Guardar acceso a ubicaciones**). Nadie puede cambiar sus propias sedes y bodegas.

    Permiso: `members.manage`. Detalles: [Equipo](/docs/es/account/team), [Roles y permisos](/docs/es/account/roles-and-permissions).
  </Step>

  <Step title="Publica una política de aprobación">
    Ve a **Aprobación de pedidos** y elige **Política de aprobación**. Elige **Publicar sin aprobaciones** (cada pedido enviado se aprueba solo), o agrega una regla con **Agregar una regla**, un **Nombre de la etapa** y **Personas que deben aprobar**, y elige **Publicar política**. Mientras no exista una política, los pedidos enviados esperan y nadie puede decidirlos.

    Permiso: `approvals.policy.manage`. Detalles: [Política de aprobación](/docs/es/orders/approval-policy).
  </Step>

  <Step title="Recibe las primeras existencias">
    Ve a **Inventario** y elige **Recibir**. En **Cómo encontrar lo que llegó**, elige **Escanear un código** (escribe o escanea el **Código del proveedor** y elige **Buscar**) o **Elegir el insumo** (**Buscar insumos**). Indica cómo llegó en **Llegó como** (una presentación o unidades sueltas), escribe **Cuántas**, elige la **Bodega** (Bodega Central), completa el lote, la fecha de vencimiento o los números de serie si el insumo los controla, y elige **Recibir**.

    muveya crea una caja con un código (puedes escribir el tuyo en **Código de caja (opcional)**), registra un movimiento `receive` y ofrece imprimir la etiqueta de la caja.

    Permiso: `inventory.receive` (o `inventory.adjust`, que lo incluye), más acceso a la bodega. Detalles: [Recibir existencias](/docs/es/inventory/receive).
  </Step>

  <Step title="Crea y envía un pedido">
    Ve a **Pedidos** y elige **Nuevo pedido**. Elige la **Clínica** (Clínica Norte), **Entregar en la bodega** (Bodega Norte) y, en **Tomar existencias de**, Bodega Central. Agrega un **Motivo (opcional)** si sirve y elige **Crear pedido**. El pedido se abre como **Borrador**: en **Agregar un insumo**, elige el **Insumo**, escribe una **Cantidad** entera y elige **Agregar insumo**. Cuando la lista esté completa, elige **Enviar pedido**.

    Permiso: `orders.create`. Detalles: [Crear y seguir pedidos](/docs/es/orders/create-and-track).
  </Step>

  <Step title="Aprueba el pedido">
    El pedido pasa de **Enviado** a **Esperando aprobación** cuando se aplica la política. El aprobador va a **Aprobación de pedidos** y selecciona el número del pedido para abrir **Decidir el pedido #N**, revisa la **Etapa que decides**, agrega un **Comentario (opcional)** y elige **Aprobar**. Con la política **Publicar sin aprobaciones**, el pedido queda **Aprobado** por sí solo.

    Una vez aprobado, muveya reserva las existencias para el pedido y el estado pasa a **Existencias reservadas**. Si no hay suficientes existencias utilizables, el pedido se queda en **Aprobado** y no se reserva nada.

    Permiso: `approvals.decide`, en manos de alguien distinto de quien pidió, con acceso a la sede del pedido. Detalles: [Aprobar o rechazar pedidos](/docs/es/orders/approvals).
  </Step>

  <Step title="Prepara y despacha el pedido">
    Ve a **Entregas** y, en **Por preparar**, selecciona el número del pedido para abrir **Preparar el pedido #N**. **Cajas por tomar** lista las cajas reservadas. Para cada una, escanea o escribe su etiqueta en **Código de caja** y elige **Registrar caja**. Cuando todas estén tomadas, agrega un **Transportista o mensajero (opcional)** y elige **Despachar pedido**. Las cajas salen de Bodega Central y quedan **En tránsito**.

    Permiso: `fulfillment.pick` para registrar cajas, `fulfillment.dispatch` para despachar. Detalles: [Preparar y despachar un pedido](/docs/es/deliveries/picking).
  </Step>

  <Step title="Confirma la entrega">
    En **Por entregar**, selecciona el número del pedido para abrir **Entrega del pedido #N**, revisa **Qué se entrega** y elige **Confirmar entrega**. Si algo salió mal, elige **Informar un problema**: el pedido pasa a **Problema de entrega**.

    Permiso: `delivery.confirm`. Detalles: [Confirmar la entrega, recibir y cerrar](/docs/es/deliveries/delivery-and-receipt).
  </Step>

  <Step title="Confirma la recepción y cierra el pedido">
    En **Por recibir**, selecciona el número del pedido para abrir **Recibir el pedido #N**. Para cada caja, elige **Aceptar**, o **Disputar** con un motivo y una descripción en **Evidencia del problema**. Elige **Confirmar recepción**. Las cajas aceptadas quedan en Bodega Norte; las disputadas vuelven a la bodega de donde salieron.

    Luego, en **Por cerrar**, selecciona el número del pedido para abrir **Seguimiento del pedido #N** y elige **Cerrar pedido**.

    Permiso: `receipt.confirm` y `fulfillment.read` para recibir, `fulfillment.close` y `fulfillment.read` para cerrar. Detalles: [Confirmar la entrega, recibir y cerrar](/docs/es/deliveries/delivery-and-receipt), [Historial de custodia](/docs/es/deliveries/custody-history).
  </Step>

  <Step title="Registra un consumo y revisa el reporte">
    En **Inventario**, abre una caja de Bodega Norte (desde la lista o con **Escanear un código**), elige **Consumir**, escribe la cantidad y, si la sede tiene boxes y áreas, el **Box o área** y **Qué pasó**. Luego ve a **Reportes**: **Consumo por insumo** muestra el consumo de cada insumo en el **Período** elegido, agrupado por día o por semana.

    Permiso: `inventory.consume` para registrar el consumo, `reports.read` para el reporte. Detalles: [Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves), [Reporte de consumo](/docs/es/reports/consumption).
  </Step>
</Steps>

## Lo que tienes ahora

* Un registro con los movimientos de cada caja (`receive`, `reserve`, `pick`, `dispatch`, el `receive` en el destino y `consume`, más `split_out` y `split_in` si una caja se separó al preparar), cada uno con quién y cuándo. Abre una caja para ver sus **Movimientos**.
* Un pedido cuyo **Historial** en **Entregas** muestra quién lo entregó y quién lo recibió, y cuyas **Decisiones** en **Aprobación de pedidos** muestran quién lo aprobó.
* Una cifra de consumo que puedes leer por insumo, por día o por semana.

## Si un paso no funciona

| Qué ves | Qué hacer |
| - | - |
| **No tienes acceso** o falta una opción del menú | Revisa en **Equipo** el permiso que nombra el paso. |
| **Todavía no hay política de aprobación: los pedidos enviados esperan hasta que se publique una** | Publica una política (paso 7). |
| **Tú solicitaste este pedido, así que otra persona tiene que aprobarlo.** | Pídeselo al aprobador, o publica la política con **Publicar sin aprobaciones**. |
| El pedido se queda en **Aprobado** y nunca muestra **Existencias reservadas** | A la bodega de origen le faltan existencias utilizables de un insumo del pedido. Revisa **Inventario** y consulta [Solución de problemas](/docs/es/help/troubleshooting). |
| **Esta clínica todavía no tiene una bodega activa. Crea una en Bodegas primero.** | Crea una bodega express para esa sede (paso 4). |

Más respuestas en [Solución de problemas](/docs/es/help/troubleshooting).


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