Hepsiburada-integratiegids 2026: REST API, HepsiJet & gecentraliseerd verkopersbeheer

1. Hepsiburada API-architectuur 2026

REST op mpop.hepsiburada.com

De verkopers-API van Hepsiburada is een pure REST/JSON-service die wordt gehost onder de overkoepelende host mpop.hepsiburada.com (mpop = "Merchant Platform Open API"). Er is geen GraphQL- of gRPC-variant. Al het geauthenticeerde verkeer verloopt via HTTPS, gekoppeld aan een Merchant ID dat tijdens de HMS-onboarding wordt uitgegeven. Het API-oppervlak is opgesplitst in logische subdomeinen in plaats van één monolithische root:

• listing-external.hepsiburada.com — listing-CRUD (prijs, voorraad, listingstatus)
• mpop.hepsiburada.com/product/api/products — productaanmaak en categorie-attributen
• oms-external.hepsiburada.com — orderbeheer (orders, pakketten, zendingen)
• returns-external.hepsiburada.com — retouren en terugbetalingen
• integration.hepsiburada.com/finance — factuuruploads en financiële afstemming

Elk subdomein deelt hetzelfde HTTP Basic-authenticatieschema, maar hanteert eigen ratelimieten en paginatieconventies. De HB-connector van Zunapro abstraheert deze fan-out achter één genormaliseerde interface.

Authenticatie: HTTP Basic via HTTPS

In tegenstelling tot de iets soepelere API van Trendyol of de OAuth-flow van Amazons SP-API gebruikt Hepsiburada een bewust eenvoudig HTTP Basic-authenticatieschema: de Authorization-header bevat Basic base64(username:password), waarbij username je API-sleutel is en password het bijbehorende secret. Elk verzoek moet ook een User-Agent-header bevatten die je Merchant ID omvat. Ontbrekende of verkeerd opgemaakte User-Agent-waarden zijn de meest voorkomende afzonderlijke oorzaak van 401 Unauthorized in productie.

GET /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU}
Host: listing-external.hepsiburada.com
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
User-Agent: {MERCHANT_ID} - SelfIntegration
Accept: application/json

HMS — Het Hepsiburada Marketplace Service-paneel

Het HMS-paneel op merchant.hepsiburada.com is de operationele webconsole die bij de API hoort. Elke API-mogelijkheid heeft een HMS-equivalent — listingbewerkingen, orderacceptatie, uitgifte van terugbetalingen, financiële afstemming — en HMS is de enige plek waar je API-sleutels aanmaakt, HepsiJet-afhaaladressen configureert en gebruikersrechten beheert. De HMS-redesign van 2024–2026 bracht een uniforme linkernavigatie, realtime settlement-rapportage en een nieuw "API Health"-dashboard dat de 4xx/5xx-percentages per endpoint toont, wat van onschatbare waarde is bij het debuggen van een integratie.

Ratelimieten en idempotentie

Hepsiburada past royale maar afgedwongen ratelimieten toe — doorgaans ~30 verzoeken/seconde per merchant op listingupdates en lager (~10/s) op orderendpoints. Bulkproductimports worden apart afgeknepen en geven 202 Accepted terug met een trackingId; vervolgens poll je /import/{trackingId} tot voltooiing. De order-API ondersteunt idempotentie via pakket- en order-ID's die stabiel blijven tussen leesbewerkingen.

2. Verbinden via REST API — stap voor stap

Voorwaarden: HMS-account & ETBİS

Vóór elke API-aanroep moet een in Turkije geregistreerd bedrijf met een vergi numarası (belastingnummer), een ETBİS-registratie (Elektronik Ticaret Bilgi Sistemi — het e-commerce-bedrijvenregister van het ministerie van Handel) en een Turks IBAN (TR…) de onboarding via HMS doorlopen. De KYC-controle is doorgaans binnen 1–3 werkdagen afgerond voor bij ETBİS geregistreerde entiteiten; niet-ETBİS-verkopers komen in een handmatige beoordelingswachtrij terecht die 1–2 weken kan duren.

