Case

Salestreak: zo bouwden we een verkoopwerkplek met AI-productcontent

Salestreak geeft online verkopers één plek voor hun producten: een catalogus met varianten en voorraad, AI-productfoto's en producteksten in vijf talen, eigen webshops met een checkout, publiceren op Etsy en print on demand via Printful. Het ging in 2026 live en staat nog aan het begin. Dit is wat er al gebouwd is, en hoe.

Product
Werkplek voor online verkopers
Gelanceerd
2026
Stack
Rails 8.1, Stripe Connect, OpenAI
Talen
5
Status
Live, net begonnen
Eén mok op een rommelig aanrecht, dezelfde mok als strakke packshot en in een gestylede ontbijtscène
Eén telefoonfoto erin, een packshot en een sfeerfoto eruit. Voorbeeldbeelden, gegenereerd ter illustratie.
De uitdaging

De uitdaging: één product, te veel plekken

Kleine online verkopers doen alles zelf. Ze fotograferen producten op het aanrecht, schrijven omschrijvingen per kanaal en per taal, houden voorraad bij in een spreadsheet en tikken orders over tussen hun eigen shop en Etsy. Elk nieuw kanaal maakt het werk groter.

Het doel: één catalogus als vertrekpunt voor foto's, teksten, shops en kanalen, en één lijst voor alle bestellingen, met de lastige onderdelen (betalingen, voorraad en het labelen van AI-content) vanaf het begin goed geregeld.

Onze aanpak

Onze aanpak

Salestreak begon op 10 september 2026 vanuit de codebase van Twelve Lumens. Billing, de beeldpipeline, vijf talen en de deployment kwamen mee, al bewezen in productie. Op die eerste dag werd het datamodel opnieuw opgezet rond producten, voorraad, kanalen en bestellingen, en kwam de eerste koppeling met Etsy erin.

  • Eén catalogus als bron voor foto's, teksten, webshops en kanalen
  • De beeldengine van Twelve Lumens, omgebouwd van kamers naar producten
  • Betalingen die altijd kloppen: idempotent, met row locks en zonder dubbele verwerking
  • Een MCP-connector waarmee AI-agents in de shop werken, binnen de rechten van de gebruiker

Een catalogus voor varianten en voorraad

Producten hebben opties zoals maat en kleur, waaruit varianten ontstaan. Elke variant heeft een eigen SKU (uniek per werkruimte), EAN, barcode, MPN, prijs, vergelijkingsprijs, inkoopprijs, gewicht en afmetingen in millimeters, plus een voorraadbeleid: bijgehouden, niet bijgehouden of op bestelling gemaakt.

Voorraad staat per locatie (magazijn, fulfilmentpartner, winkel of leverancier), met reserveringen en een mutatielogboek dat elke wijziging vastlegt: ontvangen, verkocht, geretourneerd, gecorrigeerd, beschadigd of verplaatst. Hetzelfde fundament leggen we onder de e-commerce platforms die we voor klanten bouwen.

Het catalogusmodel

  1. Product

    Naam, merk, type, tags en een omschrijving per taal.

  2. Varianten

    Ontstaan uit opties zoals maat en kleur.

    • SKU
    • EAN
    • prijs
    • gewicht
  3. Voorraad per locatie

    Magazijn, fulfilmentpartner, winkel of leverancier, met reserveringen.

  4. Mutatielogboek

    Elke wijziging vastgelegd: ontvangen, verkocht, geretourneerd, gecorrigeerd, beschadigd, verplaatst.

Productfoto's vanaf een telefoonfoto

Beeldherkenning sorteert elke upload in een van negen soorten shots en schrijft bijschriften en alt-teksten in vijf talen. Opruimen maakt van een snelle foto een strakke packshot op een neutrale achtergrond. Restylen zet het product in een van zeven scènepresets, of in een eigen merkscène op basis van een omschrijving en referentiebeelden.

Elk shot kun je laten zien als gedragen, op tafel, als flat lay, hangend, in de hand of als packshot, onder een van vijf lichtopstellingen. Een harde regel in de prompt zorgt dat producten liggen of hangen zoals ze dat in het echt zouden doen.

Elke AI-render krijgt een ingebrande disclaimerbalk en IPTC-metadata. Producteksten worden direct in het Engels, Nederlands, Duits, Frans en Spaans opgesteld op basis van de productdata en de foto-analyse, met de uitdrukkelijke regel om nooit materialen te verzinnen.

Dezelfde mok in een gestylede ontbijtscène met linnen, eucalyptus en een croissant
Een gespikkelde keramische mok op een rommelig aanrecht
Voor Na
Dezelfde mok voor en na een restyle. Voorbeeldbeelden, gegenereerd ter illustratie.

Webshops met een checkout die altijd klopt

Verkopers kunnen meerdere webshops draaien, elk in maximaal vijf talen met hreflang. De checkout gebruikt Stripe Checkout en rekent direct af op het eigen gekoppelde Stripe-account van de verkoper, met SEPA en bankoverschrijving, btw-facturen, terugbetalingen en afhandeling van betwiste betalingen. Salestreak houdt zijn platformfee in via Stripe Connect en betaalt die naar rato terug als de verkoper geld terugstort. Meer daarover bij onze Stripe-koppelingen.

