Logística

Etiquetas Mondial Relay (Sendcloud)

dolixmondialrelay · versión 1.0.2

Usted elige el Point Relais® o el Locker del destinatario en el envío, y el módulo crea la etiqueta Mondial Relay con su cuenta Sendcloud.

Precio
79 € sin IVA
Dolibarr
19.0 mínimo
Versión
1.0.2
Licencia
GPL v3+
Idiomas
Francés, inglés, alemán, español

79 € sin IVA.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Comprar en el DoliStore — 79 € sin IVA
El envío después de crear una etiqueta Mondial Relay real, el 14/10/2026: el Point Relais elegido, el número de seguimiento 73988975 con el enlace a la etiqueta PDF, el estado Sendcloud y el método de envío «Mondial Relay» escrito por el módulo.
El envío después de crear una etiqueta Mondial Relay real, el 14/10/2026: el Point Relais elegido, el número de seguimiento 73988975 con el enlace a la etiqueta PDF, el estado Sendcloud y el método de envío «Mondial Relay» escrito por el módulo. Captura de la interfaz en inglés.
01

Lo que hace el módulo

  • En la ficha del envío, una línea «Point Relais® Mondial Relay»: búsqueda de Points Relais y Lockers alrededor del código postal de entrega, con nombre, dirección, distancia y horario de apertura. El punto elegido se vuelve a leer en Sendcloud antes de guardarse.
  • «Crear la etiqueta Mondial Relay» en un envío validado: el módulo se queda con la opción Mondial Relay que corresponde al punto (Point Relais, Locker, o entrega a domicilio si usted la autoriza), la más barata que ofrece su cuenta Sendcloud, y nunca una opción sin etiqueta impresa.
  • La etiqueta PDF se guarda en los documentos del envío. El número de seguimiento y el método de envío «Mondial Relay» se escriben en el envío.
  • Estado Sendcloud del paquete a petición, y anulación de la etiqueta con petición de confirmación.
  • En la lista de envíos, la acción masiva «Etiquetas Mondial Relay» crea una etiqueta por cada envío listo y reúne los PDF en un archivo zip.
  • Comprobaciones antes de cualquier petición a Sendcloud: envío validado, peso (el del envío; si no, la suma de los productos, 10 g mínimo), direcciones del remitente y del destinatario, teléfono para la entrega a domicilio.
  • Destinatario: el contacto «entrega» del envío o de su pedido; si no, el tercero. Remitente: la dirección de su empresa en Dolibarr.
  • Modo de prueba, marcado por defecto: etiquetas de prueba de Sendcloud gratuitas, sin transportista, para probar todo el proceso. No se envía nada a Mondial Relay y el número de seguimiento no se escribe en el envío.
02

Para quién es

Dolibarr no conoce Mondial Relay: ningún método de envío con ese nombre, ninguna búsqueda de Point Relais, ninguna etiqueta. La etiqueta se prepara fuera de Dolibarr, y el número de seguimiento hay que copiarlo a mano en el envío.

Desde 2026, el «Crear una cuenta» profesional de mondialrelay.fr lleva a un registro en Sendcloud. Esa cuenta no da credenciales para las API directas de Mondial Relay: para crear etiquetas desde Dolibarr, hay que pasar por la API de Sendcloud. Eso es lo que hace el módulo.

Para quién es: Tiendas y empresas que envían paquetes a Points Relais o Lockers de Mondial Relay y gestionan sus pedidos y envíos en Dolibarr.

03

Lo que el módulo no hace

