Welkom bij de handleiding voor het integreren van Gelato Connect met Cloudprinter. Deze integratie zorgt voor een naadloze communicatie tussen de twee platforms, waardoor je bestellingen van Cloudprinter kunt ontvangen en deze efficiënt kunt verwerken via GelatoConnect. Volg deze eenvoudige stappen om de integratie op te zetten en binnen enkele minuten of uren (in plaats van maanden) Cloudprinter-bestellingen te verwerken
Er zijn 3 stappen om Cloudprinter-bestellingen te ontvangen en te verwerken met GelatoConnect:
Stel API-integratie in om communicatie mogelijk te maken.
Voeg de productcatalogus van Cloudprinter toe aan GelatoConnect.
Configureer productieprocessen voor een naadloze verwerking.
Stap 1: API-integratie
De eerste stap is om de systemen via API te verbinden. Dit zorgt ervoor dat bestellingen en updates kunnen stromen tussen GelatoConnect en Cloudprinter.
Maak productie- en signaalinterfaces in Cloudprinter:
Ga in je Cloudprinter-account naar Productie-interface en maak er een aan met de naam "GelatoConnect API - Dev": Kies het sjabloon "Your own API". Vul bij Host alleen "www.gelato.com" in en bij IP-adressen "184.169.223.162". Volg verder de instructies van Cloudprinter. Zet deze verbinding op "testmodus" en geef een lage prioriteit zodat er geen echte bestellingen via deze route lopen.
Maak in je Cloudprinter-account een Signals-interface aan met de naam "GelatoConnect Signals - Dev". Zet deze op een lage prioriteit, want dit is alleen om te testen.
Maak klant "Cloudprinter" aan in GelatoConnect:
Log in op GelatoConnect.
Ga naar het gedeelte Klanten in het menu aan de linkerkant.
Klik op Create Customer en noem de klant Cloudprinter.
Selecteer Voorinstelling toepassen voor Cloudprinter om de instellingen automatisch te laden.
Kopieer en plak in het getoonde popup-venster de API-sleutels van de Productie- en Signalen-interfaces die je in stap 1 in Cloudprinter hebt aangemaakt.
Communicatie toestaan:
GelatoConnect genereert een endpoint host wanneer je de API-sleutels invoert in de pop-up
Kopieer dit endpoint en plak het in het veld "Host" van de Productie-interface, waarbij je de voorbeeldhostnaam "www.gelato.com" uit stap 1 vervangt.
Maak een verzendmethode-koppeling aan:
Maak een lookup in GelatoConnect om Cloudprinter verzendmethoden te koppelen aan Gelato verzendmethoden. Gebruik de instructies hier en het bijgevoegde Excel-bestand om de koppeling te maken
Binnen je bestelsjabloon moet je mogelijk de volgende rij onderaan het sjabloon vervangen:
"shipmentMethodUid": ##{{ order.shipping.method|js }},met:
"shipmentMethodUid": ##{{ lookups({"alias": order.shipping.method}, strict=False, default="")|js }},waarbij "alias" verwijst naar het sjabloonveld dat is ingesteld als ##{{alias}} in je zoekopdracht.
Zodra alles klaar is, zijn de systemen met elkaar verbonden. De benodigde API-eindpunten voor taken zoals het indienen en bijwerken van bestellingen zijn al ingesteld, zodat alles automatisch verloopt.
Stap 2: Cloudprinter-producten instellen
Vervolgens importeer je de productcatalogus van Cloudprinter in GelatoConnect.
1. Toegang tot productmodellen:
Ga naar de Producten sectie in het linkermenu en klik op Productmodellen.
Klik op Toevoegen uit catalogus > Toevoegen via klant, en selecteer Cloudprinter.
2. Download referentiebestanden van Cloudprinter:
Log in een nieuw tabblad in op je Cloudprinter-account.
Ga naar Productcatalogus > Referenties downloaden.
Download de twee benodigde bestanden: Products Reference en Options Reference.
3. Upload de referentiebestanden in GelatoConnect:
Sleep de gedownloade bestanden naar het uploadgebied in GelatoConnect.
GelatoConnect laat alle producten zien die zijn ingesteld in je Cloudprinter-account.
4. Selecteer productcategorieën:
Bekijk de productlijst (deze kan verschillen, afhankelijk van je Cloudprinter-account).
Kies de categorieën die je van plan bent te produceren (bijv. briefpapier, brochures, etc.).
5. Papiersoorten toewijzen:
Kies het juiste papiersoort voor elk product.
Als je speciale afspraken hebt met Cloudprinter voor gepersonaliseerde voorraad, kun je hier de toewijzing aanpassen.
Anders raden we aan om de standaardinstellingen te gebruiken.
6. Producten en varianten genereren:
Klik op Doorgaan om de gekozen productmodellen te genereren.
GelatoConnect maakt automatisch producten aan met gekoppelde eigenschappen en interne product-UID's voor de productie.
Als je klaar bent, kun je het aangemaakte product bekijken en details zoals papierkeuze, afwerkingsopties en product-UID's rustig onder de loep nemen.
Stap 3: je productieprocessen instellen
Stel tot slot je workflows in of werk ze bij zodat ze passen bij wat jij aankan in je productie.
Toegang tot productieconfiguratie:
Gebruik de tool productieconfiguratie in GelatoConnect om de productiestappen te bepalen (zoals printen, lamineren, bindwijze) voor elke productcategorie (zoals visitekaartjes, geniet boeken).
Zorg ervoor dat alle Cloudprinter-formaten een productieconfiguratie hebben die is ingesteld en actief is.
Voor een duidelijke uitleg en een video over het instellen van je productieconfiguratie, bekijk je de juiste stap in de onboardinggids hier.
Stap 4: Zet live bestellingen aan vanuit Cloudprinter
Maak testbestellingen aan via het Test Center van Cloudprinter of stem direct af met het Cloudprinter-team. Controleer de ontvangst van de bestelling en het bestand om zeker te weten dat alles klaar is voor productie.
Stuur verzendtariefkaarten naar Cloudprinter
Vraag het bewerkbare Cloudprinter-tarievenoverzicht op bij je GelatoConnect Implementation Manager
Vul het in en stuur je bijgewerkte verzendtarieven naar Cloudprinter aan het begin van de onboarding (en jaarlijks na wijzigingen in de tarieven van de vervoerder).
Informeer het team van Cloudprinter over het testproces en verkrijg hun toestemming om live bestellingen over te zetten naar GelatoConnect.
Schakel over naar het ontvangen van live bestellingen in GelatoConnect:
Maak een nieuwe productie-interface aan met de naam "GelatoConnect API - Prod". Gebruik dezelfde parameters als de verbinding "GelatoConnect API - Dev" die je eerder hebt gemaakt, maar kies de hoogste prioriteit en zet "Live modus" aan om de echte bestellingen te ontvangen.
Zet alle eerdere productie-interfaces op "Testmodus" zodat bestellingen daar niet meer terechtkomen.
Maak een nieuwe Signals-interface aan met de naam "GelatoConnect Signals - Prod". Gebruik dezelfde parameters als de eerder gemaakte "GelatoConnect Signals - Dev" verbinding, maar geef deze de hoogste prioriteit zodat deze gebruikt wordt voor live bestellingen.