PhotopilotPhotopilot
Koppelen

Hoe koppel je Stockbase aan Shopware?

Stockbase levert per EAN productbeelden van je leveranciers, maar zet ze niet zelf in Shopware. Daarvoor heb je een laag nodig die de beelden op barcode aan je artikelen hangt, ze in je huisstijl zet en via de Shopware Admin-API op de juiste plek in de productgalerij publiceert. Met Photopilot gaat dat met je Stockbase-inlog en een Shopware-integratiesleutel; nieuwe beelden komen elk uur binnen.

Bijgewerkt:

Studiobeeld van een man in een groene werkjas, trui en jeans, gemaakt vanuit packshots
  • elk uur nieuwe Stockbase-beelden ophalen
  • EAN de sleutel tussen Stockbase en je artikelen
  • elke 2 uur controle van wat er echt in Shopware staat

Wat Stockbase wel en niet levert

Stockbase is in Nederland vooral bekend als platform voor voorraad- en productdata tussen leveranciers en winkeliers. Voor beeld werkt het eenvoudig: per EAN (de barcode, ook wel GTIN) staan er een of meer productbeelden klaar, elk met een eigen beeldnummer. Dat zijn meestal packshots van de leverancier, soms ook detailbeelden of beelden op model.

Wat je via de beeldkoppeling niet krijgt, zijn kant-en-klare producttitels, omschrijvingen of eigenschappen zoals materiaal en wasvoorschrift. Die komen uit je eigen artikelbestand, uit je kassasysteem of ERP, of worden gemaakt op basis van het beeld en het waslabel. Reken er dus niet op dat Stockbase alleen een product compleet maakt in Shopware.

Shopware 6 kent geen standaardkoppeling met Stockbase-beelden. Je kunt beelden downloaden en via een import of de Shopware-admin uploaden, maar bij honderden artikelen per seizoen wordt dat handwerk. Een koppeling die matcht, bewerkt en publiceert, scheelt dan het meeste.

Wat er uit Stockbase komt en waar de rest vandaan komt
OnderdeelUit Stockbase?Waar het anders vandaan komt
Productbeelden per EANJaniet van toepassing
Producttitel en omschrijvingNeeEigen artikeldata of AI-producttekst
SEO-titel en metabeschrijvingNeeAI-tekst per taal, na goedkeuring
Materiaal en wasvoorschriftNeeWaslabel herkennen of eigen stamdata
Modelfoto'sSomsEigen studio of AI-modelfoto vanaf de packshot

Wat je nodig hebt voordat je begint

Aan de Stockbase-kant heb je alleen de gebruikersnaam en het wachtwoord van je eigen Stockbase-account nodig. Photopilot vraagt daarmee zelf de toegangstokens aan en vernieuwt ze op tijd, zodat de koppeling niet stilvalt als een token verloopt.

Aan de Shopware-kant maak je onder Instellingen, Systeem, Integraties een integratie aan met schrijfrechten op producten. De access key en secret key geef je aan Photopilot. Een beheerdersinlog kan als terugval, maar die stopt bij een wachtwoordwissel of 2FA.

Het belangrijkste zit in je eigen data: je artikelbestand moet per maatvariant de EAN bevatten, en de productnummers moeten overeenkomen met die in Shopware. Zonder die twee sleutels valt er niets betrouwbaar te koppelen.

  • Stockbase-gebruikersnaam en wachtwoord
  • Shopware-integratie met access key, secret key en schrijfrechten op producten
  • Artikelbestand met EAN per maatvariant, meestal uit je kassasysteem of ERP
  • Productnummers die in Shopware bestaan

Stap 1: beelden ophalen en matchen op EAN

Photopilot vraagt elk uur bij Stockbase op welke beelden er zijn. Elk beeld wordt via de EAN opgezocht in je artikelbestand, tot op de barcode van de maatvariant. Daarmee is meteen duidelijk bij welk artikel en welke kleur het beeld hoort, ook als jouw artikelnummers anders zijn opgebouwd dan die van de leverancier.

