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

> O que o app Android do muveya faz, para quem ele é, como obtê-lo hoje e como entrar, escolher uma clínica odontológica, mudar o idioma e sair.

O app Android do muveya é um aplicativo nativo para o trabalho diário com o estoque. No celular, ele se chama **Muveya**. Com ele, uma pessoa da equipe escaneia a etiqueta de uma caixa para vê-la, registra um uso, transfere uma caixa para outro depósito e recebe uma entrega escaneando o código de barras do fornecedor (inclusive GS1 DataMatrix) ou escolhendo o insumo pelo nome. Ele também mostra quanto trabalho espera por você em outras áreas e o abre no console web.

O app usa a mesma conta, a mesma clínica odontológica, as mesmas permissões e os mesmos depósitos do console. Ele não tem regras de estoque próprias: o muveya verifica cada ação no servidor exatamente como faz com o console, e as movimentações ficam no mesmo registro.

<Note>
  O app Android ainda não está disponível para todos. Hoje ele não está publicado no Google Play e não há download público. Se você quiser usá-lo, escreva para [team@muveya.com](mailto:team@muveya.com). Enquanto isso, use o console no navegador do celular em `https://console.muveya.com`.
</Note>

## O que ele faz e o que continua no console

O app mostra este texto no rodapé das telas de login e **Início**: **Escaneie caixas e códigos de fornecedor para registrar uso, receber e transferir estoque. Pedidos, aprovações e configurações continuam no aplicativo web.**

| Tarefa | App Android | Console |
| - | - | - |
| Escanear a etiqueta de uma caixa e ver a caixa | Sim | Sim |
| Registrar um uso, com sala ou área, o que aconteceu, finalidade e responsável | Sim, sem referência de atendimento | Sim, com referência de atendimento opcional |
| Transferir uma caixa inteira para outro depósito | Sim | Sim |
| Receber uma entrega escaneando o código do fornecedor, inclusive GS1 DataMatrix | Sim | Sim |
| Receber um insumo escolhido pelo nome | Sim, buscando pelo nome | Sim, buscando pelo nome ou SKU |
| Ver quanto trabalho espera por você | Só as quantidades; cada linha abre o console | Sim, com as filas |
| Imprimir a etiqueta de uma caixa | Não | Sim |
| Separar parte de uma caixa, tirar uma caixa de uso | Não | Sim |
| Atribuir uma saída depois, **Uso por sala ou área** | Não | Sim |
| Correções, contagens, recolhimento de lotes, reposição | Não | Sim |
| Pedidos, aprovações, separação, despacho, entrega, recebimento e encerramento | Não | Sim |
| Catálogo, apresentações e códigos, unidades, depósitos, salas, equipe e relatórios | Não | Sim |
| Criar uma conta ou uma clínica odontológica, aceitar um convite, configurar um autenticador | Não | Sim |

Cada tarefa, rótulo e mensagem do app está descrito em [Operações no app Android](/docs/pt/android/operations).

## Para quem é

O app é para as pessoas que lidam com caixas durante o dia: assistentes que registram o que foi usado, e a equipe de depósito ou da unidade que recebe entregas e transfere caixas. O que cada pessoa pode fazer depende das suas permissões e dos depósitos atribuídos, exatamente como no console:

| Tarefa no app | Permissão necessária | Rótulo no console |
| - | - | - |
| Escanear a etiqueta de uma caixa e ver a caixa | `inventory.read` | **Ver estoque** |
| Registrar um uso | `inventory.consume`, ou `inventory.adjust`, que a inclui, mais `inventory.read` | **Registrar consumo**, ou **Ajustar e contar estoque**, mais **Ver estoque** |
| Transferir uma caixa | `inventory.transfer`, ou `inventory.adjust`, que a inclui, mais `inventory.read` | **Transferir caixas entre depósitos**, ou **Ajustar e contar estoque**, mais **Ver estoque** |
| Receber uma entrega | `inventory.receive`, ou `inventory.adjust`, que a inclui | **Receber entregas**, ou **Ajustar e contar estoque** |

