Conceitos

Esta página explica os objetos com que você trabalha no muveya e as regras que o servidor aplica a eles. Cada seção traz o rótulo do console, o identificador usado pela API e pelo código, e links para as páginas de tarefas. O Glossário lista cada termo nos três idiomas.

Sua clínica odontológica

Uma clínica odontológica (tenant na API e no código) é a sua conta de cliente: uma clínica independente ou uma rede odontológica inteira. Ela é o limite de isolamento do muveya.

Todo registro operacional (unidades, depósitos, insumos, caixas, movimentos, pedidos, decisões, entregas) pertence a uma única clínica odontológica. Nada é compartilhado ou movido entre duas delas, e uma solicitação que não corresponde à sua clínica odontológica é recusada.
Uma pessoa pode fazer parte de várias clínicas odontológicas. Use Escolha uma clínica odontológica em Início, ou o seletor no topo da barra lateral, para trocar a clínica em que está trabalhando. Função, permissões e acesso a unidades e depósitos são definidos separadamente em cada uma.
Uma chave de API pertence a uma única clínica odontológica. A API pública deduz a clínica odontológica pela chave e nunca a aceita como parâmetro. Veja Autenticação.

Unidades

Uma unidade (clinic, clinicId) é um local operacional da sua clínica odontológica, onde os insumos são pedidos, recebidos e consumidos. O console as lista em Unidades.

Campo	Regras
Nome	Obrigatório, de 1 a 120 caracteres. Pode ser renomeado.
Status	`active` ou `inactive` (Ativar unidade / Desativar unidade). Não é possível criar um pedido novo para uma unidade inativa.

O Acesso às unidades de uma pessoa decide quais pedidos, aprovações e entregas ela vê. Veja Unidades.

Depósitos

Um depósito (warehouse, warehouseId) é um lugar onde as caixas ficam guardadas. Cada caixa está em um único depósito por vez.

Tipo	`kind`	Pertence a	Uso típico
Central	`central`	Nenhuma unidade; atende toda a clínica odontológica	O almoxarifado principal que abastece várias unidades
Express	`express`	Uma única unidade, escolhida na criação	O pequeno almoxarifado dentro de uma unidade, onde os pedidos dela são entregues

Regras que o servidor aplica:

Um depósito express deve indicar uma unidade existente da sua clínica odontológica; um depósito central não deve indicar nenhuma.
O nome é obrigatório, de 1 a 120 caracteres.
O status é active ou inactive. Um depósito inativo não recebe estoque novo (receber nele ou transferir uma caixa para ele é recusado) e não pode ser escolhido em pedidos novos.
No console, Entregar no depósito de um pedido novo oferece só os depósitos ativos que pertencem à unidade escolhida, então uma unidade precisa de um depósito express antes de fazer pedidos. O servidor nunca aceita como destino o depósito express de outra unidade. Retirar estoque de oferece depósitos centrais.

O Acesso aos depósitos de uma pessoa decide qual estoque ela vê e movimenta. Veja Depósitos.

Salas e áreas

Uma sala ou área (destination, destinationId) é um lugar dentro de uma unidade onde os insumos são usados: uma sala de atendimento (treatment_room) ou qualquer outra área (area). Salas e áreas são gerenciadas na página da unidade.

Controle de estoque	`stockControl`	O que significa
Sem contagem	`uncounted`	O que é entregue à sala sai do estoque na hora; o que sobra na sala não é contado.
Estoque contado	`controlled`	A sala mantém estoque contado próprio em um depósito express da mesma unidade, o seu Ponto de estoque. O console pode criar esse depósito automaticamente. Um depósito atende no máximo uma sala.

Os nomes das salas e áreas são únicos dentro de uma unidade. Uma sala está active ou inactive; desativá-la mantém o nome nos registros passados. Ao registrar o consumo de uma caixa, você pode informar para onde foi e como:

