Etsy- en Printful-koppeling laten maken

Een Etsy- en Printful-koppeling die je orders vanzelf laat lopen

Verkopen op Etsy en laten produceren door Printful betekent vier bewegende delen: listings, orders, productie en track-and-trace. Die hele kringloop bouwden we in Salestreak: een product met varianten op Etsy zetten, nieuwe orders ophalen, ze naar Printful sturen en de track-and-trace terugzetten bij de koper.

  • Etsy Open API v3 met OAuth en PKCE
  • Printful-catalogus, mockups en orders doorzetten
  • Orders, fulfilment en track-and-trace in één flow

Van ontwerp tot bezorgde order

  1. Ontwerp

    Upload een ontwerp of laat er een maken met AI, opgeslagen als transparante PNG in 2K per printvlak.

    • voorkant
    • achterkant
  2. Mockups

    Printful maakt mockups per kleur, en die worden de productfoto's.

  3. Publiceren op Etsy

    Conceptlisting, foto's, voorraad per variant en daarna activeren.

  4. Orders synchroniseren

    Nieuwe en gewijzigde Etsy-bestellingen elke tien minuten opgehaald, omdat Etsy geen webhooks voor orders heeft.

  5. Uitleveren en volgen

    Betaalde orders gaan naar Printful, en de verzendwebhook zet de track-and-trace terug op Etsy.

De print-on-demand-kringloop in Salestreak.
Wat we bouwen

Wat we bouwen op Etsy en Printful

De hele kringloop, of alleen het deel dat je nodig hebt: publiceren, orders synchroniseren, print on demand of track-and-trace.

Etsy-shop koppelen

OAuth 2.0 met PKCE zoals Etsy dat vereist, de juiste rechten voor listings en transacties, en tokens die ververst worden voordat een synchronisatie start.

Listings met varianten

Producten gepubliceerd als één Etsy-listing met maximaal twee variatie-eigenschappen, één aanbod per combinatie en de SKU op elk aanbod.

Orders synchroniseren

Etsy-bestellingen opgehaald vanaf het laatste punt en bijgewerkt op bestelnummer, zodat een herhaalde synchronisatie nooit een order verdubbelt.

Printful-catalogus en ontwerpen

T-shirts uit de catalogus van Printful met printvlakken, beschikbaarheid per regio en printbestanden, en ontwerpen per printvlak geplaatst.

Mockups als productfoto's

De mockupgenerator van Printful asynchroon aangeroepen, mockups direct gedownload en hergebruikt als packshots voor elk kanaal.

Uitleveren en track-and-trace

Orders naar Printful met jouw eigen ordernummer voor idempotency, desgewenst automatisch bevestigd, en de track-and-trace terug naar Etsy.

Bewezen in de praktijk

Ingebouwd in ons eigen verkoopplatform

Salestreak, onze werkplek voor online verkopers, heeft beide koppelingen aan boord. Verkopers koppelen hun Etsy-shop en hun Printful-store via OAuth, ontwerpen een T-shirt, krijgen mockups als productfoto's en publiceren op Etsy. Orders komen terug in één overzicht, en betaalde print-on-demand-orders gaan naar Printful.

Salestreak ging in 2026 live en is nog jong. Daarom bouwden we beide koppelingen strak volgens de gedocumenteerde API's en dekten we ze af met geautomatiseerde tests. Printify en Gelato staan op de lijst, maar zijn nog niet gebouwd.

  • Printful-tokens elke 15 minuten ververst onder een row lock, omdat Printful het refresh token roteert
  • De ongetekende webhooks van Printful beveiligd met een geheim token in de webhook-URL
  • Orders die per bankoverschrijving betaald worden gaan pas naar productie als de betaling binnen is
  • Oudere Etsy-koppelingen zonder het recht voor track-and-trace slaan die stap over in plaats van de order te laten mislukken
  • Elke publicatie op Etsy vastgelegd als synchronisatierun, met één record per variant om orderregels later te koppelen

Zo past één product op Etsy

  1. Product

    Eén product in de catalogus, met opties als maat en kleur.

  2. Listing

    Eén Etsy-listing per product, met maximaal twee variatie-eigenschappen, vernoemd naar de opties.

  3. Aanbiedingen

    Eén aanbod per combinatie van opties, elk met een eigen prijs, aantal en SKU.

  4. Orderregels

    De Etsy-id's van elke variant worden bewaard, zodat binnenkomende bestellingen bij de juiste variant terechtkomen.

Waarom de ordersynchronisatie elke Etsy-orderregel aan een variant kan koppelen.
tussen twee Etsy-ordersyncs
10 min
tussen twee verversingen van Printful-tokens
15 min
transparante PNG per printvlak
2K
geldigheid van een Printful-access token, automatisch ververst
1 uur
Voor wie

Voor wie we dit bouwen

Print-on-demand-verkopers

Eén keer ontwerpen, publiceren op Etsy en betaalde orders vanzelf naar productie laten gaan, zonder adressen over te tikken.

