Deze gids legt de verbindingsflow van Printful uit voor als Printful uitdrukkelijk als beschikbaar wordt getoond in Integraties → Fulfillment. Alleen het live scherm Integraties voor jouw account is bepalend. Dit artikel, een providerlogo of een directe URL bewijst geen beschikbaarheid. Ontbreekt Printful daar of is het niet beschikbaar, stop dan: het valt buiten je huidige live scope.
Een geslaagde verbinding kan de mogelijkheden zichtbaar maken die je Printful-token geeft. Gedrag rond catalogus, bestellingen en webhooks hangt nog steeds af van de gekozen winkel, de rechten en de huidige status van de integratie. Controleer de volledige flow van een gekoppelde bestelling en een geaccepteerde providerreferentie voor de productie.
Wil je eerst het grotere plaatje, zie dan hoe het verbinden van een provider werkt.
Voordat je begint
Een beetje voorbereiding in Printful zorgt dat het verbinden soepel gaat.
- Zorg voor een Printful-account waarin je winkel en betaalinstellingen zijn ingesteld. Bevestig de betaalgegevens in Printful voordat je een testbestelling en een providerreferentie valideert.
- Bepaal vanuit welke Printful-winkel Composerie moet fulfillen. Heeft je Printful-account meer dan één winkel, dan kies je tijdens het verbinden de juiste.
- Verbind je met een API-sleutel, maak dan een privétoken met alleen de toegang die de installatiestappen noemen: bestellingen, producten en webhooks. Bekijk die rechten in Printful voordat je goedkeurt.
De route met een API-sleutel heeft drie korte genummerde stappen: stel je winkel en betaalgegevens in, maak het token en plak het daarna en kies je winkel. Ze linken rechtstreeks naar het Printful-dashboard en de Printful API-documentatie, zodat je elke stap in een nieuw tabblad kunt openen en kunt meelezen.
Verbind Printful
Volg alleen de installatiemethode die op je Printful-pagina staat. Is inloggen met één klik van Printful ingesteld, dan heeft de kaart de titel “Koppel je Printful-account” en begint hij met een knop “Doorgaan met Printful”. Het formulier voor een API-token zit dan ingeklapt onder Liever een API-sleutel gebruiken. Is dat niet ingesteld, dan toont de kaart het formulier voor het API-token meteen.
Open de verbindingspagina van Printful
Ga in het dashboard naar het overzicht Integraties en open het onderdeel Fulfillment. Ga alleen verder als de Printful-kaart uitdrukkelijk een beschikbare installatieactie toont en kies die om de verbindingspagina te openen.
Kies hoe je verbindt
Gebruik een van de verbindingsmethoden die op de pagina staan.
Om in te loggen kies je “Doorgaan met Printful”, log je in bij Printful en geef je toegang. Je komt direct terug op de Printful-pagina in Composerie. Weiger je, of mislukt de autorisatie, dan zegt de pagina dat en wordt er niets gewijzigd. De (i) naast “Alleen wat nodig is voor producten en orders” legt uit welke toegang Composerie vraagt en wat de waarschuwing hieronder is over één webhook per winkel.
Om een token te gebruiken dat je zelf beheert, kies je Liever een API-sleutel gebruiken.
Plak je token en zoek winkels
Heb je voor de route met een API-sleutel gekozen, plak dan je privé-API-token in het veld API-sleutel en kies Winkels zoeken. Composerie valideert het token bij Printful en leest de winkels in je account terug.
Kies de winkel om te verbinden
Kies nadat de winkels zijn gevonden in de keuzelijst Winkel de Printful-winkel die Composerie voor fulfillment moet gebruiken. De lijst toont elke winkel in je account en begint bij de eerste.
Rond het verbinden af
Kies “Printful verbinden”. De knop verschijnt pas nadat Winkels zoeken een winkel vindt, en er moet een winkel geselecteerd zijn. Composerie slaat je token versleuteld op en legt de winkel vast die je hebt gekozen.
Meldt de verbindingsflow dat er een webhook is geregistreerd, dan kan Composerie ondersteunde statusgebeurtenissen voor die gekozen winkel ontvangen. Geeft Printful tracking terug in een ondersteunde gebeurtenis of statusantwoord, dan kan Composerie die vastleggen bij de bijbehorende providerbestelling.
Bevestig de verbinding
Na het verbinden schakelt de Printful-pagina over naar de verbonden weergave. Controleer of alles klopt.
De kop toont de status Verbonden. De statusregel eronder eindigt met Laatst gecontroleerd, het moment waarop Composerie voor het laatst heeft bevestigd dat de inloggegevens nog werken. De kaart Koppeling toont de Winkel die je hebt gekozen en Gekoppeld sinds, met hoe je hebt verbonden: “ingelogd met Printful” of “API-sleutel”. Gebruik die waarden, de verbindingsstatus en een testworkflow om te bevestigen dat de inloggegevens nog werken. Providerstatus en tracking verschijnen alleen als Printful ze via een ondersteunde verbindingsroute teruggeeft.
Stel op dezelfde kaart Inkoopvaluta in op de factuurvaluta van je Printful-account, zodat kosten en marges kloppen.
Vanaf hier kun je de Printful-catalogus openen en een product gaan bouwen. Kies Catalogus bekijken in de paginakop.
Om producten binnen te halen en te kiezen wat je verkoopt, zie blader door de catalogus van een provider. Om de verbinding op de lange termijn werkend te houden, zie houd een providerverbinding gezond.
Veelgestelde vragen
Verbinden met één klik of een API-token, wat kies ik?
Gebruik een van de methoden die in je account staan. Doorgaan met Printful gebruikt het goedkeuringsscherm van Printful. Met de route met een API-sleutel onder Liever een API-sleutel gebruiken bepaal je zelf de inloggegevens en de rechten.
Waarom zie ik de knop Printful verbinden niet?
Hij verschijnt zodra Winkels zoeken een winkel in je account heeft gevonden. Plak je token, kies Winkels zoeken en controleer daarna de winkel in de keuzelijst Winkel.
Het token werkt maar er verschenen geen winkels. Wat nu?
Maak eerst een winkel aan in Printful, kom dan terug en kies opnieuw Winkels zoeken. Composerie heeft een winkel nodig om vanuit te fulfillen voordat het kan verbinden.
Is mijn API-token veilig?
Ja. Composerie slaat het token versleuteld op en legt alleen vast welke winkel je hebt gekozen. Om het te vervangen kies je Inloggegevens wijzigen in het menu Meer acties en sla je een nieuw token op. Het huidige blijft werken tot je opslaat. Bij een verbinding via inloggen staat daar in plaats daarvan Opnieuw koppelen met Printful.
Overschrijft het verbinden van Printful mijn bestaande webhook?
Dat kan. Printful staat één webhookconfiguratie per winkel toe, dus de registratie van Composerie vervangt de vorige. Op de kaart voor inloggen met één klik zegt de (i) naast Alleen wat nodig is voor producten en orders dat voordat je verbindt.
Kom je er niet uit, neem dan contact op met support en we helpen je.
Volgende stap: blader door de Printful-catalogus om je eerste product toe te voegen.