O que aconteceu (usage): Uso direto (use) ou Entrega à sala ou área (issue). Uma entrega a uma sala sai do estoque uma única vez; quem usou pode ser atribuído depois em Uso por sala ou área sem descontar o estoque de novo.
Finalidade (purpose): procedure, cleaning, administrative ou other.
Responsável (responsibleUserId): a pessoa da equipe responsável, que pode ser diferente de quem registra.
Referência de atendimento (opcional) (careRef): o código do seu sistema clínico, nunca o nome de um paciente. Letras, dígitos e . _ : / -, sem espaços, até 64 caracteres. É guardada selada.

Uma sala com estoque contado recusa Entrega à sala ou área e só aceita consumos registrados a partir de uma caixa que já está no seu ponto de estoque: transfira a caixa inteira antes. Uma caixa em um depósito express só pode ser atribuída a salas e áreas da unidade desse depósito; uma caixa em um depósito central pode ser atribuída a salas e áreas de qualquer unidade. Veja Salas e áreas e Registrar consumo e transferir caixas.

Insumos e catálogo

Um insumo (CatalogItem, itemId) é um item que a sua clínica odontológica autorizou. Ele descreve o que pode ser pedido e recebido; não é estoque.

Campo	Campo da API	Regras
SKU	`sku`	Obrigatório, único na sua clínica odontológica, até 64 caracteres (letras, dígitos, `.`, `_`, `/`, `-`). Não pode ser alterado depois.
Nome do insumo	`name`	Obrigatório, até 200 caracteres.
Categoria	`categoryId`	Obrigatória; uma categoria da sua clínica odontológica.
Unidade	`unitOfMeasure`	A unidade base em que toda quantidade deste insumo é contada. Fica fixa ao ativar o insumo ou ao recebê-lo pela primeira vez.
Criticidade	`criticality`	`low`, `medium` ou `high`.
Apresentação	`packaging`	Texto livre, só descritivo. Nunca altera quantidades. Não confunda com as Apresentações do insumo.
Controlar lotes, Controlar números de série, Controlar validades	`tracksLot`, `tracksSerial`, `tracksExpiry`	O que um recebimento deve registrar para cada caixa.
Insumo de alto valor	`highValue`	Pode acionar regras de aprovação, e toda correção do seu estoque exige uma segunda pessoa.
Custo, Moeda	`cost`, `currency`	Opcionais. Veja Custos.

Status. Um insumo nasce draft (Rascunho). Ao ativá-lo (Ativar e fixar unidade), ele passa a active (Ativo) e sua unidade fica fixa. inactive (Inativo) é uma desativação sem exclusão: nada é apagado. Só insumos ativos podem ser adicionados a pedidos, e o console só oferece insumos ativos no recebimento. Unidades de medida. A unidade base vem de uma lista fechada:

`unitOfMeasure`	Rótulo no console
`unit`	Unidade
`box`	Caixa
`pack`	Pacote
`bottle`	Frasco
`ampoule`	Ampola
`milliliter`	Mililitro
`liter`	Litro
`gram`	Grama
`kilogram`	Quilograma
`pair`	Par
`kit`	Kit

Apresentações. Uma apresentação (presentationId) é como você compra o insumo, por exemplo “Caixa com 100”. Suas Unidades base que contém são um número inteiro a partir de 1. Receber 3 de uma apresentação que contém 100 soma 300 unidades base. As apresentações têm versões: corrigir uma publica uma nova versão, e as caixas já recebidas mantêm a versão com que foram recebidas. Uma apresentação está active ou retired; uma retirada não pode mais ser recebida. Códigos. Uma apresentação pode ter códigos impressos na embalagem: gtin (GTIN (código de barras), de 8 a 14 dígitos), supplier (Código do fornecedor) e internal (Código interno). Um código identifica qual é o artigo, não qual é a caixa, e aponta para uma única apresentação por vez. Veja Apresentações e códigos.

Caixas

