Appearance
M02 - Cotización en Punto de Venta
| Campo | Valor |
|---|---|
| Estado | Borrador |
| Prioridad | MVP - Fase 1 |
| Última actualización | 2026-03-25 |
| Reuniones vinculadas | 2026-03-05, 2026-03-09, 2026-03-10-p2, 2026-03-24 |
Objetivo
Entregar cotización rápida en punto de venta para farmacias con convenio, sin mezclar gestión operativa ni trazabilidad avanzada de pedidos. Este es el primer módulo funcional (MVP) de Tu Magistral.
Alcance
SÍ incluye
- Búsqueda de producto en catálogo del convenio
- Visualización de precio de convenio vigente
- Selección de cantidad según tipo de producto
- Cálculo de total cotizado
- Emisión de cotización / voucher
- Administración de catálogo de productos (recetario)
- Gestión de precios diferenciados por convenio
- Derivación a excepción para productos fuera de catálogo
NO incluye (pertenece a otros módulos)
| Funcionalidad | Módulo destino |
|---|---|
| Validación operativa de receta | M03 - B2B |
| Conversión a orden de trabajo | M03 - B2B + M04 - Producción |
| Estados de pedido / despacho | M03 - B2B |
| Carga masiva de recetas / documentos por lote | M03 - B2B |
| API de inyección / consulta de solicitudes | M03 - B2B |
| Cotizador inteligente con IA (lectura de receta) | M03 - B2B |
| Seguimiento farmacoterapéutico | M07 - Seguimiento |
Actores y Roles
| Actor | Descripción | Acciones principales |
|---|---|---|
| Farmacia | Farmacia, clínica u hospital con convenio activo con un recetario | Buscar producto, ver precio convenio, ingresar cantidad, obtener cotización, emitir voucher |
| Recetario | Laboratorio magistral que administra el catálogo y los precios | Cargar productos, administrar catálogo, gestionar precios por convenio, carga masiva desde Excel |
Flujo Principal
Funcionalidades Detalladas
F-M02-001: Búsqueda de producto
| Campo | Detalle |
|---|---|
| Descripción | Permite a la farmacia buscar un producto dentro del catálogo del convenio activo |
| Criterios | Buscar por nombre, código interno, sinónimo. Autocompletado progresivo. Solo muestra productos del catálogo asignado al convenio activo. Respuesta inferior a 2 segundos |
| Origen | Reunión 2026-03-05, Reunión 2026-03-24 |
Detalle adicional: Los productos tienen un código interno del ERP del recetario. Los sinónimos son necesarios porque un mismo principio activo puede buscarse con distintos nombres (por ejemplo, "ciclosporina" o "cicloforina"). El buscador debe tolerar variaciones menores de escritura.
F-M02-002: Visualización de precio de convenio
| Campo | Detalle |
|---|---|
| Descripción | Muestra el precio final al cliente, según el convenio vigente |
| Criterios | Mostrar únicamente el precio final (NO costo ni margen). El precio puede variar por convenio. El factor de margen (20%, 50%, 60%) es configuración interna del recetario y no se expone al usuario farmacia |
| Origen | Reunión 2026-03-05, Reunión 2026-03-24 |
Detalle adicional: La farmacia puede tener configurado internamente un factor adicional para calcular su precio al paciente final. Este factor se aplica sobre el precio de convenio y es gestionado por la propia farmacia, no por el recetario. En el punto de venta, el vendedor puede ver solo el valor cliente final.
F-M02-003: Ingreso de cantidad
| Campo | Detalle |
|---|---|
| Descripción | Permite ingresar la cantidad requerida, adaptada al tipo de producto |
| Criterios | Cantidad según tipo de producto: Estándar (ej. colirio 10ml) = unidades enteras. Variable controlado (ej. crema) = gramos. Cápsula = unidades de cápsulas. Validación de cantidad mínima y máxima |
| Origen | Reunión 2026-03-05, Reunión 2026-03-24 |
Detalle adicional: Un colirio de cloruro de sodio de 10ml es un producto estandarizado; el paciente compra 1, 2 o N unidades. Una crema de bifonazol se costea por gramo para evitar crear múltiples códigos por cada gramaje posible (30g, 50g, 60g). Las cápsulas se costean por unidad individual, y el vendedor ingresa la cantidad de cápsulas solicitadas (30, 60, 90, etc.).
F-M02-004: Cálculo de cotización
| Campo | Detalle |
|---|---|
| Descripción | Calcula el total de la cotización con base en precio convenio y cantidad |
| Criterios | Fórmula: precio convenio x cantidad = total. Mostrar desglose: producto, cantidad, precio unitario, subtotal por línea, total general. Soportar múltiples líneas de producto en una misma cotización |
| Origen | Reunión 2026-03-24 |
F-M02-005: Emisión de cotización / voucher
| Campo | Detalle |
|---|---|
| Descripción | Genera un comprobante de cotización con detalle completo |
| Criterios | ID único de cotización. Fecha de emisión. Vigencia de la cotización. Datos del convenio (recetario y farmacia). Detalle de productos cotizados (producto, cantidad, precio unitario, total). Total general |
| Origen | Reunión 2026-03-24 |
F-M02-006: Administración de catálogo (Recetario)
| Campo | Detalle |
|---|---|
| Descripción | Permite al recetario cargar y mantener su catálogo de productos cotizables |
| Criterios | Carga manual de productos uno a uno. Carga masiva desde archivo Excel. Campos por producto: código, activo (principio activo), sinónimos, concentración, unidad de medida, volumen/peso, forma farmacéutica, presentación final, línea de fabricación. El sistema debe construir un nombre legible a partir de los campos (ej. "Ciclosporina 1% 10ml colirio") |
| Origen | Reunión 2026-03-05, Reunión 2026-03-24 |
Detalle adicional: La estructura del catálogo proviene de la práctica actual del recetario, que organiza productos por código, activo, concentración, unidad, línea de fabricación (dermatología, oftalmología, veterinaria), presentación y forma farmacéutica. Esta estructura permite cruzar información con sistemas contables y ERP internos.
F-M02-007: Gestión de precios por convenio
| Campo | Detalle |
|---|---|
| Descripción | Administra precios diferenciados por convenio, con trazabilidad de cambios |
| Criterios | Un recetario puede tener múltiples convenios. Cada convenio tiene precios independientes por producto. Trazabilidad de cambios de precio (historial). Actualización anual de precios vía carga masiva. Posibilidad de descargar la tabla vigente, modificar y resubir |
| Origen | Reunión 2026-03-05, Reunión 2026-03-24 |
Detalle adicional: La práctica actual es que el recetario mantiene una tabla general de precios y aplica descuentos diferenciados por convenio. Por ejemplo, Salco puede tener 25% de descuento y Santa Gemita 30% sobre el mismo producto. Los precios se revisan típicamente una vez al año.
F-M02-008: Derivación a excepción
| Campo | Detalle |
|---|---|
| Descripción | Cuando un producto no está en el catálogo, se genera un ticket para revisión manual |
| Criterios | Producto fuera de catálogo genera ticket de excepción. Receta dinámica o nueva que no existe en el catálogo se deriva para revisión manual por el recetario. El ticket debe registrar: producto solicitado, convenio, fecha, usuario |
| Origen | Reunión 2026-03-05, Reunión 2026-03-24 |
Detalle adicional: No todas las recetas encajan en el catálogo. Cuando una receta trae una formulación que el recetario no tiene precargada, no se puede cotizar automáticamente. En ese caso, se genera una excepción para que el equipo del recetario analice, costee y eventualmente agregue el producto al catálogo.
Estados de la Cotización
Reglas de Negocio
| ID | Regla |
|---|---|
| R-M02-001 | El catálogo no contiene combinaciones infinitas; los productos están acotados y estandarizados |
| R-M02-002 | Un producto estandarizado (ej. colirio 10ml) varía únicamente en cantidad de unidades |
| R-M02-003 | Un producto variable controlado (ej. crema por gramo, cápsula por unidad) tiene cantidad flexible pero composición fija |
| R-M02-004 | Una receta fuera de catálogo se trata como excepción y se deriva a un ticket; no se resuelve dentro del cotizador |
| R-M02-005 | El precio por convenio puede variar entre distintos clientes para el mismo producto |
| R-M02-006 | El costo y el margen del recetario NO son visibles para el usuario farmacia; solo se muestra el precio final |
| R-M02-007 | La cotización tiene una vigencia limitada; superada la vigencia, expira automáticamente |
| R-M02-008 | La dependencia con el módulo de Costeo (M06) es deseable pero no obligatoria en la fase MVP |
Dependencias
Descripción de dependencias:
- M06 - Costeo --> M02 - Cotización: El módulo de costeo podría alimentar automáticamente los precios base del catálogo. En la fase MVP, el recetario carga los precios manualmente.
- M02 - Cotización --> M03 - B2B: Una cotización confirmada podría derivar en una orden de trabajo gestionada por el módulo B2B. Esta conexión no es parte del MVP.
- M01 - Autenticación --> M02 - Cotización: El cotizador requiere que el usuario esté autenticado y asociado a un convenio activo.
Pendientes de Cierre
- [ ] Definir vigencia de la cotización (cantidad de días)
- [ ] Definir formato del voucher (PDF, imprimible, digital)
- [ ] Confirmar si se incluyen descuentos por volumen en el MVP
- [ ] Integrar con sistema de login / autenticación (M01)
- [ ] Definir si la farmacia puede configurar su factor de margen dentro del sistema o lo hace externamente
- [ ] Confirmar campos mínimos del ticket de excepción
- [ ] Definir límites de cantidad mínima y máxima por tipo de producto
Historial de Cambios
| Fecha | Reunión / Evento | Cambios principales |
|---|---|---|
| 2026-03-05 | Reunión de arquitectura y roadmap | Definición inicial del cotizador en punto de venta como primer MVP. Distinción entre productos estandarizados y variables. Separación de costeo como módulo aparte. Definición de carga manual y masiva |
| 2026-03-09 | Reunión de diagnóstico digital | Confirmación de que el cotizador en punto de venta es funcionalidad de Tu Magistral. Identificación de problemas de tiempo de respuesta en cotización manual. Separación entre cotizador de convenio y cotizador web/marketplace |
| 2026-03-10 | Reunión con Andro (Reccius) | Validación de que el módulo de cotización es el primer MVP a implementar. Confirmación de que el sistema es de gestión, no de venta. Acuerdo sobre exclusividad para ciertos recetarios competidores |
| 2026-03-24 | Reunión de refinamiento de requerimientos MVP | Refinamiento de campos del catálogo. Revisión de la estructura de precios por convenio. Definición de dos vistas (administrador y vendedor). Acuerdo en partir con requerimientos simples sin métricas |