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

# Início rápido

> Coloque uma clínica odontológica para funcionar de ponta a ponta: configuração, primeiro estoque, primeiro pedido, entrega, recebimento e relatório de consumo

Este roteiro leva uma clínica odontológica nova de uma conta vazia até um insumo que foi recebido, pedido, aprovado, entregue, recebido em uma unidade e consumido. Cada etapa indica a tela (como o console a nomeia), a permissão necessária e a página com os detalhes.

O exemplo usa uma unidade, **Clínica Norte**, um depósito central chamado **Depósito Central**, que guarda o estoque, e um depósito express chamado **Depósito Norte**, que pertence à Clínica Norte e recebe os pedidos. O insumo são luvas de nitrilo, SKU `GLV-NIT-M`, compradas em caixas de 100.

## Antes de começar

<Warning>
  **As funções não concedem permissões operacionais.** Como proprietário, você gerencia unidades, depósitos, o catálogo e a equipe desde o primeiro minuto, porque a função de proprietário inclui `settings.manage`, `catalog.manage`, `catalog.read` e `members.manage`. Ver o estoque, receber estoque, criar pedidos, aprová-los, preparar e receber entregas e ler relatórios exigem permissões concedidas de forma explícita, **inclusive ao proprietário**. A etapa 2 cuida disso.
</Warning>

<Note>
  **Você não pode aprovar o seu próprio pedido.** Quem faz um pedido nunca pode decidi-lo. Para ver a etapa de aprovação você precisa de uma segunda pessoa com `approvals.decide` (convidada na etapa 6), ou de uma política de aprovação que aprove cada pedido sozinha (etapa 7).
</Note>

| Permissão | Usada neste roteiro para |
| - | - |
| `settings.manage` | Unidades, depósitos, salas e áreas (incluída nas funções de proprietário e administrador) |
| `catalog.manage` | Categorias, insumos, apresentações e códigos (incluída nas funções de proprietário e administrador) |
| `members.manage` | Convidar pessoas e editar o acesso delas (incluída nas funções de proprietário e administrador) |
| `inventory.read` | Ver **Inventário**, caixas, alertas e contagens |
| `inventory.receive` | Receber estoque |
| `inventory.consume` | Registrar o que foi consumido |
| `orders.create` | Criar e enviar pedidos |
| `approvals.policy.manage` | Publicar a política de aprovação |
| `approvals.decide` | Decidir pedidos (sempre alguém diferente de quem pediu). Você precisa dela para oferecê-la em um convite. |
| `fulfillment.pick`, `fulfillment.dispatch` | Preparar e despachar o pedido |
| `delivery.confirm` | Confirmar a entrega |
| `receipt.confirm`, `fulfillment.read` | Receber o pedido caixa por caixa |
| `fulfillment.close` | Encerrar o pedido |
| `reports.read` | Abrir **Relatórios** |

## Roteiro