Este apartado figura en las 21 fichas de módulos, sin excepción.

  • Solo Mondial Relay, a través de Sendcloud: hace falta una cuenta Sendcloud (la cuenta profesional abierta en mondialrelay.fr lo es) y sus claves de API.
  • Las etiquetas reales las factura Sendcloud, a las tarifas de su cuenta, y exigen un medio de pago registrado en Sendcloud. El módulo no muestra el precio antes de la creación.
  • Un paquete por envío. Sin devoluciones, sin envíos en varios paquetes.
  • El Point Relais se elige en Dolibarr, no lo elige el cliente en su sitio web.
  • Las etiquetas de un lote se reúnen en un zip, no se fusionan en un único PDF.
  • Una etiqueta anulada solo se reembolsa si Sendcloud acepta la anulación antes de la fecha límite del transportista.
  • Las pruebas se hicieron con envíos de Francia a Francia.
04

Cómo funciona

Todo ocurre en la ficha del envío de Dolibarr, y en la lista de envíos.

La elección del punto

En la ficha del envío se añade una línea «Point Relais® Mondial Relay». El lápiz abre la búsqueda alrededor del código postal de entrega: los Points Relais y los Lockers, con el nombre, la dirección, la distancia y el horario de apertura. El punto elegido se vuelve a leer en Sendcloud antes de guardarse, con su tipo: comercio o Locker.

La etiqueta

En un envío validado, «Crear la etiqueta Mondial Relay»:

  1. el módulo pide a Sendcloud las opciones de envío Mondial Relay para ese peso, del país del remitente al del destinatario;
  2. se queda con la que corresponde al punto —Point Relais, Locker, o entrega a domicilio si usted la ha autorizado—, la más barata que ofrece su cuenta, y nunca una opción sin etiqueta impresa;
  3. crea el envío en Sendcloud y guarda la etiqueta PDF en los documentos del envío;
  4. escribe el número de seguimiento y el método de envío «Mondial Relay» en el envío.

Después, «Actualizar el estado» muestra el estado Sendcloud del paquete, y «Anular la etiqueta» pide la anulación a Sendcloud, tras confirmación.

Varios paquetes a la vez

En la lista de envíos, la acción masiva «Etiquetas Mondial Relay» lista los envíos seleccionados («Pendiente», «Ya creada»), crea una etiqueta por cada envío listo y después ofrece «Descargar las etiquetas (zip)».

Las comprobaciones antes de cualquier llamada

No se envía nada a Sendcloud mientras falte uno de estos puntos:

Comprobación Detalle
Envío validado el envío debe estar validado antes de crear la etiqueta
Point Relais elegido salvo si la entrega a domicilio está autorizada
Peso el del envío; si no, la suma de los productos, 10 g mínimo
Dirección del remitente la dirección de su empresa en Dolibarr: dirección, código postal, ciudad, país
Dirección del destinatario el contacto «entrega» del envío o de su pedido; si no, el tercero
Teléfono obligatorio para la entrega a domicilio

El modo de prueba

Marcado por defecto, crea etiquetas de prueba de Sendcloud gratuitas y sin transportista, para probar todo el proceso antes del primer paquete. No se envía nada a Mondial Relay, el número de seguimiento no se escribe en el envío, y una insignia TEST lo recuerda. Desmarcado, el módulo crea etiquetas Mondial Relay reales, facturadas por Sendcloud a las tarifas de su cuenta.

Lo que se ha probado de verdad

El 14 de octubre de 2026, en Dolibarr 24.0.1, en modo real, el módulo creó la etiqueta Mondial Relay n.º 73988975: un paquete de 1 kg con destino a un Point Relais de Estrasburgo. El PDF se guardó en los documentos del envío, y el número de seguimiento y el método de envío se escribieron en el envío. La anulación se pidió desde el módulo el mismo día.

Las tres capturas proceden de la prueba real del 14 de octubre de 2026, en Dolibarr 24.0.1, con la interfaz en inglés.

El envío después de crear la etiqueta real: a la derecha, «Shipping method: Mondial Relay» y «Tracking number: 73988975», escritos por el módulo; a la izquierda, el Point Relais NEUSHOP STRASBOURG, el número de seguimiento con el enlace a la etiqueta PDF, y el estado Sendcloud «Ready to send» (listo para enviar).

