Ingreso OAuth para MCP
- Las conexiones MCP ahora usan OAuth mediante Muveya Console. Si no has iniciado sesión, ingresa primero, elige tu clínica dental y revisa los permisos solicitados por la aplicación antes de autorizarla. Las claves de API siguen funcionando en
/v1, pero ya no autentican/mcp. Consulta Conectar un cliente.
Portal de documentación
La documentación de muveya ya está disponible
- muveya.com/docs abre en inglés, español y portugués.
- Las Guías recorren cada área de la consola, desde iniciar sesión hasta las entregas y los reportes.
- La Referencia de API explica la autenticación, los scopes, la paginación, los límites de uso y los errores, y genera una página por cada operación de
/v1a partir del contrato OpenAPI. - La sección MCP documenta el servidor MCP de solo lectura.
Retiro de lotes, diferencias de conteo y mediciones del piloto
Inventario y reportes
- Retiro de lotes. Encuentra todas las cajas de un lote en todas las bodegas y ponlas en cuarentena en un solo paso confirmado. La consola advierte que las cajas del lote que están en tránsito no quedan retenidas. Consulta Retiro de lote.
- Números de serie únicos. Un número de serie se puede recibir una sola vez por insumo, desde la consola o desde WhatsApp, y la pantalla de recepción indica los números de serie que ya se recibieron. Consulta Recibir existencias.
- Las diferencias de conteo se muestran por insumo y unidad, y por campaña de conteo. Consulta Conteos.
- Uso observado y consumo estimado. El reporte de consumo separa lo que se usó de lo que se entregó a boxes y áreas que no llevan su propio conteo.
GET /v1/analytics/consumption-trendy el resumen gerencial informan ambas cifras para cada insumo. Consulta Reporte de consumo. - Métricas nuevas en
GET /v1/analytics/metrics/{metric}:BOX_TRACEABILITY,APPROVAL_DECISION_MEDIAN_HOURSyDISTINCT_CUSTODY_ACTORS. Las dos últimas aceptan una ventanafromyto. Consulta Analítica de gestión. - Reposición indica el box al que pertenece cada punto de stock. Consulta Reposición y alertas.
Equipo y documentos legales
- Los miembros que gestionan el equipo pero solo llegan a algunas sedes pueden otorgar acceso a sedes y bodegas, invitar personas y reactivar o promover miembros solo dentro de su propio acceso a sedes y bodegas. Consulta Equipo.
- Los términos de servicio, la política de privacidad y el acuerdo de tratamiento de datos están publicados en muveya.com, y las pantallas de inicio de sesión de la consola enlazan los términos y la política de privacidad. Consulta Seguridad y privacidad.
Recibir cualquier insumo desde la web, etiquetas de cajas y presentaciones
Recepción y cajas
- Recibe cualquier insumo escaneando su código, buscando su nombre, como presentación o como unidades sueltas. Consulta Recibir existencias.
- Etiquetas de cajas. Imprime una etiqueta Code 128 para una caja recibida o separada. Consulta Cajas y etiquetas.
- Cada cantidad de existencias muestra su unidad, las cajas activas con el vencimiento cumplido quedan señaladas y las bodegas inactivas ya no se ofrecen para recibir ni para trasladar.
Catálogo, configuración y acceso
- Presentaciones y códigos comerciales se gestionan desde la página del insumo. Consulta Presentaciones y códigos.
- Inicio le indica a una clínica dental nueva qué le falta configurar antes de operar. Consulta Inicio rápido.
- Acceso explícito a sedes y bodegas. Cada miembro tiene acceso a todas, a algunas o a ninguna sede y bodega, y la consola explica qué significa no tener ninguna sede. Consulta Roles y permisos.
API
- Las etiquetas del resumen gerencial siguen
Accept-Language(en,es,pt) enGET /v1/analytics/briefingy en las exportaciones CSV. Consulta Exportaciones.
Pedidos, aprobaciones y entregas en la consola
Pedidos y entregas
- Pedidos. Pide insumos para una sede, completa y envía el pedido, y síguelo hasta el final. Consulta Crear y seguir pedidos.
- Aprobación de pedidos. Decide las aprobaciones pendientes y publica la política de aprobación. Consulta Aprobar o rechazar pedidos y Política de aprobación.
- Entregas. Prepara, despacha, entrega, recibe y cierra pedidos, y consulta su historial de custodia. Consulta Resumen de entregas.
- Inicio muestra a cada miembro el trabajo pendiente según los permisos que tiene.
Existencias
- Reposición. Define un mínimo por insumo y bodega, recibe una sola alerta cuando las existencias bajan de ese mínimo (se cierra cuando se recuperan) y haz conteos breves. Consulta Reposición y alertas.
- Segunda aprobación para correcciones grandes. Una corrección grande de existencias o una diferencia de conteo grande espera a una segunda persona en Correcciones de existencias. Consulta Correcciones.
- Boxes y áreas. Declara boxes de atención y áreas por sede, registra el uso o la entrega a un box con el profesional responsable, consulta el uso por box o área y atribuye salidas anteriores. Consulta Boxes y áreas y Registrar consumo y trasladar cajas.
- Separa una cantidad en una caja nueva que conserva su origen, también al preparar un pedido. Consulta Cajas y etiquetas.
- Permisos del día a día para que un miembro reciba, use o traslade existencias sin el permiso para corregirlas, y las cajas se pueden trasladar entre bodegas. Consulta Roles y permisos.
Reportes
- El reporte de consumo en Reportes muestra el consumo por insumo en su propia unidad. Consulta Reporte de consumo.
Inventario en la consola y contexto del costo del catálogo
Inventario
- Pantallas de inventario para recibir existencias, registrar uso, corregir existencias, cerrar una caja y hacer conteos. Consulta Resumen del inventario.
- Recepción por presentación: tres cajas de 100 unidades quedan registradas como exactamente 300 unidades. Las entregas también se pueden recibir escaneando el código del proveedor. Consulta Presentaciones y códigos.
- El lote, los números de serie y la fecha de vencimiento se piden solo cuando el insumo los controla.
Cuenta
- La verificación en dos pasos con una app autenticadora se puede configurar en Seguridad de la cuenta y es opcional. Consulta Seguridad de la cuenta.
Contexto del costo del catálogo
- Las lecturas de insumos agregan
costStatusy, cuando se conoce,costMeasurementjunto al importe registrado. Se aplica a las lecturas de catálogo de/v1, a la herramienta MCPcatalog.searchy a las exportaciones CSV autorizadas. Las rutas y los scopes no cambian, y una clave de API sigue sin poder escribir costos. - Revisa el estado antes de usar un importe:
review_requiredeinvalidno son costos que puedas aplicar a la unidad actual. - Sin permiso para ver costos (
catalog.cost:readpara una clave de API,catalog.cost.readpara un miembro), se omiten todos los campos de costo y las seis columnas de costo de la exportación CSV (cost,currency,costStatus,costUnitOfMeasure,costMeasurementVersion,costQuantityProtocol). - La importación CSV rechaza las filas cuyo costo está marcado como
review_requiredoinvalid, las filas con valores de costo y unidad contradictorios y los archivos que repiten una columna de costo o de unidad. - Consulta Costos y Scopes.
Invitaciones al equipo
- Invita personas a tu clínica dental por correo electrónico. Aceptan con una contraseña o con Google.
- Suspende, reactiva o retira miembros desde Equipo. Consulta Equipo.
Sedes, bodegas, catálogo y equipo en la consola
- Sedes y Bodegas: crea y administra las sedes de tu clínica dental y sus bodegas centrales y express. Consulta Sedes y Bodegas.
- Catálogo: categorías, insumos, costos, e importación y exportación CSV. Consulta Insumos del catálogo e Importar y exportar.
- Equipo: el directorio de miembros de tu clínica dental. Consulta Equipo.
Acceso a la consola
- Inicia sesión en console.muveya.com con tu correo y contraseña o con Google, y elige la clínica dental en la que trabajas. Consulta Iniciar sesión.
Servidor MCP por HTTP
POST https://api.muveya.com/mcpabre el servidor MCP de solo lectura a los asistentes de IA, autenticado con una clave de API. Consulta Servidor MCP y Conectar un cliente.- Herramientas de solo lectura para sedes, catálogo, existencias, pedidos y analítica, más recursos de referencia para códigos de error, estados de pedidos y políticas del catálogo. Consulta Herramientas MCP y Recursos MCP.
Analítica gerencial en la API
/v1/analyticsdevuelve métricas operativas, excepciones, una comparación de sedes, tendencias de consumo, las aprobaciones pendientes, los tiempos de ciclo de los pedidos y el resumen gerencial diario o semanal. Consulta Analítica de gestión.POST /v1/analytics/exportsgenera en segundo plano un CSV del resumen gerencial sin datos sensibles. Consulta Exportaciones.
Recursos de la API de solo lectura
- Lee sedes, bodegas, el catálogo, saldos y cajas de inventario, pedidos y registros de entrega (
fulfillments) en/v1. Consulta API para desarrolladores. - Paginación con cursor para pedidos, registros de entrega y saldos. Consulta Paginación.
- Un presupuesto de solicitudes por clave de API, informado en los encabezados de respuesta. Consulta Límites de uso.
- El contrato OpenAPI público de
/v1.
Claves de API
- Claves de API con formato
mvy_test_, cada una asociada a una clínica dental. GET /v1/meidentifica una clave y lista sus scopes. Consulta Autenticación.
Operaciones por WhatsApp
- Los miembros vinculados pueden consultar existencias, registrar uso y recibir existencias desde WhatsApp, con un paso de confirmación antes de cualquier cambio de existencias. Consulta Canal de WhatsApp y Operaciones por WhatsApp.