Etsy-verkopers die verder willen dan één shop

Listings, varianten en orders beheerd vanuit je eigen systeem, met Etsy als een van je verkoopkanalen.

Commerceplatforms en SaaS

Bied publiceren op Etsy of print on demand aan binnen je eigen product, onder je eigen merk.

Creators en merken met merchandise

Merch met mockups als productfoto's en orders die zonder handwerk de deur uitgaan.

Zo werkt het

Zo bouwen we een Etsy- of Printful-koppeling

Elke marktplaats en leverancier heeft een eigen datamodel. Die goed op elkaar laten aansluiten is het meeste werk.

  1. 1

    Leg jouw producten naast die van hen

    Opties, varianten, SKU's en printvlakken vertaald naar Etsy-listings en varianten uit de catalogus van Printful.

  2. 2

    Registreer de apps

    Developer-apps bij Etsy en Printful met precies de redirect-URL's en rechten die ze vereisen.

  3. 3

    Bouw koppelen en verversen

    OAuth-flows, versleutelde tokens en verversingstaken die het roteren van tokens veilig afhandelen.

  4. 4

    Bouw publiceren en synchroniseren

    Listings, foto's en voorraad eruit; bestellingen erin, zo bijgewerkt dat een synchronisatie veilig opnieuw kan draaien.

  5. 5

    Zet orders door en volg ze

    Betaalde orders naar productie, daarna verzendingen en track-and-trace terug naar de marktplaats en de koper.

  6. 6

    Test met echte shops

    Een zorgvuldige eerste publicatie en eerste order per shop, met de hand gecontroleerd voordat de automatisering het overneemt.

API's en tooling

De Etsy Open API v3 en de Printful API, gekoppeld vanuit een Rails-applicatie met achtergrondtaken, versleutelde gegevens en beeldverwerking.

  • Etsy Open API v3
  • Printful API
  • OAuth 2.0
  • PKCE
  • Webhooks
  • Ruby on Rails
  • Solid Queue
  • libvips
  • PostgreSQL
Kosten en doorlooptijd

Wat kost een koppeling met Etsy of Printful?

Het hangt ervan af hoeveel van de kringloop je nodig hebt. Deze factoren bepalen de kostenraming:

Welke richting
Alleen listings publiceren, of ook orders ophalen en track-and-trace terugzetten.
Complexiteit van je producten
Eenvoudige producten gaan snel; varianten, printvlakken en meerdere kleuren vragen meer vertaalwerk.
Print on demand
Ontwerpen, mockups en orders automatisch doorzetten betekenen een tweede koppeling met eigen uitzonderingen.
Aantal kanalen
Alleen Etsy, of Etsy naast je eigen webshop en andere marktplaatsen.
Bestaande listings
Vers beginnen is eenvoudiger dan listings en orders koppelen die al bestaan.
Veelgestelde vragen

Vragen over koppelingen met Etsy en Printful

Wat kost een koppeling met de Etsy-API?

Dat hangt ervan af of je alleen listings publiceert of ook orders en track-and-trace synchroniseert, hoe complex je producten zijn en of er print on demand bij komt. Na een gratis kennismaking krijg je een scope en kostenraming op papier.

Hoe lang duurt het bouwen van een Etsy- of Printful-koppeling?

Listings publiceren is een kleiner project dan de hele kringloop met orders, productie en track-and-trace. De kostenraming na de kennismaking bevat een planning per fase.

Heeft Etsy webhooks voor nieuwe orders?

Nee, dus orders worden opgehaald. Elke tien minuten vragen we Etsy om bestellingen die sinds de vorige keer veranderd zijn, en we werken orders bij op bestelnummer, zodat een herhaalde synchronisatie nooit dubbele orders oplevert.

Kunnen Printful-orders automatisch ingediend worden?

Ja, als je dat wilt. Betaalde orders waarvan alle regels bij een Printful-product met een klaar ontwerp horen, kunnen automatisch doorgaan of wachten op een klik op de orderpagina.

Kunnen jullie ook Printify, Gelato of andere leveranciers koppelen?

Die hebben we nog niet gebouwd. Printful kwam eerst, omdat de API de hele kringloop dekt, inclusief mockups. Andere leveranciers zouden hetzelfde patroon volgen.

Kan ik ook via mijn eigen webshop verkopen?

Ja. In Salestreak verkopen dezelfde producten op Etsy en in de eigen webshop van de verkoper met een Stripe-checkout, en orders uit beide komen in één overzicht.

Verkoop je op Etsy of met print on demand?

Vertel wat je verkoopt, waar, en hoe orders nu worden uitgeleverd. Je krijgt een eerlijk beeld van wat er te koppelen valt en wat ervoor nodig is.

martin@balk.dev

Je hoort meestal binnen één werkdag van ons.

Handig om te noemen

  • Wat je wilt bouwen, in een paar zinnen
  • Wie het gaat gebruiken
  • Een eventuele deadline of lanceerdatum
  • Systemen en tools waar het mee moet samenwerken