Uma caixa (StockBox, boxId) é um recipiente físico de um insumo. Ela tem:

um código da caixa (code) único na sua clínica odontológica. Você pode digitar a sua própria etiqueta no recebimento, ou o muveya gera uma;
o insumo que contém e a quantidade, sempre na unidade base do insumo;
o lote, os números de série e a data de validade quando o insumo os controla;
Recebida como: a apresentação, a versão e a quantidade com que chegou, quando foi recebida como apresentação;
o depósito em que está e o seu status.

Uma caixa só é criada por um recebimento, ou ao separar parte de outra caixa. Ela nunca é editada: sua quantidade só muda por meio de movimentos do registro.

Status	Rótulo no console	Significado
`active`	Ativa	Em um depósito e utilizável, a menos que a data de validade já tenha passado
`in_transit`	Em trânsito	Despachada para um pedido e ainda não recebida. Não pode ser reservada, consumida nem transferida.
`quarantine`	Em quarentena	Separada para verificação. Não aceita movimentos e nunca é retirada para um pedido.
`expired`	Vencida	Marcada como vencida. Fora do estoque utilizável.
`depleted`	Esgotada	A quantidade em mãos chegou a zero por consumo ou por uma correção.
`disposed`	Descartada	Descartada. Fora do estoque utilizável.

Como o status de uma caixa muda:

De active para depleted: um consumo, ou uma correção, que a zera.
De active para quarantine, expired ou disposed: Tirar a caixa de uso, que só aparece em caixas ativas. O muveya também aceita descartar uma caixa em quarentena ou vencida, mas o console não tem um botão para isso. O Recolhimento de lote coloca em quarentena, de uma vez, todas as caixas ativas de um lote.
De active para in_transit: o despacho. De in_transit para active no depósito de destino: um recebimento aceito. De in_transit de volta à origem como active ou quarantine: um recebimento contestado.

Validade. Uma caixa cuja data de validade já passou não pode ser consumida, reservada nem separada, mesmo que o status continue active. A data de validade vale até o fim daquele dia do calendário em UTC. Separar parte de uma caixa cria um novo recipiente com o mesmo insumo, lote, validade e data de recebimento, vinculado à caixa de origem. Só é possível separar unidades livres (não reservadas), nunca todo o conteúdo, e não de uma caixa que controla números de série. Na preparação de um pedido, a caixa é separada automaticamente quando contém mais do que o pedido precisa. Veja Caixas e etiquetas.

O registro de movimentos

Cada mudança de estoque é um movimento (StockMovement) incluído em um registro imutável. Um movimento guarda o tipo, a caixa, o insumo, a mudança de quantidade, quem fez (actorId), quando aconteceu (occurredAt, pelo relógio do servidor) e, quando for o caso, o pedido, os depósitos, um motivo, a segunda pessoa que aprovou ou a sala ou área. Nada no registro é editado ou apagado. Um erro é corrigido com um novo movimento que o compensa, e o original continua visível.

Tipo	Rótulo no console	Registrado quando	Em mãos	Reservado
`receive`	Recebido	O estoque é recebido, ou uma caixa aceita chega ao destino do pedido	aumenta	sem mudança
`reserve`	Reservado	O estoque é reservado para um pedido aprovado	sem mudança	aumenta
`release`	Liberado	Uma reserva é liberada	sem mudança	diminui
`pick`	Retirado para o pedido	Uma caixa reservada é escaneada para o seu pedido	sem mudança	sem mudança
`dispatch`	Despachado	Uma caixa retirada sai do depósito	diminui	diminui
`transfer_out`, `transfer_in`	Saída por transferência, Entrada por transferência	Uma caixa inteira vai para outro depósito	sem mudança	sem mudança
`split_out`, `split_in`	Separação (saída), Separação (entrada)	Parte de uma caixa é separada em um novo recipiente	diminui na caixa original, aumenta na nova	sem mudança
`consume`	Consumido	Um consumo é registrado	diminui	sem mudança
`return`	Devolvido	Uma caixa contestada volta ao depósito de onde saiu	aumenta	sem mudança
`adjust_gain`, `adjust_loss`	Correção (entrada), Correção (saída)	Uma correção ou uma diferença de contagem é aplicada	aumenta ou diminui	sem mudança
`expire`	Vencido	Uma caixa é marcada como vencida	sem mudança	sem mudança
`quarantine`	Em quarentena	Uma caixa ou um lote entra em quarentena	sem mudança	sem mudança
`dispose`	Descartado	Uma caixa é descartada	sem mudança	sem mudança

