La integración se puede activar por cliente, por lo que solo se transmiten los datos de los envíos correspondientes a los clientes de Deliveo seleccionados.
Requisitos previos
- una conexión a la API de Deliveo con suscripción;
- una suscripción al servicio de webhooks de Deliveo;
- una cuenta activa de Project44;
- autorización para instalar el complemento;
- autorización para configurar y utilizar el complemento.
Instalación y acceso
El complemento se puede instalar en el Portal del Dispachador, en el apartado «Complementos».
Tras la instalación, estará disponible en el menú «Complementos / Project44 Connect». Solo los usuarios con los permisos adecuados pueden realizar la instalación y utilizar el complemento.
Menús propios del complemento:
- Panel de control
- Clientes
- Configuración
Vincular la cuenta de Project44
Al conectar el complemento, el sistema crea un usuario técnico en la cuenta de Project44.
Para completar la conexión:
- Abre la gestión de usuarios de Project44.
- Busca el usuario que aparece en la página de configuración de Project44 Connect.
- Abre los roles de ese usuario.
- En la sección «Roles», haz clic en el botón «Manage Roles».
- Añade el permiso «Shipment management».
- Guarda los cambios.
En la página de configuración de Project44 Connect, un indicador de estado verde te mostrará que la conexión se ha establecido correctamente.
Configuración del identificador de envío reenviado
En la página de configuración, puedes seleccionar qué identificador de envío debe reenviar Deliveo a Project44. Los identificadores disponibles son:
- DeliveoID
- Número de referencia
- Código de seguimiento
Para guardar el valor seleccionado, haz clic en el botón «Guardar configuración de identificador». Esta configuración solo modifica el identificador que se envía a Project44. La asociación interna de eventos entre Deliveo y Project44 seguirá realizándose en función del DeliveoID.
Configuración de webhooks
Project44 Connect recibe notificaciones sobre los eventos de envío a través de la función de webhooks de Deliveo. Para configurarlo:
- Abre el menú «Configuración / Webhooks» del portal del despachador.
- Selecciona el evento en cuestión.
- Abre la configuración avanzada del evento.
- Copia la URL del webhook que aparece en la página de configuración de Project44 Connect para el evento en cuestión.
- Guarda la configuración del webhook.
- Repite el proceso para todos los eventos necesarios.
Hay una URL de webhook específica para los siguientes eventos:
- Creación de un envío
- Recogida de envío
- Traslado
- Entrega satisfactoria
- Entrega fallida
Las URL de los webhooks son únicas, por lo que debes utilizar siempre las direcciones que aparecen en la página de configuración de la instalación correspondiente de Project44 Connect.
Selección de clientes
En la página «Clientes» se puede configurar qué datos de los clientes de Deliveo se enviarán a Project44.
Para activar un cliente:
- Abre el menú «Clientes».
- Busca el cliente en la lista.
- Activa el interruptor «Activo» que se encuentra en la fila del cliente.
Cuando esté activado, se transmitirán los eventos de envío correspondientes a ese cliente. Cuando esté desactivado, los datos del cliente no se transmitirán a Project44.
La lista de clientes:
- se puede filtrar por nombre;
- el filtro se puede borrar;
- se puede navegar por las páginas si hay más de una.
Antes de activar la integración, comprueba que solo estén activos aquellos clientes cuyos datos desees transmitir.
Eventos transmitidos
Project44 Connect convierte los eventos de Deliveo en eventos de Project44.
Ejemplos de correspondencia de eventos:
- Creación de un envío →
SHIPMENT_CREATED - Recogida de envío →
PICKED_UP - Traslado de envío →
ARRIVED_AT_STOP - Entrega realizada con éxito →
DELIVERED - Entrega fallida → por ejemplo
DELIVERY_MISSEDoRETURN_TO_SENDER
El evento de Project44 correspondiente a una entrega fallida puede depender del evento de entrega fallida registrado en Deliveo.
Panel de control
El panel de control muestra las solicitudes de webhook de los últimos 30 días.
La página agrupa por tipo de evento:
- las creaciones de envíos;
- las recogidas de envíos;
- las transferencias de envíos;
- las entregas realizadas con éxito;
- los intentos de entrega;
- las entregas fallidas.
La lista detallada de eventos incluye los siguientes datos:
- ID de Deliveo
- Evento de Deliveo
- Evento P44
- Aceptado
- Fecha
La columna «Aceptado» indica si Project44 ha aceptado el evento enviado.
La lista:
- se puede filtrar por ID de Deliveo;
- se puede navegar por páginas;
- se puede utilizar para realizar comprobaciones cronológicas y detectar errores.
Comprobación de la conexión de datos
Tras la configuración, es recomendable comprobar el funcionamiento con un envío de prueba.
- Asegúrate de que el cliente asociado al envío esté activo en la página «Clientes».
- Crea o modifica un envío de modo que se produzca uno de los eventos de webhook configurados.
- Abre el panel de control de Project44 Connect.
- Busca el envío por su ID de Deliveo.
- Comprueba el evento de Deliveo y el evento de P44 asociado.
- Comprueba que la columna «Aceptado» indique que se ha recibido correctamente.
Desactivación de la conexión
La conexión activa con Project44 se puede cancelar mediante el botón «Eliminar conexión» de la página «Configuración».
Antes de eliminar la conexión, comprueba que ya no sea necesario el envío de eventos a Project44.
Tras eliminar la conexión, es recomendable comprobar también la configuración de los webhooks de Project44 Connect en el menú «Configuración» → «Webhooks» de Deliveo y, si es necesario, eliminarlos.
Errores frecuentes
No aparecen eventos en el panel de control
Comprueba:
- que la conexión esté activa;
- si el cliente en cuestión está activo en la página «Clientes»;
- que los webhooks necesarios estén configurados;
- si se ha asignado la URL de webhook correcta al evento correspondiente;
- que el evento haya tenido lugar en los últimos 30 días.
Project44 no acepta el evento
Comprueba:
- si el usuario técnico de Project44 tiene permisos de gestión de envíos;
- si la conexión con la cuenta de Project44 está activa;
- si el identificador de envío reenviado está disponible en el envío;
- qué eventos de Deliveo y P44 se muestran en el panel de control.
Los envíos de un cliente no se reenvían
Abre la página «Clientes» y comprueba si el interruptor «Activo» de ese cliente está activado.
Aparece un identificador de envío erróneo en Project44
Comprueba el identificador de envío seleccionado en la página «Configuración».
Los valores disponibles son:
- DeliveoID
- Número de referencia
- Código de seguimiento
Tras realizar los cambios, haz clic en el botón «Guardar configuración de identificador».
No funciona la transmisión de algún tipo de evento
Comprueba si el webhook correspondiente a ese evento está configurado por separado. Para cada tipo de evento, debes utilizar la URL específica que aparece en la página de Project44 Connect.