Extension du serveur

Une extension du serveur permet aux titulaires de licence 3PL de rajouter des fonctionnalités supplémentaires à Stoqflow comme l'ajout d'informations à une commande qui doivent être récupérées auprès d'un autre serveur ou valider en fonction de paramètres externes. La différence entre webhooks et une extension du serveur est que Stoqflow attendra la réponse du serveur ciblé avant de poursuivre.

Via Admin > Extension du serveur, l'extension du serveur peut être configurée et des hooks d'extension du serveur peuvent être créés et gérés.

Configurations de l'extension du serveur

Avant que l'extension du serveur puisse être utilisée, les configurations suivantes doivent être renseignées :

• Activé: Si l'extension du serveur est activé ou non
• URL : L'adresse URL à laquelle Stoqflow enverra des requêtes HTTP
• Clé secrète : Une clé unique utilisée pour sécuriser la communication entre Stoqflow et l'extension du serveur

Hooks de l'extension du serveur

Une extension du serveur hook consiste en un déclencheur et plusieurs filtres optionnels.

Déclencheurs

Pour chaque hook d'extension du serveur, un déclencheur doit être choisi. Il s'agit d'une événement dans lequel Stoqflow envoie une requête HTTP à l'adresse URL spécifiée. Les déclencheurs importants sont par exemple :

• Lorsqu'une livraison est enregistrée sur un ordre
• Lorsque une commande est modifiée

Filtres

Les filtres sont optionnels et peuvent être utilisés pour déterminer si Stoqflow doit contacter l'extension du serveur. Puisqu'il peut y avoir une latence dans le trafic HTTP entre Stoqflow et l'extension du serveur, il est préférable d'éviter ce trafic en créant des filtres qui permettent de sélectionner uniquement les commandes pour certaines boutiques.

Quand la extension du serveur est-elle contactée ?

Les hooks d'extension du serveur sont toujours exécutés avant que le déclencheur ne soit enregistré dans la base de données. Cela signifie qu'en cas de modification d'un ordre, l'extension du serveur (si nécessaire) peut apporter des modifications avant que l'ordre soit enregistré dans notre base de données.

Exemples

Une extension du serveur permet donc d'ajouter une série illimitée de fonctionnalités à Stoqflow. Voici quelques exemples de bonnes pratiques :

• Définir un transporteur préféré en fonction des paramètres dans l'application externe
• Ajouter des étiquettes de livraison personnalisées aux commandes qui peuvent ensuite être imprimées par Stoqflow

Utilisation d'une extension du serveur

Puisque la mise en place et l'utilisation d'une extension du serveur nécessitent une logique d'application sur mesure, il est préférable de contacter les développeurs de Stoqflow pour discuter de tous les aspects techniques.