Uma operação repetida nunca conta duas vezes: cada uma leva uma chave de idempotência, e uma repetição devolve o primeiro resultado. Veja Visão geral do estoque.

Saldos

Para cada caixa, o muveya deriva do registro:

Número	Campo	Significado
Em mãos	`onHand`	A quantidade física na caixa: a soma das suas mudanças em mãos. Nunca fica abaixo de zero.
Reservado	`reserved`	A parte comprometida com pedidos aprovados.
Disponível	`available`	`onHand - reserved`: o que ainda pode ser reservado.

Reposição também mostra Utilizável agora: o estoque de caixas ativas e não vencidas que de fato pode ser usado.

FEFO e FIFO

Quando o muveya reserva estoque para um pedido, ele ordena as caixas candidatas de cada insumo:

FEFO (fefo, primeiro a vencer, primeiro a sair) quando alguma caixa candidata tem data de validade: primeiro a validade mais próxima, as caixas sem validade por último, e depois o recebimento mais antigo.
FIFO (fifo, primeiro a entrar, primeiro a sair) nos demais casos: primeiro o recebimento mais antigo.

Só caixas ativas e não vencidas são candidatas. Se o pedido indicar um depósito de origem (Retirar estoque de), só as caixas desse depósito são consideradas; caso contrário, o servidor não limita a busca a um depósito. Uma linha pode retirar de várias caixas.

Pedidos

