Unidades

Uma unidade é um local operacional da sua conta de clínica odontológica: uma filial, um consultório ou qualquer lugar onde sua equipe usa insumos. Sua conta (a Clínica odontológica que você escolhe ao entrar) pode ter muitas unidades. A API e as referências técnicas chamam a unidade de clinic e a conta de tenant; no console você sempre vê Unidades. Quase tudo o que é operacional depende de uma unidade:

• Os depósitos express pertencem a exatamente uma unidade. Os depósitos centrais não pertencem a nenhuma e abastecem todas. Veja Depósitos.
• As salas e áreas (salas de atendimento e outros lugares onde os insumos são usados) pertencem a uma unidade. Veja Salas e áreas.
• Os pedidos são criados para uma unidade e entregues em um dos seus depósitos. Veja Criar e acompanhar pedidos.
• O Acesso às unidades define em quais unidades cada pessoa da equipe trabalha. Veja Equipe.

​

Quem pode fazer

Em Equipe, settings.manage aparece como Gerenciar configuração da clínica. Proprietários e administradores têm essa permissão pela função. Quem não a tem vê as mesmas telas somente para leitura: sem o botão Nova unidade, com o nome como texto e sem botão para ativar ou desativar. Veja Funções e permissões.

​

Onde

Navegação principal, Unidades (console.muveya.com/clinics). Ao selecionar o nome de uma unidade, o detalhe dela se abre (/clinics/ seguido do id da unidade).

​

A lista de unidades

A lista mostra todas as unidades da conta, na ordem em que foram criadas. Buscar unidades filtra pelo nome enquanto você digita. Não diferencia maiúsculas, minúsculas nem acentos, então clinica norte encontra “Clínica Norte”. Estados vazios:

• Sem unidades: Ainda não há unidades. Quem administra lê Crie a primeira unidade para vincular seus depósitos e insumos.; as demais pessoas leem Peça a quem administra sua clínica para adicionar uma unidade.
• Uma busca sem resultado: Nenhum resultado encontrado e Tente outra busca.

​

Criar uma unidade

Selecione Cancelar para fechar sem criar nada. Enquanto o salvamento está em andamento, a caixa de diálogo não pode ser fechada.

​

Campos e regras

• Uma unidade tem apenas nome e status. Não há campo de código nem de endereço.
• Não há verificação de nomes únicos: duas unidades podem ter o mesmo nome. Em todas as telas as unidades são escolhidas pelo nome, então dê um nome diferente a cada uma.
• Uma unidade nova sempre começa como Ativa.

​

Primeira configuração a partir do Início

Quando a conta ainda não tem unidades, quem administra vê o cartão Crie a primeira unidade em Para começar a operar, no Início. Ele abre a mesma caixa de diálogo Nova unidade. Depois de salvar, a caixa de diálogo Novo depósito se abre na hora com o nome Depósito principal já preenchido:

• Tipo de depósito começa em Central. Um depósito central abastece todas as unidades.
• Se você mudar para Express, a unidade que acabou de criar já vem escolhida em Unidade, e o depósito fica vinculado a ela.

Fechar qualquer uma das duas caixas de diálogo encerra o percurso. Você sempre pode criar depósitos depois em Depósitos.

​

O detalhe da unidade

Abra uma unidade a partir da lista. O cabeçalho mostra o nome e Gerencie esta unidade e sua disponibilidade. Selecione Voltar às unidades para retornar. O detalhe tem três partes:

1. Nome. Quem administra vê o campo editável Nome da unidade com Salvar alterações. As demais pessoas veem o nome como texto.
2. Status. Um título como Status: Ativa e, para quem administra, o botão Desativar unidade ou Ativar unidade.
3. Salas e áreas. As salas de atendimento e as áreas da unidade, com o controle de estoque e o ponto de estoque. Veja Salas e áreas.

O detalhe não lista os depósitos da unidade. Para vê-los, abra Depósitos: a coluna Unidade indica a unidade de cada depósito express.

​

Renomear uma unidade

Os registros apontam para a unidade, não para o nome dela, então as telas do console que a nomeiam (pedidos, depósitos, salas e áreas, acesso da equipe) mostram o nome novo, inclusive para o que foi registrado antes da mudança.

​

Status

Para mudar, abra a unidade e selecione Desativar unidade ou Ativar unidade. A mudança vale na hora e pode ser desfeita a qualquer momento. Não há etapa de confirmação nem forma de excluir uma unidade.

​

O que acontece ao desativar uma unidade

Ao ativar a unidade de novo, ela volta a ficar disponível para pedidos novos e depósitos express novos.

​

O que o sistema registra

• Criar uma unidade grava o nome e o status active na sua conta. Renomear ou mudar o status atualiza esse mesmo registro.
• Essas mudanças não são movimentos de estoque e nunca tocam o registro de movimentos.
• O muveya não grava um registro de auditoria separado ao criar, renomear ou mudar o status de uma unidade.
• As unidades nunca são excluídas, então todo pedido e registro que menciona uma continua mostrando o nome dela.

​

Acesso às unidades da equipe

Cada pessoa tem Acesso às unidades: Todas as unidades desta conta (inclui as criadas depois), Unidades selecionadas ou Nenhuma unidade. Ele define de quais unidades a pessoa vê pedidos, aprovações e entregas, e para quais unidades ela pode criar pedidos. Com Nenhuma unidade, ela não vê nada disso. O acesso é gerenciado em Equipe; veja Equipe.

​

Pela API e pelo MCP

• A API pública lista as unidades com GET /v1/clinics (escopo clinics:read). Cada item traz clinicId, name e status. A API não cria nem altera unidades. Veja Escopos.
• A ferramenta MCP clinics.list lista unidades e depósitos com ids, nomes e status. Veja Ferramentas MCP.

​

O que pode dar errado

Se a lista ou o detalhe não carregarem, o erro aparece com um botão Tentar de novo.

​

Páginas relacionadas