Voorraad blijft tijdens het afrekenen een uur gereserveerd en een opruimtaak geeft die vrij als een winkelmand verlaten wordt. Checkouts hebben een idempotency key, statuswijzigingen krijgen een row lock en webhook-events worden ontdubbeld, zodat een nieuwe poging nooit dubbel afschrijft.

De shops volgen ook strenge eerlijkheidsregels: "Nog maar N" verschijnt alleen als er één tot vijf stuks beschikbaar zijn, er zijn geen bezoekerstellers, verkooptellers of afteltimers, prijzen zijn inclusief btw en een vergelijkingsprijs staat er alleen als gelabelde adviesprijs, zoals de Europese Omnibus-regels vragen.

De checkout-flow

  1. Winkelmand

    Land van bezorging gekozen, prijzen inclusief btw.

  2. Voorraad gereserveerd

    Een uur vastgehouden en automatisch vrijgegeven als de winkelmand verlaten wordt.

  3. Stripe Checkout

    Afgerekend op het eigen gekoppelde account van de verkoper, met een fee voor het platform.

  4. Webhooks

    Handtekening gecontroleerd, ontdubbeld en veilig om twee keer te ontvangen.

  5. Bestelling en factuur

    Bevestigingsmails voor beide kanten en een btw-factuur voor de koper.

Etsy en print on demand

Etsy koppel je via OAuth met PKCE. Publiceren maakt eerst een conceptlisting, uploadt de afbeeldingen, zet de voorraad per variant en activeert dan de listing, inclusief de print-on-demand-velden van Etsy. Elke tien minuten worden nieuwe orders opgehaald en de track-and-trace gaat terug naar Etsy.

Ook Printful koppel je via OAuth. Ontwerpen upload je of laat je door AI maken als transparante PNG's in 2K, de mockups van Printful worden productfoto's, en orders uit Etsy of de webshop gaan door naar Printful, desgewenst automatisch, waarna webhooks de track-and-trace terugbrengen. De patronen beschrijven we op onze pagina over koppelingen met Etsy en Printful.

Andere marktplaatsen en leveranciers zijn nog niet gebouwd. Bestellingen uit de webshops en van Etsy komen in één lijst terecht, met betaal- en verzendstatus, gedeeltelijke levering en de keuze om zelf te verzenden of de order door te sturen naar de leverancier.

Een MCP-connector voor AI-agents

Salestreak heeft een eigen MCP-endpoint met een eigen OAuth 2.1-server, met dynamische clientregistratie en tokens die gebonden zijn aan hun doel (RFC 8707). De 37 gedocumenteerde tools dekken catalogus, voorraad, foto's, print on demand, websites en bestellingen.

Een agent werkt met de rol van de gebruiker die hem toegang gaf en binnen de limieten van diens abonnement. Hij kan dus nooit meer dan de persoon achter hem. Lees hoe we MCP-servers bouwen.

Zo koppelt een agent

  1. AI-assistent

    Claude, ChatGPT of een andere MCP-client.

  2. OAuth 2.1

    Dynamische clientregistratie en tokens gebonden aan de shop.

  3. 37 tools

    Catalogus, voorraad, foto's, print on demand, websites en bestellingen.

    • catalogus
    • voorraad
    • foto's
    • bestellingen
  4. Rol en abonnement van de gebruiker

    Elke aanroep draait met de rechten en limieten van de gebruiker die toestemming gaf.

Resultaat

Salestreak in cijfers

tools voor AI-agents via MCP
37
talen voor shops en AI-teksten
5
scènepresets, plus eigen merkscènes
7
geautomatiseerde tests
1.500+

Stack

Hetzelfde fundament als Twelve Lumens: Rails met Hotwire, Solid Queue in een eigen container, afgeschermde beeldopslag op Cloudflare R2 en deploys met Kamal bij elke push naar main.

  • Ruby on Rails 8.1
  • Hotwire
  • ViewComponent
  • Tailwind CSS
  • PostgreSQL
  • Solid Queue
  • Stripe Connect
  • Stripe Tax
  • Etsy API
  • Printful API
  • OpenAI
  • libvips
  • exiftool
  • Cloudflare R2
  • Kamal
Wat we leerden

Wat we leerden

Begin vanuit een bewezen kern

Omdat Salestreak begon als kopie van de codebase van Twelve Lumens, waren billing, de beeldpipeline, vijf talen en de deployment op dag één al getest in productie. De eerste dag ging naar het nieuwe datamodel, en de credentials werden meteen vervangen. De twee producten delen dus code, maar geen geheimen.

Fouten met geld zijn de duurste

Elke checkout heeft een idempotency key, statuswijzigingen krijgen een row lock en webhook-events worden ontdubbeld op hun Stripe-ID, zodat nieuwe pogingen en herhaalde berichten geen kwaad kunnen. Die paden testen we net zo zorgvuldig als het pad waarin alles goed gaat.

Leg de regels vast in tests

Een test voor het designsysteem controleert elke view, component en stylesheet: kleuren alleen uit tokens, de accentkleur alleen op goedgekeurde plekken, het woordmerk alleen uit zijn eigen component, en in geen enkele taal een em dash. Regels die in een test staan, overleven elke deadline.

Bouw je iets voor online verkopers?

Vertel over je producten, kanalen en betalingen. Je krijgt een eerlijk beeld van wat je moet bouwen, wat je beter kunt kopen en waar de lastige stukken zitten.

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