El Deliveo Website Plugin (DWP) es un módulo de Deliveo que se puede integrar en una página web y que permite a los visitantes o clientes de la página web enviar directamente sus envíos, consultar sus envíos existentes y, en función de las funciones habilitadas, realizar otras operaciones.
El DWP se conecta al sistema a través de la API de Deliveo, por lo que para utilizarlo es necesario disponer de una suscripción activa a Deliveo y acceso a la API.
El módulo se puede integrar en una página web propia, por lo que resulta especialmente útil para los servicios de mensajería que desean que sus clientes puedan registrar o consultar envíos sin necesidad de registrarse ni de utilizar el Portal del Cliente de Deliveo.
Funciones principales
Entre otras cosas, el DWP ofrece las siguientes funciones:
-
creación de un nuevo envío;
-
selección de la opción de envío;
-
selección de un punto de recogida;
-
gestión del pago contra reembolso;
-
uso del número de referencia y del código de seguimiento;
-
Gestión de los campos personalizados OP1–OP3;
-
cálculo de las tarifas de envío;
-
cálculo del peso volumétrico;
-
Pago en línea con Barion;
-
Consulta de envíos;
-
visualización de la información de seguimiento;
-
descarga de etiquetas;
-
descarga del formulario de firma;
-
modificación o cancelación del envío, en los casos en que esté permitido;
-
iniciar la devolución de un envío entregado.
Algunas de las funciones disponibles se pueden activar o desactivar en la configuración.
Envío de envíos
Una de las funciones principales del DWP es la creación de nuevos envíos. En la interfaz de envío, el usuario puede introducir los datos necesarios para el transporte del envío y, a continuación, el DWP los transmite al sistema de Deliveo.
Datos del remitente
En los datos del remitente se pueden introducir los datos necesarios para el punto de recogida del envío y la persona de contacto. Entre ellos pueden figurar, por ejemplo:
-
nombre;
-
razón social;
-
país;
-
código postal;
-
localidad;
-
dirección;
-
número de teléfono;
-
dirección de correo electrónico.
Los campos que aparecen realmente pueden variar en función de la versión y la configuración de DWP.
Datos del destinatario
En los datos del destinatario hay que indicar la información necesaria para la entrega. Al igual que en el caso del remitente, aquí también se pueden introducir los datos de contacto y la dirección del destinatario.
Uso de un punto de recogida
El DWP es capaz de mostrar las ubicaciones activas del tipo «Punto de recogida» creadas en Deliveo. El «Punto de recogida» se puede seleccionar por separado:
-
en la página de recogida;
-
en la página de entrega.
De este modo, el envío puede partir de un punto de recogida, llegar a un punto de recogida o, dependiendo de las opciones que ofrezca el servicio de mensajería, utilizarse en ambos lados. El DWP importa los puntos de recogida directamente desde el sistema de Deliveo, por lo que su gestión no se realiza en el DWP, sino en los datos maestros correspondientes de Deliveo.
Gestión del titular de la factura
El DWP se puede utilizar de dos maneras, dependiendo de si todos los envíos web pertenecen al mismo cliente.
Uso de un cliente fijo
En la configuración se puede especificar un ID de cliente fijo. En este caso:
-
todos los envíos creados desde el DWP se asignarán a este cliente;
-
no se muestra al visitante un bloque específico de «Pagador»;
-
la relación de facturación la determina el cliente especificado en la configuración.
Esto se puede utilizar en sitios web en los que el DWP se proporciona a un único cliente contratado.
Creación de un cliente a partir de los datos introducidos
Si no hay ningún cliente fijo configurado, el visitante puede introducir los datos del pagador de la factura. A partir de ellos, el DWP comprueba si ya existe el cliente correspondiente en el sistema de Deliveo.
Si lo encuentra, utilizará el cliente existente. Si no encuentra ningún cliente adecuado, el DWP lo creará a partir de los datos facilitados y, a continuación, vinculará el nuevo envío a dicho cliente.
Contenido del envío y «Collis»
Un envío puede constar de uno o varios paquetes físicos, es decir, «Collis». En el DWP se pueden añadir varios «Collis» al mismo envío. Para cada uno de los «Collis» se pueden indicar, entre otros datos:
-
peso;
-
longitud;
-
anchura;
-
altura;
-
identificador único.
El DWP determina los datos totales del envío a partir de los datos de cada paquete.
Peso total y volumen total
Si se utilizan varios paquetes, el sistema suma su peso y su volumen. A partir de las dimensiones indicadas, el DWP calcula automáticamente el peso volumétrico.
Gracias al peso volumétrico, los paquetes de gran tamaño pero relativamente ligeros también se tienen debidamente en cuenta a la hora de calcular la tarifa.
Opciones de envío
Para el envío se puede seleccionar la opción de envío creada en Deliveo. El DWP importa las opciones de envío disponibles desde el sistema de Deliveo, por lo que su creación y gestión se realizan en el Portal del Dispachador.
Mediante la opción de envío, el servicio de mensajería puede ofrecer diferentes modalidades de servicio, por ejemplo, con distintas condiciones de entrega o recogida.
Pago contra entrega
El DWP permite registrar envíos contra reembolso. Si el envío incluye un reembolso, se puede indicar el importe del mismo y los datos relacionados. La gestión del reembolso en Deliveo se realiza siguiendo el proceso habitual de gestión de reembolsos.
Número de referencia y código de seguimiento
Se puede indicar lo siguiente para el envío:
-
Número de referencia;
-
Código de seguimiento.
Con ayuda de estos, se pueden vincular a la envío de Deliveo los identificadores propios de sistemas externos, tiendas online o procesos del cliente.
Campos específicos OP1–OP3
El DWP es compatible con los campos OP1, OP2 y OP3 de Deliveo. Se trata de campos de datos personalizados que pueden utilizarse para solicitar información adicional necesaria para el funcionamiento del servicio de mensajería. El nombre que se muestra para estos campos se puede modificar en la configuración, por lo que no es necesario que el visitante vea las denominaciones técnicas OP1, OP2 u OP3.
Cálculo de tarifas
El DWP puede solicitar la tarifa al sistema de Deliveo basándose en los datos del envío. Durante el cálculo de la tarifa se pueden tener en cuenta, entre otros, los siguientes datos:
-
la dirección de recogida y la de entrega;
-
la opción de envío;
-
el número de paquetes;
-
el peso;
-
el volumen;
-
peso volumétrico;
-
pago contra reembolso;
-
las condiciones tarifarias configuradas en Deliveo.
La tarifa real siempre viene determinada por la tarifa establecida en Deliveo.
Pago en línea con Barion
El DWP también se puede utilizar con el pago en línea a través de Barion. Si la integración con Barion está habilitada y el cálculo de tarifas de Deliveo devuelve un importe a pagar, el visitante puede abonar la tarifa del servicio en línea como parte del proceso de envío del paquete.
En este caso, el proceso es el siguiente:
-
El visitante rellena los datos del envío.
-
El DWP consulta el importe de la tarifa de envío.
-
El visitante realiza el pago a través de la interfaz de Barion.
-
Una vez realizado el pago con éxito, el DWP crea el envío en Deliveo.
De este modo, el sistema evita que se cree un envío sin pagar en caso de que el pago falle o se interrumpa.
Consulta de envíos
El DWP también dispone de una función específica para consultar envíos. Esta función se puede activar o desactivar por separado en la configuración. Para consultar un envío, el visitante debe introducir:
-
el DeliveoID;
-
el código postal del destinatario.
El uso conjunto de estos dos datos impide que cualquiera pueda consultar los datos del envío conociéndolos únicamente el DeliveoID.
Datos que aparecen al realizar la consulta
Tras una identificación satisfactoria, el DWP puede mostrar la información correspondiente al envío.
Entre ellos pueden figurar:
-
el estado actual del envío;
-
el historial del envío;
-
el contenido del paquete;
-
los datos del remitente;
-
los datos del destinatario;
-
la información de seguimiento;
-
la etiqueta del envío;
-
el albarán de entrega.
La visualización de los datos del remitente y del destinatario se puede configurar por separado.
Descarga de la etiqueta
La etiqueta correspondiente al envío consultado se puede descargar desde el DWP, si dicha función está disponible. Esto resulta útil, por ejemplo, cuando el remitente del envío desea imprimir y pegar él mismo la etiqueta del paquete.
Hoja de firma
También se puede habilitar la visualización o descarga del albarán de entrega relacionado con la entrega. Si la función está activa y existe un documento correspondiente para el envío, este estará disponible en la interfaz de consulta del DWP.
Modificación y eliminación de envíos
En el DWP se puede habilitar la modificación y la cancelación de envíos creados anteriormente. La función solo se puede utilizar si se ha habilitado en la configuración del DWP. Además, el envío debe cumplir las siguientes condiciones:
-
el mensajero aún no lo haya recogido;
-
aún no se ha entregado;
-
no se haya abonado.
Si se ha producido alguna de estas situaciones, no se permite modificar ni cancelar el envío desde el DWP.
Devolución
El DWP también permite iniciar la devolución de envíos entregados. Esta función se puede activar por separado. Si la devolución está disponible para un envío entregado, el DWP prepara el nuevo formulario de envío a partir de los datos del envío original.
En este proceso, los datos originales:
-
los datos del remitente pasan a ser los del destinatario de la devolución;
-
los datos del destinatario se convierten en los del remitente de la devolución
.
De este modo, el usuario no tiene que volver a introducir todos los datos de la dirección. La devolución supone, técnicamente, la creación de un nuevo envío.
Personalización de la apariencia
La apariencia del DWP es parcialmente configurable. Entre otras cosas, se puede configurar:
-
un logotipo propio;
-
el color del tema;
-
las funciones que se muestran;
-
nombres de los distintos campos;
-
nombre que se muestra de los campos OP1–OP3;
-
datos que aparecen en la página de seguimiento.
De este modo, se puede adaptar la apariencia del DWP a la página web de la empresa de mensajería.
Funcionamiento multilingüe
El DWP se puede utilizar en varios idiomas. Con los archivos de idioma adecuados, la misma instalación se puede utilizar en varias páginas web o para diferentes grupos de clientes en distintos idiomas.
Instalación
El DWP se puede instalar en un servidor web propio. Para la instalación, hay que copiar los archivos del programa en el directorio web correspondiente y, a continuación, crear y configurar el archivo de configuración. En la configuración hay que indicar, entre otras cosas:
-
los datos de conexión a la API de Deliveo;
-
las funciones que se deseen utilizar;
-
el ID de cliente fijo, si lo hay;
-
los ajustes de visualización;
-
los datos necesarios para el pago en línea;
-
otros parámetros de funcionamiento.
Las variables de configuración específicas necesarias para la instalación y el funcionamiento se encuentran en el archivo .env.example .
Descarga: https://gitlab.com/mav-it/deliveo-website-plugin
Demostración: https://dwp.deliveo.eu/
Requisitos del servidor
DWP es una aplicación basada en PHP. Se recomienda utilizar siempre una versión de PHP que aún cuente con soporte oficial.
El desarrollo y la corrección de errores de Deliveo se realizan para las versiones de PHP compatibles. No nos hacemos responsables de la corrección de errores de compatibilidad o de funcionamiento derivados del uso de versiones de PHP obsoletas o que ya no cuenten con soporte. El servidor web debe disponer de los complementos de PHP necesarios para el funcionamiento de DWP, así como de la posibilidad de establecer conexiones HTTPS externas.
Actualización
Tras instalar una nueva versión, es recomendable comparar el archivo .env.example con la configuración anterior, ya que, al aparecer nuevas funciones, pueden introducirse nuevas variables de configuración.
El plugin puede actualizarse automáticamente desde el sitio web https://gitlab.com/mav-it/deliveo-website-plugin. Para ejecutar la actualización, hay que añadir lo siguiente después de la URL de instalación: /update
Por ejemplo: dwp.example.com/update
Información importante
El DWP se basa en la API de Deliveo, por lo que los datos creados o consultados en el DWP proceden directamente del sistema de Deliveo. El DWP no es, en sí mismo, una base de datos independiente de servicios de mensajería, sino una interfaz web complementaria de Deliveo.
Por lo tanto, una parte significativa de los servicios disponibles, las opciones de envío, los puntos de recogida, las tarifas y otras reglas de negocio no deben configurarse en el DWP, sino en el portal de gestión de Deliveo.