API-onboarding stap voor stap

1. Maak een HMS-account aan op merchant.hepsiburada.com met je vergi numarası en IBAN. Upload je ETBİS-certificaat, tekeningsbevoegdheid en belastingdienstdocument.
2. Genereer API-credentials onder Hesabım → Entegrasyon Bilgileri → API Anahtarı. Het systeem retourneert een username, password en je stabiele Merchant ID. Bewaar de secrets in een vault — Hepsiburada toont het password niet opnieuw.
3. Whitelist uitgaande IP's als je integratieplatform dat vereist. Zunapro publiceert een vast egress-IP-bereik zodat verkopers het kunnen vastpinnen op de HMS-allowlist.
4. Doe een smoke-test met een listing-leesbewerking — roep GET /listings/merchantid/{MERCHANT_ID} aan en bevestig een 200 OK met je bestaande voorraad.
5. Abonneer je op webhooks voor orderevents: POST /webhook-subscriptions met je callback-URL en de eventtypes (order.created, order.cancelled, return.created).
6. Push je eerste product met POST /product/api/products/import — Hepsiburada retourneert een trackingId; poll deze tot status:DONE.
7. Ga live — zet de integratie op "Aktif" in HMS zodra de smoke-tests slagen.

Headers en veelvoorkomende valkuilen

De meest voorkomende integratieregressie is een ontbrekende of verkeerd opgemaakte User-Agent. Hepsiburada vereist strikt het formaat {MERCHANT_ID} - {AppName}; een standaard User-Agent zoals axios/1.6 of okhttp/4 geeft 401 Unauthorized zonder beschrijvende body. Stel de User-Agent altijd expliciet in en log deze in je request-middleware.

3. Productsynchronisatie — categorieboom, attributen, varianten

De categorieboom

De catalogus van Hepsiburada is georganiseerd als een strikte categorieboom van drie tot vijf niveaus die wordt blootgesteld via GET /product/api/categories/get-all-categories. Elk product moet worden gekoppeld aan een categorie-ID op bladniveau; tussenliggende knooppunten worden geweigerd met VALIDATION_ERROR. De categorie-herziening van 2024 heeft diverse legacy-knooppunten samengevoegd (de afzonderlijk vermelde "Bluetooth Kulaklık" en "Kablosuz Kulaklık" werden samengevoegd tot "Kablosuz Kulaklık & Bluetooth"), dus elke integratie ouder dan dat heeft een verversing van de categoriemapping nodig.

Verplichte attributen blokkeren de goedkeuring

Elke categorie toont een lijst met verplichte en optionele attributen via GET /product/api/categories/{categoryId}/attributes. Anders dan Trendyol behandelt Hepsiburada ontbrekende verplichte attributen als een harde listingblokkade — het product komt in de status WAITING_FOR_APPROVAL terecht en bereikt nooit "Active" totdat elk vereist attribuut is ingevuld met een geldige lookup-waarde. Veelvoorkomende fouten:

• Merk — moet exact overeenkomen met het merkenregister van Hepsiburada; "Apple" en "APPLE" zijn verschillende ID's
• Kleur, maat, capaciteit — uit gecontroleerde woordenlijsten, niet uit vrije tekst
• Garantieperiode — vereist voor elektronica, uitgedrukt in maanden als enum
• Land van herkomst (Menşei) — vereist voor cosmetica, voeding, supplementen

Varianten: scheiding van listing & product

Hepsiburada hanteert een striktere product vs listing-scheiding dan de meeste concurrenten. Eén enkel product (HB-SKU, interne identifier) kan veel listings (merchantSku) hebben — één per verkoper, met een eigen prijs, voorraad, conditie (nieuw/gerefurbished) en garantie. Voor variantproducten (bijv. een T-shirt in S/M/L × Rood/Blauw/Zwart) is elke combinatie een apart productknooppunt, optioneel gegroepeerd onder een varyantGroupID zodat de productpagina kleur- en maatstalen toont.

Bulkimport via trackingId

