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

# Introducción

> Qué es muveya, qué no es, quién lo usa y dónde vive cada parte del producto

**muveya** es donde una clínica dental, o una red de clínicas dentales, pide, aprueba, mueve y consume sus insumos con un registro completo de quién hizo qué. Un insumo se pide desde una sede, se aprueba (por alguien distinto de quien lo pidió, cuando tu política exige una decisión), se reserva en una bodega, se toma caja por caja, se despacha, se entrega, se recibe en el destino y finalmente se consume. Cada paso queda registrado, y nada de lo registrado se edita ni se borra.

muveya se apoya en tres ideas:

* **Una sola verdad operativa.** Las existencias solo cambian mediante asientos en un registro de movimientos al que solo se agregan filas. Toda cantidad que ves (en mano, reservada, disponible) se deriva de ese registro.
* **Mínimo privilegio, aplicado por el servidor.** Ver existencias no implica ver costos, valores de pedidos ni referencias de pacientes. Si una persona no tiene el permiso, el servidor omite esos campos en la respuesta; la consola nunca los recibe.
* **Doble custodia.** Entregar y recibir son actos distintos, registrados por separado y, por lo general, por personas distintas.

## Qué no es muveya

| muveya no es | Qué significa para ti |
| - | - |
| Una ficha clínica electrónica | Un pedido clínico puede llevar una referencia opaca del paciente (`patientRef`), como el código interno de tu sistema clínico. muveya no tiene dónde guardar diagnósticos, odontogramas, planes de tratamiento ni nombres de pacientes. |
| Un ERP ni un sistema contable | Los costos sirven para mostrar valores de pedidos y para las aprobaciones. muveya no factura, no paga a proveedores ni lleva la contabilidad. |
| Un marketplace ni un portal de compras | Registras lo que llegó de tus proveedores; muveya no les emite órdenes de compra ni compara cotizaciones. |
| Un chatbot de uso general | El canal de WhatsApp ejecuta operaciones breves y guiadas, con una confirmación explícita. Nunca aprueba pedidos ni cambia existencias por su cuenta. |

## Quién lo usa

En la consola, cada persona pertenece a tu **Clínica dental** con uno de tres roles: **Propietario**, **Administrador** o **Miembro**. El rol es solo una plantilla inicial. Lo que una persona puede hacer de verdad es la lista de permisos que tiene asignada, más las sedes y bodegas a las que tiene acceso. Los roles de propietario y administrador incluyen solo `catalog.read`, `catalog.manage`, `members.manage` y `settings.manage`; el rol de miembro incluye solo `catalog.read`. Todo lo demás, como ver el inventario, crear pedidos o aprobarlos, se otorga de forma explícita, incluso a un propietario.

La tabla muestra personas típicas y los permisos que suelen recibir. Es una guía, no una regla: dale a cada persona exactamente lo que su trabajo necesita. [Roles y permisos](/docs/es/account/roles-and-permissions) lista cada permiso.

| Persona | Qué hace en muveya | Permisos que suele tener |
| - | - | - |
| Propietario o administrador | Configura sedes, bodegas, boxes y áreas, el catálogo y el equipo | `settings.manage`, `members.manage`, `catalog.manage` (incluidos en el rol) |
| Responsable de compras o del catálogo | Mantiene insumos, presentaciones y costos | `catalog.manage`, `catalog.cost.read` |
| Aprobador (gerencia) | Decide los pedidos que la política de aprobación le envía | `approvals.decide`, `orders.value.read`, y `approvals.policy.manage` para quien mantiene la política |
| Jefe de sede | Pide insumos para su sede, recibe entregas, sigue las existencias | `orders.create`, `inventory.read`, `inventory.receive`, `receipt.confirm`, `fulfillment.read`, `fulfillment.close` |
| Operador de bodega | Recibe existencias, prepara y despacha pedidos, traslada y cuenta cajas | `inventory.read`, `inventory.receive`, `inventory.transfer`, `fulfillment.pick`, `fulfillment.dispatch`, `delivery.confirm`, y `inventory.adjust` si además corrige existencias |
| Asistente o técnico de laboratorio | Registra lo que se consumió | `inventory.read`, `inventory.consume` |
| Profesional clínico | Pide insumos, incluidos pedidos clínicos para un paciente | `orders.create`, `orders.clinical.create` |
| Gerente que consulta cifras | Lee el consumo | `reports.read` |