Um pedido (Order, orderId) é uma solicitação interna de insumos de uma unidade, entregue em um dos seus depósitos. Cada pedido tem um número único na sua clínica odontológica (number, exibido como #12).

Tipo	`type`	Quem pode criar	Dados extras
Geral	`general`	`orders.create`	Motivo opcional
Clínico	`clinical`	`orders.create` e `orders.clinical.create` (a opção É para o tratamento de um paciente do console)	Referência do paciente opcional (`patientRef`), até 200 caracteres

Regras:

Só quem pediu pode adicionar, alterar ou remover linhas, e só enquanto o pedido é um rascunho. Cada linha é um insumo ativo e uma quantidade inteira de pelo menos 1, na unidade base do insumo. Ao ser adicionada, a linha guarda uma cópia do custo, da categoria e da marca de alto valor do insumo.
Só quem pediu pode enviar o pedido, e ele precisa de pelo menos uma linha. O valor do pedido fica congelado no envio.
O Motivo (opcional) aceita até 2000 caracteres e é recusado se parecer conter dados pessoais.
Só quem pediu pode cancelar, e só a partir de draft, submitted ou pending_approval.
Enviar e cancelar verificam a versão do pedido: se o pedido mudou um instante antes, a ação é recusada e a tela mostra a versão mais recente.

Status	Rótulo no console	Significado
`draft`	Rascunho	Em preparação por quem pede
`submitted`	Enviado	Enviado; aguarda a aplicação da política de aprovação
`pending_approval`	Aguardando aprovação	Precisa de uma ou mais decisões
`approved`	Aprovado	Aprovado; ainda sem estoque reservado
`rejected`	Rejeitado	Rejeitado. Final.
`cancelled`	Cancelado	Cancelado por quem pediu. Final.
`allocated`	Estoque reservado	Todas as linhas têm estoque reservado
`picking`	Em preparação	Pelo menos uma caixa foi retirada
`dispatched`	Despachado	As caixas saíram do depósito de origem
`delivered`	Entregue	Entrega confirmada
`exception`	Problema de entrega	Entrega confirmada com problema
`received`	Recebido	Todas as caixas aceitas no destino
`partially_fulfilled`	Recebido em parte	Pelo menos uma caixa contestada
`closed`	Encerrado	Encerrado pelo destino. Final.

Qualquer outra mudança de status é recusada. Veja Criar e acompanhar pedidos.

Aprovações e separação de funções

A política de aprovação decide quais pedidos enviados precisam da decisão de alguém. Veja Política de aprovação.

Versões. Publicar cria uma nova versão (policyVersion) que substitui a vigente. Versões publicadas nunca são editadas. Até que a primeira versão seja publicada, os pedidos enviados ficam em submitted; depois disso, são processados na próxima vez que qualquer pedido for enviado.
Regras. Cada regra tem condições e um requisito. Condições: faixa de valor do pedido (minValue, maxValue, em unidades menores, inclusive), tipos de pedido (orderTypes), categorias (categories) e insumos de alto valor (highValue). Uma condição vazia vale para todo pedido; uma condição de valor nunca vale para um pedido sem valor. O requisito é um Nome da etapa (stage, até 64 caracteres), a permissão que quem decide precisa ter (requiredScope, approvals.decide quando o console escreve a regra) e Pessoas que devem aprovar (minApprovers, de 1 a 10). Uma política tem no máximo 100 regras.
Avaliação. No envio, o muveya aplica a versão vigente ao pedido e guarda o plano resultante com o pedido. Se nenhuma regra corresponder (ou se a política não tiver regras, como com Publicar sem aprovações), o sistema aprova o pedido na hora (auto_approve) e a aprovação automática fica auditada.
Decisões. Quem decide escolhe uma etapa e escolhe Aprovar ou Rejeitar. Uma rejeição encerra o pedido na hora. O pedido passa a approved só quando cada etapa tem o número exigido de aprovadores diferentes. Cada decisão é um registro imutável (approved ou rejected) com a pessoa, o horário, a etapa, a versão da política e um comentário opcional (até 500 caracteres no console).

Separação de funções:

Quem pediu nunca pode decidir o próprio pedido. A tentativa é recusada e auditada, e a caixa de aprovações nunca lista os seus próprios pedidos.
Uma pessoa decide uma mesma etapa de um pedido uma única vez.
Quem decide precisa ter todas as permissões que a etapa exige e acesso à unidade do pedido.
Uma decisão tomada sobre uma versão desatualizada do pedido é recusada sem gravar nada.
Correções de estoque acima do limite exigem uma segunda pessoa, diferente (veja Contagens e correções).
A entrega é confirmada pelo lado de origem (delivery.confirm) e o recebimento pelo lado de destino (receipt.confirm). Uma pessoa limitada a unidades específicas que tem acesso tanto à unidade de origem quanto a uma unidade de destino diferente não pode confirmar o recebimento nem encerrar o pedido.

Veja Aprovar ou rejeitar pedidos.

Atendimento e custódia

Depois de aprovado, um pedido é executado por um atendimento (fulfillment), que acompanha as caixas do depósito de origem até o destino. A custódia é por caixa inteira: uma caixa viaja completa, e uma caixa que contém mais do que o pedido precisa é separada antes.

Etapa	Quem	Status do pedido depois	Registro	Caixa
Alocação	O sistema, logo após a aprovação	`allocated`	`reserve` em cada caixa escolhida	Continua `active`
Separação	`fulfillment.pick`	`picking` (primeira caixa)	`pick`; mais `split_out`, `split_in`, `release` e `reserve` quando uma caixa é separada	Continua `active`
Despacho	`fulfillment.dispatch`	`dispatched`	`dispatch`	`in_transit`
Entrega	`delivery.confirm`	`delivered`, ou `exception` com problema	Nenhum	Continua `in_transit`
Recebimento	`receipt.confirm`	`received`, ou `partially_fulfilled` com contestação	Caixa aceita: `receive` no destino. Caixa contestada: `return` na origem	Aceita: `active` no destino. Contestada: `active` ou `quarantine` na origem
Encerramento	`fulfillment.close`	`closed`	Nenhum	Sem mudança

O atendimento também tem um status próprio: allocating (Reservando estoque) enquanto a reserva acontece, e depois os mesmos valores do pedido, de allocated a closed. Regras que vale conhecer:

A alocação é tudo ou nada. Se uma linha não puder ser reservada por completo, tudo o que foi reservado nessa tentativa é liberado e o pedido continua Aprovado. O muveya tenta de novo em uma alocação posterior.
A separação só aceita caixas reservadas para aquele pedido; cada caixa é registrada uma única vez.
O despacho: o console oferece Despachar pedido quando todas as caixas reservadas foram retiradas, e você pode anotar a transportadora. Cada caixa retirada deve conter exatamente a quantidade do pedido, o que a separação garante ao dividir as caixas maiores.
Os problemas de entrega valem para o envio inteiro. O console oferece Não foi possível entregar, Chegou danificado, Foi para o lugar errado e Outra coisa, mais detalhes opcionais. Um pedido em exception não pode ser recebido nem encerrado pelo console, e as caixas continuam Em trânsito; escreva para team@muveya.com para resolver.
O recebimento precisa decidir cada caixa entregue uma vez. Uma caixa contestada precisa de um motivo (o console oferece Danificada, Faltando, Insumo errado, Vencida e Outro) e de uma descrição em Evidência do problema; você pode pedir que ela fique em quarentena quando voltar.
O encerramento não movimenta estoque; fica disponível quando cada caixa foi aceita ou devolvida.
Cada uma dessas etapas grava um registro imutável com a pessoa e o horário. O Histórico do pedido em Entregas mostra esses registros junto com os movimentos das caixas.

Veja Entregas: visão geral e Histórico de custódia.

Contagens e correções

Verificações físicas e correções exigem inventory.adjust.

Corrigir esta caixa registra uma entrada ou uma saída com quantidade e motivo (Correção de contagem, Danificado, Uso não registrado, Outro).
Contar um insumo conta as caixas ativas de um insumo em um depósito. Começar a contar abre uma contagem antes da medição, para perceber qualquer movimento que aconteça nesse meio-tempo. Uma contagem (cycleCount) está open, submitted ou cancelled. Ao salvar, cada caixa termina sem diferença, corrigida, aguardando aprovação ou alterada durante a contagem (é preciso contar de novo).
Uma campanha de contagem (countCampaign) agrupa as contagens de um depósito e está open (Em andamento) ou closed (Encerrada). Contagens também lista as caixas que não foram contadas recentemente.
Limite de aprovação. Uma correção maior que o limite ainda não altera o estoque: ela vira uma solicitação em Correções de estoque que outra pessoa com inventory.adjust precisa aprovar pela própria sessão. O limite é de 100 unidades base por padrão; um mínimo por depósito pode reduzi-lo (de 0 a 100), nunca aumentá-lo. Para insumos de alto valor, toda correção exige outra pessoa. Uma caixa tem no máximo uma solicitação pendente.

Status da solicitação	Rótulo no console	Resultado
`pending`	Pendentes	Nada gravado ainda
`approved`	Aprovada por …	Exatamente um movimento de correção gravado, com as duas pessoas
`rejected`	Rejeitada por …	Nada gravado
`withdrawn`	Retirada	Nada gravado
`stale`	Desatualizada: a caixa mudou	Nada gravado; é preciso solicitar ou contar de novo

Veja Correções de estoque e Contagens físicas.

Reposição e alertas

Um mínimo por depósito (stockPolicy) é definido para um insumo em um depósito, na unidade base dele:

Campo	Regras
Mínimo	Número inteiro a partir de 0. Zero significa “nunca alertar”.
Pedido habitual	Opcional, número inteiro a partir de 1. Sugerido quando o insumo fica abaixo do mínimo.
Avisar antes do vencimento (dias)	Opcional, de 1 a 365. Padrão: 30.
Limite de aprovação	Opcional, de 0 a 100.

Reposição compara Utilizável agora com o mínimo: Abaixo do mínimo (below_minimum), Suficiente (ok) ou Sem mínimo (no_minimum). Os alertas de estoque são gerados automaticamente: low_stock (Abaixo do mínimo) e expiry_approaching (Perto do vencimento, exibido como Vencido quando a data já passou). Um alerta fica open até a condição desaparecer e depois passa a resolved. Veja Reposição e alertas de estoque.

Permissões e acesso a unidades e depósitos

O acesso de uma pessoa em uma clínica odontológica tem três partes. 1. Função (roleTemplate): um modelo.

Função	Rótulo no console	Inclui
`owner`	Proprietário	`catalog.read`, `catalog.manage`, `members.manage`, `settings.manage`. Só um proprietário pode mudar funções, convidar administradores e transferir a propriedade. Uma clínica odontológica sempre mantém um proprietário ativo.
`admin`	Administrador	`catalog.read`, `catalog.manage`, `members.manage`, `settings.manage`
`member`	Membro	`catalog.read`

2. Permissões (scopes): todas as outras são concedidas uma a uma, para qualquer função. inventory.adjust também inclui inventory.receive, inventory.consume e inventory.transfer.

Família	Permissões	Grupo no console
Catálogo	`catalog.read`, `catalog.manage`, `catalog.cost.read`	Catálogo
Estoque	`inventory.read`, `inventory.receive`, `inventory.consume`, `inventory.transfer`, `inventory.adjust`	Estoque
Pedidos	`orders.create`, `orders.read.all`, `orders.value.read`, `orders.clinical.create`, `orders.patient_ref.read`	Pedidos
Aprovações	`approvals.policy.manage`, `approvals.decide`	Aprovações
Atendimento	`fulfillment.pick`, `fulfillment.dispatch`, `delivery.confirm`, `receipt.confirm`, `fulfillment.close`, `fulfillment.read`	Atendimento
Relatórios e auditoria	`reports.read`, `audit.read`	Relatórios e auditoria
Administração	`members.manage`, `settings.manage`, `integrations.manage`	Administração

audit.read e integrations.manage podem ser concedidas, mas nenhuma tela do console as usa por enquanto. 3. Acesso a unidades e depósitos: Acesso às unidades (clinicScopeMode, clinicIds) e Acesso aos depósitos (warehouseScopeMode, warehouseIds), cada um com todos (inclusive os criados depois), uma lista selecionada ou nenhum. O acesso às unidades limita os pedidos, aprovações e entregas que a pessoa vê; o acesso aos depósitos limita o estoque que ela vê e movimenta. O proprietário fundador começa com acesso a tudo. Ninguém pode mudar o próprio acesso a unidades e depósitos, e um convite sempre concede pelo menos uma unidade. O console oculta o que você não pode usar, mas o servidor verifica cada solicitação por conta própria. Veja Funções e permissões.

Omissão de dados no servidor

Alguns campos são omitidos pelo servidor quando quem consulta não tem a permissão. Eles não aparecem na resposta (não vêm em branco), então nenhuma tela, exportação ou integração consegue revelá-los.

Campo	Onde aparece	Permissão que o revela
Custo e moeda do insumo (`cost`, `currency`)	Catálogo, exportação CSV	`catalog.cost.read`
Cópia do custo em cada linha do pedido	Detalhe do pedido	`catalog.cost.read`
Valor do pedido e sua moeda, e o valor avaliado pela política de aprovação	Pedidos, detalhe do pedido, caixa de aprovações	`orders.value.read`
Referência do paciente de um pedido clínico (`patientRef`)	Detalhe do pedido	`orders.patient_ref.read`
Referência de atendimento de um consumo (`careRef`)	Uso por sala ou área	`orders.patient_ref.read`

A API pública nunca devolve valores de pedidos nem referências de pacientes. A referência do paciente é guardada criptografada e nunca é enviada à IA, e as mensagens de WhatsApp nunca mostram custos, valores de pedidos ou referências de pacientes. Veja Segurança e privacidade.

Auditoria

Além do registro de movimentos e dos registros imutáveis de decisões, entregas, recebimentos e encerramentos, o muveya grava registros de auditoria para ações sensíveis e recusas, por exemplo decisões de aprovação, uma tentativa recusada de aprovar o próprio pedido, aprovações automáticas, correções de estoque, etapas de custódia e importações de catálogo recusadas. Os registros de auditoria nunca são editados. Por enquanto não há tela nem API que os pesquise; use os Movimentos de uma caixa e o Histórico de um pedido para acompanhar o que aconteceu.

Idiomas, fusos horários e moeda

Idiomas. O console, as mensagens do servidor e os e-mails de convite estão em inglês (en), espanhol (es) e português (pt). Escolha em Idioma, na barra lateral, no cabeçalho do celular ou nas telas de entrada. O navegador guarda a escolha; na primeira vez, o console segue o idioma do navegador e, se não puder, usa inglês. Códigos, status e nomes de permissões continuam em inglês em todos os idiomas.
Fusos horários. O muveya guarda todos os horários em UTC. A maioria das telas mostra datas e horas no fuso horário do seu dispositivo. O relatório de consumo agrupa dias e semanas em UTC, e os resultados de análises declaram timezone como UTC. Não há configuração de fuso horário por clínica odontológica.
Moeda. Não há configuração de moeda por clínica odontológica. Cada custo de insumo leva o próprio código ISO 4217 (três letras maiúsculas, como USD ou CLP) e um valor em unidades menores inteiras: 1200 equivale a USD 12,00 ou CLP 1200. O valor de um pedido só soma as linhas na mesma moeda da primeira linha com custo, então mantenha o seu catálogo em uma única moeda.

Primeiros passos

Conta e equipe

Unidades e depósitos

Catálogo

Inventário

Pedidos e aprovações

Entregas

Relatórios

WhatsApp

App Android

Confiança e ajuda

Sua clínica odontológica

Unidades

Depósitos

Salas e áreas

Insumos e catálogo

Caixas

O registro de movimentos

Saldos

FEFO e FIFO

Pedidos

Aprovações e separação de funções

Atendimento e custódia

Contagens e correções

Reposição e alertas

Permissões e acesso a unidades e depósitos

Omissão de dados no servidor

Auditoria

Idiomas, fusos horários e moeda

Páginas relacionadas

​Sua clínica odontológica

​Unidades

​Depósitos

​Salas e áreas

​Insumos e catálogo

​Caixas

​O registro de movimentos

​Saldos

​FEFO e FIFO

​Pedidos

​Aprovações e separação de funções

​Atendimento e custódia

​Contagens e correções

​Reposição e alertas

​Permissões e acesso a unidades e depósitos

​Omissão de dados no servidor

​Auditoria

​Idiomas, fusos horários e moeda

​Páginas relacionadas

Sua clínica odontológica

Unidades

Depósitos

Salas e áreas

Insumos e catálogo

Caixas

O registro de movimentos

Saldos

FEFO e FIFO

Pedidos

Aprovações e separação de funções

Atendimento e custódia

Contagens e correções

Reposição e alertas

Permissões e acesso a unidades e depósitos

Omissão de dados no servidor

Auditoria

Idiomas, fusos horários e moeda

Páginas relacionadas