Beelden die al binnen zijn, herkent Photopilot aan EAN en beeldadres en slaat ze over. Hebben meerdere maten van hetzelfde artikel hetzelfde beeld, dan komt het maar één keer bij het artikel terecht in plaats van één keer per maat.

Staat een EAN nog niet in je assortiment, of is het artikel niet actief, dan wordt het beeld nog niet ingelezen. Zodra het artikel er wel is, pakt de volgende uurronde het beeld alsnog op. Zo hoeft niemand bestanden te hernoemen of te sorteren.

Overzicht van leveranciersbeelden in Photopilot met filters voor gekoppeld, niet gekoppeld en conflict
Leveranciersbeelden per bron, met wat gekoppeld is en wat nog niet.

Stap 2: huisstijl en beeldslots

Stockbase-beelden verschillen sterk per leverancier: de ene levert op wit, de andere op grijs, met kleine of juist grote marges. Photopilot zet ze om naar je eigen beeldregels: achtergrond, stramien per artikelgroep, schaduw, kleurcorrectie en beeldverhouding. Die standaardbewerkingen zitten in het maandplan, vanaf €500 per maand.

Elk beeld krijgt een beeldslot, zoals voorkant, achterkant of detail. Beeldslot 1 wordt straks het hoofdbeeld in Shopware. Komt hetzelfde artikel ook uit Fashion Cloud of uit je eigen studio, dan bepalen je regels per slot welke versie wint; de andere blijven zichtbaar als alternatief.

Is er alleen een platte packshot, dan kun je er een ghost mannequin-beeld of een AI-modelfoto van maken. AI-foto's kosten €0,05 – €0,21 per foto in de wachtrij en zijn vaak binnen een uur klaar. Per merk of artikelgroep kies je of beelden automatisch doorlopen of eerst in de review komen.

Productbeelden van overhemden met stramienlijnen voor gelijke marges
Elke leverancier in dezelfde uitsnede, met beeldslot 1 als hoofdbeeld.

Stap 3: beelden in de Shopware-productgalerij

Na goedkeuring zet Photopilot het beeld via de Admin-API als productmedia bij het product. Het product wordt gevonden op productnummer; hangen de beelden bij een variantproduct aan het hoofdproduct, dan valt Photopilot terug op de EAN. Beeldslot 1 wordt positie 1 en daarmee het hoofdbeeld; de andere slots volgen in jouw volgorde.

Photopilot markeert de media die het zelf plaatst. Een nieuwe versie van hetzelfde slot vervangt dus het vorige Photopilot-beeld, en beelden die je zelf in Shopware hebt gezet blijven staan. Werk je liever met je eigen beeldimport, dan levert Photopilot de bestanden met vaste bestandsnamen via FTP of Azure aan.

Staat het product nog niet in Shopware, bijvoorbeeld omdat de ERP-import later komt, dan probeert Photopilot het later opnieuw. Zodra het product verschijnt, gaat de push alsnog door.

Twee beeldslots, voorkant en achterkant van een rok, allebei met de status live
Per beeldslot zie je welke versie live staat.

Stap 4: teksten en eigenschappen erbij

Een beeld alleen maakt nog geen goede productpagina (PDP). Photopilot schrijft op basis van beeld en artikeldata per taal een omschrijving, SEO-titel (metaTitle) en metabeschrijving (metaDescription) en zet die na goedkeuring binnen enkele minuten in de producttranslaties. De producttitel overschrijft Photopilot alleen als je daarvoor kiest.

Materiaal en wasvoorschrift haalt Photopilot uit het waslabel (care label) of uit je eigen stamdata en zet ze als Shopware-eigenschap Materiaal en Wasvoorschrift op het product, als je wilt ook als filter. Kleur en maat blijven onaangeroerd.

Talen en verkoopkanalen leest Photopilot zelf uit Shopware en houdt ze elke zes uur bij. Zo zie je per taal welke artikelen al tekst hebben en welke nog niet.

