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

# Crear y seguir pedidos

> Solicita insumos para una de tus sedes, envía el pedido y síguelo desde el borrador hasta el cierre.

Un pedido solicita insumos para que se entreguen en una bodega de una de tus sedes. Empieza como **borrador** y solo tú, quien lo solicita, puedes editarlo. Cuando lo envías, la [política de aprobación](/docs/es/orders/approval-policy) decide si alguien tiene que aprobarlo; después, el equipo de entregas reserva las existencias, lo prepara, lo despacha y la sede lo recibe.

Esta página cubre las pantallas de **Pedidos**: la lista (`console.muveya.com/orders`), **Nuevo pedido** (`/orders/new`) y el detalle del pedido (`/orders/<orderId>`).

<Note>
  En las pantallas de pedidos, la sede aparece como **Clínica** (columna, campo y dato). Es lo mismo que la navegación principal llama **Sedes**. Consulta [Conceptos](/docs/es/concepts).
</Note>

## Quién puede hacer qué

| Lo que quieres hacer | Permiso que necesitas (etiqueta en **Equipo**) |
| - | - |
| Ver **Pedidos** en la navegación principal | Cualquiera de `orders.create`, `orders.read.all`, `approvals.decide`, `fulfillment.pick`, `fulfillment.dispatch`, `delivery.confirm`, `receipt.confirm`, `fulfillment.close`, `fulfillment.read` |
| Crear un pedido general, agregar y cambiar sus insumos, enviarlo, cancelarlo | `orders.create` (**Crear pedidos de insumos**) |
| Crear un pedido clínico con referencia de paciente | `orders.create` **y** `orders.clinical.create` (**Crear pedidos clínicos**) |
| Ver todos los pedidos de tus sedes, no solo los tuyos | `orders.read.all` (**Ver todos los pedidos**), o `approvals.decide`, o cualquier permiso de entregas |
| Ver el **Valor del pedido** | `orders.value.read` (**Ver valores de pedidos**) |
| Ver la **Referencia del paciente** de un pedido clínico | `orders.patient_ref.read` (**Ver referencias externas de pacientes**) |

Ninguno de estos permisos viene con un rol: un **Propietario** o un **Administrador** también necesita que se los asignen de forma explícita. Además, se aplica el acceso a sedes: solo puedes pedir para una sede asignada a ti, entregar en una bodega asignada a ti y ver pedidos de tus sedes asignadas. Consulta [Roles y permisos](/docs/es/account/roles-and-permissions).

Solo la persona que creó un pedido puede editarlo, enviarlo o cancelarlo. Nadie más puede hacerlo, sin importar sus permisos.

## Qué pedidos ves

El servidor decide qué pedidos aparecen en tu lista y cuáles puedes abrir:

| Tus permisos | Pedidos que ves |
| - | - |
| `orders.read.all`, `approvals.decide` o cualquier permiso de entregas | Todos los pedidos cuya sede está asignada a ti |
| Solo `orders.create` | Solo los pedidos que tú solicitaste, en sedes asignadas a ti |
| Ninguno de los anteriores | Ninguno: la lista se rechaza con **Tu cuenta no tiene permiso para esta acción.** |

Si abres un pedido que no puedes ver, la consola responde exactamente como si no existiera: **Este pedido no existe o no puedes verlo.**

## La lista de pedidos

Abre **Pedidos** en la navegación principal. La pantalla se titula **Pedidos** y muestra los pedidos del más nuevo al más antiguo, de 25 en 25; **Cargar más pedidos** trae la página siguiente.

