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

# App Android

> Qué hace la app Android de muveya, para quién es, cómo conseguirla hoy y cómo iniciar sesión, elegir una clínica dental, cambiar el idioma y cerrar sesión.

La app Android de muveya es una app nativa para el trabajo diario con las existencias. En el teléfono se llama **Muveya**. Con ella, una persona del equipo escanea la etiqueta de una caja para verla, registra un uso, traslada una caja a otra bodega y recibe una entrega escaneando el código de barras del proveedor (incluido GS1 DataMatrix) o eligiendo el insumo por nombre. También muestra cuánto trabajo te espera en otras áreas y lo abre en la consola web.

La app usa la misma cuenta, la misma clínica dental, los mismos permisos y las mismas bodegas que la consola. No tiene reglas de existencias propias: muveya revisa cada acción en el servidor exactamente como lo hace con la consola, y los movimientos quedan en el mismo registro.

<Note>
  La app Android todavía no está disponible para todos. Hoy no está publicada en Google Play y no hay una descarga pública. Si quieres usarla, escribe a [team@muveya.com](mailto:team@muveya.com). Mientras tanto, usa la consola en el navegador de tu teléfono en `https://console.muveya.com`.
</Note>

## Qué hace y qué sigue en la consola

La app muestra este texto al pie de las pantallas de inicio de sesión e **Inicio**: **Escanea cajas y códigos de proveedor para registrar uso, recibir y trasladar. Pedidos, aprobaciones y configuración siguen en la aplicación web.**

| Tarea | App Android | Consola |
| - | - | - |
| Escanear la etiqueta de una caja y ver la caja | Sí | Sí |
| Registrar un uso, con box o área, qué pasó, propósito y responsable | Sí, sin referencia de atención | Sí, con referencia de atención opcional |
| Trasladar una caja completa a otra bodega | Sí | Sí |
| Recibir una entrega escaneando el código del proveedor, incluido GS1 DataMatrix | Sí | Sí |
| Recibir un insumo elegido por nombre | Sí, buscando por nombre | Sí, buscando por nombre o SKU |
| Ver cuánto trabajo te espera | Solo cantidades; cada fila abre la consola | Sí, con las colas |
| Imprimir la etiqueta de una caja | No | Sí |
| Separar parte de una caja, sacar una caja de uso | No | Sí |
| Atribuir una salida después, **Uso por box o área** | No | Sí |
| Correcciones, conteos, retiro de lotes, reposición | No | Sí |
| Pedidos, aprobaciones, preparación, despacho, entrega, recepción y cierre | No | Sí |
| Catálogo, presentaciones y códigos, sedes, bodegas, boxes, equipo y reportes | No | Sí |
| Crear una cuenta o una clínica dental, aceptar una invitación, configurar un autenticador | No | Sí |

Cada tarea, etiqueta y mensaje de la app se describe en [Operaciones en la app Android](/docs/es/android/operations).

## Para quién es

La app es para las personas que manejan cajas durante el día: asistentes que registran lo que se usó, y personal de bodega o de sede que recibe entregas y traslada cajas. Lo que cada persona puede hacer depende de sus permisos y de las bodegas asignadas, igual que en la consola:

| Tarea en la app | Permiso necesario | Etiqueta en la consola |
| - | - | - |
| Escanear la etiqueta de una caja y ver la caja | `inventory.read` | **Ver inventario** |
| Registrar un uso | `inventory.consume`, o `inventory.adjust` que lo incluye, más `inventory.read` | **Registrar consumo**, o **Ajustar y contar stock**, más **Ver inventario** |
| Trasladar una caja | `inventory.transfer`, o `inventory.adjust` que lo incluye, más `inventory.read` | **Trasladar cajas entre bodegas**, o **Ajustar y contar stock**, más **Ver inventario** |
| Recibir una entrega | `inventory.receive`, o `inventory.adjust` que lo incluye | **Recibir entregas**, o **Ajustar y contar stock** |

