P44 Connect

L'intégration peut être activée client par client ; par conséquent, seules les données relatives aux envois des clients Deliveo désignés sont transmises.

Conditions préalables

• abonnement à l'API Deliveo ;
• un abonnement à l'utilisation des webhooks Deliveo ;
• un compte Project44 actif ;
• une autorisation pour l'installation de l'extension ;
• droits d'accès pour la configuration et l'utilisation de l'extension.

Installation et accès

L'extension peut être installée sur le Portail des dispatchers, dans le menu « Extensions ».

Une fois installé, il est accessible via le menu « Extensions / Project44 Connect ». Seuls les utilisateurs disposant des autorisations appropriées peuvent procéder à l'installation et à l'utilisation de l'extension.

Menus propres à l'extension :

• Tableau de bord
• Clients
• Paramètres

Connexion au compte Project44

Lors de la connexion de l'extension, le système crée un utilisateur technique dans le compte Project44.

Pour terminer la connexion :

1. Ouvrez la gestion des utilisateurs de Project44.
2. Recherchez l'utilisateur dont le nom apparaît sur la page Paramètres de Project44 Connect.
3. Ouvrez les rôles de cet utilisateur.
4. Dans la section « Rôles », cliquez sur le bouton « Gérer les rôles ».
5. Ajoutez l'autorisation « Shipment management ».
6. Enregistrez la modification.

Sur la page « Paramètres » de Project44 Connect, un indicateur vert signale que la connexion a été établie avec succès.

Configuration de l'identifiant d'expédition transmis

Sur la page « Paramètres », vous pouvez choisir quel identifiant d'expédition Deliveo doit transmettre à Project44. Les identifiants disponibles sont les suivants :

• DeliveoIDL'identifiant primaire unique de vos envois dans le système Deliveo.
• Numéro de référence
• Code de suivi

Pour enregistrer la valeur sélectionnée, cliquez sur le bouton « Enregistrer la configuration de l'identifiant ». Ce paramètre ne modifie que l'identifiant transmis à Project44. Le mappage interne des événements entre Deliveo et Project44 continue de s'effectuer sur la base du DeliveoIDL'identifiant primaire unique de vos envois dans le système Deliveo..

Configuration des webhooks

Project44 Connect reçoit des notifications concernant les événements liés aux envois via la fonctionnalité de webhooks de Deliveo. Pour configurer cette fonctionnalité :

1. Ouvrez le menu Paramètres / Webhooks du portail du répartiteur.
2. Sélectionnez l'événement concerné.
3. Ouvrez les paramètres avancés de l'événement.
4. Copiez l'URL du webhook qui s'affiche pour cet événement sur la page « Paramètres » de Project44 Connect.
5. Enregistrez la configuration du webhook.
6. Répétez l'opération pour chaque événement concerné.

Une URL de webhook distincte est associée aux événements suivants :

• Création d'un envoi
• Prise en charge d'un envoi
• Transfert
• Livraison réussie
• Échec de la livraison

Les URL des webhooks sont uniques ; veillez donc à toujours utiliser les adresses indiquées sur la page « Paramètres » de votre installation Project44 Connect.

Sélection des clients

La page « Clients » vous permet de définir quels clients Deliveo doivent être transférés vers Project44.

Pour activer un client :

1. Ouvrez le menu « Clients ».
2. Recherchez le client dans la liste.
3. Activez le bouton « Actif » situé dans la ligne du client.

Lorsque ce bouton est activé, les événements d'expédition associés à ce client sont transférés. Lorsqu'il est désactivé, les données du client ne sont pas transférées vers Project44.

La liste des clients :

• peut être filtrée par nom ;
• le filtrage peut être désactivé ;
• peut être parcourue page par page s’il y a plusieurs pages.

Avant d'activer l'intégration, vérifiez que seuls les clients dont vous souhaitez transmettre les données sont bien actifs.

Événements transférés

