Skip to main content

03. Glosario de Términos del Dominio: MDX-Cloud

Este glosario define los términos técnicos, regulatorios y del negocio utilizados en toda la documentación de MDX-Cloud. Su propósito es eliminar ambigüedades y garantizar que cualquier nuevo integrante del equipo (desarrollador, QA, cliente) comparta el mismo lenguaje.

A — Regulatorio y Fiscal​

CFDI (Comprobante Fiscal Digital por Internet)​

Documento electrónico que ampara operaciones comerciales ante el SAT. En MDX-Cloud se genera bajo el estándar CFDI 4.0. Todo CFDI tiene un UUID único (folio fiscal) generado por el PAC y es inmutable una vez timbrado.

COFEPRIS (Comisión Federal para la Protección contra Riesgos Sanitarios)​

Autoridad sanitaria mexicana que regula la distribución de medicamentos. MDX-Cloud cumple sus lineamientos mediante trazabilidad de lotes, control de caducidades (FEFO) y gestión de recalls/retiros sanitarios.

PAC (Proveedor Autorizado de Certificación)​

Empresa autorizada por el SAT para timbrar CFDIs. Es el intermediario entre el sistema y el SAT. MDX-Cloud se conecta al PAC mediante su API para sellar y validar los comprobantes fiscales.

SAT (Servicio de Administración Tributaria)​

Autoridad fiscal del gobierno mexicano. Es el ente regulador al que reporta el PAC y ante quien se registran y cancelan los CFDIs.

Timbrado​

Proceso por el cual el PAC recibe el XML del CFDI generado por MDX-Cloud, lo valida, le asigna el folio fiscal UUID y lo sella criptográficamente. Una vez timbrado, el documento tiene validez fiscal.

RFC (Registro Federal de Contribuyentes)​

Clave fiscal única asignada por el SAT a personas físicas y morales. Es dato obligatorio en toda factura CFDI 4.0 tanto para el emisor como para el receptor.

Régimen Fiscal​

Clasificación fiscal bajo la que opera un contribuyente ante el SAT (ej. Persona Moral, Régimen Simplificado de Confianza). Campo obligatorio en el CFDI 4.0.

B — Inventario y Almacén (WMS)​

FEFO (First Expired, First Out)​

Algoritmo de rotación de inventario que ordena la salida de mercancía priorizando los lotes con fecha de caducidad más próxima primero. Es el estándar obligatorio para distribución de medicamentos. MDX-Cloud lo implementa en el motor de generación de rutas de picking.

⚠️ No confundir con FIFO: FEFO ordena por caducidad, FIFO ordena por fecha de entrada.

FIFO (First In, First Out)​

Algoritmo utilizado en MDX-Cloud para la dispersión de abonos en Crédito y Cobranza: el primer pago recibido de un cliente se aplica primero a las facturas más antiguas.

⚠️ No confundir con FEFO: FIFO en MDX-Cloud se refiere al orden de liquidación de deudas, no de inventario físico.

Lote​

Agrupación de unidades de un producto fabricadas en el mismo proceso, identificadas por un número de lote (numero_lote) y una fecha de caducidad. Es la unidad mínima de trazabilidad sanitaria en MDX-Cloud.

Kardex​

Registro cronológico e inmutable de todos los movimientos de inventario de un producto en un CEDIS. En MDX-Cloud corresponde a la tabla wms.movimientos_inventario, que actúa como el libro contable del almacén.

Picking / Surtido​

Proceso por el cual el Auxiliar de Almacén reúne físicamente los productos de una Orden de Surtido, guiado por la ruta óptima FEFO generada por el sistema. Se valida ítem por ítem mediante escaneo de código de barras.

Recall / Retiro Sanitario​

Orden de COFEPRIS para retirar del mercado un lote específico de medicamento por riesgo sanitario. En MDX-Cloud activa una alerta_lote de tipo RETIRO_SANITARIO que bloquea el lote afectado en todos los CEDIS y genera notificaciones automáticas.

Rotación Inversa​

Situación que ocurre cuando un lote recién recibido tiene fecha de caducidad más corta que el stock ya exhibido en anaquel. El sistema detecta esto al escanear la entrada y genera una tarea de reacomodo físico prioritaria para el Auxiliar.

Stock Mínimo / Stock Máximo​

Parámetros configurables por producto que definen el umbral de alerta de reabastecimiento (stock_minimo) y la cantidad objetivo de compra (stock_maximo). El algoritmo de sugerencia de compra (§ 11.4) los utiliza para generar órdenes automáticas.

Stock Reservado​

Cantidad de unidades de un lote que ya han sido asignadas a pedidos en estado Autorizado o En Surtido, pero que físicamente aún no han salido del almacén. El stock disponible real = Existencia − Stock Reservado.

CEDIS (Centro de Distribución)​

Punto físico de almacenamiento y distribución de MDX (sucursal, bodega o sede). El inventario en MDX-Cloud siempre es trazado a nivel (CEDIS, Producto, Lote).

Transferencia Inter-CEDIS​

Movimiento de mercancía entre dos CEDIS distintos. Tiene un flujo de tres estados: Solicitada → En Tránsito → Recibida. El stock del CEDIS origen se reserva al enviar y se libera en el destino al confirmar recepción.

C — Comercial y Ventas​

Remisión​

Documento de control interno que ampara la salida de mercancía cuando el cliente no necesita la factura en ese momento. No tiene validez fiscal. En MDX-Cloud, una remisión abre un plazo máximo de 30 días naturales o el mes calendario en curso para convertirse en CFDI; pasado ese plazo, el sistema aplica el Candado Contable y bloquea la facturación.

Candado Contable​