Productie-catalogus-pushes gebruiken POST /product/api/products/import met een array van maximaal 100 producten per verzoek. De API retourneert een trackingId; integrators moeten GET /product/api/products/import/{trackingId} pollen tot de status DONE is en vervolgens de resultaten rij voor rij doorlopen op validatiefouten. Zunapro batcht imports in blokken van 100 rijen, herhaalt soft failures en toont foutrapporten op rijniveau binnen het verkopersparaneel.

POST /product/api/products/import
Host: mpop.hepsiburada.com
Authorization: Basic ...
User-Agent: {MERCHANT_ID} - Zunapro

{
  "merchant": "{MERCHANT_ID}",
  "items": [{
    "merchantSku": "ZP-TSHIRT-RED-M",
    "categoryId": 18021982,
    "productName": "Premium Pamuklu T-Shirt — Kırmızı M",
    "brand": "Zuna",
    "attributes": [
      {"name":"Renk","value":"Kırmızı"},
      {"name":"Beden","value":"M"}
    ],
    "price": 249.90,
    "availableStock": 87,
    "varyantGroupID": "ZP-TSHIRT-2026"
  }]
}

4. Orderbeheer — webhooks, statusflow, labels

De levenscyclus van een order

Een Hepsiburada-order doorloopt een vaste statusmachine die elke integratie moet implementeren. De statussen zijn belangrijk — voortijdige overgangen leveren strafpunten op tegen je verkopersscore:

• Open — order ontvangen, wacht op acceptatie (SLA van 24 uur voor de meeste categorieën, 48u voor meubels)
• InProgress / Picking — verkoper heeft bevestigd, picking en verpakking
• Packaged — pakket aangemaakt via API, wacht op overdracht aan de vervoerder
• Shipped — de vervoerder heeft het pakket gescand; trackingnummer actief
• Delivered — laatstemijls levering bevestigd
• Cancelled / Returned — retourportaal geïnitieerd door klant of verkoper

Webhook vs polling

Hepsiburada ondersteunt zowel webhooks (aanbevolen) als polling. Webhooks worden per Merchant ID geconfigureerd in HMS of via POST /webhook-subscriptions; het platform pusht JSON-events naar je HTTPS-endpoint met HMAC-handtekeningen in de X-HB-Signature-header. Polling valt terug op GET /orders?status=Open&offset=0&limit=100 in een cron van 30–60 seconden. Zunapro gebruikt standaard webhooks met een polling-reconciler van 5 minuten die eventuele gemiste events opvangt — een dubbel-vangnetpatroon dat de ordervolledigheid boven 99,99% houdt.

Verzendlabels: automatische HepsiJet-generatie

Wanneer je een order als Packaged markeert met HepsiJet geselecteerd, genereert de API automatisch een afdrukbaar PDF-verzendlabel en retourneert een download-URL plus een trackingnummer. Er is geen apart labelverzoek — het label zit bij de respons van de pakketaanmaak:

POST /packages
Host: oms-external.hepsiburada.com

{
  "orderId": "HB-72184",
  "lineItems": [{"id": "HB-72184-1", "qty": 1}],
  "cargoCompany": "HepsiJet"
}

→ 201 Created
{
  "packageId": "PKG-998812",
  "trackingNumber": "HJ73219840TR",
  "labelUrl": "https://mpop.hepsiburada.com/labels/PKG-998812.pdf",
  "status": "Packaged"
}

Het retourportaal

Retouren worden door de klant geïnitieerd via het standaard retourportaal van Hepsiburada (Iade Talepleri) en komen bij verkopers binnen via GET /returns?status=Open. Verkopers hebben 3 werkdagen om de retour goed te keuren of te betwisten; daarna treedt automatische goedkeuring in werking. Goedgekeurde retouren activeren een terugbetaling via de betaalrail van Hepsiburada (die de verkoper bij de volgende financiële settlement ziet), en de voorraad moet opnieuw worden bijgeschreven via PUT /listings/{merchantSku}/stock.

5. Voorraad- & prijssynchronisatie — realtime, Buy Box, repricer