Uma pessoa sem nenhuma dessas permissões consegue entrar, mas **Início** mostra **Seu acesso nesta organização não inclui estoque. Peça a um administrador.** As permissões e os depósitos são concedidos em **Equipe**; veja [Equipe](/docs/pt/account/team) e [Funções e permissões](/docs/pt/account/roles-and-permissions). No app, o depósito aparece como **Almoxarifado**: é o mesmo depósito que o console mostra em **Depósitos**.

## Requisitos

| Requisito | Detalhe |
| - | - |
| Versão do Android | Android 10 ou posterior. |
| Google Play Services | O leitor de códigos funciona dentro do Google Play Services. Em um celular sem ele, o leitor não abre; você ainda pode digitar os códigos. |
| Conexão com a internet | Cada tela lê os dados do muveya e cada ação é enviada na hora. O app não tem modo offline. |
| Um navegador | Necessário para entrar com o Google e para abrir o console a partir de **Início**. |
| Permissões do celular | Só acesso à rede. O app não pede a câmera: a câmera do leitor funciona dentro do Google Play Services. |
| Uma conta do muveya | Uma conta que já existe, com participação ativa em pelo menos uma clínica odontológica. O app nunca cria contas. |

## Entrar

Quando o app abre, a tela de login mostra **Sua clínica, conectada.** e **Use a conta da sua clínica para continuar.** Enquanto verifica quais métodos de acesso estão disponíveis, mostra **Consultando as opções de acesso…**. Depois oferece **Continuar com o Google** e o formulário de e-mail e senha. **Idioma**, no canto superior direito, muda o idioma do app (veja [Idioma](#idioma)).

<Warning>
  O app só entra com contas que já existem. Ele nunca cria uma conta nem uma clínica odontológica. Para ter uma conta, peça um convite a um administrador da sua clínica odontológica e aceite-o no console, ou crie uma clínica odontológica no console. Veja [Entre e crie sua conta](/docs/pt/account/sign-in).
</Warning>

### Com e-mail e senha

<Steps>
  <Step title="Informe seus dados">
    Digite seu **E-mail** e sua **Senha**. **Mostrar senha** e **Ocultar senha** mostram ou escondem o que você digitou.
  </Step>

  <Step title="Adicione seu código de autenticação, se usar um">
    Se sua conta tem um app autenticador, digite os seis dígitos dele em **Código de autenticação (opcional)**. A ajuda diz **Digite 6 dígitos se sua conta usa verificação em duas etapas.** Quando sua conta tem um autenticador, todo login com senha exige o código. Veja [Segurança da conta](/docs/pt/account/security).
  </Step>

  <Step title="Entre">
    Toque em **Entrar**. O botão fica desativado até o e-mail parecer válido, a senha não estar vazia e o campo do código estar vazio ou ter exatamente seis dígitos. Enquanto o muveya verifica, a tela mostra **Verificando seu acesso…** com **Cancelar**.
  </Step>
</Steps>

O app apaga a senha e o código do formulário assim que você toca em **Entrar**. O e-mail aceita até 254 caracteres e a senha até 512.

### Com o Google

<Steps>
  <Step title="Comece">
    Toque em **Continuar com o Google**. O navegador abre a página de login do Google e o app mostra **Conclua o acesso com o Google no navegador e volte ao Muveya.** com **Cancelar**.
  </Step>

  <Step title="Escolha sua conta do Google">
    Escolha a conta do Google cujo e-mail é o da sua conta do muveya. Quando o Google termina, o navegador leva você de volta ao app.
  </Step>

  <Step title="Adicione seu código de autenticação, se for pedido">
    Se sua conta tem um autenticador, o app mostra **Código de autenticação (opcional)**. Digite os seis dígitos e toque em **Continuar**, que fica desativado até os seis dígitos estarem lá. **Cancelar** interrompe o acesso com o Google.
  </Step>
</Steps>

Você tem 10 minutos desde o toque em **Continuar com o Google** para concluir todo o percurso. Se o tempo acabar, ou se o código de autenticação estiver errado, toque em **Continuar com o Google** de novo.

| Sua situação | O que você vê | O que fazer |
| - | - | - |
| Seu e-mail do Google tem uma conta do muveya pronta | Você entra. | Nada. |
| Seu e-mail do Google não tem conta do muveya | **Não há uma conta Muveya para este e-mail. Peça a um administrador da sua clínica que convide você.** | Peça um convite, aceite-o no console e entre de novo. O app nunca oferece criar uma conta. |
| A conta existe, mas o e-mail não foi verificado ou a senha não foi configurada | **Confira seu e-mail, senha e código de autenticação.** | Conclua primeiro a configuração no console. Veja [Entre e crie sua conta](/docs/pt/account/sign-in). |
| Nenhum navegador pode ser aberto | **Não foi possível abrir um navegador. Verifique se há um disponível e tente novamente.** | Instale ou ative um navegador e tente novamente. |

Se o acesso com o Google estiver desligado no serviço, **Continuar com o Google** não aparece. Se nenhum método estiver disponível, a tela diz **O acesso com senha não está disponível neste serviço. Continue no aplicativo web.**

## Escolha sua clínica odontológica

O app chama a sua conta de clínica odontológica de **organização**. Depois que você entra, o muveya abre uma das clínicas odontológicas em que a sua participação está ativa, e o app vai direto para a tela **Início** dela. O nome abaixo do logotipo mostra qual está ativa.

Para trabalhar em outra, abra o **Menu** e escolha **Trocar organização**. A tela **Sua conta** mostra seu e-mail, o título **Escolha sua clínica ou rede odontológica** e a ajuda **Aqui aparecem as organizações disponíveis para sua conta.** Cada organização é um botão com o nome dela e com **Organização ativa** (a atual, que não pode ser tocada) ou **Abrir organização**. Toque na que você quer. **Voltar** retorna a **Início** sem mudar nada.

Na mesma tela:

* **Atualizar acesso** lê de novo suas clínicas odontológicas e permissões. Use depois que um administrador mudar o seu acesso.
* **Sair** encerra a sua sessão.

Se a sua conta não tem nenhuma participação ativa, a tela mostra **Sua conta não tem uma clínica disponível. Fale com seu administrador para revisar o acesso.** Participações suspensas ou removidas não aparecem.

<Tip>
  Os botões que o app mostra dependem das permissões que ele leu quando você entrou, abriu o app, trocou de organização ou tocou em **Atualizar acesso**. O muveya sempre verifica as suas permissões atuais no servidor, então uma ação que você perdeu é recusada mesmo que o botão ainda apareça.
</Tip>

## A tela Início

A tela se chama **Início**. No alto aparecem o logotipo do muveya, o botão **Menu** e o nome da organização ativa.

| Elemento | O que faz |
| - | - |
| **Escanear código** | Abre o leitor. A ajuda diz **A etiqueta de uma caixa ou o código de barras do fornecedor.** |
| **Ou digite o código** e **Buscar** | Procura uma caixa ou um código de fornecedor que você digita, com até 64 caracteres. |
| **Receber um insumo sem código** | Abre a busca pelo nome. Só aparece se você pode receber. |
| **Pendências** | Quantidades de trabalho que esperam por você, com **Atualizar**. |

O **Menu** oferece **Início** (em qualquer outra tela), **Trocar organização**, **Idioma** e **Sair**. Nas outras telas, **Voltar** no canto superior esquerdo e o gesto de voltar do celular retornam um passo.

### Pendências

Esta seção mostra uma linha para cada tipo de trabalho que espera por você, conforme suas permissões. Linhas sem pendências ficam ocultas. Cada linha mostra a quantidade e **Abrir no aplicativo web**: ao tocar, a tela correspondente do console abre no navegador. O app não mostra os itens em si.

| Linha | Conta | Abre no console | Permissão |
| - | - | - | - |
| **Pedidos para aprovar** | Pedidos que aguardam a sua decisão | **Aprovação de pedidos** | `approvals.decide` |
| **Pedidos para preparar** | Pedidos em `allocated` ou `picking` | **Entregas** | `fulfillment.pick` ou `fulfillment.dispatch` |
| **Entregas para confirmar** | Pedidos em `dispatched` | **Entregas** | `delivery.confirm` |
| **Entregas para receber** | Pedidos em `delivered` | **Entregas** | `receipt.confirm` |
| **Alertas de estoque abertos** | Alertas de estoque abertos nos seus depósitos | **Alertas de estoque** | `inventory.read` |
| **Caixas para contar** | Caixas não contadas nos últimos 30 dias | **Contagens** | `inventory.read` |

Uma quantidade que chegou ao máximo que o app lê de uma vez aparece com um sinal de mais, por exemplo `50+` para pedidos ou `200+` para alertas. Enquanto conta, a seção diz **Verificando suas pendências**; sem nada, **Você não tem pendências.**; se não conseguiu ler algumas quantidades, **Não foi possível ler algumas pendências.** Toque em **Atualizar** para contar de novo. As quantidades também são atualizadas sempre que você volta a **Início**.

<Note>
  O navegador tem a sua própria sessão do console, separada da do app. Se você não entrou no console nesse navegador, entre primeiro. A tela **Início** do console mostra mais trabalho pendente que o app, por exemplo pedidos a encerrar e rascunhos de pedidos. Veja [Introdução](/docs/pt/introduction).
</Note>

## Idioma

O app está em inglês, espanhol e português. Enquanto você não escolhe, ele segue as configurações de idioma do celular e usa inglês quando nenhum dos idiomas do celular é um desses três.

Para mudar, toque em **Idioma** na tela de login, ou abra o **Menu** e escolha **Idioma**, e então escolha **English**, **Español** ou **Português**. O app guarda a sua escolha. No Android 13 e posteriores, você também pode escolher o idioma nas configurações de idioma por app do celular.

O idioma também vale para as mensagens que o servidor do muveya envia ao app, como o motivo pelo qual uma ação foi recusada.

## Sessões e saída

* O app mantém você conectado entre um uso e outro, com as mesmas regras de sessão do console: uma sessão termina após 30 minutos sem atividade e 30 dias depois do login, e termina quando um administrador suspende ou remove você ou muda a sua função.
* Quando o muveya informa que a sessão terminou, o app volta para a tela de login com **Confira seu e-mail, senha e código de autenticação.** Entre de novo.
* Se, ao abrir, o app não consegue verificar a sessão salva, ele mostra **Não foi possível verificar sua sessão. Conecte-se e tente novamente ou saia.** com **Tentar novamente** e **Sair**.

Para sair, abra o **Menu** e escolha **Sair**, ou toque em **Sair** na tela **Sua conta**. O app primeiro apaga a sessão salva no celular e depois a encerra no servidor do muveya.

| O que você vê depois de sair | Significado | O que fazer |
| - | - | - |
| A tela de login, sem mensagem | Você saiu no celular e no servidor. | Nada. |
| **Você saiu neste dispositivo. Não foi possível confirmar o encerramento da sessão no servidor.**, às vezes com **Não foi possível conectar. Tente novamente.** | O celular não tem mais a sessão, mas o servidor não confirmou, por exemplo por falta de conexão. | Nada é necessário no celular. A sessão do servidor termina sozinha após 30 minutos sem atividade. |
| **Não foi possível apagar a sessão protegida neste dispositivo. Tente sair novamente antes de continuar.** | O celular não conseguiu apagar a sessão salva. | Toque em **Sair** de novo. O app não faz mais nada até apagar a sessão. |

## Privacidade e segurança no celular

* **O que fica no celular.** Só a prova da sua sessão e o vencimento dela, criptografadas com uma chave guardada no Android Keystore do celular, e a sua escolha de idioma. Senhas e códigos de autenticação nunca são salvos: ficam só na memória enquanto você entra.
* **Sem backups.** Os dados do app ficam fora dos backups na nuvem do Android e das transferências para um celular novo. Se trocar de celular, entre de novo.
* **Sem dados de estoque guardados.** Caixas, insumos e quantidades são lidos do muveya a cada vez e não ficam guardados no celular.
* **Só conexões criptografadas.** O app se comunica com o muveya por HTTPS e recusa conexões sem criptografia.
* **Sem permissão de câmera.** O leitor funciona dentro do Google Play Services e devolve só o código que leu.
* **Sem dados de pacientes nem custos.** O app nunca pede uma referência de atendimento ou de paciente, e não mostra custos nem valores de pedidos.

Mais informações em [Segurança e privacidade](/docs/pt/trust/security-and-privacy).

## O que pode dar errado

| O que você vê | Por quê | O que fazer |
| - | - | - |
| **Confira seu e-mail, senha e código de autenticação.** | E-mail ou senha errados, código de autenticação ausente ou errado, uma conta ainda não configurada ou uma sessão que terminou. | Confira cada dado e entre de novo. |
| **Houve muitas tentativas. Aguarde um momento antes de tentar novamente.** | Muitas tentativas com erro para esse e-mail a partir da sua rede. | Aguarde 15 minutos e tente de novo com cuidado. |
| **Não foi possível conectar. Tente novamente.** | Sem conexão, ou o muveya não respondeu a tempo. | Verifique a rede e entre de novo. Se as opções de acesso não carregaram, toque em **Tentar novamente**. |
| **Não foi possível verificar a resposta. Tente novamente.** | A resposta recebida pelo app não era a esperada. | Tente novamente. Se continuar, escreva para [team@muveya.com](mailto:team@muveya.com). |
| **Este app de desenvolvimento ainda não está conectado. Peça à sua equipe o app configurado.** | Esta cópia do app não está conectada a um serviço do muveya. Não é possível fazer nada com ela. | Escreva para [team@muveya.com](mailto:team@muveya.com) para obter uma cópia que você possa usar. |
| **Não foi possível confirmar a organização ativa. Atualize o acesso antes de continuar.** | A troca de organização não terminou. | Toque em **Tentar novamente**, ou em **Sair** e entre de novo. |
| **Sua conta não tem uma clínica disponível. Fale com seu administrador para revisar o acesso.** | Nenhuma participação ativa. | Fale com um administrador da sua clínica odontológica. |
| **Seu acesso nesta organização não inclui estoque. Peça a um administrador.** | Você não tem nenhuma permissão de estoque nesta organização. | Peça a um administrador. Depois abra o **Menu**, **Trocar organização** e toque em **Atualizar acesso**. |

Mais casos em [Solução de problemas](/docs/pt/help/troubleshooting).

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Operações no app Android" icon="mobile-screen-button" href="/docs/pt/android/operations">
    Escanear, registrar um uso, transferir uma caixa e receber, passo a passo.
  </Card>

  <Card title="Entrar" icon="right-to-bracket" href="/docs/pt/account/sign-in">
    Contas, convites, clínicas e sessões.
  </Card>

  <Card title="Segurança da conta" icon="shield-halved" href="/docs/pt/account/security">
    Configure o app autenticador.
  </Card>

  <Card title="Funções e permissões" icon="key" href="/docs/pt/account/roles-and-permissions">
    O que cada permissão libera.
  </Card>
</CardGroup>


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