> ## 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. # Unidades > Crie, renomeie, ative e desative as unidades da sua conta de clínica odontológica e entenda o que depende de cada uma. 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](/docs/pt/locations/warehouses). * As **salas e áreas** (salas de atendimento e outros lugares onde os insumos são usados) pertencem a uma unidade. Veja [Salas e áreas](/docs/pt/locations/destinations). * Os **pedidos** são criados para uma unidade e entregues em um dos seus depósitos. Veja [Criar e acompanhar pedidos](/docs/pt/orders/create-and-track). * O **Acesso às unidades** define em quais unidades cada pessoa da equipe trabalha. Veja [Equipe](/docs/pt/account/team). ```mermaid theme={null} flowchart TD A["Conta de clínica odontológica"] --> L1["Unidade: Clínica Norte"] A --> L2["Unidade: Clínica Sul"] A --> C["Depósito central (abastece todas as unidades)"] L1 --> E1["Depósito express"] L1 --> R1["Salas e áreas"] L2 --> E2["Depósito express"] L2 --> R2["Salas e áreas"] ``` ## Quem pode fazer | Ação | Quem | | - | - | | Abrir **Unidades** e o detalhe de uma unidade | Todas as pessoas ativas da conta | | Criar uma unidade | Proprietários e administradores, ou pessoas com `settings.manage` | | Renomear uma unidade | Proprietários e administradores, ou pessoas com `settings.manage` | | Ativar ou desativar uma unidade | Proprietários e administradores, ou pessoas com `settings.manage` | | Definir em quais unidades uma pessoa trabalha | Proprietários e administradores, ou pessoas com `members.manage` (em **Equipe**) | 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](/docs/pt/account/roles-and-permissions). ## 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. | Coluna | O que mostra | | - | - | | **Nome da unidade** | O nome. Selecione-o para abrir o detalhe. | | **Status** | **Ativa** ou **Inativa**. | **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.** Esta lista não é filtrada pelo acesso às unidades. Todas as pessoas veem todas as unidades aqui; o acesso às unidades restringe pedidos, aprovações e entregas, não esta lista. ## Criar uma unidade Em **Unidades**, selecione **Nova unidade**. Uma caixa de diálogo com o título **Nova unidade** se abre. Digite o **Nome da unidade**, por exemplo `Clínica Norte`. Selecione **Salvar unidade**. O botão mostra **Salvando…** enquanto a solicitação é processada. Ao terminar, a caixa de diálogo se fecha e a unidade aparece na lista como **Ativa**. 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 | Campo | Obrigatório | Regras | | - | - | - | | **Nome da unidade** | Sim | De 1 a 120 caracteres. Os espaços no início e no fim são removidos. | * 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](/docs/pt/locations/warehouses). ## 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](/docs/pt/locations/destinations). 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 Em **Unidades**, selecione o nome da unidade. Edite **Nome da unidade**. Valem as mesmas regras: obrigatório e com no máximo 120 caracteres. Selecione **Salvar alterações**. Ao terminar, **Alterações salvas** aparece abaixo do botão. 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 | Status | Rótulo | Significado | | - | - | - | | `active` | **Ativa** | A unidade pode receber pedidos novos e depósitos express novos. | | `inactive` | **Inativa** | A unidade é mantida com todo o histórico, mas deixa de ser oferecida para trabalho novo. | 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 | Área | Efeito | | - | - | | Pedidos novos | A unidade deixa de aparecer em **Clínica** ao criar um pedido. Se uma tela desatualizada ainda a enviar, o pedido é recusado com **Essa clínica não está ativa.** | | Pedidos já criados | Nada muda. Eles seguem pela aprovação e pela entrega. | | Depósitos express novos | A unidade deixa de aparecer em **Unidade** ao criar um depósito express. | | Depósitos existentes | Nada muda. Eles mantêm o próprio status e o estoque. Desative-os separadamente em **Depósitos**, se necessário. | | Salas e áreas | Nada muda. Continuam ativas e podem ser escolhidas quando sai estoque de uma caixa. Desative-as separadamente no detalhe da unidade. | | Acesso da equipe | As pessoas mantêm o acesso às unidades. A unidade continua aparecendo, marcada como inativa, ao gerenciar o acesso em **Equipe**. | | Histórico e relatórios | Tudo o que foi registrado para a unidade continua visível e mantém o nome. | 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](/docs/pt/account/team). Se o acesso de uma pessoa lista unidades específicas, as unidades que você criar depois não são adicionadas automaticamente. Abra a pessoa em **Equipe** e adicione a unidade nova. ## 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](/docs/pt/api-reference/scopes). * A ferramenta MCP `clinics.list` lista unidades e depósitos com ids, nomes e status. Veja [Ferramentas MCP](/docs/pt/mcp/tools). ## O que pode dar errado | Mensagem | Por quê | O que fazer | | - | - | - | | **Informe um valor.** | **Nome da unidade** está vazio ou só tem espaços. | Digite um nome. | | **Este valor é muito longo.** | O nome tem mais de 120 caracteres. | Encurte o nome. | | **Sua conta não tem permissão para esta ação.** | Você não é proprietário nem administrador e não tem `settings.manage` (`tenants.insufficient_role`). | Peça a mudança a um proprietário ou administrador, ou peça a permissão **Gerenciar configuração da clínica**. | | **Este registro não está disponível na conta de clínica odontológica ativa.** | A unidade não existe na conta em que você está trabalhando (`clinics.not_found`), por exemplo um link copiado de outra conta. | Confira qual **Clínica odontológica** está escolhida no console e abra a unidade pela lista. | | **Confira os dados informados antes de tentar novamente.** | A solicitação era inválida (`common.invalid_request`), por exemplo um link incompleto para uma unidade. | Volte a **Unidades** e abra a unidade pela lista. | | **A conta de clínica odontológica ativa mudou. Recarregue a página antes de tentar novamente.** | Você trocou de conta em outra aba com esta tela aberta (`tenants.context_changed`). | Recarregue a página e confira a conta antes de tentar de novo. | | **Não foi possível confirmar a operação. Verifique sua conexão e a lista antes de tentar novamente.** | A conexão caiu antes de o muveya responder. | Confira a lista: a mudança pode já estar salva. Tente de novo só se não estiver. | | **Não foi possível concluir a solicitação. Tente novamente.** | Qualquer outra falha. | Selecione **Tentar de novo** ou repita a ação. Se continuar falhando, escreva para [team@muveya.com](mailto:team@muveya.com). | | **Essa clínica não está ativa.** | Um pedido foi enviado para uma unidade inativa ou fora do seu acesso às unidades (`orders.clinic_unavailable`). | Ative a unidade, escolha outra ou peça acesso a um administrador. | Se a lista ou o detalhe não carregarem, o erro aparece com um botão **Tentar de novo**. ## Páginas relacionadas Depósitos centrais e express, e como pedidos e estoque os usam. Onde os insumos são usados dentro de uma unidade. Dê a cada pessoa acesso às unidades e depósitos certos. Peça insumos para uma unidade. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.