Het voorraad-endpoint

Voorraad wordt bijgewerkt via de listing-API met een delta-bewuste payload:

PUT /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU}
{
  "availableStock": 42,
  "price": 299.90
}

Het endpoint accepteert prijs en voorraad in dezelfde aanroep, maar de interne cache van Hepsiburada kan 30–90 seconden nodig hebben om zich naar de storefront te verspreiden. Bulkupdates gebruiken POST /listings/import met hetzelfde trackingId-patroon als de productimport.

Realtime vs cron-synchronisatie

Verkopers op productieniveau gebruiken event-gedreven synchronisatie (elke voorraadwijziging in je ERP vuurt binnen seconden een PUT naar Hepsiburada) in plaats van een cron van 15 minuten. Het risico van cron-only-synchronisatie is oververkoop tijdens flash-periodes (Ramazan kampanyası, Black Friday, Efsane Cuma). Het hybride model van Zunapro vuurt onmiddellijke PUTs en een reconciler van 15 minuten voor het geval van gemiste events — hetzelfde patroon dat is gedocumenteerd in onze master→local→targets prijs- & voorraad-autosynchronisatie-architectuur.

De Buy Box winnen

De Buy Box van Hepsiburada (het standaardaanbod "Sepete Ekle" op een gedeelde productpagina) wordt toegekend door een gewogen formule die het volgende combineert:

• Prijs — concurrerend binnen 1–2% van het laagste geldige aanbod
• Voorraadgezondheid — diepte, versheid, geen recente voorraadtekorten
• Leveringsbelofte — bij gelijke omstandigheden wint HepsiJet
• Verkopersbeoordeling — minimaal 9,0+ over alle levering- en service-KPI's
• Orderdefectpercentage — annuleringen, late verzendingen, retouren bestraft

Een goed afgestelde repricer die de prijzen van concurrenten elke 5–10 minuten opnieuw evalueert, verhoogt het Buy Box-aandeel doorgaans met 15–30% op betwiste SKU's.

6. HepsiJet — eigen koeriersnetwerk

De verticaal geïntegreerde laatste mijl van Hepsiburada

HepsiJet is het eigen laatstemijls koeriersnetwerk van Hepsiburada, gelanceerd in 2017 om de afhankelijkheid van Yurtiçi en Aras Kargo op tijdkritische SKU's te doorbreken. In 2026 exploiteert HepsiJet 1.500+ afhaalpunten in 81 provincies, verzorgt het levering dezelfde dag in Istanbul, Ankara en Izmir en gebruikt het een eigen wagenpark van meer dan 2.500 voertuigen plus een netwerk van şube-franchises.

Barcodestandaard en labelformaat

Elk HepsiJet-verzendlabel draagt een Code-128-barcode die een trackingnummer van 12 tekens met het voorvoegsel HJ codeert (bijvoorbeeld HJ73219840TR). Het door de API gegenereerde PDF-label gebruikt een A6-layout die geschikt is voor thermische printers; labels kunnen rechtstreeks worden afgedrukt via de geïntegreerde ZPL-wachtrij.

Dezelfde dag & Yarın Kapında

HepsiJet biedt twee premium leveringsniveaus die zichtbaar zijn op de productpagina:

• "Yarın Kapında" — levering de volgende dag in 81 provincies wanneer de order vóór 14:00 lokale tijd wordt verzonden
• "Bugün Kapında" — levering dezelfde dag in Istanbul, Ankara, Izmir, Bursa, Adana voor orders die vóór 11:00 worden geplaatst

Beide badges verhogen de conversie aanzienlijk — de eigen gegevens van Hepsiburada wijzen op een conversiestijging van 15–25% op listings met de badges, ongeveer gelijkwaardig aan het "Hızlı Teslimat"-effect van Trendyol.

Afhalen vs Şubeye Bırak