<Steps>
  <Step title="Crie sua conta e sua clínica odontológica">
    Abra `https://console.muveya.com`, escolha **Criar uma clínica odontológica** e preencha **Seu nome**, **E-mail** e **Nome da clínica odontológica**. Abra o link de verificação do e-mail, defina sua senha em **Escolha sua senha** e entre. Você também pode escolher **Continuar com o Google** e confirmar o nome da sua clínica odontológica.

    Você passa a ser **Proprietário** da nova clínica odontológica, com acesso a todas as unidades e depósitos, inclusive os que criar depois. O console abre em **Início**, onde **Para começar a operar** lista o que ainda falta.

    Permissão: nenhuma. Detalhes: [Entrar](/docs/pt/account/sign-in).
  </Step>

  <Step title="Conceda a si mesmo as permissões que vai usar">
    Vá em **Equipe**, abra a sua própria linha, marque em **Permissões** as permissões da tabela acima e escolha **Salvar permissões**. As permissões marcadas como **Incluído na função** já são suas. Inclua `approvals.decide` se for convidar um aprovador: um convite só pode oferecer permissões que você tem. Tê-la não permite que você decida os seus próprios pedidos.

    Permissão: `members.manage`. Detalhes: [Funções e permissões](/docs/pt/account/roles-and-permissions).
  </Step>

  <Step title="Adicione suas unidades">
    Vá em **Unidades**, escolha **Nova unidade**, digite o **Nome da unidade** (por exemplo, Clínica Norte) e escolha **Salvar unidade**. Em **Início**, o cartão **Crie a primeira unidade** abre o mesmo formulário e depois oferece o depósito principal da unidade.

    Abra uma unidade para adicionar as **Salas e áreas** (salas de atendimento e outras áreas) se quiser que cada consumo diga onde aconteceu.

    Permissão: `settings.manage`. Detalhes: [Unidades](/docs/pt/locations/clinics), [Salas e áreas](/docs/pt/locations/destinations).
  </Step>

  <Step title="Adicione seus depósitos">
    Vá em **Depósitos** e escolha **Novo depósito**. Dê um **Nome do depósito**, escolha o **Tipo de depósito** e escolha **Salvar depósito**:

    * **Central**: atende toda a clínica odontológica e não pertence a nenhuma unidade. Crie assim o **Depósito Central**.
    * **Express**: pertence a uma única **Unidade**. Crie assim o **Depósito Norte**, vinculado à Clínica Norte.

    O console entrega um pedido em um depósito que pertence à unidade que pede, então cada unidade que faz pedidos precisa de um depósito express.

    Permissão: `settings.manage`. Detalhes: [Depósitos](/docs/pt/locations/warehouses).
  </Step>

  <Step title="Configure o catálogo">
    **Manualmente.** Vá em **Catálogo** e abra **Categorias** para criar pelo menos uma categoria (**Nova categoria** e depois **Salvar categoria**). De volta a **Catálogo**, escolha **Novo insumo**, preencha **SKU**, **Nome do insumo**, **Categoria**, **Unidade** e **Criticidade**, escolha o que controlar (**Controlar lotes**, **Controlar números de série**, **Controlar validades**) e escolha **Criar insumo**. Um insumo novo começa como **Rascunho**. Abra-o e escolha **Ativar e fixar unidade**: pelo console, só insumos ativos são recebidos e adicionados a pedidos.

    No insumo, em **Apresentações**, escolha **Adicionar apresentação** (por exemplo, "Caixa com 100" com **Unidades base que contém** igual a 100) e depois **Adicionar código** para registrar o código de barras impresso na embalagem, assim o recebimento consegue escaneá-lo.

    **Por arquivo.** Escolha **Importar CSV** e envie um arquivo com as colunas `sku`, `name`, `categoryId`, `unitOfMeasure` e `criticality` (até 5 MB e 10.000 linhas de dados). Os insumos importados são criados como rascunhos, então ative-os depois. O servidor só aceita importações de um proprietário ou de um administrador.

    Permissão: `catalog.manage` (CSV: função de proprietário ou administrador). Detalhes: [Insumos do catálogo](/docs/pt/catalog/items), [Apresentações e códigos](/docs/pt/catalog/presentations-and-codes), [Importar e exportar](/docs/pt/catalog/import-export).
  </Step>

  <Step title="Convide sua equipe e defina o acesso">
    Vá em **Equipe** e escolha **Convidar pessoa**. Informe o e-mail, escolha a **Função** (**Membro**, ou **Administrador** se você for proprietário), marque as **Permissões** de que a pessoa precisa (você só pode conceder acessos que tem), escolha o **Acesso às unidades** e o **Acesso aos depósitos**, escolha o **Idioma do e-mail** e escolha **Criar convite**. Para este roteiro, convide pelo menos um aprovador com `approvals.decide` e acesso à Clínica Norte.

    Depois que a pessoa entrar, abra-a em **Equipe** para mudar as **Permissões** (**Salvar permissões**) ou as **Unidades e depósitos** (**Salvar acesso aos locais**). Ninguém pode mudar as próprias unidades e depósitos.

    Permissão: `members.manage`. Detalhes: [Equipe](/docs/pt/account/team), [Funções e permissões](/docs/pt/account/roles-and-permissions).
  </Step>

  <Step title="Publique uma política de aprovação">
    Vá em **Aprovação de pedidos** e escolha **Política de aprovação**. Escolha **Publicar sem aprovações** (cada pedido enviado se aprova sozinho), ou adicione uma regra com **Adicionar uma regra**, um **Nome da etapa** e **Pessoas que devem aprovar**, e escolha **Publicar política**. Enquanto não houver política, os pedidos enviados ficam aguardando e ninguém pode decidi-los.

    Permissão: `approvals.policy.manage`. Detalhes: [Política de aprovação](/docs/pt/orders/approval-policy).
  </Step>

  <Step title="Receba o primeiro estoque">
    Vá em **Inventário** e escolha **Receber**. Em **Como encontrar o que chegou**, escolha **Escanear um código** (digite ou escaneie o **Código do fornecedor** e escolha **Buscar**) ou **Escolher o insumo** (**Buscar insumos**). Indique como chegou em **Chegou como** (uma apresentação ou unidades soltas), informe **Quantas**, escolha o **Depósito** (Depósito Central), preencha o lote, a data de validade ou os números de série se o insumo os controla, e escolha **Receber**.

    O muveya cria uma caixa com um código (você pode digitar o seu em **Código da caixa (opcional)**), registra um movimento `receive` e oferece a impressão da etiqueta da caixa.

    Permissão: `inventory.receive` (ou `inventory.adjust`, que a inclui), mais acesso ao depósito. Detalhes: [Receber estoque](/docs/pt/inventory/receive).
  </Step>

  <Step title="Crie e envie um pedido">
    Vá em **Pedidos** e escolha **Novo pedido**. Escolha a **Clínica** (Clínica Norte), **Entregar no depósito** (Depósito Norte) e, em **Retirar estoque de**, Depósito Central. Adicione um **Motivo (opcional)** se for útil e escolha **Criar pedido**. O pedido abre como **Rascunho**: em **Adicionar um insumo**, escolha o **Insumo**, informe uma **Quantidade** inteira e escolha **Adicionar insumo**. Quando a lista estiver completa, escolha **Enviar pedido**.

    Permissão: `orders.create`. Detalhes: [Criar e acompanhar pedidos](/docs/pt/orders/create-and-track).
  </Step>

  <Step title="Aprove o pedido">
    O pedido passa de **Enviado** para **Aguardando aprovação** quando a política é aplicada. O aprovador vai em **Aprovação de pedidos** e seleciona o número do pedido para abrir **Decidir o pedido #N**, confere a **Etapa que você decide**, adiciona um **Comentário (opcional)** e escolhe **Aprovar**. Com a política **Publicar sem aprovações**, o pedido fica **Aprovado** sozinho.

    Depois da aprovação, o muveya reserva o estoque para o pedido e o status passa a **Estoque reservado**. Se não houver estoque utilizável suficiente, o pedido continua **Aprovado** e nada é reservado.

    Permissão: `approvals.decide`, nas mãos de alguém diferente de quem pediu, com acesso à unidade do pedido. Detalhes: [Aprovar ou rejeitar pedidos](/docs/pt/orders/approvals).
  </Step>

  <Step title="Prepare e despache o pedido">
    Vá em **Entregas** e, em **A preparar**, selecione o número do pedido para abrir **Preparar o pedido #N**. **Caixas a retirar** lista as caixas reservadas. Para cada uma, escaneie ou digite a etiqueta em **Código da caixa** e escolha **Registrar caixa**. Quando todas estiverem retiradas, informe uma **Transportadora ou mensageiro (opcional)** e escolha **Despachar pedido**. As caixas saem do Depósito Central e ficam **Em trânsito**.

    Permissão: `fulfillment.pick` para registrar caixas, `fulfillment.dispatch` para despachar. Detalhes: [Preparar e despachar um pedido](/docs/pt/deliveries/picking).
  </Step>

  <Step title="Confirme a entrega">
    Em **A entregar**, selecione o número do pedido para abrir **Entrega do pedido #N**, confira **O que está sendo entregue** e escolha **Confirmar entrega**. Se algo deu errado, escolha **Informar um problema**: o pedido passa a **Problema de entrega**.

    Permissão: `delivery.confirm`. Detalhes: [Entrega e recebimento](/docs/pt/deliveries/delivery-and-receipt).
  </Step>

  <Step title="Confirme o recebimento e encerre o pedido">
    Em **A receber**, selecione o número do pedido para abrir **Receber o pedido #N**. Para cada caixa, escolha **Aceitar**, ou **Contestar** com um motivo e uma descrição em **Evidência do problema**. Escolha **Confirmar recebimento**. As caixas aceitas ficam no Depósito Norte; as contestadas voltam ao depósito de onde saíram.

    Depois, em **A encerrar**, selecione o número do pedido para abrir **Acompanhamento do pedido #N** e escolha **Encerrar pedido**.

    Permissão: `receipt.confirm` e `fulfillment.read` para receber, `fulfillment.close` e `fulfillment.read` para encerrar. Detalhes: [Entrega e recebimento](/docs/pt/deliveries/delivery-and-receipt), [Histórico de custódia](/docs/pt/deliveries/custody-history).
  </Step>

  <Step title="Registre um consumo e confira o relatório">
    Em **Inventário**, abra uma caixa do Depósito Norte (pela lista ou com **Escanear um código**), escolha **Consumir**, informe a quantidade e, se a unidade tiver salas e áreas, a **Sala ou área** e **O que aconteceu**. Depois vá em **Relatórios**: **Consumo por insumo** mostra o que cada insumo consumiu no **Período** escolhido, agrupado por dia ou por semana.

    Permissão: `inventory.consume` para registrar o consumo, `reports.read` para o relatório. Detalhes: [Registrar consumo e transferir caixas](/docs/pt/inventory/use-and-moves), [Relatório de consumo](/docs/pt/reports/consumption).
  </Step>