| Columna | Qué muestra |
| - | - |
| **Pedido** | El número del pedido, por ejemplo `#42`. Abre el detalle. Los números son correlativos dentro de tu clínica dental. |
| **Estado** | El estado actual (consulta [Estados del pedido](#estados-del-pedido)). |
| **Tipo** | **General** o **Clínico**. |
| **Clínica** | La sede para la que es el pedido. |
| **Entregar en** | La bodega de destino. |
| **Solicitado por** | Quien lo solicitó, por su nombre, o **Tú** para tus propios pedidos. |
| **Creado** | Fecha y hora de creación. |

El selector **Mostrar** filtra la lista:

| Opción | Estados incluidos |
| - | - |
| **Todos los pedidos** | Todos |
| **Borradores** | `draft` |
| **Esperando aprobación** | `submitted`, `pending_approval`, `approved` |
| **Por preparar** | `allocated`, `picking` |
| **En camino** | `dispatched`, `delivered` |
| **Recibidos** | `received`, `partially_fulfilled`, `closed` |
| **Problemas de entrega** | `exception` |
| **Rechazados o cancelados** | `rejected`, `cancelled` |

Si la lista está vacía, ves **No hay pedidos aquí. Ves los pedidos que solicitaste, o los de tus clínicas si los apruebas, preparas o recibes.** Si no tienes ninguna sede asignada, ves **No tienes sedes asignadas. Pide a un administrador que te dé acceso.**

En **Inicio**, la sección **Trabajo pendiente** muestra la tarjeta **Borradores de pedidos** cuando tienes borradores sin enviar.

## Crear un pedido

### Antes de empezar

* La sede debe estar activa y tener al menos una bodega activa que le pertenezca. Consulta [Sedes](/docs/es/locations/clinics) y [Bodegas](/docs/es/locations/warehouses).
* Los insumos deben estar activos en el catálogo, con su unidad fijada. Consulta [Insumos](/docs/es/catalog/items).
* Si quieres que el pedido tenga valor (y usar reglas de aprobación por valor), los insumos necesitan un costo confirmado para su unidad actual. Consulta [Costos](/docs/es/catalog/costs).

### Paso 1: el encabezado del pedido

<Steps>
  <Step title="Abre Nuevo pedido">
    Ve a **Pedidos** y selecciona **Nuevo pedido**. El enlace solo aparece si tienes `orders.create`. La pantalla se titula **Nuevo pedido**: "Elige la clínica y dónde entregar. Después agregas los insumos."
  </Step>

  <Step title="Elige la Clínica">
    Selecciona la sede en **Clínica**. Solo se ofrecen sedes activas asignadas a ti. Si tienes exactamente una, aparece como texto y ya queda elegida.
  </Step>

  <Step title="Elige Entregar en la bodega">
    Selecciona el destino en **Entregar en la bodega**. La lista incluye las bodegas activas que pertenecen a la sede elegida y que están asignadas a ti. Mientras no elijas una sede, indica **Elige primero la clínica.** Si solo una bodega cumple, aparece como texto y ya queda elegida.
  </Step>

  <Step title="Si quieres, elige Tomar existencias de">
    **Tomar existencias de** viene con **Cualquier bodega central**. Puedes indicar, en su lugar, una bodega central activa como origen preferido. Pese a la etiqueta, a un pedido sin origen indicado se le pueden reservar existencias de cualquier caja utilizable en cualquier bodega de la clínica dental, incluidas las express; revisa **Tomar de** en la lista de preparación antes de ir a buscar las cajas (consulta [Preparar y despachar un pedido](/docs/es/deliveries/picking)).
  </Step>

  <Step title="Si quieres, escribe un Motivo">
    **Motivo (opcional)** es texto libre para quienes aprueban y para el equipo de entregas. No debe contener datos personales (consulta [El motivo y los datos personales](#el-motivo-y-los-datos-personales)).
  </Step>

  <Step title="Márcalo como clínico, si corresponde">
    Si tienes `orders.clinical.create`, ves la casilla **Es para el tratamiento de un paciente**. Márcala para crear un pedido clínico; aparece el campo **Referencia del paciente (opcional)** con la ayuda "Usa el código interno de tu clínica, nunca un nombre ni un número de documento."
  </Step>

  <Step title="Crea el pedido">
    Selecciona **Crear pedido**. La consola abre el nuevo pedido en **Borrador**, listo para sus insumos.
  </Step>
</Steps>

| Campo | Obligatorio | Reglas |
| - | - | - |
| **Clínica** | Sí | Debe ser una sede activa asignada a ti. Vacío: **Elige la clínica.** |
| **Entregar en la bodega** | Sí | Debe estar activa, pertenecer a la sede elegida y estar asignada a ti. Vacío: **Elige dónde entregar.** |
| **Tomar existencias de** | No | Una bodega central activa, o **Cualquier bodega central**. |
| **Motivo (opcional)** | No | Hasta 2000 caracteres. Se quitan los espacios al inicio y al final. Sin datos personales. |
| **Es para el tratamiento de un paciente** | No | Solo aparece con `orders.clinical.create`. Sin marcar, el pedido es general. |
| **Referencia del paciente (opcional)** | No | Solo pedidos clínicos. Hasta 200 caracteres. |

El encabezado no se puede cambiar después de crear el pedido: no hay forma de editar la sede, el destino, el origen, el motivo ni la referencia del paciente. Si alguno está mal, cancela el borrador y crea un pedido nuevo.

Si la sede elegida tiene bodegas pero ninguna está asignada a ti, ves **No tienes asignada ninguna bodega de esta clínica. Pide a un administrador que te dé acceso.** Si no tiene ninguna bodega activa, ves **Esta clínica todavía no tiene una bodega activa. Crea una en Bodegas primero.**

### Pedidos generales y clínicos

| | General (`general`) | Clínico (`clinical`) |
| - | - | - |
| Permisos | `orders.create` | `orders.create` y `orders.clinical.create` |
| Referencia del paciente | Nunca | Opcional |
| Política de aprobación | Las reglas lo alcanzan con **Pedidos generales** | Las reglas lo alcanzan con **Pedidos clínicos** |
| Todo lo demás | Mismos campos, mismo ciclo de vida | Mismos campos, mismo ciclo de vida |

<Warning>
  La referencia del paciente es un código opaco de tu propio sistema clínico, por ejemplo `ext-7f3a`. Nunca ingreses un nombre, un número de documento, un teléfono ni nada que identifique a una persona. muveya nunca busca a qué corresponde ese código. Se guarda cifrado y solo lo ven integrantes con `orders.patient_ref.read`, únicamente en el detalle del pedido: nunca aparece en la lista de pedidos, en las pantallas de aprobación ni en la API pública.
</Warning>

### El motivo y los datos personales

Un paciente se vincula a un pedido solo mediante la referencia del paciente. Para que no aparezcan identificadores en el texto libre, el servidor rechaza un **Motivo** que contenga cualquiera de estos elementos y muestra **El motivo parece incluir datos personales. Quita nombres, teléfonos o números de documento.**

* Una dirección de correo electrónico.
* Un número de tarjeta escrito como cuatro grupos de cuatro dígitos.
* Una de las palabras `rut`, `dni`, `mrn`, `nhs`, `ssn`, `cpf`, `paciente` o `patient` seguida inmediatamente de un valor que contiene un dígito (por ejemplo, "paciente 12").
* Nueve o más dígitos seguidos. Los puntos o guiones entre dígitos no cortan la secuencia, así que `12.345.678-9` cuenta como nueve dígitos. Las fechas y las horas no se ven afectadas.

Reescribe el motivo sin el identificador y vuelve a crear el pedido.

### Paso 2: agrega los insumos

Mientras el pedido es un borrador, tú (quien lo solicita) ves el formulario **Agregar un insumo** debajo de la tabla **Insumos**.

<Steps>
  <Step title="Elige el insumo">
    Selecciónalo en **Insumo**. La lista muestra los insumos activos con nombre y SKU, por ejemplo "Guantes de nitrilo M · GLV-NIT-M".
  </Step>

  <Step title="Revisa la unidad">
    La consola lee la unidad del insumo y muestra **Se cuenta en:** seguido de la unidad (por ejemplo **Caja**). La cantidad que ingreses está en esa unidad.
  </Step>

  <Step title="Ingresa la cantidad y agrégalo">
    Escribe un número entero mayor que cero en **Cantidad** y selecciona **Agregar insumo**.
  </Step>
</Steps>

Al agregar una línea, el pedido guarda una copia del nombre, el SKU, la unidad, la categoría y la marca de alto valor del insumo y, si lo tiene, el costo unitario vigente en ese momento. Los cambios posteriores en el catálogo no modifican la línea.

Para cambiar una cantidad, edítala en la columna **Cantidad** y selecciona **Guardar**. Para sacar un insumo, selecciona **Quitar**. Si agregas dos veces el mismo insumo, se crean dos líneas separadas; si solo necesitas más, cambia la línea existente.

| Mensaje | Por qué | Qué hacer |
| - | - | - |
| **Ingresa una cantidad entera mayor que cero.** | La cantidad está vacía, es cero, es negativa o tiene decimales. | Ingresa un número entero, 1 o más. |
| **La unidad de este insumo cambió en el catálogo. Elígelo de nuevo para ver la unidad actual.** | La unidad cambió después de que el formulario la leyó. | Elige otra vez el insumo y revisa **Se cuenta en:**. |
| **La unidad de este insumo todavía no se revisó en el catálogo.** | La unidad del insumo todavía no está fijada. | Pide a quien gestiona el catálogo que fije la unidad. Consulta [Insumos](/docs/es/catalog/items). |
| **Este insumo no está activo en el catálogo.** | El insumo se desactivó. | Elige otro insumo. |
| **El registro cambió o ya existe. Revísalo antes de volver a intentar.** | El insumo tiene un costo que no está confirmado para su unidad actual (`catalog.cost_unverified`). | Pide a quien gestiona el catálogo que confirme el costo. Consulta [Costos](/docs/es/catalog/costs). |
| **Ese insumo ya no está en el pedido.** | La línea ya se quitó, por ejemplo en otra pestaña. | Revisa el pedido actualizado. |

### Paso 3: envía el pedido

Selecciona **Enviar pedido**. El botón sigue deshabilitado hasta que el pedido tenga al menos un insumo.

Al enviarlo, el sistema:

1. Pasa el pedido de `draft` a `submitted` y registra la hora de envío.
2. Congela el valor del pedido a partir de los costos de las líneas.
3. Deja el pedido en cola para la política de aprobación. En pocos segundos el pedido pasa a **Esperando aprobación** (alguien debe decidir) o directo a **Aprobado** (la política no exige decisión). Mientras avanza, el pedido muestra **El pedido está pasando a su siguiente paso. Esta pantalla se actualiza sola en unos segundos.**

<Note>
  Si tu clínica dental nunca publicó una política de aprobación, un pedido enviado se queda en **Enviado**. Publicar la primera política no lo mueve por sí sola: los pedidos que ya esperaban se procesan la próxima vez que se envía cualquier pedido en tu clínica dental. Quienes gestionan la política ven en Inicio la tarjeta **Todavía no hay política de aprobación: los pedidos enviados esperan hasta que se publique una**. Consulta [Política de aprobación](/docs/es/orders/approval-policy).
</Note>

Después del envío ya no se pueden cambiar los insumos; si lo intentas, ves **Este pedido ya no se puede cambiar.**

## Estados del pedido

El ciclo de vida del pedido es una máquina de estados cerrada. Un estado solo cambia mediante una de las transiciones siguientes; cualquier otra se rechaza.

| Estado | Etiqueta | Significado | Qué lo hace avanzar |
| - | - | - | - |
| `draft` | **Borrador** | Quien lo solicita lo está preparando. | Quien lo solicita lo envía o lo cancela. |
| `submitted` | **Enviado** | Enviado; espera que se aplique la política de aprobación. | El sistema: a `pending_approval` si la política exige una decisión, a `approved` si no la exige. Quien lo solicita puede cancelarlo. |
| `pending_approval` | **Esperando aprobación** | Espera las decisiones que exige su plan de aprobación. | Personas con `approvals.decide`: a `approved` cuando se aprueban todas las etapas, a `rejected` cuando se rechaza cualquier etapa. Quien lo solicita puede cancelarlo. Consulta [Aprobación de pedidos](/docs/es/orders/approvals). |
| `approved` | **Aprobado** | Aprobado por personas o por la política. Ya no se puede cancelar. | El sistema reserva existencias y lo pasa a `allocated`. Si faltan existencias, sigue en **Aprobado** hasta que la reserva sea posible. |
| `rejected` | **Rechazado** | Alguien lo rechazó. Es definitivo. | Nada. Crea un pedido nuevo si todavía necesitas los insumos. |
| `cancelled` | **Cancelado** | Quien lo solicitó lo canceló. Es definitivo. | Nada. |
| `allocated` | **Existencias reservadas** | Hay existencias reservadas en la bodega de origen. | El primer escaneo válido de una caja (`fulfillment.pick`) lo pasa a `picking`. |
| `picking` | **En preparación** | Se están preparando las cajas. | El despacho (`fulfillment.dispatch`) lo pasa a `dispatched`. |
| `dispatched` | **Despachado** | Las cajas salieron de la bodega de origen. | La confirmación de entrega (`delivery.confirm`): a `delivered`, o a `exception` si se informa un problema. |
| `delivered` | **Entregado** | Entregado en el destino. | La confirmación de recepción (`receipt.confirm`): a `received`, o a `partially_fulfilled` si se disputa la recepción. |
| `exception` | **Problema de entrega** | Se informó un problema en la entrega. | Ninguna acción de la consola lo hace avanzar. El pedido muestra "Se informó un problema de entrega. Su resolución está pendiente con el dueño de la clínica." |
| `received` | **Recibido** | Recibido completo. | El cierre (`fulfillment.close`) lo pasa a `closed`. |
| `partially_fulfilled` | **Recibido en parte** | Recibido con una disputa (dañado, faltante o parcial). | El cierre (`fulfillment.close`) lo pasa a `closed`. |
| `closed` | **Cerrado** | Cerrado administrativamente. Es definitivo. | Nada. |

```mermaid theme={null}
stateDiagram-v2
  [*] --> draft : crear
  draft --> submitted : enviar
  draft --> cancelled : cancelar
  submitted --> pending_approval : requiere aprobación
  submitted --> approved : no requiere aprobación
  submitted --> cancelled : cancelar
  pending_approval --> approved : todas las etapas aprobadas
  pending_approval --> rejected : una etapa rechazada
  pending_approval --> cancelled : cancelar
  approved --> allocated : existencias reservadas
  allocated --> picking : primera caja escaneada
  picking --> dispatched : despachar
  dispatched --> delivered : entrega confirmada
  dispatched --> exception : entrega con problema
  delivered --> received : recepción confirmada
  delivered --> partially_fulfilled : recepción disputada
  received --> closed : cerrar
  partially_fulfilled --> closed : cerrar
  rejected --> [*]
  cancelled --> [*]
  closed --> [*]
```

Todo lo que ocurre desde `allocated` se explica en [Resumen de entregas](/docs/es/deliveries/overview).

## El detalle del pedido

Abre un pedido desde la lista. El encabezado muestra **Pedido #** con el número, el estado a su lado y **Volver a pedidos**.

### Datos

| Dato | Cuándo aparece |
| - | - |
| **Tipo** | Siempre. |
| **Clínica** | Siempre. |
| **Entregar en** | Siempre. |
| **Tomar existencias de** | Siempre; **Cualquier bodega central** si no se eligió origen. |
| **Solicitado por** | Siempre. |
| **Motivo** | Si el pedido tiene uno. |
| **Referencia del paciente** | Pedidos clínicos con referencia, y solo si tienes `orders.patient_ref.read`. |
| **Valor del pedido** | Si tienes `orders.value.read` y al menos una línea tiene costo. |

### Siguiente paso

El panel **Siguiente paso** te dice qué pasa ahora:

| Estado | Qué dice u ofrece el panel |
| - | - |
| **Borrador** | A quien lo solicita: "Agrega los insumos y envía el pedido cuando esté completo." A las demás personas: el nombre de quien lo solicita y "todavía está preparando este pedido." |
| **Enviado**, **Aprobado** | "El pedido está pasando a su siguiente paso. Esta pantalla se actualiza sola en unos segundos." La pantalla se actualiza cada pocos segundos mientras el pedido está en uno de estos estados. |
| **Esperando aprobación** | "Esperando aprobación." y, por cada etapa del plan, su nombre y la cantidad de aprobaciones que necesita. A quien lo solicita: "Tú solicitaste este pedido, así que otra persona tiene que aprobarlo." A quien tiene `approvals.decide`: el enlace **Revisar y decidir**. |
| **Rechazado** | "Este pedido fue rechazado. Crea uno nuevo si todavía necesitas los insumos." |
| **Cancelado** | "Este pedido fue cancelado." |
| De **Existencias reservadas** a **Entregado** | "El pedido se está preparando y entregando." |
| **Recibido**, **Recibido en parte**, **Cerrado** | "El pedido fue recibido." |
| **Problema de entrega** | "Se informó un problema de entrega. Su resolución está pendiente con el dueño de la clínica." |

Desde **Existencias reservadas** en adelante, quienes tienen algún permiso de entregas también ven **Seguir la entrega**, que abre la pantalla de la entrega. Consulta [Resumen de entregas](/docs/es/deliveries/overview).

### Insumos

La tabla **Insumos** muestra cada línea con **Insumo** (nombre y SKU) y **Cantidad** (cantidad y unidad, por ejemplo "10 × Caja"). Si el pedido no tiene líneas, ves **Todavía no hay insumos. Agrega al menos uno para enviar el pedido.** Mientras el pedido es tu borrador, una columna **Cambiar** contiene **Guardar** y **Quitar**.

## Cancelar un pedido

**Quién:** solo quien lo solicitó, con `orders.create`.
**Cuándo:** mientras el pedido está en **Borrador**, **Enviado** o **Esperando aprobación**.

<Steps>
  <Step title="Abre el pedido">
    Ábrelo desde **Pedidos**.
  </Step>

  <Step title="Selecciona Cancelar pedido">
    El diálogo **¿Cancelar el pedido #1042?** (con el número del pedido) explica: "El pedido se detiene aquí y nadie lo va a preparar. No se puede deshacer."
  </Step>

  <Step title="Confirma">
    Selecciona **Sí, cancelarlo**, o **Mantener el pedido** para volver.
  </Step>
</Steps>

**Qué registra el sistema:** el pedido pasa a `cancelled`, un estado definitivo. No se reserva ni se prepara nada. Si estaba esperando aprobación, sale de la bandeja de quienes aprueban; las decisiones ya registradas quedan en su historial.

Una vez que un pedido está **Aprobado**, ya no se puede cancelar desde la consola, y ninguna otra persona (ni siquiera un **Propietario** o un **Administrador**) puede cancelar el pedido de otra. Si hay que detener un pedido aprobado, escribe a [team@muveya.com](mailto:team@muveya.com).

## Valor y datos ocultos

* El **Valor del pedido** es la suma, en las líneas que tienen costo, de la cantidad por el costo unitario copiado al agregar la línea. Se guarda en unidades menores (centavos, o pesos enteros en una moneda sin decimales) y se muestra con el formato de la moneda del pedido. Las líneas sin costo no suman; si ninguna línea tiene costo, el pedido no tiene valor. El valor se congela al enviar el pedido.
* El valor solo lo ven quienes tienen `orders.value.read`. Sin ese permiso, el dato **Valor del pedido** (y la columna de valor de la bandeja de aprobaciones) simplemente no aparece. Los costos de cada línea dependen de `catalog.cost.read`; esta pantalla no los muestra.
* La **Referencia del paciente** solo se muestra con `orders.patient_ref.read`, y solo en el detalle del pedido.
* El servidor quita los datos ocultos antes de que lleguen a tu navegador, así que no aparecen en absoluto, en lugar de aparecer vacíos.

## Qué puede salir mal

| Mensaje | Código | Por qué | Qué hacer |
| - | - | - | - |
| **No puedes crear pedidos. Pide al administrador de tu clínica el permiso para solicitar insumos.** | | No tienes `orders.create`. | Pide a quien gestiona el equipo **Crear pedidos de insumos**. |
| **No tienes sedes asignadas para crear pedidos. Pide a un administrador que te dé acceso.** | | Tu acceso a sedes está vacío. | Pide acceso a una sede. |
| **Esa clínica no está activa.** | `orders.clinic_unavailable` | La sede está inactiva, no existe o no está asignada a ti. | Elige otra sede o pide acceso. |
| **Esa bodega no está activa.** | `orders.warehouse_unavailable` | El destino está inactivo, pertenece a otra sede o no está asignado a ti, o la bodega de origen elegida está inactiva. | Elige otra bodega o pide acceso. |
| **El motivo parece incluir datos personales. Quita nombres, teléfonos o números de documento.** | `orders.justification_rejected` | El motivo coincidió con un patrón de datos personales. | Quita el identificador. |
| **No puedes agregar una referencia de paciente.** | `orders.patient_ref_forbidden` | Intentaste crear un pedido clínico sin `orders.clinical.create`. | Crea un pedido general, o pide **Crear pedidos clínicos**. |
| **Este insumo no está activo en el catálogo.** | `orders.catalog_item_unavailable` | El insumo está inactivo o no existe. | Elige otro insumo. |
| **La unidad de este insumo cambió en el catálogo. Elígelo de nuevo para ver la unidad actual.** | `catalog.measurement_conflict` | La unidad cambió después de que elegiste el insumo. | Vuelve a elegirlo. |
| **La unidad de este insumo todavía no se revisó en el catálogo.** | `catalog.measurement_unverified` | La unidad no está fijada. | Consulta a quien gestiona el catálogo. |
| **Este pedido ya no se puede cambiar.** | `orders.not_editable` | El pedido ya no es un borrador. | No hay nada que cambiar; sigue su estado. |
| **Ese insumo ya no está en el pedido.** | `orders.line_not_found` | La línea se quitó mientras tanto. | Revisa el pedido. |
| **Alguien cambió este pedido hace un momento. La pantalla ya muestra la versión más reciente; revísala y vuelve a intentar.** | `orders.version_conflict` | El pedido cambió desde que se cargó tu pantalla (por ejemplo, se envió o se canceló en otra pestaña). | Revisa el pedido actualizado y repite la acción si todavía aplica. |
| **El pedido ya no está en un paso donde se pueda hacer esto.** | `orders.transition_not_allowed` | El estado no permite la acción (por ejemplo, cancelar un pedido aprobado). | Consulta [Estados del pedido](#estados-del-pedido). |
| **Este pedido no existe o no puedes verlo.** | `orders.not_found` | Enlace incorrecto, otra sede, o el pedido de otra persona sin permiso para verlo. | Revisa el enlace y tu acceso. |
| **Tu cuenta no tiene permiso para esta acción.** | `common.forbidden` | Falta un permiso. | Pide el permiso indicado en la sección **Quién puede hacer qué**. |

## Pedidos fuera de la consola

Los pedidos solo se crean en la consola. También hay acceso de solo lectura:

* La API pública lista y lee pedidos con `GET /v1/orders` y `GET /v1/orders/{orderId}` (scope `orders:read`). El valor del pedido y la referencia del paciente siempre se omiten para una clave de API. Consulta [Scopes](/docs/es/api-reference/scopes).
* La herramienta MCP `orders.get` lee un pedido, y el recurso `muveya://orders/status-model` describe este ciclo de vida. Consulta [Herramientas MCP](/docs/es/mcp/tools) y [Recursos MCP](/docs/es/mcp/resources).

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Aprobación de pedidos" icon="circle-check" href="/docs/es/orders/approvals">
    Decide los pedidos que esperan tu aprobación.
  </Card>

  <Card title="Política de aprobación" icon="scale-balanced" href="/docs/es/orders/approval-policy">
    Qué pedidos necesitan aprobación y de quién.
  </Card>

  <Card title="Resumen de entregas" icon="truck" href="/docs/es/deliveries/overview">
    Qué pasa después de aprobar un pedido.
  </Card>

  <Card title="Costos" icon="coins" href="/docs/es/catalog/costs">
    De dónde sale el valor del pedido.
  </Card>

  <Card title="Roles y permisos" icon="user-shield" href="/docs/es/account/roles-and-permissions">
    Asigna permisos de pedidos y acceso a sedes.
  </Card>

  <Card title="Conceptos" icon="book" href="/docs/es/concepts">
    Clínica dental, sedes, bodegas y pedidos.
  </Card>
</CardGroup>


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