Verkopers kiezen tussen HepsiJet-afhaling (de koerier haalt op bij het magazijn, per pakket in rekening gebracht) en Şubeye Bırak (de verkoper levert pakketten af bij het dichtstbijzijnde HepsiJet-filiaal, goedkoper per pakket maar operationeel zwaarder). De integratie-API ondersteunt beide — de pakketrespons bevat een veld pickupAddressId dat de routering bepaalt.

7. HepsiLojistik — het FBA-model

Wat HepsiLojistik is

HepsiLojistik is de fulfilment-by-marketplace-dienst van Hepsiburada — het Turkse equivalent van Amazon FBA, Trendyol TFC en Allegro One Fulfillment. Verkopers verzenden voorraad in bulk naar de fulfilmentcentra van Hepsiburada; Hepsiburada verzorgt opslag, picking, verpakking, laatstemijls levering (via HepsiJet) en retouren. HepsiLojistik-orders dragen een onderscheidende "Hepsiburada Garanti"-badge en krijgen de hoogste zichtbaarheidsweging in de Buy Box-formule.

Het netwerk van fulfilmentcentra

• Gebze (Kocaeli) — vlaggenschip-fulfilmentcentrum, ~150.000 m², bedient Istanbul + Marmara
• Çorlu (Tekirdağ) — toegevoegd in 2023, gericht op West-Turkije + grensoverschrijdend met de Balkan
• Kemalpaşa (Izmir) — dekking van de Egeïsche regio, geopend in 2024 voor Zuidwest-Turkije
• Ankara (Polatlı) — hub van Centraal-Anatolië, geoptimaliseerd voor levering in de hoofdstadregio

De tariefstructuur

De prijzen van HepsiLojistik worden gepubliceerd als een fulfilmenttarief per eenheid plus maandelijkse opslag:

