Bienvenue dans le guide d'intégration de Gelato Connect avec Cloudprinter. Cette intégration permet une communication fluide entre les deux plateformes, vous permettant de recevoir des commandes de Cloudprinter et de les traiter efficacement via GelatoConnect. Suivez ces étapes simples pour configurer l'intégration et commencer à gérer les commandes Cloudprinter en quelques minutes ou heures (contre des mois)
Il y a 3 étapes pour recevoir et traiter les commandes Cloudprinter avec GelatoConnect :
Configurez l'intégration de l'API pour permettre la communication.
Ajoutez le catalogue des produits de Cloudprinter à GelatoConnect.
Configurez des workflows de production pour un traitement sans accroc.
Étape 1 : intégration de l’API
La première étape consiste à connecter les systèmes via l’API. Cela permet aux commandes et aux mises à jour de circuler facilement entre GelatoConnect et Cloudprinter.
Créez les interfaces Production et Signaux dans Cloudprinter :
Dans votre compte Cloudprinter, créez une interface de production appelée "GelatoConnect API - Dev" : sélectionnez le modèle "Votre propre API". Dans le champ Hôte, indiquez simplement "www.gelato.com", et dans le champ Adresses IP, saisissez "184.169.223.162". Configurez le reste selon les instructions d'aide de Cloudprinter. Mettez cette configuration en "mode test" et en priorité basse, afin que les commandes réelles ne passent pas par cette connexion.
Dans votre compte Cloudprinter, créez une interface Signals appelée "GelatoConnect Signals - Dev". Configurez-la avec une priorité basse, car elle sert uniquement aux tests.
Créer le client « Cloudprinter » dans GelatoConnect :
Connectez-vous à GelatoConnect.
Naviguez vers la section Clients dans le menu de gauche.
Cliquez sur Créer un client et nommez le client Cloudprinter.
Sélectionnez Appliquer les préréglages pour Cloudprinter pour charger automatiquement les paramètres.
Dans la fenêtre qui s'affiche, copiez et collez les clés API des interfaces Production et Signals que vous avez créées dans Cloudprinter à l'étape 1.
Autoriser la communication :
GelatoConnect générera un hôte de point de terminaison lorsque vous saisirez les clés API dans la fenêtre contextuelle.
Copiez ce point de terminaison et collez-le dans le champ « Hôte » de l’interface de production (en remplaçant le nom d’hôte fictif « www.gelato.com » que vous avez ajouté à l’étape 1).
Créer un mappage de méthode d'expédition :
Créez une table de correspondance dans GelatoConnect pour associer les méthodes d'expédition Cloudprinter aux méthodes d'expédition Gelato. Utilisez les instructions ici et le fichier Excel joint pour effectuer cette correspondance
Dans votre modèle de soumission de commande, il se peut que vous deviez remplacer la ligne suivante en bas du modèle :
\"shipmentMethodUid\": ##{{ order.shipping.method|js }},avec :
"shipmentMethodUid": ##{{ lookups({"alias": order.shipping.method}, strict=False, default="")|js }},où « alias » renvoie au champ du modèle défini comme ##{{alias}} dans votre recherche.
Une fois terminé, les systèmes sont synchronisés. Les points de terminaison API nécessaires pour des tâches comme la soumission et la mise à jour des commandes sont préconfigurés, ce qui garantit une communication automatique.
Étape 2 : configurer les produits Cloudprinter
Ensuite, vous importerez le catalogue des produits de Cloudprinter dans GelatoConnect.
1. Accéder aux modèles de produits :
Allez dans la section Produits dans le menu de gauche et cliquez sur Modèles de produits.
Cliquez sur Ajouter depuis le catalogue > Ajouter depuis le client, et sélectionnez Cloudprinter.
2. Téléchargez les fichiers de référence depuis Cloudprinter :
Dans un nouvel onglet, connectez-vous à votre compte Cloudprinter.
Accédez à Catalogue des produits > Télécharger les références.
Téléchargez les deux fichiers requis : Référence des produits et Référence des options.
3. Téléchargez les fichiers de référence dans GelatoConnect :
Glissez-déposez les fichiers téléchargés dans la zone de dépôt sur GelatoConnect.
GelatoConnect affichera tous les produits pour lesquels votre compte Cloudprinter est configuré.
4. Sélectionner les catégories de produits :
Consultez la liste des produits (elle peut varier selon votre compte Cloudprinter).
Choisissez les catégories que vous souhaitez produire (par exemple, papiers à lettres, brochures, etc.).
5. Associez les types de papier :
Sélectionnez les types de papier appropriés pour chaque produit.
Si vous avez des accords particuliers avec Cloudprinter pour du stock personnalisé, vous pouvez ajuster l'association ici.
Sinon, nous vous conseillons d'utiliser les correspondances par défaut.
6. Générer des produits et des variantes :
Cliquez sur Continuer pour générer les modèles de produits sélectionnés.
GelatoConnect créera automatiquement des produits avec des attributs associés et des identifiants internes pour la production.
Une fois terminé, vous pouvez consulter le produit créé et examiner des détails comme l’association du papier, les options de finition et les identifiants uniques du produit.
Étape 3 : configurer les flux de production
Enfin, configurez ou mettez à jour vos flux de travail pour qu'ils correspondent à vos capacités de production.
Accédez à la configuration de production :
Utilisez l’outil de configuration de production dans GelatoConnect pour définir les étapes de production (par exemple, impression, plastification, reliure) pour chaque catégorie de produit (par exemple, cartes de visite, livres brochés).
Assurez-vous que tous les formats Cloudprinter disposent d'une configuration de production définie et active.
Pour obtenir des conseils détaillés et une vidéo sur la configuration de la production, veuillez consulter l'étape correspondante dans le guide d'intégration ici.
Étape 4 : Activer les commandes en direct depuis Cloudprinter
Créez des commandes test via le Test Center de Cloudprinter ou en contactant directement l’équipe Cloudprinter. Vérifiez la réception de la commande et le fichier pour vous assurer qu’ils sont prêts à être produits.
Envoyer les grilles tarifaires d'expédition à Cloudprinter
Demandez le fichier de la grille tarifaire Cloudprinter modifiable à votre responsable de l’implémentation GelatoConnect.
Remplissez-le et envoyez vos tarifs d'expédition mis à jour à Cloudprinter au début de l'intégration (et chaque année après les modifications des tarifs des transporteurs).
Informez l'équipe de Cloudprinter du processus de test et obtenez leur accord pour passer les commandes en direct sur GelatoConnect.
Passez à la réception des commandes en direct dans GelatoConnect :
Créez une nouvelle interface de production appelée "GelatoConnect API - Prod". Utilisez les mêmes paramètres que pour la connexion "GelatoConnect API - Dev" créée précédemment, mais choisissez la priorité la plus élevée et le "mode en direct" pour recevoir les commandes en temps réel.
Passez toutes les interfaces de production précédentes en « Mode test » afin que les commandes n'y soient plus envoyées.
Créez une nouvelle interface Signals appelée \"GelatoConnect Signals - Prod\". Utilisez les mêmes paramètres que la connexion \"GelatoConnect Signals - Dev\" créée précédemment, mais utilisez la priorité la plus élevée pour l'utiliser pour les commandes en direct