La elección del punto para el código postal 67100: dos comercios y un Locker, con la dirección, la distancia y el horario de apertura.

La elección del punto: Points Relais y Lockers de Mondial Relay alrededor del código postal de entrega, con dirección, distancia y horario de apertura.
La elección del punto: Points Relais y Lockers de Mondial Relay alrededor del código postal de entrega, con dirección, distancia y horario de apertura. Captura de la interfaz en inglés.
05

Ajustes

La página de configuración está reservada a los administradores.

Ajuste Por defecto Efecto
Clave pública de Sendcloud vacía Clave de la integración «Sendcloud API» de su cuenta.
Clave secreta de Sendcloud vacía Cifrada en la base de datos. Una vez guardada, no se vuelve a mostrar nunca: el campo indica «guardada (dejar vacío para conservarla)».
Modo de prueba (etiquetas gratuitas) marcado Etiquetas de prueba de Sendcloud, gratuitas y sin transportista. Desmarcado: etiquetas Mondial Relay reales, de pago.
Permitir la entrega a domicilio no Sin Point Relais elegido, la etiqueta se crea para entrega a domicilio. El teléfono del destinatario es entonces obligatorio.

El botón «Probar la conexión» busca Points Relais cerca de la dirección de su empresa e indica cuántos encuentra.

La configuración: clave pública y clave secreta de Sendcloud (la clave secreta no vuelve a mostrarse nunca), modo de prueba, entrega a domicilio y el resultado de «Test the connection».
La configuración: clave pública y clave secreta de Sendcloud (la clave secreta no vuelve a mostrarse nunca), modo de prueba, entrega a domicilio y el resultado de «Test the connection». Captura de la interfaz en inglés.
06

Seguridad y salvaguardas

  • Dos permisos propios: «Ver la información Mondial Relay de los envíos» y «Elegir el Point Relais, crear y anular las etiquetas Mondial Relay». Con el primero solo, la línea Mondial Relay es visible, sin ningún botón.
  • Además, el permiso de Dolibarr: las páginas de elección del punto y de etiquetas masivas exigen también el permiso de leer los envíos.
  • Clave secreta cifrada en la base de datos, nunca vuelve a mostrarse en la página de configuración.
  • Token anti-CSRF en cada formulario. En la ficha del envío, el módulo comprueba por sí mismo el token de las acciones de crear, actualizar y anular.
  • Anulación confirmada: una ventana recuerda que la etiqueta solo se reembolsa si la anulación se acepta antes de la fecha límite del transportista.
  • Llamadas salientes limitadas a panel.sendcloud.sc y servicepoints.sendcloud.sc, sin seguir redirecciones. Se utiliza el proxy configurado en Dolibarr, si lo hay.
  • Configuración reservada a los administradores.
07

Lo que se entrega

Lo que el módulo escribe en su instalación
Tablas creadas en la base de datosUna tabla: llx_dolixmr_envoi, una fila por envío (Point Relais elegido, envío Sendcloud, número de seguimiento, archivo de la etiqueta, estado, modo de prueba o real). Se añade un método de envío «Mondial Relay» al diccionario si no existe. Los ajustes son constantes de Dolibarr: DOLIXMR_SC_PUBLIC, DOLIXMR_SC_SECRET (cifrada), DOLIXMR_MODE_TEST y DOLIXMR_DOMICILE.
PermisosDos permisos: «Ver la información Mondial Relay de los envíos» y «Elegir el Point Relais, crear y anular las etiquetas Mondial Relay». Con el primero solo, la línea Mondial Relay del envío es visible, sin ningún botón. La página de elección del punto y la página de etiquetas masivas exigen también el permiso de Dolibarr de leer los envíos. La página de configuración está reservada a los administradores.
Desinstalación
  • Desactive el módulo en ConfiguraciónMódulos. La línea Mondial Relay, los botones y la acción masiva desaparecen.
  • No se elimina nada: la tabla llx_dolixmr_envoi, los ajustes y el método de envío «Mondial Relay» permanecen en la base de datos.
  • Las etiquetas PDF permanecen en los documentos de los envíos, y los números de seguimiento en los envíos.

