Zum Hauptinhalt springen

[Auftragseingang – GCW] Integration von GelatoConnect mit Cloudprinter

Juliana Maciel Maruri da Cunha avatar
Verfasst von Juliana Maciel Maruri da Cunha
Vor über 2 Wochen aktualisiert

Willkommen zu unserem Leitfaden zur Integration von Gelato Connect mit Cloudprinter. Mit dieser Verbindung kommunizieren die beiden Plattformen reibungslos miteinander – so können Sie Bestellungen von Cloudprinter empfangen und effizient über GelatoConnect abwickeln. Folgen Sie einfach diesen Schritten, um die Integration einzurichten und Cloudprinter-Bestellungen in wenigen Minuten oder Stunden (statt in Monaten) zu bearbeiten.

So erhalten und bearbeiten Sie Cloudprinter-Bestellungen mit GelatoConnect in drei einfachen Schritten:

  1. Richten Sie die API-Integration ein, damit die Kommunikation reibungslos funktioniert.

  2. Fügen Sie den Produktkatalog von Cloudprinter zu GelatoConnect hinzu.

  3. Richten Sie Produktionsabläufe so ein, dass alles reibungslos läuft.


Schritt 1: API-Integration

Der erste Schritt ist, die Systeme über eine API zu verbinden. So können Bestellungen und Aktualisierungen reibungslos zwischen GelatoConnect und Cloudprinter ausgetauscht werden.

  1. Erstellen Sie Produktions- und Signalschnittstellen in Cloudprinter:

    • Erstellen Sie in Ihrem Cloudprinter-Konto eine Produktionsschnittstelle mit dem Namen "GelatoConnect API - Dev": Wählen Sie als Vorlage "Eigene API" aus. Geben Sie im Feld Host einfach "www.gelato.com" an und im Feld IP-Adressen "184.169.223.162". Richten Sie den Rest gemäß den Hilfsanweisungen von Cloudprinter ein. Stellen Sie sicher, dass diese Verbindung im "Testmodus" und mit niedriger Priorität läuft, damit keine Live-Bestellungen über diese Verbindung abgewickelt werden.

    • Erstellen Sie in Ihrem Cloudprinter-Konto eine Signals-Schnittstelle mit dem Namen „GelatoConnect Signals - Dev“. Legen Sie diese Schnittstelle mit niedriger Priorität an, da sie nur zu Testzwecken dient.

  2. Kunden "Cloudprinter" in GelatoConnect anlegen:

    • Melden Sie sich bei GelatoConnect an.

    • Wechseln Sie im linken Menü zum Bereich Kunden.

    • Klicken Sie auf Kunden erstellen und benennen Sie den Kunden Cloudprinter.

    • Wählen Sie Voreinstellung für Cloudprinter anwenden, um die Einstellungen automatisch zu laden.

    • Kopieren Sie im angezeigten Popup die API-Schlüssel aus den Bereichen Produktion und Signale, die Sie in Cloudprinter im ersten Schritt erstellt haben, und fügen Sie sie ein.

  3. Kommunikation autorisieren:

    • GelatoConnect erstellt einen Endpunkt-Host, sobald Sie die API-Schlüssel im Pop-up eingeben.

    • Kopieren Sie diesen Endpunkt und fügen Sie ihn in das Feld „Host“ der Produktionsoberfläche ein (ersetzen Sie dabei den Platzhalter „www.gelato.com“, den Sie in Schritt 1 hinzugefügt haben).

  4. Erstellen Sie eine Zuordnung für Versandmethoden:

    • Erstellen Sie in GelatoConnect eine Zuordnung, um die Versandmethoden von Cloudprinter den Versandmethoden von Gelato zuzuordnen. Nutzen Sie dazu die Anweisungen in diesem Leitfaden und die beigefügte Excel-Datei für die Zuordnung.

    • In Ihrer Bestellvorlage müssen Sie möglicherweise die folgende Zeile am Ende der Vorlage ersetzen:

      "shipmentMethodUid": ##{{ order.shipping.method|js }},

      mit:

      "shipmentMethodUid": ##{{ lookups({"alias": order.shipping.method}, strict=False, default="")|js }},

      wobei „alias“ auf das Vorlagenfeld verweist, das in Ihrer Suche als ##{{alias}} festgelegt ist.

Sobald alles eingerichtet ist, sind die Systeme miteinander verbunden. Die erforderlichen API-Endpunkte für Aufgaben wie das Übermitteln und Aktualisieren von Bestellungen sind bereits vorkonfiguriert, sodass die Kommunikation automatisch abläuft.


Schritt 2: Cloudprinter-Produkte einrichten

Als Nächstes importieren Sie den Produktkatalog von Cloudprinter in GelatoConnect.