</Steps>

## O que você tem agora

* Um registro com os movimentos de cada caixa (`receive`, `reserve`, `pick`, `dispatch`, o `receive` no destino e `consume`, mais `split_out` e `split_in` se uma caixa foi separada na preparação), cada um com quem o fez e quando. Abra uma caixa para ver os **Movimentos**.
* Um pedido cujo **Histórico** em **Entregas** mostra quem entregou e quem recebeu, e cujas **Decisões** em **Aprovação de pedidos** mostram quem aprovou.
* Um número de consumo que você pode ler por insumo, por dia ou por semana.

## Se uma etapa não funcionar

| O que você vê | O que fazer |
| - | - |
| **Você não tem acesso** ou falta uma opção no menu | Confira em **Equipe** a permissão indicada na etapa. |
| **Ainda não há política de aprovação: os pedidos enviados aguardam até que uma seja publicada** | Publique uma política (etapa 7). |
| **Você solicitou este pedido, então outra pessoa precisa aprová-lo.** | Peça ao aprovador, ou publique **Publicar sem aprovações**. |
| O pedido continua **Aprovado** e nunca mostra **Estoque reservado** | Falta estoque utilizável de um insumo do pedido no depósito de origem. Confira **Inventário** e veja [Solução de problemas](/docs/pt/help/troubleshooting). |
| **Esta clínica ainda não tem um depósito ativo. Crie um em Depósitos primeiro.** | Crie um depósito express para essa unidade (etapa 4). |

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


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