Versión del Módulo: auto
Creador/Licencia: Federico García-Patiño / GPL-v3
Idioma interfaz usuario: Inglés, Español, Francés
Ayuda/Soporte: federico.garcia.patino@gmail.com
Prerrequisitos:

• Versión min Dolibarr: auto
• Versión max Dolibarr: auto

Instalación (desde Dolibarr v9+)

• Vaya al menú Inicio - Configuración - Módulos - Implemente un módulo externo y envíe el zip
• El módulo o tema está entonces disponible y activable.

Para instalar este módulo (Dolibarr v8-):

• Descargar el archivo del módulo (archivo .zip) desde la web DoliStore.com
• Ponga el archivo en el directorio raíz de Dolibarr.
• Descomprima el zip archivo, por ejamplo usando el comando  unzip module_geoaddresses-1.0.zip 
• El módulo o tema está listo para ser activado.

Introducción

Existen algunos procesos empresariales cuya eficacia depende de la calidad de la información de las direcciones postales que se almacenen para clientes, proveedores, contactos, almacenes... Ejemplos de estos servicios serían la optimización de rutas en un sistema de reparto de mercancías, u otras acciones de marketing o comunicaciones corporativas que se realizan mediante correo postal (christmas navideños, felicitaciones, cambios de condiciones de servicios…). Incluso existen otras utilidades, donde poder disponer de unos datos con calidad sobre las ubicaciones permite representaciones de los datos mucho más intuitivas y directas que las vistas tabuladas.

De esta manera, la geo-localización de las direcciones postales conceptualmente aporta valor añadido sobre los siguientes capítulos:

• Mejora la calidad de los datos mediante la validación visual y el ajuste de los mismos

• Permite el despliegue de nuevos servicios

• Permite el desarrollo de nuevas representaciones de los datos

La solución

El módulo GeoAddresses de Dolibarr se integra con los componentes habituales de Dolibarr donde aparecen direcciones postales (almacenes, terceros y contactos) y añade una utilidad gráfica para la captura automática de información basada en los datos existentes, y la posterior validación de estos datos. Con independencia del estado en el que se encuentren los datos es posible comenzar a consumir los servicios del módulo GeoAddresses desde el primer momento.

Proveedor de servicios de mapas y localizaciones

Los servicios del módulo GeoAddresses se basan en la integración con el proveedor de servicios de mapas y localización para desarroladores mapbox  (mapbox.com), que ofrece sus servicios de forma gratuita a través de una API, para todos sus productos en rangos de uso significativos, que en el caso del consumo de GeoAddresses (fordward geocoding) se encuentran en el límite de 50.000 servicios de mapas y 100.000 solicitudes mensuales de geolocalización (a 03/04/2022). 

Puede consultar otras posibilidades de servicios en el sitio web del fabricante mapbox.com indicado más arriba.

GeoAddresses funciona sobre los servicios de mapbox.com y no es responsable de cambios en las condiciones del servicio, ni en los interfaces técnicos utilizados para la integración con Dolibarr que pueda aplicar este proveedor sobre sus productos en el futuro.

Instalación

Para instalar el módulo GeoAddresses hay que seguir los pasos habituales para la instalación de cualquier módulo en Dolibarr.

Configuración

Antes de comenzar a utilizar GeoAddresses es necesario completar un proceso de registro de usuario en mapbox,com, del que se obtienen como resultado la información necesaria para poder consumir sus servicios. El registro habilita un panel de control donde es posible consultar el consumo del servicio en cada momento.

Una vez completado el registro sólo es necesario completar la configuración del módulo de la forma que se presenta en la siguiente pantalla:

Donde:

• Sistema de proyección: EPSG:3857

• URL del servicio: https://api.mapbox.com/geocoding/v5/mapbox.places/

• Nombre del parámetro para el token de seguridad: access_token

• Token de seguridad: el asignado por mapbox.com en el registro

Caso de uso

Tras la instalación y configuración de GeoAddresses se habilita una pestaña denominada “Mapa” en las fichas de información de los módulos implicados: almacenes, terceros (clientes, clientes potenciales, proveedores), y contactos.

Al acceder al contenido de esta pestaña el módulo hace una consulta al servicio de direcciones de mapbox procesando y enviando los datos que figuran como dirección postal del objeto en cuestión de Dolibarr y ofrece una ubicación tentativa situada en el mapa. En este momento se inserta un registro con los datos obtenidos en estado “borrador” que podrán ser validados visualmente por el usuario.

Acceso a los servicios

La siguiente pantalla se corresponde con un cliente de Dolibarr, muestra los elementos funcionales principales de la integración:

Donde

1. Pestaña de acceso a los servicios

2. Buscador alternativo: en el caso de que se verifique que la localización calculada automáticamente no es válida es posible realizar búsquedas alternativas y establecer la localización desde este servicio

3. Marcador de posición: indica visualmente la localización. Es posible hacer ajuste fino sobre este marcador mediante acciones de “drag & drop”. El color naranja indica que la dirección no está validada, y el color verde indica que la dirección ha sido validada.

4. Panel de información: ofrece información de las coordenadas (longitud y latitud) en el sistema de proyección utilizado.

5. Comandos:

   1. Validar: indica que la información está validada

   2. Restaurar posición: Si se realizó algún cambio manual, permite sitúar el marcador en su posición original.

Validación de direcciones

La validación de direcciones sitúa el marcador de posición en color verde. Una vez que una dirección se encuentra validada es posible volver al estado borrador para su corrección si posteriormente se detecta algún error.

Buenas prácticas

En el momento de la instalación, en Dolibarr no se dispone de la información geográfica sobre la base de direcciones existente, por lo que es aconsejable incluir la visita a la pestaña de mapa y validar los datos de cada cliente en cada acceso. 

Para el alta de nuevos clientes es aconsejable que el registro de datos de direcciones postales siga una nomenclatura clara y limpia, poniendo atención en la documentación de la información administrativa normalizada (localidad, código postal, provincia, región, país). Como norma general, la línea de dirección de se puede especificar de la siguiente manera:

1. Tipo de vía

2. Nombre de la vía

3. Número de la vía

4. Información adicional (bloque, piso, escalera, puerta…)