Skip to main content
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 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>).
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.

Quién puede hacer qué

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. 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: 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. El selector Mostrar filtra la lista: 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 y Bodegas.
  • Los insumos deben estar activos en el catálogo, con su unidad fijada. Consulta Insumos.
  • 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.

Paso 1: el encabezado del pedido

1

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.”
2

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

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

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).
5

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).
6

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

Crea el pedido

Selecciona Crear pedido. La consola abre el nuevo pedido en Borrador, listo para sus insumos.
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

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.

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

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”.
2

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

Ingresa la cantidad y agrégalo

Escribe un número entero mayor que cero en Cantidad y selecciona Agregar insumo.
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.

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.
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.
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. Todo lo que ocurre desde allocated se explica en Resumen de entregas.

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

Siguiente paso

El panel Siguiente paso te dice qué pasa ahora: 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.

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

Abre el pedido

Ábrelo desde Pedidos.
2

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.”
3

Confirma

Selecciona Sí, cancelarlo, o Mantener el pedido para volver.
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.

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

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.
  • La herramienta MCP orders.get lee un pedido, y el recurso muveya://orders/status-model describe este ciclo de vida. Consulta Herramientas MCP y Recursos MCP.

Páginas relacionadas

Aprobación de pedidos

Decide los pedidos que esperan tu aprobación.

Política de aprobación

Qué pedidos necesitan aprobación y de quién.

Resumen de entregas

Qué pasa después de aprobar un pedido.

Costos

De dónde sale el valor del pedido.

Roles y permisos

Asigna permisos de pedidos y acceso a sedes.

Conceptos

Clínica dental, sedes, bodegas y pedidos.