La carpeta dolixmondialrelay, en PHP legible, bajo licencia GPL v3 o posterior: el descriptor del módulo, la clase de llamada a Sendcloud, la clase de los envíos, los hooks de la ficha y de la lista de envíos, la página de elección del punto, la página de etiquetas masivas, la página de configuración, el script SQL de la tabla, los iconos.

  • Idiomas: francés (fr_FR), inglés (en_US), alemán (de_DE) y español (es_ES).
  • Un README.md que describe el funcionamiento y los límites.
  • Un ChangeLog.md.
  • Se añade una tabla: llx_dolixmr_envoi. Guarda una fila por envío: Point Relais elegido, envío Sendcloud, número de seguimiento, nombre del archivo de la etiqueta, estado, modo de prueba o real.
  • Lo que se escribe en el envío, para una etiqueta real: el número de seguimiento y el método de envío «Mondial Relay». La etiqueta PDF se guarda en sus documentos.
  • Lo que se envía a Sendcloud: los nombres, direcciones, teléfonos y emails del remitente y del destinatario cuando están rellenados, el peso, la referencia del envío, la opción de envío y el punto elegido; para la búsqueda de puntos, el país, el código postal y el peso.
  • Se añade un método de envío «Mondial Relay» al diccionario si no existe.
  • No se modifica ningún archivo de Dolibarr.
08

Compatibilidad

El descriptor del módulo solo declara una versión mínima. En el código no figura ningún límite superior: las versiones siguientes son aquellas en las que el módulo se ha ejecutado de verdad.

Compatibilidad del módulo Etiquetas Mondial Relay (Sendcloud)
Versiones de DolibarrDolibarr 19.0 mínimo. Instalado y ejecutado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4 y 24.0.1.
PHP mínimo7.4
Módulos de Dolibarr que activarExpediciones
LicenciaGPL v3 o posterior, código fuente completo
IdiomasFrancés, inglés, alemán, español
MenúNinguna entrada de menú. Línea «Point Relais® Mondial Relay» y botones en la ficha del envío; acción masiva «Etiquetas Mondial Relay» en la lista de envíos.
09

Instalación

  1. Obtenga el módulo en el DoliStore y descargue el archivo zip.
  2. En Dolibarr: InicioConfiguraciónMódulospestaña «Instalar módulo externo», y suba el zip. Si no, descomprima la carpeta dolixmondialrelay en htdocs/custom/.
  3. Active «Etiquetas Mondial Relay (Sendcloud)». Dolibarr activa también el módulo Expediciones si no lo está. Se crea la tabla y se añade el método de envío «Mondial Relay».
  4. En Sendcloud: SettingsIntegrations«Sendcloud API»Connect, para obtener la clave pública y la clave secreta. Para etiquetas reales, registre un medio de pago en Sendcloud (SettingsBilling).
  5. En la página de configuración del módulo: introduzca las dos claves, deje el modo de prueba marcado para los primeros intentos, permita o no la entrega a domicilio y después haga clic en «Probar la conexión».
  6. Compruebe la dirección completa de la empresa (InicioConfiguraciónEmpresa/Organización): es la dirección del remitente. Conceda los dos permisos a los usuarios correspondientes.

El detalle — permisos de la carpeta custom, alojamiento compartido, actualizaciones, desinstalación — está en la página Instalación y actualizaciones.

10

Preguntas frecuentes

¿En qué versiones de Dolibarr funciona este módulo?

El descriptor exige Dolibarr 19.0 como mínimo y PHP 7.4 como mínimo. El módulo se ha instalado y ejecutado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4 y 24.0.1. Si utiliza otra versión y tiene alguna duda, escriba antes de comprar.

