Insumos do catálogo

O catálogo é a lista fechada de insumos com que a sua clínica odontológica trabalha. Cada linha de pedido, caixa de estoque e registro de consumo aponta para um insumo desta lista, então um insumo precisa existir aqui antes que alguém possa pedi-lo, recebê-lo ou usá-lo. O console chama cada item do catálogo de insumo; a API e o código o chamam de item.

​

Quem pode fazer

As permissões são atribuídas a cada pessoa na tela Equipe. Veja Funções e permissões.

​

Onde

Abra Catálogo na navegação principal. O módulo tem três telas de insumos:

​

A lista do catálogo

A tela Catálogo (Organize os insumos utilizados pela sua clínica odontológica.) mostra:

• Novo insumo, no cabeçalho, se você tem catalog.manage.
• Uma caixa de busca, Buscar por SKU ou nome. Ela encontra qualquer parte do SKU ou do nome, sem diferenciar maiúsculas nem acentos, então anestesico encontra “Anestésico local”.
• Links para Categorias e, se você tem catalog.manage, para Importar CSV e Exportar CSV. Veja Categorias e Importar e exportar.
• Dois filtros: Categoria (padrão Todas as categorias) e Status (padrão Todos os estados, depois Rascunho, Ativo e Inativo). Limpar filtros zera a busca e os dois filtros.

A tabela tem as colunas SKU, Nome do insumo, Categoria, Unidade e Status, além de Custo se você tem catalog.cost.read. Clique no nome para abrir o insumo. Os insumos aparecem na ordem em que foram criados, do mais antigo ao mais recente, 50 por página, com Anterior e Próxima abaixo da tabela e um contador das linhas exibidas sobre o total.

​

Criar um insumo

​

Campos e validações

A Unidade é a unidade de medida base em que o insumo é contado em todo lugar: estoque, pedidos, consumo e apresentações. Não confunda com as unidades da clínica (os locais). Os valores permitidos são:

​

O que as opções de rastreabilidade fazem

Uma mudança nessas opções vale para os recebimentos registrados depois dela; as caixas já recebidas mantêm o que foi registrado. Veja Receber estoque, Política de aprovação e Correções de estoque. A Criticidade é salva, exibida no insumo e incluída nas exportações. Na versão atual ela não altera alertas, reposição nem aprovações.

​

Status

Não há como voltar para draft, e insumos não podem ser excluídos. Desative os insumos que você não usa mais.

​

Por que só insumos ativos podem ser pedidos

Quando alguém adiciona um insumo a um pedido, o muveya copia para a linha o SKU, o nome, a unidade, a categoria, a marca de alto valor e o custo vigente do insumo. Essa cópia só faz sentido se a unidade for definitiva, por isso a tela de pedidos oferece apenas insumos ativos e o servidor recusa qualquer outro com orders.catalog_item_unavailable: Este insumo não está ativo no catálogo. As linhas já adicionadas mantêm a cópia mesmo que depois o insumo seja desativado ou editado. Veja Criar e acompanhar pedidos.

​

Os detalhes do insumo

Abra um insumo a partir da lista. O título da página é o nome do insumo, com Voltar ao catálogo acima.

• Se você tem catalog.manage, vê o mesmo formulário da criação com os valores atuais. O SKU fica bloqueado e diz O SKU identifica este insumo e não pode ser alterado. Clique em Salvar alterações; Insumo salvo confirma.
• Caso contrário, vê uma lista somente leitura: SKU, Categoria, Unidade, Apresentação, Descrição, Criticidade, as quatro opções de rastreabilidade como Sim ou Não, e Custo se você tem catalog.cost.read.

Abaixo dos dados, todas as pessoas veem:

1. Status, por exemplo Status: Rascunho, com Somente insumos ativos podem ser adicionados a novos pedidos.
2. Apresentações: como o insumo é comprado e recebido. Veja Apresentações e códigos.
3. Custo do insumo, só para quem tem catalog.manage e catalog.cost.read. Veja Custos.

​

Ativar ou desativar

​

A unidade fica fixa

Estoque, pedidos e apresentações são contados na unidade base do insumo, então mudá-la depois do uso mudaria o significado das quantidades registradas. O muveya protege a unidade:

• A unidade fica fixa na primeira vez que o insumo é ativado, ou na primeira vez que estoque do insumo é recebido, mesmo que ele ainda seja um rascunho.
• Uma vez fixa, continua fixa, inclusive depois de desativar o insumo. O formulário mostra a unidade como texto com Esta unidade está protegida e não pode ser alterada. Você pode editar os outros dados.
• Todo o resto, exceto o SKU, continua editável: nome, descrição, categoria, apresentação (o texto livre), criticidade e as opções de rastreabilidade.

Enquanto a unidade não estiver fixa, você pode mudá-la e salvá-la junto com os outros campos. Antes de salvar, o formulário mostra Alteração escolhida: com a nova unidade e um botão Descartar alteração da unidade. Mudar a unidade tem consequências:

• Um custo registrado para a unidade anterior passa para review_required e precisa ser confirmado de novo. Veja Custos.
• Uma apresentação publicada com a unidade anterior não serve para receber até que você a corrija, o que a publica novamente com a unidade atual.

Se a unidade não puder ser verificada ou tiver mudado nesse meio-tempo, o formulário avisa:

​

Identificadores

O console sempre mostra nomes e nunca identificadores, exceto na tela de importação CSV, onde você precisa copiar os identificadores de categoria.

​

Ler o catálogo fora do console

A API pública lê o catálogo com GET /v1/catalog/items e GET /v1/catalog/items/{itemId} (escopo catalog:read), e a ferramenta MCP catalog.search busca insumos por nome ou SKU (os ativos, por padrão). As duas são somente leitura: insumos são criados e editados apenas no console ou por uma importação CSV. Veja API para desenvolvedores e Ferramentas MCP.

​

O que o sistema registra

• O insumo, com status draft, ao ser criado.
• Quando a unidade fica fixa: quem a fixou e quando.
• As edições de campos e as mudanças de status atualizam o insumo. Na versão atual elas não são gravadas como entradas de auditoria separadas; as importações CSV, as exportações e as retiradas de códigos de embalagem são.

​

O que pode dar errado

​

Páginas relacionadas