Regla de negocio de MDX que bloquea la facturación de remisiones vencidas. Se activa cuando el mes calendario de la remisión ha concluido o cuando han transcurrido más de 30 días desde su emisión. Protege el cierre contable mensual.

Pedido en Borrador​

Estado inicial de un pedido capturado parcialmente por el Agente de Ventas en la app móvil. No se envía al sistema central hasta que el agente lo confirma. Permite guardar y reanudar la captura sin pérdida de datos.

Matriz de Precios​

Tabla de tarifas que asigna precios diferenciados a cada cliente según su perfil (farmacia, hospital, público general, etc.). El motor de precios de MDX-Cloud la evalúa automáticamente al crear un pedido.

División de Folios​

Proceso por el cual el backend de MDX-Cloud divide automáticamente una venta de alto valor en múltiples CFDIs independientes, cada uno por debajo de un tope monetario solicitado por el cliente para optimización fiscal. Ver algoritmo completo en § 11.2.

Despacho​

Acción de dar salida física y fiscal a la mercancía surtida. Equivale a la transición Surtido → Despachado en la máquina de estados del pedido.

D — Crédito y Cobranza​

Límite de Crédito​

Monto máximo de deuda autorizado para un cliente. El sistema bloquea automáticamente nuevos pedidos si el saldo vencido del cliente supera este límite.

Saldo a Favor​

Remanente de un pago del cliente que excede sus deudas actuales. El sistema lo registra como crédito disponible para aplicar en futuras facturas.

Excepción Gerencial​

Autorización especial que el Gerente puede emitir para liberar un pedido bloqueado por crédito o stock insuficiente. Queda registrada en la bitácora de auditoría con firma digital del gerente.

E — Infraestructura y Tecnología​

JWT (JSON Web Token)​

Token de autenticación firmado criptográficamente que incluye los claims (permisos) del usuario. En MDX-Cloud tiene una vida útil de 15 minutos y se almacena en memoria RAM del navegador (nunca en disco).

Refresh Token​

Token de larga duración (7 días) almacenado en una cookie HttpOnly segura. Permite renovar el JWT de forma silenciosa sin que el usuario tenga que volver a iniciar sesión.

RBAC (Role-Based Access Control)​

Modelo de control de acceso donde los permisos se asignan a roles y los roles a usuarios. En MDX-Cloud los permisos son granulares y atómicos — se pueden combinar para crear perfiles híbridos.

Offline-First​

Patrón arquitectónico donde la aplicación funciona plenamente sin conexión a internet, almacenando datos localmente (IndexedDB/Dexie.js) y sincronizando con el backend cuando la conectividad se restablece.

IndexedDB / Dexie.js​

Base de datos relacional nativa del navegador web. MDX-Cloud la usa para almacenar catálogos de productos (cache_*) y operaciones pendientes de sincronización (pending_*) en tablets y dispositivos móviles.

SignalR​

Librería de .NET que implementa WebSockets para comunicación en tiempo real bidireccional entre el backend y el frontend. MDX-Cloud la utiliza para emitir deltas de inventario, alertas de crédito y notificaciones de autorización sin necesidad de recargar la página.

Hangfire​

Motor de colas de tareas en segundo plano integrado a .NET, respaldado en PostgreSQL. MDX-Cloud lo utiliza para procesos de alta latencia como el timbrado CFDI, envío de notificaciones push y generación de reportes.

PITR (Point-in-Time Recovery)​

Estrategia de respaldo de PostgreSQL que permite restaurar la base de datos a cualquier segundo exacto en el tiempo. MDX-Cloud la implementa mediante WAL Archiving hacia Cloudflare R2, con pérdida máxima garantizada de 5 minutos.

WAL (Write-Ahead Log)​

Mecanismo de PostgreSQL que registra cada transacción en un archivo de log antes de aplicarla a los datos. Es la base del PITR. En MDX-Cloud los WAL se envían a la bóveda de respaldos cada 5 minutos.

Caddy​

Proxy inverso HTTP/2 + HTTP/3 seleccionado como punto de entrada único al VPS. Gestiona TLS de origen, headers de seguridad, rate limiting y enruta el tráfico hacia el contenedor de .NET interno.

TLS de Origen​

Certificado criptográfico que autentica el tramo de red Cloudflare → VPS. Garantiza que solo Cloudflare puede comunicarse con el servidor, bloqueando conexiones directas a la IP pública del VPS.

F — Personal y Organización​

CURP (Clave Única de Registro de Población)​

Identificador único de personas físicas en México. Dato obligatorio en el expediente de empleados para trámites fiscales y de seguridad social.

NSS (Número de Seguridad Social)​

Número de registro del empleado ante el IMSS. Dato obligatorio en el expediente para futura integración con timbrado de nóminas.

CLABE (Clave Bancaria Estandarizada)​

Número de 18 dígitos que identifica una cuenta bancaria en México. Se registra en el expediente del empleado para la dispersión de nómina.

G — Estándares de Desarrollo​

UUIDv4​

Identificador único universal de 128 bits generado aleatoriamente. MDX-Cloud lo usa para crear IDs de transacciones en el frontend antes de enviarlas al backend, lo que garantiza idempotencia: si una petición se envía dos veces por error de red, el backend la reconoce por su UUID y no la duplica.

SemVer (Semantic Versioning)​

Estándar de versionado de software con el formato vMayor.Menor.Parche. Una versión Mayor implica cambios incompatibles, Menor agrega funcionalidad compatible, Parche corrige errores.

SLA (Service Level Agreement)​

Acuerdo de nivel de servicio que define tiempos máximos de respuesta y resolución ante incidencias. Ver tabla completa en § 14.4.

Definition of Done​

Checklist obligatorio que debe cumplir cualquier funcionalidad antes de ser liberada a producción en MDX-Cloud. Ver lista completa en § 13.6.