> ## 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.

# Categorías

> Crea las categorías que agrupan tus insumos y conoce para qué sirven y qué todavía no permiten.

Una categoría agrupa insumos en el catálogo de tu clínica dental, por ejemplo "Guantes y protección de barrera" o "Anestesia". Cada insumo pertenece exactamente a una categoría, así que necesitas al menos una categoría antes de crear un insumo.

Una categoría solo tiene nombre. No tiene estado, categoría superior ni código propio aparte de su identificador interno.

## Quién puede hacerlo

| Acción | Permiso |
| - | - |
| Ver las categorías | Cualquier persona de la clínica dental. |
| Crear una categoría | `catalog.manage` (propietarios y administradores lo tienen por su rol; un miembro necesita **Gestionar catálogo**). |

Consulta [Roles y permisos](/docs/es/account/roles-and-permissions).

## Dónde

En **Catálogo**, haz clic en el enlace **Categorías**, junto al buscador. La pantalla **Categorías** (`/catalog/categories`) dice **Agrupa los insumos del catálogo de tu clínica dental.** y tiene **Volver al catálogo** arriba.

La pantalla lista todas las categorías en una sola columna, **Nombre de la categoría**, en el orden en que se crearon. Si no hay ninguna, muestra **Todavía no hay categorías** y **Agrega una categoría para empezar a organizar los insumos.**

## Crear una categoría

<Steps>
  <Step title="Abre el diálogo">
    En **Categorías**, haz clic en **Nueva categoría**, en el encabezado. El botón solo aparece si tienes `catalog.manage`.
  </Step>

  <Step title="Ponle nombre">
    Escribe el **Nombre de la categoría**: obligatorio, de hasta 120 caracteres y no solo espacios.
  </Step>

  <Step title="Guarda">
    Haz clic en **Guardar categoría**. El diálogo se cierra y la categoría aparece al final de la lista. **Cancelar** cierra el diálogo sin guardar.
  </Step>
</Steps>

También puedes crear una categoría mientras creas o editas un insumo: haz clic en **Nueva categoría**, bajo el campo **Categoría**. Se abre el mismo diálogo y, al guardar, la nueva categoría queda seleccionada en el formulario del insumo.

<Note>
  Los nombres de categoría no tienen que ser únicos. muveya no impide crear dos categorías con el mismo nombre, así que revisa la lista antes.
</Note>

## Renombrar, desactivar o eliminar

La versión actual no permite renombrar, desactivar ni eliminar una categoría, ni en la consola ni mediante la API.

* **Para dejar de usar una categoría**, abre cada insumo que pertenece a ella, elige otra **Categoría** y haz clic en **Guardar cambios**. La categoría anterior sigue en la lista y en los filtros.
* **Para corregir un nombre mal escrito**, crea una categoría con el nombre correcto y mueve los insumos a ella de la misma forma.
* Si necesitas renombrar o quitar una categoría, escribe a [team@muveya.com](mailto:team@muveya.com).

## Identificadores de categoría

Cada categoría tiene un `categoryId` interno. La consola muestra nombres en todas partes excepto en la pantalla de importación CSV, donde la tabla **ID de categorías para tu CSV** muestra cada **Nombre de la categoría** junto a su `categoryId` con un botón **Copiar ID de categoría** (**ID de categoría copiado** lo confirma). Los archivos CSV identifican las categorías por ese identificador, no por el nombre. Consulta [Importar y exportar](/docs/es/catalog/import-export).

La API pública lista las categorías con `GET /v1/catalog/categories` (scope `catalog:read`). Cada insumo que lee la API trae su `categoryId`.

## Para qué se usan las categorías

| Dónde | Cómo |
| - | - |
| Lista del catálogo | El filtro **Categoría** muestra solo los insumos de una categoría, y la columna **Categoría** indica la categoría de cada insumo. |
| Formulario del insumo | **Categoría** es un campo obligatorio en todo insumo. |
| Importación CSV | Cada fila debe traer el `categoryId` de una categoría de tu clínica dental. |
| Pedidos | Cuando se agrega un insumo a un pedido, la línea guarda una copia de la categoría del insumo. Cambiar el insumo de categoría después no modifica las líneas ya agregadas. |
| Políticas de aprobación | El modelo de la política de aprobación puede activar una regla cuando alguna línea del pedido pertenece a un conjunto de categorías. El editor de la política en la consola no ofrece una condición por categoría en la versión actual; una regla que ya la tenga la conserva al editar y publicar la política. El editor sí ofrece **Solo pedidos con insumos de alto valor**, que depende de la opción **Insumo de alto valor** de cada insumo. Consulta [Política de aprobación](/docs/es/orders/approval-policy). |
| Reportes | El reporte **Consumo por insumo** agrupa por insumo, no por categoría. En la versión actual no existe un reporte por categoría. Consulta [Reporte de consumo](/docs/es/reports/consumption). |

## Qué registra el sistema

La categoría y su nombre, solo en tu clínica dental. La creación de una categoría no genera un registro de auditoría separado.

## Qué puede salir mal

| Mensaje | Causa | Qué hacer |
| - | - | - |
| **Completa este campo.** | El nombre está vacío o solo tiene espacios. | Escribe un nombre. |
| **Usa un máximo de 120 caracteres.** | El nombre es demasiado largo. | Acórtalo. |
| **Tu cuenta no tiene permiso para esta acción.** | No tienes `catalog.manage`. | Pide ayuda a un administrador de la clínica dental. |
| **Esta categoría ya no está disponible. Elige otra.** | Aparece en el formulario del insumo: la categoría elegida no existe en esta clínica dental. | Elige otra categoría. |
| **Categoría no disponible** | Aparece en la lista del catálogo: no se encontró la categoría del insumo. | Abre el insumo y elige una categoría. |

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Insumos del catálogo" icon="box" href="/docs/es/catalog/items">
    Crea insumos y asígnales su categoría.
  </Card>

  <Card title="Importar y exportar" icon="file-csv" href="/docs/es/catalog/import-export">
    Usa identificadores de categoría en un archivo CSV.
  </Card>

  <Card title="Política de aprobación" icon="list-check" href="/docs/es/orders/approval-policy">
    Decide qué pedidos requieren aprobación.
  </Card>

  <Card title="Roles y permisos" icon="user-shield" href="/docs/es/account/roles-and-permissions">
    Otorga **Gestionar catálogo**.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.