Project44 Connect convertit les événements Deliveo en événements Project44.

Exemples de correspondance entre les événements :

• Création d’un envoi → SHIPMENT_CREATED
• Prise en charge d’un envoi → PICKED_UP
• Transfert d'un envoi → ARRIVED_AT_STOP
• Livraison réussie → DELIVERED
• Échec de la livraison → par exemple DELIVERY_MISSED ou RETURN_TO_SENDER

L'événement Project44 correspondant à une livraison échouée peut dépendre de l'événement de livraison échouée enregistré dans Deliveo.

Tableau de bord

Le Tableau de bord affiche les requêtes webhook des 30 derniers jours.

La page regroupe, par type d'événement :

• les créations d'envois ;
• les enlèvements d'envois ;
• les transferts d'envois ;
• les livraisons réussies ;
• les tentatives de remise ;
• les livraisons infructueuses.

La liste détaillée des événements contient les données suivantes :

• ID Deliveo
• Événement Deliveo
• Événement P44
• Accepté
• Date

La colonne « Accepté » indique si Project44 a bien reçu l'événement envoyé.

La liste :

• peut être filtrée par ID Deliveo ;
• peut être parcourue page par page ;
• peut être utilisée pour vérifier l'ordre chronologique et rechercher des erreurs.

Vérification de la connexion

Une fois la configuration effectuée, il est recommandé de vérifier le bon fonctionnement à l'aide d'un envoi test.

1. Assurez-vous que le client associé à l'envoi est actif sur la page Clients.
2. Créez ou modifiez un envoi de manière à ce que l'un des événements Webhook configurés se produise.
3. Ouvrez le tableau de bord Project44 Connect.
4. Recherchez l'envoi à l'aide de l'identifiant Deliveo.
5. Vérifiez l'événement Deliveo et l'événement P44 associé.
6. Vérifiez que la colonne « Accepté » indique que la réception a bien eu lieu.

Suppression de la connexion

La connexion Project44 active peut être supprimée à l’aide du bouton « Supprimer la connexion » situé sur la page « Paramètres ».

Avant de supprimer la connexion, vérifiez que la transmission d'événements vers Project44 n'est plus nécessaire.

Après avoir supprimé la connexion, il est recommandé de vérifier également les paramètres du webhook associé à Project44 Connect dans le menu Paramètres → Webhooks de Deliveo, et de les supprimer si nécessaire.

Erreurs courantes

Les événements n'apparaissent pas sur le tableau de bord

Vérifiez :

• si la connexion est active ;
• si le client concerné est actif sur la page Clients ;
• si les webhooks nécessaires sont configurés ;
• si l'URL du webhook correspondant a bien été associée à l'événement concerné ;
• si l'événement s'est produit au cours des 30 derniers jours.

Project44 n'accepte pas l'événement

Vérifiez :

• si l'utilisateur technique de Project44 dispose des droits d'accès « Shipment management » ;
• si la connexion au compte Project44 est active ;
• si l'identifiant d'expédition transmis est disponible dans l'expédition ;
• quels événements Deliveo et P44 s’affichent sur le tableau de bord.

Les envois d'un client ne sont pas transférés

Ouvrez la page « Clients » et vérifiez que le bouton « Actif » correspondant à ce client est bien activé.

Un identifiant d'envoi erroné s'affiche dans Project44

Vérifiez l'identifiant d'envoi sélectionné sur la page « Paramètres ».

Les valeurs disponibles sont les suivantes :

• DeliveoIDL'identifiant primaire unique de vos envois dans le système Deliveo.
• Numéro de référence
• Code de suivi

Une fois la modification effectuée, cliquez sur le bouton « Enregistrer les paramètres d'identifiant ».

La transmission d'un type d'événement ne fonctionne pas

Vérifiez que le webhook correspondant à cet événement est bien configuré. Pour chaque type d'événement, vous devez utiliser l'URL spécifique qui s'affiche sur la page Project44 Connect.