Puntos — los 1.000 puntos que deciden si tu pedido necesita camión ADR

Concepto

Puntos es el motor que, por cada expedición, decide en veinte segundos si el pedido puede salir como paquetería normal o necesita camión ADR —y cuando necesita ADR, emite el documento de transporte, las instrucciones escritas y las etiquetas con la fila correcta de la tabla A del capítulo 3.2.

Lo paga el expedidor —el fabricante o distribuidor que firma la carta de porte y responde ante la inspección—, no el transportista. 1.450 € de alta (carga del catálogo: cada referencia comercial mapeada a su fila ONU desde la ficha de datos de seguridad) + 349 €/mes por centro de expedición hasta 400 expediciones (1,90 € la extra). Y 4.800 €/año en marca blanca para el consejero de seguridad que lo revende a su cartera.

El negocio está en una asimetría que hoy nadie calcula: la tabla A del ADR 2025, en el Excel oficial que publica el Ministerio, tiene 2.939 filas para 2.349 números ONU y 23 columnas. Un mismo producto puede aparecer seis veces: UN 1263 PINTURA tiene 6 filas, con cantidad limitada de 500 ml o 5 L y categoría de transporte 1, 2 o 3 según el grupo de embalaje. La cuenta de la exención 1.1.3.6 mezcla esas categorías con multiplicadores 50 / 20 / 3 / 1 y un techo de 1.000. Elegir la fila equivocada no da un error: da un número.

Ejemplo de la trampa: 250 L de esmalte (GE II → categoría 2 → ×3 = 750 puntos) + 100 L de disolvente UN 1993 (GE II → ×3 = 300) son 1.050 puntos: no exento, hace falta ADR completo. Con las filas de GE III (categoría 3, ×1) la misma carga sale 350 puntos y "exenta". El almacén envía 350 litros de inflamables como paquetería normal y el documento declara una categoría que no es la del bulto. Eso es lo que se ve en carretera.

Por qué es nueva

• Novedad: hoy esto lo resuelve (a) una plantilla de Word que el consejero de seguridad dejó en 2023, (b) un ERP químico de gama alta que imprime documentos pero no decide, o (c) el transportista comprobando en el muelle lo que le acaban de dar. Nadie convierte la tabla A en un motor de decisión por expedición que junte en el mismo cálculo la cuenta de puntos, el límite de cantidad limitada, la segregación de carga y el código de túnel, alimentado desde el picking. Y nadie revalida el histórico cuando cambia la edición: el 1 de enero de 2027 entran 188 números ONU afectados y 231 cambios de columna, con cuatro ONU nuevos (3561–3564) y una entrada suprimida (2941).
• Dónde añadimos valor: dos bolsillos. Uno, deja de pagar recargo ADR en los envíos que no lo necesitan —la exención 1.1.3.6 quita paneles naranja, instrucciones escritas y certificado ADR del conductor, aunque no quita el documento de transporte, el extintor ni la formación básica—, así que un pedido exento puede ir por mensajería normal en lugar de agencia ADR: decenas de euros por envío y cientos de envíos al mes. Dos, deja de arriesgar la inmovilización: una infracción grave se mueve entre 401 y 2.000 € y en muchos supuestos el vehículo no sigue viaje. El error típico no es mala fe, es copiar la fila de al lado.
• Visión: del documento por expedición al expediente probatorio —cada envío con su clasificación, la versión de la FDS con la que se decidió y la edición del ADR aplicable— y de ahí a la certificación "ADR-ready" que las grandes cuentas ya piden a sus proveedores. Después, la misma clasificación sirve para IMDG e IATA: el producto pasa de documento a registro de sustancias.

Diagrama de secuencia

Cargando diagrama…

Lo que ve el usuario

En el muelle, la persona que imprime el albarán ve una línea por pedido con un semáforo. Verde: "204 puntos · exento 1.1.3.6 · puede ir por mensajería, no pongas paneles". Rojo: "1.050 puntos · ADR obligatorio · UN 1263 PINTURA, clase 3, GE II, túnel D/E, 1 bulto de 250 L" y un botón que imprime documento, instrucciones escritas en el idioma del país de destino y etiquetas para la Zebra. Ámbar: referencia nueva sin clasificar; abre la ficha de seguridad en la página 14, propone la fila con su confianza ("UN 1993, 0,93") y pide confirmación.