Van Stockbase via Photopilot naar Shopware
StapWat er gebeurtTempo
OphalenNieuwe Stockbase-beelden per EANelk uur
MatchenEAN naar artikel, kleur en maatvariantin dezelfde ronde
BewerkenAchtergrond, stramien, schaduw, kleur, beeldslotna binnenkomst
PublicerenProductmedia op vaste positie via de Admin-APIna goedkeuring of autopilot
TekstenOmschrijving, metaTitle en metaDescription per taalbinnen minuten na goedkeuring
ControleWat staat er echt live in de shopelke 2 uur

Controle en live gaan

Shopware antwoordt soms zonder foutmelding terwijl een veld niet is opgeslagen. Daarom controleert Photopilot elke twee uur wat er werkelijk in de shop staat. Pushlogs per artikel laten zien wat er is verstuurd, wat al goed stond en wat is overgeslagen, met een knop om het opnieuw te proberen.

Het publiceren naar je live shop zet je zelf aan in de contentinstellingen, pas als je tevreden bent over de eerste resultaten. Tot die tijd leest Photopilot alleen en kun je in alle rust kijken wat er klaarstaat.

Tip: begin met één leverancier op review, kijk een week mee in de pushlogs en zet daarna leverancier voor leverancier over op autopilot.

Wanneer deze koppeling niet de slimste route is

Haal je maar van een handvol artikelen per seizoen beelden uit Stockbase en vind je de uitstraling van de leverancier prima, dan is downloaden en zelf uploaden in Shopware goedkoper. Je mist dan de eigen uitsnede, de controle per leverancier en de teksten, maar bij kleine aantallen weegt dat niet op.

Ook als je artikelbestand geen betrouwbare EAN per maat heeft, loont het om eerst je stamdata op orde te brengen. Elke beeldkoppeling, met Stockbase of met Fashion Cloud, staat of valt met die barcode.

FAQ

Veelgestelde vragen

Heeft Stockbase een koppeling met Shopware?

Er is geen standaardkoppeling die Stockbase-beelden matcht, bewerkt en op de juiste plek in de Shopware-galerij zet. Photopilot vult dat gat: het leest Stockbase met je eigen inlog, koppelt op EAN en schrijft via de Admin-API naar je producten.

Wat heb ik nodig om Stockbase-beelden in Shopware te krijgen?

Je Stockbase-gebruikersnaam en wachtwoord, een Shopware-integratie met schrijfrechten op producten en een artikelbestand met EAN per maatvariant. Er is geen plugin of ontwikkelwerk nodig.

Hoe vaak komen nieuwe Stockbase-beelden in Shopware?

Photopilot kijkt elk uur of er nieuwe Stockbase-beelden zijn. Na bewerking en eventuele review gaan ze naar Shopware; met autopilot gebeurt dat zonder tussenkomst.

Levert Stockbase ook productteksten of materiaal?

Via de beeldkoppeling niet: Stockbase levert per EAN productbeelden. Teksten, materiaal en wasvoorschrift komen uit je eigen artikeldata of maakt Photopilot op basis van beeld en waslabel.

Krijg ik dubbele beelden als Stockbase een foto opnieuw aanbiedt?

Nee. Photopilot herkent beelden die al binnen zijn aan EAN en beeldadres en slaat ze over. Ook als meerdere maten hetzelfde beeld hebben, komt het maar één keer bij het artikel.

Werkt het als onze artikelnummers anders zijn dan die van de leverancier?

Ja. De koppeling met Stockbase loopt via de EAN, niet via het artikelnummer. Het productnummer is alleen nodig om het juiste product in Shopware te vinden, met de EAN als terugval bij variantproducten.

Overschrijft Photopilot mijn eigen productfoto's in Shopware?

Nee. Photopilot vervangt alleen media die het zelf heeft geplaatst. Beelden die je zelf in Shopware hebt gezet, blijven staan.

Kan ik Stockbase-beelden eerst controleren voordat ze live gaan?

Ja. Per leverancier of artikelgroep kies je of beelden eerst in de review komen of via autopilot doorlopen. Het publiceren naar de live shop zet je bovendien zelf aan.

Kan ik Stockbase en Fashion Cloud samen gebruiken voor Shopware?

Ja. Beide bronnen komen in hetzelfde overzicht en per beeldslot bepalen je regels welke versie wint. In Shopware zie je daarna één consistente galerij, ongeacht de bron.