• Fulfilmenttarief per eenheid — doorgaans ₺25–₺75 afhankelijk van de gewichtsklasse en categorie
• Maandelijkse opslag — gefactureerd per m³ per maand, gestaffeld op snelheid (long-tail-SKU's betalen meer)
• Inkomende verzending — de verkoper betaalt de inkomende verzending naar het fulfilmentcentrum
• Retourverwerking — inbegrepen in het fulfilmenttarief voor retouren binnen het beleid

Aanvraag & onboarding

HepsiLojistik is niet standaard open. Verkopers vragen het aan via HMS → Lojistik Hizmetleri → HepsiLojistik Başvuru, waarbij ze 6 maanden verkoophistorie en een lijst met doel-SKU's aanleveren. Hepsiburada geeft prioriteit aan verkopers boven ~500 orders per maand met voorspelbare vraagpatronen; verkopers met een lager volume blijven meestal op het standalone HepsiJet-afhaalmodel.

8. e-factuur (e-Fatura) integratie — GİB & ERP

GİB e-Fatura is verplicht

De Turkse GİB (Gelir İdaresi Başkanlığı — Belastingdienst) heeft e-Fatura (gestructureerde XML-facturen die worden ingediend bij het GİB-portaal) verplicht gesteld voor alle bedrijven boven de jaarlijkse omzetdrempel (momenteel ~₺3M, verlaagd voor e-commerceverkopers onder de wijzigingen van 2026). Onder de drempel geldt e-Arşiv Fatura — even elektronisch, iets lichter qua ondertekening. Marktplaatsorders zijn niet vrijgesteld: elke B2C- en B2B-marktplaatsorder vereist een elektronische factuur die binnen 7 dagen na het verzendevent wordt uitgegeven.

Het factuur-endpoint van Hepsiburada

Hepsiburada biedt een financieel endpoint voor factuuruploads — verkopers (of hun e-Fatura-integrators) pushen de GİB-UUID en de PDF-weergave van de uitgegeven factuur, die vervolgens bij de klant verschijnt via de standaard "Faturayı İndir"-link op de orderpagina:

POST /finance/invoices
Host: integration.hepsiburada.com

{
  "orderId": "HB-72184",
  "invoiceNumber": "ZUN2026000087421",
  "invoiceUuid": "f8e7d6c5-1234-5678-9abc-def012345678",
  "invoiceDate": "2026-06-09",
  "pdfBase64": "JVBERi0xLjQKJ..."
}

Compatibele ERP- & e-Fatura-aanbieders

De meeste Turkse verkopers geven de onderliggende factuur uit via hun ERP / e-Fatura-entegratör en sturen het resultaat door naar Hepsiburada. Zunapro levert native connectoren voor:

• Logo Tiger 3 / Logo Wings — het meest ingezette ERP van Turkije
• Mikro Yazılım — sterk in de mkb-retail
• Netsis (SAP-partner) — voor enterprise-verkopers
• Foriba, Uyumsoft, Digital Planet, izibiz — pure GİB e-Fatura-integrators

De KVKK-laag

De persoonsgegevens (PII) van klanten die door de factuurpijplijn stromen, vallen onder de Turkse KVKK (Kişisel Verilerin Korunması Kanunu — Wet op de bescherming van persoonsgegevens), de lokale AVG-equivalente regelgeving die wordt gehandhaafd door de KVKK Kurumu (Gegevensbeschermingsautoriteit). Verkopers zijn gezamenlijke verwerkingsverantwoordelijken voor de order-PII en moeten verwerkingsactiviteiten registreren op VERBİS waar van toepassing.

9. Veelvoorkomende fouten en oplossingen

Belangrijkste productiefouten

HTTP / Code	Symptoom	Grondoorzaak	Oplossing
401 Unauthorized	Alle verzoeken geweigerd	Ontbrekende of verkeerd opgemaakte User-Agent-header	Stel User-Agent: {MERCHANT_ID} - {AppName} expliciet in
403 Forbidden	Specifiek endpoint geblokkeerd	API-sleutel mist scope; merchant niet goedgekeurd voor module	Geef de sleutel opnieuw uit in HMS met volledige scopes, neem contact op met Merchant Support
VALIDATION_ERROR	Product vast in WAITING_FOR_APPROVAL	Verplicht categorie-attribuut ontbreekt of ongeldige lookup-waarde	Haal /categories/{id}/attributes op, vul de verplichte velden in met geldige enum-waarden
BRAND_NOT_FOUND	Productimport geweigerd	Merkstring komt niet exact overeen met het HB-merkenregister	Vraag /brands?name=... op, gebruik de geretourneerde ID, vraag merkaanmaak aan indien ontbrekend
429 Too Many Requests	Burstverkeer afgeknepen	~30 req/s op listings of ~10/s op orders overschreden	Implementeer exponentiële back-off met ondersteuning voor de Retry-After-header
STOCK_UPDATE_DELAY	Storefront toont 30–90s verouderde voorraad	Cache-propagatievertraging, geen bug	Verlaag de voorraad preventief bij risico op oververkoop; stem af na de vertraging
HEPSIJET_PICKUP_FAIL	Pakket aangemaakt maar geen koeriersophaling	Verkeerde pickupAddressId of adres buiten HepsiJet-dekking	Controleer het afhaaladres in HMS, wijk uit naar Yurtiçi/Aras voor uitgesloten postcodes
INVOICE_UPLOAD_REJECTED	e-factuur-upload geeft 400 terug	Ongeldig UUID-formaat of PDF-base64-corruptie	Valideer het UUID v4-formaat, hercodeer de PDF, probeer opnieuw met een idempotent factuurnummer

Diagnostische workflow

Wanneer een Hepsiburada-integratie zich vreemd begint te gedragen, is de diagnostische volgorde die Zunapro aanhoudt:

1. Controleer het HMS → API Health-dashboard op foutpercentages op endpointniveau
2. Valideer de User-Agent en Basic-auth-credentials met een curl-smoke-test
3. Inspecteer de X-Request-Id-header van een mislukte respons — de Merchant Support van Hepsiburada vereist deze om een ticket te traceren
4. Vergelijk met de changelog van developers.hepsiburada.com op recente schemawijzigingen

10. Hepsiburada-commissie 2026 — 8% tot 22%

Het commissieschema van Hepsiburada voor 2026 is per categorie gestaffeld, wordt per kwartaal gepubliceerd in HMS onder Hesabım → Komisyon Oranları en opgesplitst in drie brede banden plus enkele uitschieter-categorieën (goud, automotive, grote huishoudapparaten).

Commissievergelijking 2026 — Hepsiburada vs Trendyol vs Amazon TR

Marktplaats	Lage band	Middenband	Hoge band	Abonnement / Overig
Hepsiburada	8% – 12%	12% – 17%	15% – 22%	Gratis account · HepsiAd optioneel · HepsiLojistik-kosten indien gebruikt
Trendyol	9% – 13%	13% – 18%	16% – 24%	Gratis account · TFC-kosten indien gebruikt · Trendyol Ads optioneel
Amazon TR	5% – 12%	12% – 17%	15% – 22%	Professionele verkoper ~₺99 / maand · FBA-kosten indien gebruikt
n11	6% – 10%	10% – 15%	13% – 18%	Gratis account · n11 Pro-abonnementsniveau optioneel
Çiçeksepeti	10% – 14%	14% – 18%	16% – 22%	Gratis account · specialisatie in bloemen/cadeaus met levering dezelfde dag

De tabel lezen: Hepsiburada is ongeveer gelijk aan Amazon TR en iets goedkoper dan Trendyol in alle banden. De onderscheidende factor is niet de commissie maar de logistiek — de eigen laatste mijl van HepsiJet geeft Hepsiburada een structureel voordeel op leveringsbeloftes in de grote steden, terwijl het grotere gebruikersbestand van Trendyol de iets hogere tarieven compenseert.

Turks juridisch kader 2026 — btw, e-Fatura, KVKK, ETBİS

Btw-tarieven (KDV) 2026

De btw van Turkije — KDV (Katma Değer Vergisi) — gebruikt in 2026 drie wettelijke tarieven:

• standaardtarief van 20% — de meeste consumentengoederen, elektronica, mode, wonen & leven
• verlaagd tarief van 10% — basisboodschappen, textiel voor bepaalde categorieën, boeken, horeca
• super-verlaagd van 1% — basisvoedingsmiddelen (brood, melk, eieren), landbouwinputs, bepaalde medische producten

Marktplaatsverkopers registreren zich voor KDV via het regionale Vergi Dairesi (belastingkantoor); grensoverschrijdende verkopers kunnen gebruikmaken van het onlangs uitgebreide speciale btw-regime van Turkije voor e-commerce na 2024.

e-Fatura & e-Arşiv — GİB-mandaat

• e-Fatura — gestructureerde XML-facturen ingediend bij de GİB, verplicht boven de jaarlijkse omzetdrempel en voor alle e-commerceverkopers onder de wijzigingen van 2026
• e-Arşiv Fatura — even elektronisch maar lichter; voor B2C onder de e-Fatura-drempel
• uitgiftevenster van 7 dagen — elke marktplaatsorder vereist een elektronische factuur binnen 7 dagen na verzending
• e-İrsaliye, e-Müstahsil, e-Smm — begeleidende documenten voor logistieke, agrarische en freelance-stromen

KVKK — het AVG-equivalent van Turkije

KVKK (Kişisel Verilerin Korunması Kanunu), van kracht sinds 2016 en aangescherpt met de AVG-afstemming van 2024, regelt de verwerking van persoonsgegevens. Marktplaatsverkopers zijn gezamenlijke verwerkingsverantwoordelijken voor de order-PII (naam, adres, telefoon, IBAN indien relevant) en moeten:

• Zich registreren op VERBİS (Veri Sorumluları Sicil Bilgi Sistemi) indien boven de drempels
• Een schriftelijk privacybeleid (Aydınlatma Metni) bijhouden dat toegankelijk is voor klanten
• De rechten van betrokkenen (inzage, rectificatie, verwijdering) binnen 30 dagen honoreren
• Inbreuken binnen 72 uur melden bij de KVKK Kurumu

ETBİS — het e-commerce-bedrijvenregister

ETBİS (Elektronik Ticaret Bilgi Sistemi), beheerd door het ministerie van Handel (Ticaret Bakanlığı), is het verplichte register voor elk e-commercebedrijf dat in Turkije actief is. Registratie is gratis en online; het ETBİS-nummer moet worden weergegeven in de marktplaatsverkopersprofielen en in de footers van eigen winkels. De KYC van Hepsiburada controleert ETBİS automatisch tijdens de onboarding.

Logistiek & verzending — HepsiJet eerst, Yurtiçi/Aras als back-up

De standaard: HepsiJet

HepsiJet is de standaardvervoerder voor Hepsiburada-orders en de enige die de "Yarın Kapında" / "Bugün Kapında"-badges automatisch activeert. Voor de meeste verkopers in de grote steden is het routeren van 80–100% van het volume via HepsiJet de juiste keuze.

Geïntegreerde externe vervoerders

Hepsiburada integreert ook met de gevestigde nationale vervoerders van Turkije, waarbij verzendlabels worden gegenereerd via hetzelfde pakketaanmaak-endpoint door simpelweg de waarde cargoCompany te wijzigen:

• Yurtiçi Kargo — dichtste plattelandsdekking, sterk op de postcodes van Oost-Anatolië die HepsiJet uitsluit
• Aras Kargo — concurrerende B2B-SLA's, populair voor meubels en volumineuze goederen
• DHL Kargo — flexibele levervensters dezelfde dag in geselecteerde corridors
• PTT Kargo — staatspostbedrijf, plattelandsbereik, tragere SLA's
• UPS Türkiye / DHL — internationale grensoverschrijdende routes

Routeringslogica in Zunapro

De logistieke router van Zunapro beoordeelt elke order aan de hand van een configureerbare matrix — gewicht, bestemmingspostcode, aangegeven waarde, SKU-klasse — en selecteert standaard HepsiJet, waarbij hij terugvalt op Yurtiçi voor uitgesloten postcodes en op Aras voor pakketten boven 30 kg. De gekozen vervoerder wordt via hetzelfde Hepsiburada-pakket-endpoint doorgestuurd, zodat de klant één enkele trackingervaring ziet.

Hoe je begint met verkopen op Hepsiburada — stap voor stap 2026

De lancering in 5 stappen

1. Registreer je op ETBİS & HMS — open je ETBİS-record via etbis.ticaret.gov.tr, doorloop daarna de onboarding op merchant.hepsiburada.com met vergi numarası, IBAN en tekeningsbevoegdheid. De KYC is binnen 1–3 werkdagen afgerond.
2. Genereer API-credentials — Hesabım → Entegrasyon Bilgileri → API Anahtarı. Bewaar username/password in je vault; noteer de Merchant ID voor de User-Agent-headers.
3. Koppel de e-factuur — kies je GİB-integrator (Logo, Mikro, Foriba, izibiz) en bevestig dat het factuurupload-endpoint van Hepsiburada bereikbaar is. Test met één B2C-order.
4. Kies je logistieke stack — HepsiJet-afhaling vs Şubeye Bırak, plus Yurtiçi/Aras-back-up voor uitgesloten postcodes. Leg labels en verpakkingsmateriaal vooraf klaar.
5. Verbind via Zunapro (10 minuten) — plak de API-credentials in de Hepsiburada-tegel, koppel je master-catalogus, activeer HepsiJet-automatische labels en de e-factuur, zet de schakelaar live.

De Zunapro-verbindingsflow

1. Log in op Zunapro en open de Turkije-module
2. Klik op "Hepsiburada verbinden" — plak API-username, password en Merchant ID
3. Automatische categoriemapping — de ML van Zunapro stelt categoriemappings op bladniveau voor elke master-SKU voor; bevestig met een paar klikken
4. Activeer HepsiJet-automatische labels + e-factuur — één toggle per stuk
5. Ga live — de eerste listingsynchronisatie van een catalogus met 1.000 SKU's is in ongeveer 10 minuten voltooid; webhooks registreren automatisch

Hepsiburada-integratie FAQ 2026