Diese Anleitung erklärt die Verbindung mit Printful, wenn Printful unter Integrationen → Fulfillment ausdrücklich als verfügbar angezeigt wird. Maßgeblich ist nur der aktuelle Bildschirm Integrationen für dein Konto. Dieser Artikel, ein Anbieter-Logo oder eine direkte URL beweisen die Verfügbarkeit nicht. Fehlt Printful dort oder ist es nicht verfügbar, höre hier auf: Es liegt außerhalb deines aktuellen Live-Umfangs.
Eine erfolgreiche Verbindung kann die Funktionen freigeben, die dein Printful-Token gewährt. Verhalten von Katalog, Bestellungen und Webhooks hängt trotzdem vom gewählten Shop, den Berechtigungen und dem aktuellen Integrationsstatus ab. Prüfe den vollständigen Ablauf einer zugeordneten Bestellung und eine angenommene Anbieter-Referenz, bevor du in Produktion gehst.
Wenn du erst das große Bild sehen möchtest, lies wie das Verbinden eines Anbieters funktioniert.
Bevor du anfängst
Ein wenig Vorbereitung in Printful sorgt dafür, dass die Verbindung reibungslos läuft.
- Halte ein Printful-Konto bereit, in dem Shop und Zahlungseinstellungen eingerichtet sind. Bestätige die Zahlungsdaten in Printful, bevor du eine Testbestellung und eine Anbieter-Referenz prüfst.
- Entscheide, aus welchem Printful-Shop Composerie das Fulfillment übernehmen soll. Hat dein Printful-Konto mehr als einen Shop, wählst du beim Verbinden den richtigen aus.
- Wenn du mit einem API-Schlüssel verbindest, erzeuge ein privates Token nur mit dem Zugriff, den die Einrichtungsschritte nennen: Bestellungen, Produkte und Webhooks. Prüfe diese Berechtigungen in Printful vor der Freigabe.
Der Weg über den API-Schlüssel kommt mit drei kurzen nummerierten Schritten: Shop und Zahlungsdaten einrichten, das Token erstellen, dann einfügen und deinen Shop wählen. Sie verlinken direkt auf das Printful-Dashboard und die Printful-API-Dokumentation, du kannst jeden Schritt also in einem neuen Tab öffnen und mitverfolgen.
Printful verbinden
Folge nur der Einrichtungsmethode, die auf deiner Printful-Seite angezeigt wird. Ist die Ein-Klick-Anmeldung von Printful eingerichtet, trägt die Karte den Titel „Verbinde dein Printful-Konto“ und beginnt mit einem Button „Weiter mit Printful“. Das Formular für das API-Token ist dann unter Stattdessen einen API-Schlüssel nutzen eingeklappt. Ist sie nicht eingerichtet, zeigt die Karte das Formular für das API-Token direkt.
Die Printful-Verbindungsseite öffnen
Gehe im Dashboard zur Übersicht Integrationen und öffne den Abschnitt Fulfillment. Mach nur weiter, wenn die Printful-Karte ausdrücklich eine verfügbare Einrichtungsaktion zeigt, und wähle sie, um die Verbindungsseite zu öffnen.
Die Art der Verbindung wählen
Nutze eine der Verbindungsmethoden, die auf der Seite angezeigt werden.
Zum Anmelden wählst du „Weiter mit Printful“, meldest dich bei Printful an und gibst den Zugriff frei. Du landest direkt wieder auf der Printful-Seite in Composerie. Lehnst du ab oder schlägt die Autorisierung fehl, sagt die Seite das, und es wird nichts geändert. Das (i) neben „Nur was für Produkte und Bestellungen nötig ist“ erklärt den Zugriff, den Composerie anfordert, und den Hinweis zu einem Webhook pro Shop weiter unten.
Für ein Token, das du selbst verwaltest, wähle Stattdessen einen API-Schlüssel nutzen.
Dein Token einfügen und Shops suchen
Wenn du den Weg über den API-Schlüssel gewählt hast, füge dein privates API-Token in das Feld API-Schlüssel ein und wähle dann Shops suchen. Composerie validiert das Token bei Printful und liest die Shops in deinem Konto aus.
Den Shop zum Verbinden wählen
Nachdem die Shops gefunden wurden, wähle in der Auswahl Shop den Printful-Shop, den Composerie für das Fulfillment nutzen soll. Sie listet jeden Shop deines Kontos auf und beginnt beim ersten.
Das Verbinden abschließen
Wähle „Printful verbinden“. Der Button erscheint erst, nachdem Shops suchen einen Shop gefunden hat, und er braucht einen gewählten Shop. Composerie speichert dein Token verschlüsselt und hält den von dir gewählten Shop fest.
Meldet der Verbindungsablauf, dass ein Webhook registriert wurde, kann Composerie unterstützte Status-Ereignisse für den gewählten Shop empfangen. Liefert Printful die Sendungsverfolgung in einem unterstützten Ereignis oder einer Statusantwort, kann Composerie sie an der zugehörigen Anbieterbestellung festhalten.
Die Verbindung bestätigen
Nach dem Verbinden wechselt die Printful-Seite in ihre Ansicht für verbundene Anbieter. Prüfe, ob alles stimmt.
Die Kopfzeile zeigt den Status Verbunden. Die Statuszeile darunter endet mit Zuletzt geprüft, dem Zeitpunkt, zu dem Composerie zuletzt bestätigt hat, dass die Zugangsdaten noch funktionieren. Die Karte Verbindung zeigt den von dir gewählten Shop und Verbunden seit, mit der Art der Verbindung: „angemeldet mit Printful“ oder „API-Schlüssel“. Nutze diese Werte, den Verbindungsstatus und einen Testablauf, um zu bestätigen, dass die Zugangsdaten noch funktionieren. Anbieterstatus und Sendungsverfolgung erscheinen nur, wenn Printful sie über einen unterstützten Verbindungsweg zurückgibt.
Stelle in derselben Karte die Einkaufswährung auf die Abrechnungswährung deines Printful-Kontos ein, damit Kosten und Margen stimmen.
Von hier aus kannst du den Printful-Katalog öffnen und mit dem Bau eines Produkts beginnen. Wähle in der Kopfzeile der Seite Katalog ansehen.
Wie du Produkte holst und auswählst, was du verkaufst, steht unter den Katalog eines Anbieters durchsuchen. Wie die Verbindung dauerhaft funktioniert, steht unter eine Anbieterverbindung gesund halten.
Häufige Fragen
Ein-Klick-Verbindung oder API-Token, was soll ich nehmen?
Nutze eine der Methoden, die in deinem Konto angezeigt werden. Weiter mit Printful nutzt den Freigabebildschirm von Printful. Mit dem Weg über den API-Schlüssel unter Stattdessen einen API-Schlüssel nutzen bestimmst du Zugangsdaten und Berechtigungen selbst.
Warum sehe ich den Button Printful verbinden nicht?
Er erscheint, sobald Shops suchen einen Shop in deinem Konto gefunden hat. Füge dein Token ein, wähle Shops suchen und prüfe dann den Shop in der Auswahl Shop.
Das Token funktioniert, aber es sind keine Shops erschienen. Und jetzt?
Lege zuerst in Printful einen Shop an, komm dann zurück und wähle noch einmal Shops suchen. Composerie braucht einen Shop, aus dem das Fulfillment läuft, bevor es sich verbinden kann.
Ist mein API-Token sicher?
Ja. Composerie speichert das Token verschlüsselt und hält nur fest, welchen Shop du gewählt hast. Um es zu wechseln, wähle im Menü Weitere Aktionen die Option Zugangsdaten ändern und speichere ein neues Token. Das aktuelle funktioniert weiter, bis du speicherst. Bei einer Verbindung per Anmeldung findest du dort stattdessen Neu mit Printful verbinden.
Überschreibt das Verbinden von Printful meinen bestehenden Webhook?
Das kann passieren. Printful erlaubt pro Shop eine Webhook-Konfiguration, daher ersetzt die Registrierung von Composerie die vorherige. Auf der Karte für die Ein-Klick-Anmeldung sagt das (i) neben Nur was für Produkte und Bestellungen nötig ist das vor dem Verbinden.
Wenn du nicht weiterkommst, wende dich an den Support, dann helfen wir dir.
Weiter: den Printful-Katalog durchsuchen, um dein erstes Produkt hinzuzufügen.