¿Qué cuenta necesito?

Una cuenta Sendcloud, con sus claves de API. Cuando crea una cuenta profesional en mondialrelay.fr, llega a un registro en Sendcloud: es la misma cuenta. Las pruebas se hicieron con una cuenta Sendcloud en el plan gratuito. Para etiquetas reales, debe haber un medio de pago registrado en Sendcloud.

¿Cuánto cuesta una etiqueta?

El precio es el de su cuenta Sendcloud: es Sendcloud quien factura la etiqueta, no Dolix. El módulo no muestra ese precio antes de la creación. En modo de prueba, las etiquetas son gratuitas.

¿El módulo ya ha creado una etiqueta Mondial Relay real?

Sí. El 14 de octubre de 2026, en Dolibarr 24.0.1 y en modo real, creó la etiqueta Mondial Relay n.º 73988975, para un paquete de 1 kg con destino a un Point Relais de Estrasburgo: PDF guardado en los documentos del envío, número de seguimiento y método de envío escritos en el envío. La anulación se pidió desde el módulo el mismo día. Las demás pruebas usaron el modo de prueba de Sendcloud.

Point Relais o Locker: ¿cómo elige el módulo la opción de envío?

Sendcloud indica para cada punto si es un comercio o un Locker, y cada tipo tiene su propia opción de envío. El módulo guarda el tipo del punto elegido y se queda con la opción correspondiente, la más barata que ofrece su cuenta. Las opciones sin etiqueta impresa (código QR) se descartan: el módulo produce un PDF para imprimir.

¿Y si lo desinstalo?

La línea Mondial Relay, los botones y la acción masiva desaparecen. No se elimina nada: la tabla, los ajustes y el método de envío permanecen, al igual que las etiquetas PDF y los números de seguimiento ya escritos en los envíos.

¿Quién se encarga del soporte y cómo funcionan las actualizaciones?

El soporte lo presta la persona que escribió el módulo, en support@dolix.fr. El pedido, el pago, la factura y la descarga corren a cargo del DoliStore, donde se publican las nuevas versiones.

11

Historial de versiones

Tomado del archivo ChangeLog.md del módulo: una sola fuente.

1.0.23 de noviembre de 2026

Interfaz traducida al español (es_ES). Incluye también la corrección 1.0.1, que nunca se publicó por separado: los apóstrofos duplicados que envía Mondial Relay en el nombre o la dirección de un Point Relais («ROUTE D''ALTENHEIM») se muestran y se guardan ahora con normalidad («ROUTE D'ALTENHEIM»). Probado en 19.0.4 a 24.0.2 con Dolibarr en español.

1.0.014 de octubre de 2026

Primera versión, a través de la API de Sendcloud: elección del Point Relais® o del Locker, etiqueta PDF guardada en los documentos del envío, opción Mondial Relay elegida según el punto, número de seguimiento y método de envío «Mondial Relay» escritos en el envío. Estado a petición, anulación con confirmación, acción masiva con zip de las etiquetas. Modo de prueba gratuito. Comprobaciones antes de cualquier petición. Clave secreta cifrada en la base de datos. Interfaz en francés, inglés y alemán.

12

Soporte de este módulo

Escriba a support@dolix.fr. Responde la persona que escribió el módulo.

Respuesta en un plazo de dos días laborables. No es un servicio de guardia.

Qué incluir en su mensaje

  • La versión exacta de Dolibarr.
  • El módulo afectado y su versión — aquí dolixmondialrelay 1.0.2.
  • Lo que ha hecho, y lo que esperaba.
  • El mensaje de error copiado tal cual, o una captura de pantalla.
  • Cómo está instalado Dolibarr, si lo sabe.

Este módulo está a la venta en el DoliStore.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Comprar en el DoliStore — 79 € sin IVA
También

Los demás módulos