B2B Salud - Sistema de recepción de vacunas global
Canal de pedidos para la red mundial de distribuidores de un laboratorio, donde el precio de un producto depende del distribuidor, del contrato, del país y de la fecha.
Diater fabrica inmunoterapia y la vende fuera de España a través de una red de distribuidores repartida por el mundo. Cada distribuidor opera unos países concretos, con un catálogo autorizado en cada uno, unos precios pactados en un contrato y unas condiciones de pago negociadas años atrás en una mesa.
Nada de eso se decide en la web. Cuando alguien entra en la plataforma, todas las respuestas importantes ya están dadas: para qué empresa trabaja, qué países son suyos, qué productos existen ahí, cuánto cuestan hoy y cómo se pagan. Lo que había que construir no era una tienda.
Una plataforma que no vende: ejecuta contratos
El reto
El precio no es un número: es un acuerdo con fecha de caducidad. Se resuelve cruzando distribuidor, contrato, país, producto y periodo de vigencia. Eso tiene una consecuencia que ordena todo el modelo: un precio no se edita jamás. Si se corrige el vigente, se reescribe lo que costaron los pedidos ya grabados y el histórico deja de cuadrar con la facturación. Los precios se abren, se cierran y se suceden; nunca se sustituyen.
Una jerarquía dentro de otra empresa. No basta con dar de alta al distribuidor: hay que representar a su gente. Cada distribuidor tiene empleados, y cada empleado tiene un papel en cada país en el que esa empresa opera. La misma persona puede tramitar pedidos en un mercado y solo consultar facturas en otro. El laboratorio acaba modelando la organización interna de compañías que no administra, y que no se parecen entre sí.
Escala mundial, catálogo local. Lo que se puede vender no es lo mismo en todos los países: registro sanitario, presentaciones autorizadas, alérgenos relevantes. Un catálogo global filtrado a posteriori es una fuga esperando a ocurrir; lo que existe para un usuario tiene que ser, desde el origen, solo lo suyo.
Al por mayor, la vacuna sigue teniendo nombre. Aunque quien compra sea una empresa, un tratamiento de inmunoterapia se compone para un paciente concreto y lo prescribe un médico concreto. El pedido no podía ser un carrito con unidades: exige médico y paciente igual que si el alergólogo estuviera delante.
La plataforma no cobra ni factura, y eso es una decisión. El pago es la forma habitual que cada distribuidor tiene pactada, y la facturación vive en el ERP. La tentación en un proyecto así es añadir pasarela y facturación porque un eCommerce "debe" tenerlas; hacerlo habría creado una segunda verdad sobre el dinero, compitiendo con la que ya existía.
El pedido de verdad no es la pantalla: es el fichero. Lo que pone en marcha la fabricación es un volcado con códigos de referencia que entra en SAP. Si ese fichero sale mal, da igual lo bien que funcione el formulario.
En farma, la documentación es parte del producto. Contratos, listas de precios, facturas, certificados de análisis, materiales promocionales, estimados anuales de venta. Y algunos de esos documentos no se leen: se firman.
La solución
— El precio como serie temporal
Cada precio es un registro con su distribuidor, su contrato, su país, su producto y su rango de fechas. Un pedido no busca "el precio del producto": busca el precio que estaba en vigor el día en que se hizo. Así, una renegociación anual es un alta de precios con nueva vigencia, no una edición masiva sobre lo existente, y el histórico de pedidos sigue contando la verdad de cada momento.
Es la decisión menos vistosa de todo el proyecto y la que más problemas evita. Cuando llegó el momento de renegociar precios a gran escala, el problema no fue cómo cambiarlos, sino qué significaba cambiarlos: si se movían las fechas de los existentes o se abrían nuevos rangos. Que la pregunta se pudiera plantear en esos términos ya era mérito del modelo.
— Los procesos por lotes, a la vista
La importación de precios y la exportación a SAP no son scripts que alguien lanza por SSH: son dos apartados del panel, al mismo nivel que los pedidos o los distribuidores.
Es una decisión deliberada. Un proceso masivo que ocurre a oscuras solo se puede depurar preguntando al desarrollador; un proceso masivo con su pantalla, su histórico y su registro de ejecuciones lo puede revisar quien lo lanzó. Cuando lo que se importa son los precios de una red internacional y lo que se exporta son órdenes de fabricación, esa diferencia deja de ser comodidad y pasa a ser control.
— Distribuidores, empleados y países
Tres niveles encajados: el laboratorio da de alta al distribuidor, el distribuidor tiene sus empleados y cada empleado tiene un rol por país. El rol decide qué apartados existen para él —pedidos, facturas, documentación—, de modo que dos compañeros de la misma empresa pueden ver pantallas distintas según el mercado en el que estén trabajando.
Un listado de empleados muestra quién es quién, en qué país y con qué papel. Es la pregunta que se hace cualquiera que gestione un equipo repartido por varios mercados, y hasta entonces se respondía preguntando.
— El contrato como fuente de verdad del catálogo
Al entrar, el usuario encuentra sus países, y dentro de cada uno solo los productos autorizados con sus presentaciones y alérgenos. No hay catálogo global que después se filtra: lo que existe para ese usuario es lo que su contrato dice que existe.
— El pedido conserva el nombre del paciente
El formulario pide país, médico, paciente, dirección de envío, presentación, tratamiento, unidades y porcentajes. Los médicos y las direcciones no se teclean: están dados de alta en el backoffice y se seleccionan, porque un nombre mal escrito en una prescripción es un problema distinto a un nombre mal escrito en un pedido de material de oficina.
Antes de grabar, confirmación explícita. Igual que en la plataforma de Portugal, y por la misma razón.
— La salida hacia el ERP
Cada pedido se exporta con los códigos de referencia que el sistema del laboratorio espera. La plataforma no es el final del proceso: es la boca de entrada de una cadena de fabricación que ya existía y que no se iba a cambiar por una web.
Los pedidos se numeran por país —IT…, MY…, AU…—, de modo que la referencia dice de dónde viene antes de que nadie la abra. Y aunque la plataforma no cobra, sí sabe lo que se debe: cada pedido arrastra su estado de pago, porque el laboratorio necesita conciliar lo que ha fabricado con lo que su ERP tiene facturado.
— Espacio documental, y espacio documental que reclama
Dos áreas distintas, y esa distinción es el detalle bueno. Una guarda la documentación del cliente: contrato, precios, pedidos, facturas, certificados de análisis, materiales promocionales, estimado anual de ventas. La otra guarda los documentos que requieren algo del cliente —una factura que hay que firmar, por ejemplo— y avisan de que están ahí.
Un repositorio donde todo pesa lo mismo se convierte en un cajón. Separar lo que se consulta de lo que se debe atender es lo que evita que una firma pendiente se quede seis meses en una carpeta.
— Diagnóstico: la excepción que puso a prueba el modelo
Más adelante entró una familia de productos que rompía las premisas: productos de diagnóstico terminados, iguales para todos los clientes, sin paciente y sin médico, y comprados de varios en varios en lugar de uno a uno.
Se resolvió sin duplicar la plataforma: la misma regla de precios, checkout propio sin campo de médico, carrito multilínea y el distribuidor ocupando el lugar del paciente en el modelo de datos. No es elegante sobre el papel; es la decisión correcta, porque conserva un único circuito de pedido en lugar de abrir un segundo sistema paralelo que habría que mantener el resto de su vida.
Eso sí, con su propio fichero para el ERP, generado en paralelo al de tratamientos: los productos podían compartir plataforma, pero no estructura de volcado.
Stack
Backend: Ruby on Rails
Autenticación: Devise · autologin
Roles: por empleado y país, dentro de cada distribuidor, con implementación propia
Modelo de precios: distribuidor / contrato / país / producto / vigencia
Integraciones: exportación a SAP en ficheros de estructura propia (tratamientos y diagnóstico, en paralelo) · importación masiva de precios
Procesos por lotes: apartados propios de exportación a SAP e importación de precios, con su histórico
Base de datos: PostgreSQL
Idioma del producto: inglés y Español
¿Un proyecto parecido en mente?
Hablemos