> ## 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.
# Salas e áreas
> Configure as salas de atendimento e as áreas de cada unidade, decida se elas contam o próprio estoque e registre onde os insumos foram usados.
As **salas e áreas** são os lugares dentro de uma unidade onde os insumos são usados: uma sala de
atendimento, uma área de esterilização, a recepção. Quando sai estoque de uma caixa, quem registra
informa para qual sala ou área ele foi, e o relatório **Uso por sala ou área** soma tudo. A API e as
referências técnicas as chamam de `destinations`.
Uma sala ou área:
* pertence a exatamente uma unidade;
* tem um **Tipo**: **Sala de atendimento** ou **Área**. O tipo é só descritivo; os dois funcionam
igual;
* tem um **Controle de estoque**: **Sem contagem** ou **Estoque contado**. Esta é a opção que muda o
comportamento;
* está **Ativa** ou **Inativa**.
## Sem contagem ou estoque contado
| | **Sem contagem** (`uncounted`) | **Estoque contado** (`controlled`) |
| - | - | - |
| O que o console explica | **As entregas saem do estoque; o que fica na sala não é contado.** | **A sala mantém estoque próprio que é contado.** |
| Ponto de estoque | Nenhum. A lista mostra um traço. | Um depósito express da mesma unidade, mostrado em **Ponto de estoque**. |
| Entregar insumos à sala | Registrado como uma saída, **Entrega à sala ou área** (`issue`). As unidades saem do estoque uma única vez. | Não é permitido como saída. Leve primeiro a caixa inteira ao ponto de estoque da sala. |
| Usar insumos na sala | Registrado como **Uso direto** (`use`) a partir de qualquer caixa que possa ir para essa sala. | Registrado como uso direto a partir de caixas que estão no ponto de estoque da sala. |
| Contagens, mínimos e alertas | Nada é contado na sala. | O ponto de estoque é um depósito normal: pode ser contado, ter mínimos e gerar alertas. |
Escolha **Estoque contado** só para salas onde alguém realmente vai contar o que fica guardado lá.
Para o resto, **Sem contagem** é mais simples: os insumos saem do estoque quando são entregues.
## Quem pode fazer
| Ação | Permissão |
| - | - |
| Ver as salas e áreas de uma unidade | Todas as pessoas ativas da conta |
| Criar, ativar ou desativar uma sala ou área | Proprietários e administradores, ou `settings.manage` (**Gerenciar configuração da clínica**) |
| Escolher uma sala ou área quando sai estoque de uma caixa | `inventory.consume` (**Registrar consumo**) ou `inventory.adjust`, mais acesso ao depósito da caixa |
| Levar uma caixa para uma sala contada | `inventory.transfer` (**Transferir caixas entre depósitos**) ou `inventory.adjust`, mais acesso aos dois depósitos |
| Abrir **Uso por sala ou área** | `inventory.read` (**Ver estoque**). Só aparecem saídas de depósitos do seu acesso. |
| Atribuir uma saída depois | `inventory.consume` ou `inventory.adjust`, mais acesso ao depósito de onde o estoque saiu |
| Ver referências de atendimento em **Uso por sala ou área** | `orders.patient_ref.read` (**Ver referências externas de pacientes**) |
Veja [Funções e permissões](/docs/pt/account/roles-and-permissions).
## Onde
* Para configurar: **Unidades**, abra uma unidade, seção **Salas e áreas**
(`console.muveya.com/clinics/` seguido do id da unidade).
* Para usar: a página da caixa em **Inventário**. Veja
[Registrar consumo e transferir caixas](/docs/pt/inventory/use-and-moves).
* Para ler o relatório: **Inventário**, link **Uso por sala ou área**
(`console.muveya.com/inventory/usage`).
## A seção Salas e áreas
A seção explica **Onde os insumos são usados nesta unidade. Ao registrar uma saída, escolhe-se uma
destas.** As salas são listadas por nome.
| Coluna | O que mostra |
| - | - |
| **Nome** | O nome da sala ou área. |
| **Tipo** | **Sala de atendimento** ou **Área**. |
| **Controle de estoque** | **Sem contagem** ou **Estoque contado**. |
| **Ponto de estoque** | Para uma sala contada, o nome do depósito express dela, ou **Depósito indisponível** se não puder ser mostrado. Um traço para uma sala sem contagem. |
| **Status** | **Ativa** ou **Inativa**. |
| **Ações** | Só para quem administra: **Ativar** ou **Desativar**. |
Quando a unidade não tem nenhuma, a seção diz **Ainda não há salas nem áreas**, seguido de
**Adicione as salas de atendimento e as áreas onde esta unidade usa insumos.** para quem administra,
ou **Peça a quem administra sua clínica para adicionar salas e áreas.** para as demais pessoas.
## Criar uma sala ou área
Em **Unidades**, selecione a unidade. Role até **Salas e áreas**.
Selecione **Nova sala ou área**. Uma caixa de diálogo com o mesmo título se abre.
Digite o **Nome**, por exemplo `Sala 2` ou `Esterilização`. Em **Tipo**, escolha
**Sala de atendimento** (a opção padrão) ou **Área**.
Em **Controle de estoque**, mantenha **Sem contagem** (a opção padrão) ou escolha
**Estoque contado**. O texto abaixo do campo explica a opção.
Com **Estoque contado**, aparece o campo **Ponto de estoque**: **O depósito express desta unidade
que guarda o estoque da sala.** Mantenha **Criar automaticamente** ou escolha um dos depósitos da
lista.
Selecione **Salvar sala ou área**. A sala aparece na lista como **Ativa**.
### Campos e regras
| Campo | Obrigatório | Regras |
| - | - | - |
| **Nome** | Sim | De 1 a 120 caracteres, sem os espaços do início e do fim. Deve ser único na unidade, contando também as salas inativas. A comparação é exata, então `Sala 2` e `sala 2` são nomes diferentes. |
| **Tipo** | Sim | **Sala de atendimento** (`treatment_room`) ou **Área** (`area`). |
| **Controle de estoque** | Sim | **Sem contagem** (`uncounted`) ou **Estoque contado** (`controlled`). |
| **Ponto de estoque** | Só salas contadas | **Criar automaticamente**, ou um depósito express ativo desta unidade que nenhuma outra sala use. Uma sala sem contagem nunca tem ponto de estoque. |
Sobre o ponto de estoque:
* **Criar automaticamente** cria um depósito express novo desta unidade, com o mesmo nome da sala, na
mesma etapa que a sala. Se um dos dois falhar, nenhum é criado. O depósito novo aparece em
**Depósitos**.
* A lista de depósitos existentes mostra só depósitos express ativos desta unidade que ainda não são
ponto de estoque de outra sala, incluindo salas inativas.
* Um depósito é o ponto de estoque de no máximo uma sala.
Depois de criada, a sala não pode ter o nome, o tipo, o controle de estoque nem o ponto de estoque
alterados, e não pode ser excluída. Para corrigir, desative a sala e crie uma nova com outro nome: o
nome antigo continua ocupado pela sala inativa.
Pessoas cujo **Acesso aos depósitos** lista depósitos específicos não recebem o novo ponto de estoque
automaticamente. Adicione-o ao acesso delas em **Equipe**; caso contrário, não poderão levar caixas
para a sala nem consumir o estoque dela. Veja [Equipe](/docs/pt/account/team).
## Status
| Status | Rótulo | Significado |
| - | - | - |
| `active` | **Ativa** | A sala pode ser escolhida quando sai estoque de uma caixa. |
| `inactive` | **Inativa** | A sala é mantida e continua nomeada no histórico, mas não pode mais ser escolhida. |
Para mudar, selecione **Desativar** ou **Ativar** na linha da sala. A mudança vale na hora e pode ser
desfeita.
O que acontece ao desativar uma sala:
* Ela deixa de ser oferecida ao registrar uma saída. Uma saída que ainda a indique é recusada com
**Essa sala ou área não está mais ativa. Escolha outra.**
* As saídas anteriores mantêm o nome dela, e **Uso por sala ou área** continua a mostrá-la no filtro.
* Em uma sala contada, o depósito ponto de estoque não é desativado e continua ligado à sala: não pode
virar ponto de estoque de outra sala. Os consumos registrados nesse depósito deixam de ser marcados
automaticamente com a sala. Desative o depósito separadamente em **Depósitos** se ele não deve mais
receber estoque.
## Como as salas e áreas são usadas quando sai estoque de uma caixa
A tarefa completa está em [Registrar consumo e transferir caixas](/docs/pt/inventory/use-and-moves). Isto é o que as
salas e áreas mudam nela:
Em uma caixa de um depósito **central**, **Sala ou área** oferece as salas ativas de todas as
unidades. Em uma caixa de um depósito **express**, só as salas ativas da unidade desse depósito.
Quando a conta tem mais de uma unidade, cada sala mostra a unidade depois do nome, por exemplo
`Sala 2 · Clínica Norte`. Se só uma sala é possível, ela aparece sem pedir escolha.
Se a unidade não tem nenhuma sala ativa, o formulário diz **Esta unidade ainda não tem salas nem
áreas, então este consumo não dirá para onde foi.** O consumo pode ser registrado mesmo assim, mas
não aparecerá em **Uso por sala ou área**. Quem administra também vê o link
**Configurar salas e áreas**.
Escolha **O que aconteceu**: **Entrega à sala ou área** (a opção padrão, **Sai do estoque uma
única vez; quem usou pode ser atribuído depois sem descontar de novo.**) ou **Uso direto** (**Foi
usado na hora.**).
Se a caixa já está no ponto de estoque da sala, o formulário diz **Usado a partir do estoque
contado desta sala.** e a saída é registrada como uso direto. Se a caixa está em outro lugar, diz,
por exemplo, **Sala 2 conta seu próprio estoque. Leve primeiro a caixa inteira até lá; retirar só
parte de uma caixa virá depois.** Quem pode transferir caixas vê **Levar esta caixa para Sala 2**;
as demais pessoas leem **Peça a alguém que possa transferir caixas para levar esta caixa até
Sala 2.**
Preencha **Finalidade**, **Responsável** e, se quiser, **Referência de atendimento (opcional)**
(veja a próxima seção) e selecione **Consumir**.
Todo consumo registrado sem sala, por qualquer canal (por exemplo, WhatsApp), em uma caixa que está no
ponto de estoque de uma sala contada ativa é registrado automaticamente como uso direto nessa sala.
### Regras aplicadas pelo sistema
* A sala precisa estar ativa (`inventory.destination_not_found`).
* Uma caixa de um depósito express só pode ir para uma sala da mesma unidade. Uma caixa de um
depósito central pode ir para uma sala de qualquer unidade (`inventory.destination_mismatch`).
* Uma sala contada recusa **Entrega à sala ou área** (`inventory.destination_requires_transfer`) e
aceita uso direto só a partir do próprio ponto de estoque (`inventory.destination_mismatch`).
* Se a caixa foi transferida para outro depósito enquanto você registrava, a saída é recusada em vez
de ser atribuída ao lugar errado (`inventory.destination_mismatch`).
* A quantidade precisa ser um número inteiro maior que zero.
## Campos de atribuição
| Campo | Valores | Observações |
| - | - | - |
| **Finalidade** | **Não especificada**, **Procedimento** (`procedure`), **Limpeza** (`cleaning`), **Administrativa** (`administrative`), **Outra** (`other`) | Opcional. É uma lista fechada, então os relatórios nunca dependem de texto livre. |
| **Responsável** | Uma pessoa ativa da equipe | Por padrão, você. Se escolher outra pessoa, o formulário diz, por exemplo, **Registrado por você, responsável: Dra. Pereira.** |
| **Referência de atendimento (opcional)** | O código do sistema clínico externo | **O código do sistema clínico, nunca o nome do paciente.** De 1 a 64 caracteres: começa com uma letra ou um número e depois usa só letras, números e `.` `_` `:` `/` `-`, sem espaços. Exemplo: `ext-7f3a`. |
| Registrado por | Você | Gravado automaticamente. É um campo diferente de **Responsável**. |
A referência de atendimento é guardada selada. Ela nunca aparece na página da caixa nem nas listas de
movimentos; só é mostrada em **Uso por sala ou área**, e só para pessoas com
`orders.patient_ref.read`.
Nunca digite o nome de um paciente, o CPF ou qualquer identificador direto como referência de
atendimento. O formato bloqueia nomes com espaços, mas não consegue reconhecer todos os
identificadores.
## O relatório Uso por sala ou área
**Inventário**, **Uso por sala ou área** mostra **O que saiu do estoque para cada sala ou área, e
quanto já está atribuído.**
Filtros:
| Filtro | Valor inicial | Regras |
| - | - | - |
| **Sala ou área** | **Todas as salas e áreas** | Lista todas as salas, ativas ou não. |
| **De** e **Até** | Os últimos 7 dias, incluindo hoje | Dias corridos completos no seu fuso horário. **De** precisa ser igual ou anterior a **Até**, com no máximo 92 dias de diferença; caso contrário, a tela diz **Escolha uma data inicial igual ou anterior à final, com no máximo 92 dias de diferença.** |
**Totais** tem uma linha por sala, insumo e unidade de medida (quantidades em unidades de medida diferentes
nunca são somadas):
| Coluna | Significado |
| - | - |
| **Sala ou área** | A sala. |
| **Insumo** | O nome e o código do insumo. |
| **Unidade** | A unidade de medida das quantidades. |
| **Entregue** | Quantidade entregue a salas sem contagem. |
| **Uso direto** | Quantidade registrada como uso direto. |
| **Atribuído** | Quanto dessas saídas foi atribuído depois. |
**Saídas** lista cada saída: **Quando**, **Insumo**, **Quantidade**, **Unidade**, **Sala ou área**,
**O que aconteceu**, **Finalidade**, **Responsável**, **Registrado por**, **Pendente** (quantidade
ainda não atribuída) e, se você puder vê-la, **Referência de atendimento**. Um botão
**Atribuições (3)** expande as atribuições posteriores de uma saída, cada uma com **Quando**,
**Quantidade**, **Responsável**, **Finalidade**, **Registrado por** e, quando permitido,
**Referência de atendimento**.
* Só aparecem saídas registradas com uma sala ou área. Se não houver, a tela diz **Não há saídas com
sala ou área nestas datas.** e **Aqui aparecem apenas os consumos registrados com uma sala ou
área.**
* Uma leitura cobre no máximo 2.000 saídas. Acima disso, a tela diz **Esta é uma visão parcial.
Restrinja as datas para ver todas as saídas.** e os totais ficam incompletos.
* Uma pessoa que não está mais na equipe aparece como **Fora da equipe**.
### Atribuir uma saída depois
Use quando você entregou insumos a uma sala e depois soube quem os usou e para quê.
Em **Uso por sala ou área**, encontre a saída. **Atribuir** aparece quando você pode registrar
consumo e a saída ainda tem quantidade **Pendente**.
Informe **Quantidade a atribuir** (começa com a quantidade pendente), **Responsável**,
**Finalidade** e, se quiser, **Referência de atendimento (opcional)**.
Selecione **Salvar atribuição**. A tela confirma **Atribuição registrada.** e a quantidade pendente
diminui. Selecione **Fechar** ao terminar.
Regras:
* A quantidade é um número inteiro maior que zero, e o total atribuído nunca pode passar da saída.
Mais do que o pendente é recusado com **Isso excede o que ainda está pendente desta saída.**
* Qualquer saída registrada com uma sala pode ser atribuída, seja entrega ou uso direto.
* Uma saída aceita no máximo 500 atribuições.
* Salvar a mesma atribuição duas vezes (por exemplo, com um toque duplo) registra uma vez só; a tela
diz **Já estava registrado.**
* Uma atribuição não pode ser editada nem removida.
## O que o sistema registra
* **A sala ou área**: unidade, nome, tipo, controle de estoque, ponto de estoque e status. Mudar o
status atualiza esse registro. Essas mudanças não geram registro de auditoria.
* **Cada saída**: um movimento `consume` no registro de movimentos, que desconta a quantidade da
caixa uma única vez. Ele guarda a sala (`destinationId`), o que aconteceu (`usage`: `issue` ou
`use`), a finalidade, a pessoa responsável, quem registrou e a referência de atendimento selada.
Esses campos não mudam depois.
* **Cada atribuição posterior**: um registro separado, só de inclusão, ligado à saída. Nunca é um
movimento de estoque, então não pode descontar estoque uma segunda vez.
* **Levar uma caixa para uma sala contada**: uma transferência normal entre depósitos; o total de
estoque não muda.
Por enquanto, salas e áreas não fazem parte da API pública nem do MCP.
## O que pode dar errado
Ao configurar salas e áreas:
| Mensagem | Por quê | O que fazer |
| - | - | - |
| **Informe um valor.** | **Nome** está vazio. | Digite um nome. |
| **Este valor é muito longo.** | O nome tem mais de 120 caracteres. | Encurte o nome. |
| **Esta unidade já tem uma sala ou área com esse nome.** | O nome já é usado nesta unidade, talvez por uma sala inativa (`destinations.name_taken`). | Escolha outro nome. |
| **Escolha um depósito express ativo desta unidade que nenhuma outra sala use.** | O ponto de estoque escolhido está inativo, é central, é de outra unidade ou já é usado por outra sala (`destinations.warehouse_invalid`). | Escolha outro depósito ou mantenha **Criar automaticamente**. |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | A unidade ou a sala não existe nesta conta (`clinics.not_found`, `destinations.not_found`). | Abra a unidade de novo a partir de **Unidades**. |
| **Sua conta não tem permissão para esta ação.** | Você não tem `settings.manage` (`tenants.insufficient_role`). | Peça a um proprietário ou administrador. |
| **Confira os dados informados antes de tentar novamente.** | Os dados foram recusados (`common.invalid_request`). | Confira os campos e tente de novo. |
Ao registrar uma saída ou uma atribuição:
| Mensagem | Por quê | O que fazer |
| - | - | - |
| **Esta sala conta seu próprio estoque. Leve primeiro a caixa até lá.** | Você tentou entregar a uma sala contada (`inventory.destination_requires_transfer`). | Leve a caixa inteira para a sala e depois registre o uso. |
| **Esta caixa pertence a outra unidade que não a da sala ou área escolhida. Verifique onde está a caixa.** | A caixa e a sala são de unidades diferentes, a caixa não está no ponto de estoque da sala contada ou foi transferida nesse meio-tempo (`inventory.destination_mismatch`). | Recarregue a caixa e escolha uma sala da unidade dela. |
| **Essa sala ou área não está mais ativa. Escolha outra.** | A sala foi desativada (`inventory.destination_not_found`). | Escolha outra sala. |
| **A pessoa responsável não está mais na equipe. Escolha outra pessoa.** | A pessoa responsável escolhida não é uma pessoa ativa da equipe (`inventory.responsible_not_member`). | Escolha outra pessoa. |
| **Use letras, números e . \_ : / - sem espaços.** | A referência de atendimento tem um espaço ou um caractere não permitido. | Corrija ou deixe em branco. |
| **Use o código do sistema clínico, sem espaços.** | O muveya recusou a referência de atendimento (`inventory.care_ref_invalid`). | Use o código do sistema externo. |
| **Isso excede o que ainda está pendente desta saída.** | A atribuição passa do pendente (`inventory.attribution_exceeds_exit`). | Diminua a quantidade. |
| **O registro mudou ou já existe. Confira antes de tentar novamente.** | A saída não aceita mais atribuições, ou uma ação repetida não bate com a original (`inventory.exit_not_attributable`, `inventory.idempotency_key_conflict`). | Recarregue **Uso por sala ou área** e confira a saída. |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | A saída é de um depósito fora do seu acesso (`inventory.movement_not_found`). | Peça a um administrador acesso a esse depósito. |
## Páginas relacionadas
Registre consumos, escolha a sala e transfira caixas.
As unidades às quais as salas e áreas pertencem.
Depósitos express que funcionam como pontos de estoque.
Quem pode configurar salas, registrar consumo e ver referências de atendimento.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.