1. Greifen Sie auf Produktmodelle zu:

  • Gehen Sie im linken Menü zum Bereich Produkte und klicken Sie auf Produktmodelle.

  • Klicken Sie auf Aus Produktkatalog hinzufügen > Aus Kunden hinzufügen und wählen Sie Cloudprinter aus.

2. Referenzdateien von Cloudprinter herunterladen:

  • Öffnen Sie einen neuen Tab und melden Sie sich bei Ihrem Cloudprinter-Konto an.

  • Wechseln Sie zu Produktkatalog > Referenzen herunterladen.

  • Laden Sie die beiden benötigten Dateien herunter: Products Reference und Options Reference.

3. Laden Sie die Referenzdateien in GelatoConnect hoch:

  • Ziehen Sie die heruntergeladenen Dateien einfach per Drag & Drop in den Upload-Bereich von GelatoConnect.

  • GelatoConnect zeigt Ihnen alle Produkte an, die in Ihrem Cloudprinter-Konto eingerichtet sind.

4. Wählen Sie Produktkategorien aus:

  • Überprüfen Sie die Produktliste (diese kann je nach Ihrem Cloudprinter-Konto unterschiedlich sein).

  • Wählen Sie die Kategorien aus, die Sie produzieren möchten (zum Beispiel Briefköpfe, Broschüren und mehr).

5. Papierarten zuordnen:

  • Wählen Sie die passenden Papiersorten für jedes Produkt aus.

  • Wenn Sie besondere Vereinbarungen mit Cloudprinter für personalisierte Lagerbestände haben, können Sie die Zuordnung hier anpassen.

  • Andernfalls empfehlen wir, die Standardzuweisungen zu verwenden.

6. Produkte und Varianten erstellen:

  • Klicken Sie auf Weiter, um die ausgewählten Produktmodelle zu erstellen.

  • GelatoConnect erstellt automatisch Produkte mit zugeordneten Attributen und internen Produkt-UIDs für die Produktion.

Sobald alles abgeschlossen ist, können Sie das erstellte Produkt ansehen und Details wie Papierzuordnung, Veredelungsoptionen und Produkt-UIDs überprüfen.


Schritt 3: Produktionsabläufe einrichten

Abschließend: Richten Sie Ihre Arbeitsabläufe so ein oder passen Sie sie an, dass sie zu Ihren Produktionsmöglichkeiten passen.

  1. Zugriff auf die Produktionseinstellungen:

    • Verwenden Sie das Tool zur Produktionskonfiguration in GelatoConnect, um die einzelnen Produktionsschritte (z. B. Drucken, Laminieren, Bindung) für jede Produktkategorie (z. B. Visitenkarten, geheftete Bücher) festzulegen.

    • Stellen Sie sicher, dass für alle Cloudprinter-Formate eine Produktionskonfiguration festgelegt und aktiviert ist.

Ausführliche Anleitungen und ein Video zur Einrichtung der Produktionskonfiguration finden Sie im entsprechenden Schritt des Onboarding-Guides hier.


Schritt 4: Live-Bestellungen von Cloudprinter aktivieren

  1. Erstellen Sie Testaufträge über das Test Center von Cloudprinter oder stimmen Sie sich direkt mit dem Cloudprinter-Team ab. Prüfen Sie den Auftragseingang und die Datei, um sicherzustellen, dass alles bereit für die Produktion ist.

  2. Versenden Sie Versandpreiskarten an Cloudprinter

    1. Fordern Sie die bearbeitbare Cloudprinter-Preisliste bei Ihrem GelatoConnect Implementation Manager an.

    2. Füllen Sie das Formular aus und senden Sie Ihre aktualisierten Versandkosten zu Beginn des Onboardings (und danach jährlich nach Änderungen der Versandtarife) an Cloudprinter.

  3. Informieren Sie das Team von Cloudprinter über den Testprozess und holen Sie deren Zustimmung ein, um Live-Bestellungen auf GelatoConnect umzustellen.

  4. Wechseln Sie dazu, Live-Bestellungen in GelatoConnect zu empfangen:

    1. Erstellen Sie eine neue Produktionsschnittstelle mit dem Namen „GelatoConnect API - Prod“. Verwenden Sie die gleichen Parameter wie bei der zuvor eingerichteten Verbindung „GelatoConnect API - Dev“, aber wählen Sie die höchste Priorität und den „Live-Modus“, um die echten Bestellungen zu erhalten.

    2. Stellen Sie alle bisherigen Produktionsschnittstellen auf "Testmodus" um, damit keine Bestellungen mehr dorthin gelangen.

    3. Erstellen Sie eine neue Signals-Schnittstelle mit dem Namen „GelatoConnect Signals - Prod“. Verwenden Sie die gleichen Parameter wie bei der zuvor eingerichteten Verbindung „GelatoConnect Signals - Dev“, aber geben Sie ihr die höchste Priorität, damit sie für Live-Bestellungen genutzt wird.

Hat dies deine Frage beantwortet?