<Note>
  El permiso `audit.read` se puede asignar, pero todavía no hay pantalla ni API que busque en el historial de auditoría. Los registros de auditoría se guardan de todos modos. Para seguir hoy lo que le pasó a una caja o a un pedido, usa los **Movimientos** de la caja y el **Historial** del pedido.
</Note>

## Dónde vive muveya

<CardGroup cols={2}>
  <Card title="Consola web" icon="window-maximize" href="/docs/es/quickstart">
    `https://console.muveya.com`. Configuración, pedidos, aprobaciones, entregas, inventario, conteos, reportes y gestión del equipo. Funciona en la computadora y en el navegador del teléfono, en inglés, español y portugués.
  </Card>

  <Card title="Canal de WhatsApp" icon="whatsapp" href="/docs/es/whatsapp/overview">
    Una persona del equipo con su teléfono vinculado puede consultar una caja, registrar consumo y recibir existencias desde el teléfono, exactamente con los permisos que tiene en la consola. La consola todavía no tiene una pantalla para vincular un teléfono; el resumen explica cómo funciona la vinculación. El canal todavía no está activado en el servicio de producción.
  </Card>

  <Card title="App Android" icon="android" href="/docs/es/android/overview">
    Una app nativa para el teléfono que escanea etiquetas de cajas y códigos de proveedor, registra usos, traslada cajas y recibe entregas, con los mismos permisos que la consola. Todavía no está publicada en Google Play: escribe a [team@muveya.com](mailto:team@muveya.com) para usarla.
  </Card>

  <Card title="API pública /v1" icon="code" href="/docs/es/api-reference/introduction">
    `https://api.muveya.com/v1`. Acceso de solo lectura a sedes, bodegas, catálogo, inventario, pedidos, abastecimiento y analítica, más una escritura: `POST /v1/analytics/exports`. Todavía no hay webhooks, y las claves de API no se crean desde la consola: escribe a [team@muveya.com](mailto:team@muveya.com) para solicitar una.
  </Card>

  <Card title="MCP" icon="robot" href="/docs/es/mcp/introduction">
    Un endpoint Model Context Protocol de solo lectura en `/mcp`, autenticado mediante Console con OAuth, para que un asistente de IA consulte existencias, pedidos y cifras de gestión. No puede aprobar, mover existencias ni cambiar nada.
  </Card>
</CardGroup>

La [app Android](/docs/es/android/overview) nativa todavía no está disponible para todos (escribe a [team@muveya.com](mailto:team@muveya.com) para usarla), así que mientras tanto usa la consola en el navegador de tu teléfono.

## La pantalla Inicio

Al iniciar sesión, la consola abre **Inicio**. Se adapta a los permisos que tienes, así que dos personas ven tarjetas distintas.

<AccordionGroup>
  <Accordion title="Para empezar a operar">
    Aparece mientras a tu clínica dental le falta algo para operar, y solo para lo que tú puedes crear. Cada tarjeta abre la pantalla que lo resuelve:

    | Tarjeta | Aparece cuando | Abre | Necesario para verla |
    | - | - | - | - |
    | **Crea la primera sede** | Todavía no hay sedes. El recorrido crea la sede y luego ofrece su bodega principal. | **Sedes** | rol de propietario o administrador, o `settings.manage` |
    | **Crea una bodega** | Hay sedes pero ninguna bodega | **Bodegas** | rol de propietario o administrador, o `settings.manage` |
    | **Agrega tu primer insumo** | El catálogo está vacío | **Nuevo insumo** | rol de propietario o administrador, o `catalog.manage` |
    | **Agrega cómo vienen tus insumos** | Hay insumos pero ninguno tiene una presentación activa | **Catálogo** | rol de propietario o administrador, o `catalog.manage` |
    | **Invita a tu equipo** | Eres la única persona activa y no hay invitaciones pendientes | **Invitar persona** | rol de propietario o administrador, o `members.manage` |
    | **Todavía no hay política de aprobación: los pedidos enviados esperan hasta que se publique una** | Nunca se publicó una política de aprobación | **Política de aprobación** | `approvals.policy.manage` |
  </Accordion>

  <Accordion title="Trabajo pendiente">
    Lo que te espera ahora, una tarjeta por cada permiso que tienes. Cada tarjeta muestra cuántos elementos esperan (una página completa se muestra como `50+` o `200+`) y abre la cola correspondiente. Las tarjetas sin nada pendiente se ocultan; si no hay nada en absoluto, ves **No hay nada esperándote por ahora.**

    | Tarjeta | Cuenta | Abre | Permiso |
    | - | - | - | - |
    | **Pedidos esperando tu aprobación** | Pedidos de tus sedes que esperan tu decisión (nunca los tuyos) | **Aprobación de pedidos** | `approvals.decide` |
    | **Pedidos por preparar** | Pedidos en `allocated` o `picking` | **Entregas** | `fulfillment.pick` o `fulfillment.dispatch` |
    | **Entregas por confirmar** | Pedidos en `dispatched` | **Entregas** | `delivery.confirm` |
    | **Pedidos por recibir** | Pedidos en `delivered` | **Entregas** | `receipt.confirm` |
    | **Pedidos por cerrar** | Pedidos en `received` o `partially_fulfilled` | **Entregas** | `fulfillment.close` |
    | **Borradores de pedidos** | Pedidos en `draft` | **Pedidos** | `orders.create` |
    | **Alertas de existencias abiertas** | Alertas abiertas de existencias bajas y de vencimiento en tus bodegas | **Alertas de existencias** | `inventory.read` |
    | **Cajas por contar** | Cajas que no se contaron en los últimos 30 días | **Conteos** | `inventory.read` |
  </Accordion>

  <Accordion title="Tu clínica dental">
    El nombre de la clínica dental en la que trabajas, el correo con el que iniciaste sesión y el enlace **Elige una clínica dental** para cambiar a otra clínica dental a la que perteneces.
  </Accordion>
