Module UltimateMeteo ES
Módulo UltimateMeteo
Presentación
El módulo UltimateMeteo es una extensión para Dolibarr ERP/CRM publicada por Atoo-Net.
Muestra la meteorología en tiempo real directamente en las fichas de terceros, proveedores y contactos, basándose en la dirección registrada en Dolibarr. Utiliza APIs gratuitas y no requiere ninguna clave API.
| Propiedad | Valor |
|---|---|
| Autor | Philippe Grand — Atoo-Net |
| Versión | 24.0.0 |
| Licencia | GNU GPL v3+ |
| Dolibarr mínimo | v24.0 |
| PHP mínimo | v8.0 |
¿Por qué utilizar UltimateMeteo?
Las condiciones meteorológicas tienen un impacto directo en muchas actividades profesionales. UltimateMeteo integra la información meteorológica allí donde la necesita — directamente en sus fichas de Dolibarr — para tomar mejores decisiones sin cambiar de herramienta.
Casos de uso
Construcción y oficios de la edificación
Antes de planificar una intervención exterior, como trabajos de tejado, pintura o cimentaciones, consulte la previsión meteorológica en la dirección de su cliente directamente desde su ficha. Evite enviar un equipo a una obra bajo la lluvia o con heladas.
Agricultura y espacios verdes
Al planificar tratamientos, siembras o trabajos de siega, compruebe las condiciones meteorológicas en la ubicación de su cliente. Una simple mirada a la pestaña Meteorología le indica si la semana es favorable — sin salir de Dolibarr.
Transporte y logística
Al preparar una entrega o una recogida, compruebe la velocidad del viento y las condiciones meteorológicas en el destino. Esto permite anticipar retrasos, adaptar rutas o avisar al cliente con antelación.
Eventos y servicios exteriores
Para empresas de catering, organizadores de eventos o empresas de alquiler, conocer la previsión meteorológica en la dirección del lugar permite confirmar o ajustar la logística in situ, como carpas, calefacción o equipamiento del personal.
Equipos comerciales de campo
Los comerciales en desplazamiento pueden consultar la meteorología en cada etapa antes de salir. Combinado con la gestión de la agenda en Dolibarr, esto ofrece una planificación que integra los riesgos meteorológicos.
Servicio de atención al cliente y servicio posventa
Cuando un cliente informa de un problema, como filtración de agua, fallo de un equipo o corte de electricidad, visualizar instantáneamente la meteorología reciente en su dirección ayuda a calificar la incidencia y priorizar la intervención.
Instalación
- Descargar el módulo desde DoliStore
- Descomprimir y colocar la carpeta
ultimatemeteo/enhtdocs/custom/ - Ir a Inicio → Configuración → Módulos/Aplicaciones
- Localizar UltimateMeteo en la sección AtooNet
- Activar el módulo haciendo clic en el botón de la columna Activado
Configuración
Configuración de permisos
Después de la activación, configure los derechos de acceso por grupo de usuarios en Inicio → Configuración → Usuarios y grupos → Grupos:
| Permiso | Descripción |
|---|---|
Leer datos meteorológicos |
Permite ver las pestañas meteorológicas en las fichas |
Crear / Modificar |
Permite lanzar una actualización de los datos |
Eliminar |
Permite eliminar registros meteorológicos |
Caché de datos
Desde la versión 24.0.0, el módulo utiliza una caché inteligente:
- Los datos meteorológicos se almacenan en la base de datos en la tabla
llx_ultimatemeteo_currentweather - Si existe un registro para un tercero desde hace menos de 30 minutos, los datos se actualizan mediante UPDATE en lugar de crear un nuevo registro
- Si no existe ningún registro reciente, se crea uno nuevo
- Este mecanismo evita una acumulación excesiva de filas en la base de datos
Zona horaria
El módulo detecta automáticamente la zona horaria configurada en Dolibarr mediante la constante MAIN_TIMEZONE. Si esta constante no está definida, se utiliza la zona horaria predeterminada del servidor PHP.
Uso
Pestaña Meteorología
El módulo añade una pestaña Meteorología en cada ficha de tercero: clientes, clientes potenciales y proveedores.
Al abrir esta pestaña, Dolibarr:
- Recupera la dirección, el código postal y la ciudad guardados en la ficha
- Geocodifica la dirección mediante la API OpenStreetMap Nominatim para obtener las coordenadas GPS
- Consulta la API Open-Meteo para recuperar la meteorología actual y las previsiones
- Muestra los resultados con un mapa interactivo
La información mostrada es:
| Campo | Descripción |
|---|---|
| Temperatura (°C) | Temperatura actual en grados Celsius |
| Velocidad del viento (km/h) | Velocidad del viento en km/h |
| Descripción meteorológica | Condición meteorológica: cielo despejado, cubierto, lluvia, nieve, tormenta… |
| Fecha | Fecha y hora de la última observación |
Previsión meteorológica de los próximos días
Debajo de los datos actuales, una tabla muestra la previsión para 5 días con, para cada jornada:
- La fecha
- La temperatura mínima (Min)
- La temperatura máxima (Max)
Mapa interactivo
Un mapa interactivo de OpenStreetMap mediante Leaflet 1.9.4 se muestra en la parte inferior de la página con:
- Un marcador posicionado en la ciudad del tercero
- Una ventana emergente que indica el nombre de la localidad
- Zoom +/− disponible
- Atribución OpenStreetMap conforme a la política de uso de teselas OSM
Pestaña Contacto
La misma pestaña Meteorología está disponible en las fichas de contactos/direcciones. Funciona de forma idéntica utilizando la dirección del contacto.
Condiciones meteorológicas soportadas
El módulo utiliza los códigos WMO estándar y los traduce automáticamente en 5 idiomas: FR, EN, DE, ES, IT.
| Código WMO | Descripción |
|---|---|
| 0 | Cielo despejado |
| 1 | Principalmente despejado |
| 2 | Parcialmente nuboso |
| 3 | Cubierto |
| 45 / 48 | Niebla / Niebla engelante |
| 51 / 53 / 55 | Llovizna ligera / moderada / densa |
| 61 / 63 / 65 | Lluvia ligera / moderada / fuerte |
| 71 / 73 / 75 | Nieve ligera / moderada / fuerte |
| 77 | Granos de nieve |
| 80 / 81 / 82 | Chubascos ligeros / moderados / violentos |
| 85 / 86 | Chubascos de nieve ligeros / fuertes |
| 95 | Tormenta |
| 96 / 99 | Tormenta con granizo ligero / fuerte |
APIs utilizadas
El módulo se basa en APIs completamente gratuitas, sin registro ni clave API requerida:
| API | Función | URL |
|---|---|---|
| Open-Meteo | Meteorología actual y previsiones | https://api.open-meteo.com |
| OpenStreetMap Nominatim | Geocodificación dirección → coordenadas GPS | https://nominatim.openstreetmap.org |
| Leaflet 1.9.4 | Biblioteca de mapa interactivo | https://leafletjs.com |
| OpenStreetMap Tiles | Teselas cartográficas | https://tile.openstreetmap.org |
Novedades de la versión 24.0.0
Correcciones
- Error 403r en los mapas OpenStreetMap: añadido de
referrerPolicyy de la atribución conforme a la política de teselas OSM 2026 - Leaflet fijado en la versión 1.9.4 con verificación de integridad SRI, en lugar de una URL CDN sin versión
- Llamadas API seguras: sustitución de
file_get_contentspor cURL con User-Agent conforme en el hook de terceros - Caché de datos: mecanismo UPDATE/INSERT con caché de 30 minutos, eliminando los INSERT sistemáticos en cada visualización
- Zona horaria dinámica: uso de la configuración de Dolibarr en lugar de una zona horaria Europe/Paris codificada en duro
Mejoras
- Códigos meteorológicos completos: añadido de los códigos WMO 71–99, que cubren nieve, chubascos, tormentas y granizo, en los 5 archivos de idioma
- Internacionalización: las descripciones meteorológicas utilizan ahora el sistema de traducción de Dolibarr
$langs->trans() - Enlaces de ayuda wiki: añadido de enlaces contextuales hacia la documentación wiki en todas las páginas del módulo
- Compatibilidad con Dolibarr v24: actualización de los patrones para respetar las convenciones v24
FAQ
La meteorología no se muestra
Compruebe que la ficha del tercero o del contacto tiene correctamente introducidos un código postal y una ciudad. La geocodificación requiere al menos una ciudad.
El mapa muestra "Access blocked" o "403r"
Este problema se corrigió en la versión 24.0.0. OpenStreetMap reforzó su política de Referer a principios de 2026. La actualización incluye:
- El añadido de
referrerPolicy: "strict-origin-when-cross-origin"en la configuración de Leaflet - La atribución obligatoria
© OpenStreetMap contributors - La fijación de Leaflet en una versión estable, 1.9.4
Si sigue viendo este error, compruebe que utiliza correctamente la versión 24.0.0 del módulo.
¿Los datos meteorológicos se actualizan automáticamente?
Los datos se recuperan cada vez que se abre la pestaña Meteorología. Una caché de 30 minutos evita llamadas API repetitivas: si los datos tienen menos de 30 minutos, simplemente se actualizan en la base de datos.
¿Funciona el módulo sin conexión?
No. El módulo requiere acceso a Internet para consultar las APIs Open-Meteo y Nominatim.
¿Qué idiomas están soportados?
El módulo está disponible en: Francés, Inglés, Alemán, Español, Italiano.
¿Cómo acceder a la ayuda en línea?
Cada página del módulo dispone de un enlace de ayuda contextual mediante el icono ? situado en la parte superior derecha, que remite a la sección correspondiente de esta página wiki.
Véase también
- Atoo-Net — Editor del módulo
- Documentación de la API Open-Meteo
- Política de uso de teselas OpenStreetMap
- Documentación de Leaflet