Una persona sin ninguno de estos permisos puede iniciar sesión, pero **Inicio** muestra **Tu acceso en esta organización no incluye inventario. Pídelo a un administrador.** Los permisos y las bodegas se otorgan en **Equipo**; consulta [Equipo](/docs/es/account/team) y [Roles y permisos](/docs/es/account/roles-and-permissions).

## Requisitos

| Requisito | Detalle |
| - | - |
| Versión de Android | Android 10 o posterior. |
| Servicios de Google Play | El escáner de códigos funciona dentro de los servicios de Google Play. En un teléfono sin ellos, el escáner no se abre; igual puedes escribir los códigos. |
| Conexión a internet | Cada pantalla lee los datos de muveya y cada acción se envía en el momento. La app no tiene modo sin conexión. |
| Un navegador web | Se necesita para iniciar sesión con Google y para abrir la consola desde **Inicio**. |
| Permisos del teléfono | Solo acceso a la red. La app no pide la cámara: la cámara del escáner funciona dentro de los servicios de Google Play. |
| Una cuenta de muveya | Una cuenta que ya existe, con una membresía activa en al menos una clínica dental. La app nunca crea cuentas. |

## Iniciar sesión

Al abrir la app, la pantalla de inicio de sesión muestra **Tu clínica, conectada.** y **Usa la cuenta de tu clínica para continuar.** Mientras revisa qué métodos de acceso están disponibles, muestra **Consultando las opciones de acceso…**. Luego ofrece **Continuar con Google** y el formulario de correo y contraseña. **Idioma**, arriba a la derecha, cambia el idioma de la app (consulta [Idioma](#idioma)).

<Warning>
  La app solo inicia sesión con cuentas que ya existen. Nunca crea una cuenta ni una clínica dental. Para tener una cuenta, pide una invitación a un administrador de tu clínica dental y acéptala en la consola, o crea una clínica dental en la consola. Consulta [Inicia sesión y crea tu cuenta](/docs/es/account/sign-in).
</Warning>

### Con correo y contraseña

<Steps>
  <Step title="Ingresa tus datos">
    Escribe tu **Correo electrónico** y tu **Contraseña**. **Mostrar contraseña** y **Ocultar contraseña** muestran u ocultan lo que escribiste.
  </Step>

  <Step title="Agrega tu código de autenticación, si usas uno">
    Si tu cuenta tiene una app de autenticación, escribe sus seis dígitos en **Código de autenticación (opcional)**. La ayuda dice **Ingresa 6 dígitos si tu cuenta usa verificación en dos pasos.** Cuando tu cuenta tiene un autenticador, cada inicio de sesión con contraseña necesita el código. Consulta [Seguridad de la cuenta](/docs/es/account/security).
  </Step>

  <Step title="Inicia sesión">
    Presiona **Iniciar sesión**. El botón sigue desactivado hasta que el correo parece válido, la contraseña no está vacía y el campo del código está vacío o tiene exactamente seis dígitos. Mientras muveya revisa, la pantalla muestra **Verificando tu acceso…** con **Cancelar**.
  </Step>
</Steps>

La app borra la contraseña y el código del formulario apenas presionas **Iniciar sesión**. El correo admite hasta 254 caracteres y la contraseña hasta 512.

### Con Google

<Steps>
  <Step title="Empieza">
    Presiona **Continuar con Google**. El navegador abre la página de acceso de Google y la app muestra **Completa el acceso con Google en el navegador y vuelve a Muveya.** con **Cancelar**.
  </Step>

  <Step title="Elige tu cuenta de Google">
    Elige la cuenta de Google cuyo correo es el de tu cuenta de muveya. Cuando Google termina, el navegador te devuelve a la app.
  </Step>

  <Step title="Agrega tu código de autenticación, si te lo pide">
    Si tu cuenta tiene un autenticador, la app muestra **Código de autenticación (opcional)**. Escribe los seis dígitos y presiona **Continuar**, que sigue desactivado hasta que estén los seis dígitos. **Cancelar** detiene el acceso con Google.
  </Step>
</Steps>

Tienes 10 minutos desde que presionas **Continuar con Google** para completar todo el recorrido. Si se acaba el tiempo o el código de autenticación es incorrecto, presiona **Continuar con Google** de nuevo.

| Tu situación | Lo que ves | Qué hacer |
| - | - | - |
| Tu correo de Google tiene una cuenta de muveya lista | Inicias sesión. | Nada. |
| Tu correo de Google no tiene cuenta de muveya | **No hay una cuenta de Muveya para este correo. Pide a un administrador de tu clínica que te invite.** | Pide una invitación, acéptala en la consola y vuelve a iniciar sesión. La app nunca ofrece crear una cuenta. |
| La cuenta existe, pero su correo no está verificado o no terminó de configurar la contraseña | **Revisa tu correo, contraseña y código de autenticación.** | Termina primero la configuración en la consola. Consulta [Inicia sesión y crea tu cuenta](/docs/es/account/sign-in). |
| No se puede abrir ningún navegador | **No pudimos abrir un navegador. Verifica que haya uno disponible e intenta de nuevo.** | Instala o activa un navegador e intenta de nuevo. |

Si el acceso con Google está desactivado en el servicio, **Continuar con Google** no aparece. Si no hay ningún método disponible, la pantalla dice **El acceso con contraseña no está disponible en este servicio. Continúa en la aplicación web.**

## Elige tu clínica dental

La app llama **organización** a tu cuenta de clínica dental. Después de iniciar sesión, muveya abre una de las clínicas dentales donde tu membresía está activa, y la app va directo a su pantalla **Inicio**. El nombre bajo el logo indica cuál está activa.

Para trabajar en otra, abre **Menú** y elige **Cambiar organización**. La pantalla **Tu cuenta** muestra tu correo, el título **Elige tu clínica o red dental** y la ayuda **Aquí aparecen las organizaciones disponibles para tu cuenta.** Cada organización es un botón con su nombre y con **Organización activa** (la actual, que no se puede presionar) o **Abrir organización**. Presiona la que quieres. **Volver** regresa a **Inicio** sin cambiar nada.

En la misma pantalla:

* **Actualizar acceso** vuelve a leer tus clínicas dentales y tus permisos. Úsalo después de que un administrador cambie tu acceso.
* **Cerrar sesión** termina tu sesión.

Si tu cuenta no tiene ninguna membresía activa, la pantalla muestra **Tu cuenta no tiene una clínica disponible. Contacta a tu administrador para revisar el acceso.** Las membresías suspendidas o retiradas no aparecen.

<Tip>
  Los botones que muestra la app dependen de los permisos que leyó al iniciar sesión, al abrir la app, al cambiar de organización o al presionar **Actualizar acceso**. muveya siempre revisa tus permisos actuales en el servidor, así que una acción que ya no tienes se rechaza aunque su botón siga visible.
</Tip>

## La pantalla Inicio

La pantalla se titula **Inicio**. Arriba ves el logo de muveya, el botón **Menú** y el nombre de la organización activa.

| Elemento | Qué hace |
| - | - |
| **Escanear código** | Abre el escáner. La ayuda dice **La etiqueta de una caja o el código de barras del proveedor.** |
| **O escribe el código** y **Buscar** | Busca una caja o un código de proveedor que escribes, de hasta 64 caracteres. |
| **Recibir un insumo sin código** | Abre la búsqueda por nombre. Solo aparece si puedes recibir. |
| **Pendientes** | Cantidades de trabajo que te espera, con **Actualizar**. |

El **Menú** ofrece **Inicio** (en cualquier otra pantalla), **Cambiar organización**, **Idioma** y **Cerrar sesión**. En las demás pantallas, **Volver** arriba a la izquierda y el gesto de retroceso del teléfono regresan un paso.

### Pendientes

Esta sección muestra una fila por cada tipo de trabajo que te espera, según tus permisos. Las filas sin nada pendiente se ocultan. Cada fila muestra la cantidad y **Abrir en la web**: al presionarla, se abre en el navegador la pantalla correspondiente de la consola. La app no muestra los elementos en sí.

| Fila | Cuenta | Abre en la consola | Permiso |
| - | - | - | - |
| **Pedidos por aprobar** | Pedidos que esperan tu decisión | **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` |
| **Entregas por recibir** | Pedidos en `delivered` | **Entregas** | `receipt.confirm` |
| **Alertas de stock abiertas** | Alertas de existencias abiertas 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` |

Una cantidad que llegó al máximo que la app lee de una vez se muestra con un signo más, por ejemplo `50+` para pedidos o `200+` para alertas. Mientras cuenta, la sección dice **Revisando tus pendientes**; si no hay nada, **No tienes pendientes.**; si no pudo leer algunas cantidades, **No se pudieron leer algunos pendientes.** Presiona **Actualizar** para contar de nuevo. Las cantidades también se actualizan cada vez que vuelves a **Inicio**.

<Note>
  El navegador tiene su propia sesión de la consola, distinta de la de la app. Si no iniciaste sesión en la consola en ese navegador, hazlo primero. La pantalla **Inicio** de la consola muestra más trabajo pendiente que la app, por ejemplo pedidos por cerrar y borradores de pedidos. Consulta [Introducción](/docs/es/introduction).
</Note>

## Idioma

La app está en inglés, español y portugués. Mientras no elijas uno, sigue la configuración de idioma de tu teléfono y usa inglés cuando ninguno de los idiomas del teléfono es uno de esos tres.

Para cambiarlo, presiona **Idioma** en la pantalla de inicio de sesión, o abre **Menú** y elige **Idioma**, y luego elige **English**, **Español** o **Português**. La app recuerda tu elección. En Android 13 y posteriores, también puedes elegirlo en la configuración de idioma por app del teléfono.

El idioma también se aplica a los mensajes que el servidor de muveya envía a la app, como el motivo por el que se rechazó una acción.

## Sesiones y cierre de sesión

* La app mantiene tu sesión abierta entre usos, con las mismas reglas de sesión que la consola: una sesión termina tras 30 minutos sin actividad y 30 días después de iniciar sesión, y termina cuando un administrador te suspende, te retira o cambia tu rol.
* Cuando muveya informa que la sesión terminó, la app vuelve a la pantalla de inicio de sesión con **Revisa tu correo, contraseña y código de autenticación.** Inicia sesión de nuevo.
* Si al abrirse la app no puede revisar la sesión guardada, muestra **No pudimos verificar tu sesión. Conéctate e intenta de nuevo o cierra sesión.** con **Reintentar** y **Cerrar sesión**.

Para cerrar sesión, abre **Menú** y elige **Cerrar sesión**, o presiona **Cerrar sesión** en la pantalla **Tu cuenta**. La app primero borra la sesión guardada en el teléfono y luego la termina en el servidor de muveya.

| Lo que ves después de cerrar sesión | Significado | Qué hacer |
| - | - | - |
| La pantalla de inicio de sesión, sin mensaje | Cerraste sesión en el teléfono y en el servidor. | Nada. |
| **Cerraste sesión en este dispositivo. No pudimos confirmar el cierre de la sesión en el servidor.**, a veces con **No pudimos conectarnos. Intenta de nuevo.** | El teléfono ya no tiene la sesión, pero el servidor no lo confirmó, por ejemplo porque no había conexión. | No hace falta nada en el teléfono. La sesión del servidor termina sola tras 30 minutos sin actividad. |
| **No pudimos borrar la sesión protegida en este dispositivo. Intenta cerrar sesión de nuevo antes de continuar.** | El teléfono no pudo borrar la sesión guardada. | Presiona **Cerrar sesión** de nuevo. La app no hace nada más hasta borrar la sesión. |

## Privacidad y seguridad en el teléfono

* **Lo que queda en el teléfono.** Solo la prueba de tu sesión y su vencimiento, cifradas con una clave guardada en el Android Keystore del teléfono, y tu elección de idioma. Las contraseñas y los códigos de autenticación nunca se guardan: solo están en memoria mientras inicias sesión.
* **Sin copias de seguridad.** Los datos de la app quedan fuera de las copias de seguridad en la nube de Android y de las transferencias a un teléfono nuevo. Si cambias de teléfono, inicia sesión de nuevo.
* **Sin datos de existencias guardados.** Las cajas, los insumos y las cantidades se leen de muveya cada vez y no se guardan en el teléfono.
* **Solo conexiones cifradas.** La app se comunica con muveya por HTTPS y rechaza conexiones sin cifrar.
* **Sin permiso de cámara.** El escáner funciona dentro de los servicios de Google Play y solo devuelve el código que leyó.
* **Sin datos de pacientes ni costos.** La app nunca pide una referencia de atención ni de paciente, y no muestra costos ni valores de pedidos.

Más información en [Seguridad y privacidad](/docs/es/trust/security-and-privacy).

## Qué puede salir mal

| Lo que ves | Por qué pasa | Qué hacer |
| - | - | - |
| **Revisa tu correo, contraseña y código de autenticación.** | Correo o contraseña incorrectos, un código de autenticación faltante o incorrecto, una cuenta sin terminar de configurar o una sesión que terminó. | Revisa cada dato e inicia sesión de nuevo. |
| **Hubo demasiados intentos. Espera un momento antes de intentar de nuevo.** | Demasiados intentos fallidos con ese correo desde tu red. | Espera 15 minutos e intenta de nuevo con cuidado. |
| **No pudimos conectarnos. Intenta de nuevo.** | No hay conexión, o muveya no respondió a tiempo. | Revisa la red e inicia sesión de nuevo. Si no cargaron las opciones de acceso, presiona **Reintentar**. |
| **No pudimos verificar la respuesta. Intenta de nuevo.** | La respuesta que recibió la app no era la esperada. | Intenta de nuevo. Si continúa, escribe a [team@muveya.com](mailto:team@muveya.com). |
| **Esta app de desarrollo aún no está conectada. Pide a tu equipo la app configurada.** | Esta copia de la app no está conectada a un servicio de muveya. No se puede hacer nada con ella. | Escribe a [team@muveya.com](mailto:team@muveya.com) para obtener una copia que puedas usar. |
| **No pudimos confirmar la organización activa. Actualiza el acceso antes de continuar.** | El cambio de organización no terminó. | Presiona **Reintentar**, o **Cerrar sesión** y vuelve a iniciar sesión. |
| **Tu cuenta no tiene una clínica disponible. Contacta a tu administrador para revisar el acceso.** | No tienes ninguna membresía activa. | Pregunta a un administrador de tu clínica dental. |
| **Tu acceso en esta organización no incluye inventario. Pídelo a un administrador.** | No tienes ningún permiso de inventario en esta organización. | Pídelo a un administrador. Luego abre **Menú**, **Cambiar organización** y presiona **Actualizar acceso**. |

Encontrarás más casos en [Solución de problemas](/docs/es/help/troubleshooting).

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Operaciones en la app Android" icon="mobile-screen-button" href="/docs/es/android/operations">
    Escanear, registrar un uso, trasladar una caja y recibir, paso a paso.
  </Card>

  <Card title="Iniciar sesión" icon="right-to-bracket" href="/docs/es/account/sign-in">
    Cuentas, invitaciones, clínicas y sesiones.
  </Card>

  <Card title="Seguridad de la cuenta" icon="shield-halved" href="/docs/es/account/security">
    Configura la app de autenticación.
  </Card>

  <Card title="Roles y permisos" icon="key" href="/docs/es/account/roles-and-permissions">
    Qué habilita cada permiso.
  </Card>
</CardGroup>


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