</AccordionGroup>

La barra lateral (o el menú en el teléfono) muestra **Inicio**, **Pedidos**, **Aprobación de pedidos**, **Entregas**, **Sedes**, **Bodegas**, **Catálogo**, **Inventario**, **Reposición**, **Correcciones de existencias**, **Reportes** y **Equipo**. **Pedidos**, **Aprobación de pedidos**, **Entregas**, **Reportes** y **Equipo** solo aparecen para quienes participan en ese trabajo. Ocultar un enlace es solo una comodidad: el servidor revisa cada solicitud por su cuenta.

## Guías

<CardGroup cols={2}>
  <Card title="Inicio rápido" icon="rocket" href="/docs/es/quickstart">
    De una cuenta nueva a un insumo recibido, consumido y reportado.
  </Card>

  <Card title="Conceptos" icon="shapes" href="/docs/es/concepts">
    Clínica dental, sedes, bodegas, cajas, registro de movimientos, pedidos y custodia.
  </Card>

  <Card title="Cuenta y equipo" icon="users" href="/docs/es/account/team">
    Inicia sesión, invita personas, asigna permisos y acceso a sedes y bodegas.
  </Card>

  <Card title="Sedes y bodegas" icon="building" href="/docs/es/locations/clinics">
    Sedes, bodegas centrales y express, boxes y áreas.
  </Card>

  <Card title="Catálogo" icon="boxes-stacked" href="/docs/es/catalog/items">
    Insumos, categorías, presentaciones, códigos, costos y CSV.
  </Card>

  <Card title="Inventario" icon="warehouse" href="/docs/es/inventory/overview">
    Recibe, consume, traslada, corrige, cuenta, repone y retira lotes.
  </Card>

  <Card title="Pedidos y aprobaciones" icon="clipboard-check" href="/docs/es/orders/create-and-track">
    Pide insumos, decide pedidos y publica la política de aprobación.
  </Card>

  <Card title="Entregas" icon="truck" href="/docs/es/deliveries/overview">
    Prepara, despacha, entrega, recibe y cierra.
  </Card>

  <Card title="Reportes" icon="chart-line" href="/docs/es/reports/consumption">
    Consumo por insumo y analítica de gestión.
  </Card>

  <Card title="Seguridad y privacidad" icon="shield-halved" href="/docs/es/trust/security-and-privacy">
    Aislamiento, omisión de datos y cómo se protege tu información.
  </Card>
</CardGroup>

## Próximos pasos

* [Inicio rápido](/docs/es/quickstart): completa tu primer pedido de punta a punta.
* [Conceptos](/docs/es/concepts): el modelo detrás de cada pantalla.
* [Glosario](/docs/es/glossary): cada término, estado y etiqueta en tres idiomas.
* [Solución de problemas](/docs/es/help/troubleshooting): qué hacer cuando algo no avanza.


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