> ## 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. # Categorias > Crie as categorias que agrupam seus insumos e saiba para que elas servem e o que ainda não permitem. Uma categoria agrupa insumos no catálogo da sua clínica odontológica, por exemplo "Luvas e proteção de barreira" ou "Anestesia". Cada insumo pertence a exatamente uma categoria, então você precisa de pelo menos uma categoria antes de criar um insumo. Uma categoria tem apenas um nome. Ela não tem status, categoria superior nem código próprio além do identificador interno. ## Quem pode fazer | Ação | Permissão | | - | - | | Ver as categorias | Qualquer pessoa da clínica odontológica. | | Criar uma categoria | `catalog.manage` (Proprietários e Administradores a têm pela função; um Membro precisa de **Gerenciar catálogo**). | Veja [Funções e permissões](/docs/pt/account/roles-and-permissions). ## Onde Em **Catálogo**, clique no link **Categorias**, ao lado da caixa de busca. A tela **Categorias** (`/catalog/categories`) diz **Agrupe os insumos do catálogo da sua clínica odontológica.** e tem **Voltar ao catálogo** no topo. A tela lista todas as categorias em uma única coluna, **Nome da categoria**, na ordem em que foram criadas. Quando não há nenhuma, mostra **Ainda não há categorias** e **Adicione uma categoria para começar a organizar os insumos.** ## Criar uma categoria Em **Categorias**, clique em **Nova categoria**, no cabeçalho. O botão só aparece se você tem `catalog.manage`. Digite o **Nome da categoria**: obrigatório, com até 120 caracteres e não só espaços. Clique em **Salvar categoria**. O diálogo fecha e a categoria aparece no fim da lista. **Cancelar** fecha o diálogo sem salvar. Você também pode criar uma categoria enquanto cria ou edita um insumo: clique em **Nova categoria**, abaixo do campo **Categoria**. O mesmo diálogo abre e, ao salvar, a nova categoria fica selecionada no formulário do insumo. Os nomes de categoria não precisam ser únicos. O muveya não impede a criação de duas categorias com o mesmo nome, então confira a lista antes. ## Renomear, desativar ou excluir A versão atual não permite renomear, desativar nem excluir uma categoria, nem no console nem pela API. * **Para deixar de usar uma categoria**, abra cada insumo que pertence a ela, escolha outra **Categoria** e clique em **Salvar alterações**. A categoria antiga continua na lista e nos filtros. * **Para corrigir um nome escrito errado**, crie uma categoria com o nome certo e mova os insumos para ela da mesma forma. * Se você precisar renomear ou remover uma categoria, escreva para [team@muveya.com](mailto:team@muveya.com). ## Identificadores de categoria Cada categoria tem um `categoryId` interno. O console mostra nomes em todo lugar, exceto na tela de importação CSV, onde a tabela **IDs de categorias para seu CSV** mostra cada **Nome da categoria** ao lado do seu `categoryId` com um botão **Copiar ID da categoria** (**ID da categoria copiado** confirma). Os arquivos CSV identificam as categorias por esse identificador, não pelo nome. Veja [Importar e exportar](/docs/pt/catalog/import-export). A API pública lista as categorias com `GET /v1/catalog/categories` (escopo `catalog:read`). Cada insumo lido pela API traz o seu `categoryId`. ## Para que as categorias são usadas | Onde | Como | | - | - | | Lista do catálogo | O filtro **Categoria** mostra só os insumos de uma categoria, e a coluna **Categoria** indica a categoria de cada insumo. | | Formulário do insumo | **Categoria** é um campo obrigatório em todo insumo. | | Importação CSV | Cada linha precisa trazer o `categoryId` de uma categoria da sua clínica odontológica. | | Pedidos | Quando um insumo é adicionado a um pedido, a linha guarda uma cópia da categoria do insumo. Mudar o insumo de categoria depois não altera as linhas já adicionadas. | | Políticas de aprovação | O modelo da política de aprovação pode acionar uma regra quando alguma linha do pedido pertence a um conjunto de categorias. O editor da política no console não oferece uma condição por categoria na versão atual; uma regra que já tenha essa condição a mantém quando você edita e publica a política. O editor oferece **Só pedidos com insumos de alto valor**, que depende da opção **Insumo de alto valor** de cada insumo. Veja [Política de aprovação](/docs/pt/orders/approval-policy). | | Relatórios | O relatório **Consumo por insumo** agrupa por insumo, não por categoria. Na versão atual não existe relatório por categoria. Veja [Relatório de consumo](/docs/pt/reports/consumption). | ## O que o sistema registra A categoria e o nome, somente na sua clínica odontológica. A criação de uma categoria não é gravada como uma entrada de auditoria separada. ## O que pode dar errado | Mensagem | Causa | O que fazer | | - | - | - | | **Preencha este campo.** | O nome está vazio ou só tem espaços. | Digite um nome. | | **Use no máximo 120 caracteres.** | O nome é longo demais. | Encurte-o. | | **Sua conta não tem permissão para esta ação.** | Você não tem `catalog.manage`. | Peça ajuda a um administrador da clínica odontológica. | | **Esta categoria não está mais disponível. Escolha outra.** | Aparece no formulário do insumo: a categoria escolhida não existe nesta clínica odontológica. | Escolha outra categoria. | | **Categoria indisponível** | Aparece na lista do catálogo: a categoria do insumo não foi encontrada. | Abra o insumo e escolha uma categoria. | ## Páginas relacionadas Crie insumos e defina a categoria deles. Use identificadores de categoria em um arquivo CSV. Decida quais pedidos precisam de aprovação. Conceda **Gerenciar catálogo**. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.