Hepsiburada Marketplace Sync - Automatische voorraad- en prijsupdates via API of CSV

Uw webshop is de bron van waarheid. De marktplaats hoort die te volgen.

Verkopen op Hepsiburada betekent dat drie dingen op elke aanbieding actueel moeten blijven: prijs, beschikbare voorraad en verzendtijd. Doet u dat met de hand, dan exporteert u elke ochtend opnieuw een spreadsheet; vergeet u het een dag, dan verkoopt u voorraad die u niet meer heeft of staat u op een prijs die u nooit had willen aanbieden. Deze module maakt van uw PrestaShop-catalogus de enige bron en duwt de wijzigingen door.

Twee manieren van aanleveren, één rijenbouwer

• CSV-export — download een bestand met exact de kolommen, in exact de volgorde die de bulkuploader van Hepsiburada verwacht, en upload het zelf in het verkopersportaal.
• Listing API — voer uw inloggegevens in en de module praat rechtstreeks met Hepsiburada. Richt een cron op het meegeleverde adres en voorraad- en prijswijzigingen worden vanzelf aangeleverd.

Beide routes lopen door dezelfde rijenbouwer, dus het bestand dat u downloadt en de payload die de API verstuurt komen altijd overeen. Wilt u ooit controleren wat de API doet, download dan het bestand.

Wat het verstuurt — en waar het van afblijft

Het catalogusteam van Hepsiburada is eigenaar van de aanbieding zelf, dus deze module raakt uw productnamen, beschrijvingen, afbeeldingen, categorieën en kenmerken nooit aan. Het verstuurt de velden die van de verkoper zijn: prijs exclusief btw, beschikbare voorraad, verzendtijd, vervoerder- en adreslabels, maximaal te bestellen aantal, en het personalisatietype en de lengte daarvan. Niets wat tot hun catalogus behoort wordt overschreven.

Beveiligingen, want een verkeerde prijs is duur

• "Hold back" (voorraad achterhouden) — trek een buffer van elk aantal af voordat het wordt verstuurd. Zet hem op 2 en een product met 5 op voorraad wordt aangeboden als 3, zodat een marktplaatsbestelling niet meer kan verkopen dan uw webshop zojuist heeft verkocht.
• Prijsfactor — verstuur de winkelprijs ongewijzigd, of tel er een marge bij op om de marktplaatscommissie te dekken. Waarden boven 10 worden als typefout geweigerd in plaats van gepubliceerd.
• "Never send a price below" (nooit een prijs versturen onder) — een veiligheidsbodem. Rijen die eronder vallen worden tegengehouden en gerapporteerd in plaats van live te gaan met een verkeerd bedrag.
• "Never offer more than" (nooit meer aanbieden dan) — begrens het aantal dat op de marktplaats wordt getoond, ongeacht wat er in het magazijn ligt.

Producten die zijn uitgeschakeld of niet bestelbaar zijn worden verstuurd met voorraad nul in plaats van te worden weggelaten, zodat ze op de marktplaats stoppen met verkopen in plaats van er stilletjes verouderd te blijven staan.

Het vertelt u wat niet verstuurd kan worden, en waarom

Het statuspaneel op het tabblad Getting started (aan de slag) noemt de betrokken producten in plaats van u te laten raden: geen SKU en geen voorraadcode, een prijs die op nul uitkomt, een prijs onder uw bodem, een ontbrekende naam in de exporttaal. Dubbele SKU's worden opgespoord voordat u verstuurt — Hepsiburada weigert een hele batch als er één twee keer voorkomt, dus dit vooraf onderscheppen scheelt een volledige heruploade. Het vervoerdersveld valideert tegen de vervoerders die Hepsiburada publiceert en waarschuwt bij een onbekende naam, die hun kant anders stilzwijgend negeert.

Geplande synchronisatie die eerlijk rapporteert

Het tabblad Send (versturen) toont een cron-adres met token. Richt de cron van uw hosting daarop — elk half uur is gebruikelijk — en standaard verstuurt hij alleen wat gewijzigd is sinds de laatste geslaagde run; productopslagacties en voorraadmutaties markeren aanbiedingen automatisch als gewijzigd. Voeg &mode=full toe om alles opnieuw te versturen nadat Hepsiburada een batch heeft geweigerd of kwijtgeraakt. Het eindpunt antwoordt in JSON, zodat een monitoringtool een echte storing van een rustige run kan onderscheiden, gelijktijdige runs worden geweigerd zodat een trage run zich niet kan opstapelen, en het opnieuw genereren van het adres maakt het oude onmiddellijk ongeldig mocht de URL ooit uitlekken.