En el panel del responsable: cola de revisión, referencias sin FDS vigente y el contador del mes en euros —"132 expediciones enviadas sin recargo ADR: 3.960 € que no has pagado"—. El consejero de seguridad entra con su propia cuenta y ve la cartera entera: qué referencias de qué empresa están sin confirmar y qué expediciones quedarían invalidadas con la edición 2027.

Imagen sugerida: pantalla de escritorio sobre fondo claro con la tabla del picking y tres filas con semáforo verde, rojo y ámbar; a la derecha, una tarjeta de veredicto con la cuenta de puntos desglosada (750 + 300 = 1.050, techo 1.000) y debajo dos botones, "Documento ADR" e "Etiqueta".

Repositorios utilizados

• https://github.com/docling-project/docling — leer las fichas de datos de seguridad en PDF (sección 14: transporte, y las tablas de composición) y el picking escaneado, sin pedirle al cliente que rellene un formulario de 40 campos.
• https://github.com/gorules/zen — las tablas del ADR como grafos de decisión versionados: categoría de transporte, multiplicadores, límites de cantidad limitada y exceptuada, segregación y matriz de túneles. Cambiar de edición es cambiar de grafo, con tests por caso.
• https://github.com/pgvector/pgvector — emparejar el nombre comercial ("DISOLVENTE SINTÉTICO 3000") con las 2.349 entradas de la tabla A por similitud y sinónimos, con umbral de confianza y cola de revisión humana en vez de adivinar.
• https://github.com/temporalio/temporal — el expediente como proceso vivo: espera la confirmación del consejero, archiva el hash del documento emitido y se reabre solo cuando se publica una edición nueva del ADR.

Variaciones (sinergias)

1. + https://github.com/ultralytics/ultralytics (62.694 ⭐) + https://github.com/ocrmypdf/OCRmyPDF (35.106 ⭐): la foto del palet en el muelle se convierte en una comprobación física. Ultralytics detecta pictogramas de peligro y cuenta bultos; OCRmyPDF saca el texto de la etiqueta del fabricante aunque venga torcida o con flash. Emerge el control de carga antes de que el camión salga: "el documento dice 12 bultos de UN 1263, el palet tiene 13 y dos llevan pictograma de corrosivo que no están declarados". Nicho: plataformas de grupaje y almacenes de distribuidores químicos con 20-100 salidas diarias, donde el que carga no es el que documenta.

2. + https://github.com/valhalla/valhalla (6.349 ⭐) + https://github.com/traccar/traccar (7.894 ⭐): la clasificación ya calcula el código de túnel; ahora se cruza con la ruta real. Valhalla en perfil de camión con hazmat filtra las vías con restricción declarada en OSM, y Traccar guarda la traza del vehículo casada con el expediente. Emerge el parte de ruta defendible: la empresa puede demostrar por dónde pasó, por dónde no y qué túneles tenía prohibidos ese porte. Nicho: flotas que cruzan los Pirineos y los corredores alpinos —Mont Blanc, Fréjus, Gotardo— donde la categoría del túnel decide la ruta y la multa. Aviso honesto: en Valhalla el flag hazmat es estándar pero la categoría A–E no viene en el motor sin parche; la matriz se resuelve en el grafo zen y se aplica como restricción de ruta.

3. + https://github.com/apache/superset (75.235 ⭐) + https://github.com/evidence-dev/evidence (7.041 ⭐): todo expediente deja un histórico con clase, cantidad y destino. Con Superset para el cuadro operativo y Evidence para los informes en markdown versionados, emerge el informe anual del consejero de seguridad generado desde los datos reales en lugar de desde una hoja de cálculo reconstruida en diciembre, más el mapa de calor de qué referencias concentran el riesgo. Nicho: los despachos de consejeros de seguridad externos, cuya capacidad está topada por ley (el PSIC del art. 30 del RD 97/2014 limita las unidades que puede cubrir cada consejero): el mismo profesional pasa de 40 a 80 empresas sin contratar a nadie, con el informe ya hecho.

Plan MVP completo

projects/puntos-adr/docs/mvp/PLAN-MVP.md