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
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,pacienteopatientseguida 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-9cuenta como nueve dígitos. Las fechas y las horas no se ven afectadas.
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.
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:- Pasa el pedido de
draftasubmittedy registra la hora de envío. - Congela el valor del pedido a partir de los costos de las líneas.
- 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.
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ó, conorders.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.
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 decatalog.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/ordersyGET /v1/orders/{orderId}(scopeorders:read). El valor del pedido y la referencia del paciente siempre se omiten para una clave de API. Consulta Scopes. - La herramienta MCP
orders.getlee un pedido, y el recursomuveya://orders/status-modeldescribe 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.