Producten koppelen, en combinaties

Elke Hepsiburada-aanbieding heeft een HepsiburadaSku. Plak die in het tabblad Hepsiburada op de productpagina, of gebruik "Link products automatically" (producten automatisch koppelen) als uw PrestaShop-referenties al overeenkomen met uw Hepsiburada-verkopersvoorraadcodes. Combinaties worden volledig ondersteund — elke combinatie wordt apart gekoppeld en geprijsd, omdat Hepsiburada elke variant als een eigen aanbieding behandelt.

Wat versie 2.0 heeft opgelost

Versie 1.x prijsde altijd vanuit wholesale_price, dat de meeste webshops leeg laten, waardoor elke geëxporteerde prijs 0,00 was. Versie 2.0 gaat standaard uit van de verkoopprijs, weigert een nulprijs überhaupt te exporteren, en waarschuwt wanneer de kostprijs als bron is gekozen in een catalogus zonder kostprijzen. Versie 1.x schreef de SKU ook weg bij elke actionProductUpdate, waardoor elk ander opslagpad — een voorraadwijziging, de webservice, een andere module — hem stilzwijgend leegmaakte; 2.0 schrijft alleen wanneer het productformulier de velden daadwerkelijk meestuurde. Koppelingen worden nu per winkel opgeslagen in plaats van één SKU per product wereldwijd, en 1.x bewaarde wel API-inloggegevens maar verstuurde nooit ergens een verzoek, dus na de upgrade blijft de API uit totdat u hem bewust aanzet.

Compatibiliteit

PrestaShop 1.7, 8 en 9, met geen overrides, in acht talen: Nederlands, Engels, Frans, Duits, Italiaans, Pools, Spaans en Turks. Multistore-bewust — koppelingen worden per winkel opgeslagen, zodat hetzelfde product in verschillende winkels verschillende Hepsiburada-SKU's kan dragen, en de configuratiepagina vertelt u altijd op welke winkel hij van toepassing is. Bij het verwijderen worden de tabellen en instellingen van de module opgeruimd; uw Hepsiburada-aanbiedingen behouden hun laatst ontvangen waarden en worden simpelweg niet meer bijgewerkt.

Veelgestelde vragen

Heb ik de API nodig, of kan ik ook gewoon een bestand gebruiken?

Allebei kan. Download de CSV en upload hem in het verkopersportaal, of zet de API aan en laat een cron de wijzigingen aanleveren. Beide leveren identieke gegevens op.

Verandert het mijn producttitels of afbeeldingen op Hepsiburada?

Nee. Die zijn van hun catalogusteam. De module verstuurt alleen prijs, voorraad, verzendtijd, vervoerder- en adreslabels, maximaal aantal en personalisatie-instellingen.

Hoe voorkom ik dat ik meer verkoop dan ik heb?

Stel een achtergehouden aantal in. Elk voorraadgetal wordt daarmee verlaagd voordat het wordt verstuurd, zodat de marktplaats uw laatste paar stuks nooit te zien krijgt.

Welke inloggegevens heeft de API nodig?

De Listing API-inloggegevens van Hepsiburada, die niet uw login voor het verkopersportaal zijn — vraag ze aan bij Hepsiburada. Een 401 betekent dat de gebruikersnaam of het wachtwoord verkeerd is, 403 betekent dat ze geen recht hebben op de Listing API, en 404 betekent dat het verkopers-ID verkeerd is. Er is een "Test connection"-knop (verbinding testen) die hun exacte melding toont.

Ondersteunt het combinaties?

Ja. Elke combinatie wordt apart gekoppeld en geprijsd, omdat Hepsiburada elke variant als een eigen aanbieding behandelt.

Waarom is mijn hele upload geweigerd?

Vrijwel altijd door een dubbele SKU — Hepsiburada weigert de hele batch als er één twee keer voorkomt. Het statuspaneel vindt dubbele SKU's voordat u verstuurt.

Mijn 1.x-prijzen werden allemaal als nul geëxporteerd. Is dat opgelost?

Ja. Dat kwam doordat 1.x prijsde vanuit het kostprijsveld, dat de meeste webshops leeg laten. Versie 2.0 gebruikt standaard de verkoopprijs en weigert een nulprijs überhaupt te exporteren.