Trendyol-integratiegids 2026: REST API, XML-koppeling & gecentraliseerd winkelbeheer

1. Trendyol API-architectuur 2026

De Marketplace API van Trendyol is een RESTful, JSON-over-HTTPS-interface, gepubliceerd op één productie-basis-URL — https://api.trendyol.com — met een aparte stage-omgeving op https://stageapi.trendyol.com. Elke API-aanroep wordt geverifieerd met HTTP Basic Auth: de Authorization-header draagt een base64-gecodeerd ApiKey:ApiSecret-paar, en de Supplier ID wordt als padparameter meegegeven op elk leverancier-scoped endpoint. Er is geen aparte access-token-round-trip voor first-party verkopers — Basic Auth wordt bij elke aanvraag gecontroleerd — wat de integratie eenvoudig houdt, maar betekent dat gelekte inloggegevens onmiddellijk via het Partner-paneel moeten worden geroteerd.

Basis-URL, authenticatie, headers

POST https://api.trendyol.com/sapigw/suppliers/{supplierId}/v2/products
Authorization: Basic BASE64(ApiKey:ApiSecret)
User-Agent: {supplierId} - SelfIntegration
Content-Type: application/json
Accept: application/json

De User-Agent-header is niet cosmetisch: de traffic-shaping en rate-limit-verrekening van Trendyol maken er gebruik van. Integrators (zoals Zunapro) sturen {supplierId} - Zunapro; first-party verkopers sturen {supplierId} - SelfIntegration. Verkeerd gestempelde User-Agent-headers kunnen 401/403-responses veroorzaken, zelfs met geldige inloggegevens.

Rate limits en quota

Trendyol handhaaft rate limits per endpoint, per leverancier. De gepubliceerde plafonds voor 2026 zijn:

• Productendpoints — doorgaans 60 aanvragen/minuut per Supplier ID, met bursttolerantie tot 90/min gedurende 30 seconden
• Orderendpoints — doorgaans 600 aanvragen/minuut (orders is bewust een endpoint met veel verkeer en lage latency)
• Prijs- & voorraadupdate-endpoints — doorgaans 100 aanvragen/minuut, waarbij elke aanvraag maximaal 1.000 SKU's in één batch draagt
• Categorie- & attribuutopzoekingen — doorgaans 30 aanvragen/minuut (deze veranderen langzaam, dus agressieve caching wordt verwacht)

Elke respons bevat X-RateLimit-Limit, X-RateLimit-Remaining en, bij 429's, Retry-After-headers. Een goed gebouwde integratie gebruikt een token-bucket-wachtrij per Supplier ID en past bij 429 tegendruk toe met exponentiële back-off; Zunapro implementeert dit standaard zodat zelfs bulkpushes van meerdere duizenden SKU's de limieten nooit overschrijden.

OAuth 2.0 voor onafhankelijke integrators

Voor onafhankelijke tussenlaag-integrators (Zunapro en vergelijkbare SaaS-platforms die namens vele leveranciers optreden) biedt Trendyol een OAuth 2.0 authorization-code-flow in plaats van directe Basic Auth. De integrator registreert een client_id / client_secret bij Trendyols developer-relations-team, de leverancier autoriseert de integrator vanuit het Partner-paneel, en de integrator ontvangt een access token van 1 uur plus een refresh token voor heruitgifte. Dit voorkomt dat de ruwe ApiKey / ApiSecret van de leverancier ooit wordt verwerkt en is het audit-vriendelijke pad voor enterprise-klanten die vele Trendyol-winkels beheren.

Webhooks

Trendyol pusht order-lifecycle-events naar uw geregistreerde webhook-URL: Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. De webhook-payload is een JSON-envelop die de order-ID en de nieuwe status draagt; uw endpoint moet binnen 3 seconden met HTTP 200 antwoorden. Bij mislukking probeert Trendyol het 5 keer opnieuw met exponentiële back-off en parkeert het event vervolgens — daarom is een reconciliatie-pull elke 5 minuten tegen /sapigw/suppliers/{id}/orders een niet-optioneel vangnet.

2. Koppelen via REST API — stap voor stap

Het officiële happy path voor het koppelen aan de REST API van Trendyol in 2026 is kort en goed gedocumenteerd — maar de volgorde van handelingen is belangrijk, omdat sommige juridische voorwaarden bovenstrooms van de API zelf liggen.

2.1 Open een Trendyol-verkopersaccount

Bezoek partner.trendyol.com en dien een aanvraag "Open een Trendyol-account" in. U hebt nodig:

• VKN (Vergi Kimlik Numarası) — Turks belastingnummer (of buitenlands equivalent bedrijfsregistratie voor Trendyol International)
• Trade Registry Gazette (Ticaret Sicil Gazetesi) voor besloten of naamloze vennootschappen
• Handtekeningcirculaire (imza sirküleri)
• ETBİS (Elektronik Ticaret Bilgi Sistemi) registratiebewijs — verplicht voor elke Turkse e-commerce-exploitant sinds 2018
• Bankrekening (IBAN TR) op naam van de juridische entiteit voor marketplace-uitbetalingen

Goedkeuring duurt doorgaans 2–5 werkdagen. Zodra goedgekeurd, ontvangt de verkoper een Supplier ID en toegang tot het Trendyol Partner-paneel.

2.2 Genereer API Key en Secret

Open vanuit het Partner-paneel Accountinstellingen → Integratie-informatie en klik op "Create API Key". Trendyol genereert een API Key van 40 tekens en een API Secret van 40 tekens. Beide waarden worden één keer getoond — ze kunnen later niet worden opgehaald. Bewaar ze in een wachtwoordmanager of, beter nog, plak ze rechtstreeks in de integratietegel van Zunapro, die ze opslaat als AES-256-versleutelde, gemaskeerde secrets.

2.3 Eerste smoke-test-aanvraag

Bevestig dat de inloggegevens actief zijn door het supplier-info-endpoint aan te roepen:

curl -X GET "https://api.trendyol.com/sapigw/suppliers/{supplierId}/addresses" \
  -H "Authorization: Basic $(echo -n 'API_KEY:API_SECRET' | base64)" \
  -H "User-Agent: {supplierId} - SelfIntegration" \
  -H "Accept: application/json"

Een geslaagde respons retourneert de geregistreerde magazijn- en retouradressen van de leverancier in JSON. Een 401 betekent dat de Basic Auth-header verkeerd is; een 403 betekent dat de Supplier ID niet overeenkomt met de inloggegevens; een 404 betekent dat het endpoint-pad onjuist is opgebouwd.

2.4 OAuth-variant (voor multi-leverancier-integrators)

Voor onafhankelijke integrators ziet de OAuth 2.0-flow er als volgt uit:

1. Integrator redirects supplier to:
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. Supplier approves access; Trendyol redirects back with ?code={authCode}

3. Integrator exchanges code for tokens:
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

4. Response: { access_token, refresh_token, expires_in: 3600 }

Access tokens zijn 1 uur geldig en 30 dagen te vernieuwen. Zunapro handelt alle vier de stappen transparant af, zodat de leverancier slechts één "Connect to Trendyol"-knop ziet.

2.5 Plaats uw eerste product

Gebruik POST /sapigw/suppliers/{supplierId}/v2/products met een JSON-array van items. Het minimale productobject vereist barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (doorgaans TRY), listPrice, salePrice, vatRate, cargoCompanyId, een images-array (1–8 URL's) en een attributes-array van categoriespecifieke attribuut-ID's.

3. Productsynchronisatie op schaal

Bulkupload — 1.000 SKU's per batch

Het POST /v2/products-endpoint van Trendyol accepteert tot 1.000 SKU's per enkele JSON-aanvraag. Voor verkopers met catalogi van 10.000+ SKU's is dit het verschil tussen een onboarding van een uur en een van meerdere dagen. De batch retourneert een batchRequestId per aanroep; Trendyol verwerkt elke batch asynchroon en toont per SKU succes / mislukking zodra de verwerking is voltooid (doorgaans binnen 1–15 minuten, afhankelijk van de diepte van de validatiewachtrij).

Categoriekoppeling — de allermoeilijkste stap

De categorieboom van Trendyol is diep en strikt. Vanaf 2026 zijn er ruwweg 12.000 eindcategorieën, elk met een eigen set verplichte en optionele attributen. Een jeans die staat onder "Heren → Broeken → Casual" vereist de attributen gender, size, color, material en fit-type; een smartphone onder "Elektronica → Mobiel → Telefoons" vereist brand, model, memory, guaranteeType en warrantyPeriod. Een product plaatsen in een verkeerde eindcategorie, of in de juiste categorie maar met een ontbrekend verplicht attribuut, levert een stille afwijzing op in het batchresultaat.

De ondersteunde aanpak is:

1. Haal de live categorieboom op met GET /sapigw/product-categories (24u cachen)
2. Haal voor elke eindcategorie de verplichte + optionele attributen op met GET /sapigw/product-categories/{categoryId}/attributes
3. Koppel uw master-catalogus-SKU's aan Trendyol-eindcategorieën — Zunapro gebruikt een ML-mapper die is getraind op miljoenen historische Trendyol-listings om categorieën voor te stellen op basis van titel + merk + uw taxonomie met een first-pass-matchpercentage van meer dan 92%
4. Valideer elke SKU tegen verplichte attributen voordat u het POST-endpoint aanroept, om rate-limit-verspilling op gedoemde aanvragen te vermijden

Merk-whitelist en brandId

Elk product moet verwijzen naar een brandId die bestaat in het merkregister van Trendyol. Nieuwe merken kunnen niet on-the-fly worden aangemaakt — ze doorlopen een handmatig merk-goedkeuringsproces via het Partner-paneel (doorgaans 1–3 werkdagen). Gebruik GET /sapigw/brands?name={brandName} om een bestaande brandId op te zoeken voordat u producten aanmaakt.

Regels voor afbeeldingsupload

• 1–8 afbeeldingen per product
• Publieke HTTPS-URL's (Trendyol crawlt de afbeeldingen en host ze opnieuw op zijn CDN)
• Minimaal 1200×1800 px, witte achtergrond voor modecategorieën
• JPG of PNG, max ~10 MB per afbeelding
• De eerste afbeelding wordt de zoekresultaat-thumbnail — investeer erin

Batchstatus-polling

GET https://api.trendyol.com/sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId}

Response:
{
  "batchRequestId": "abc-def-...",
  "status": "COMPLETED",
  "itemCount": 1000,
  "items": [
    { "requestItem": {...}, "status": "SUCCESS" },
    { "requestItem": {...}, "status": "INVALID", "failureReasons": ["INVALID_BARCODE"] }
  ]
}

4. Orderbeheer — webhooks en de statusflow

De order-lifecycle van 2026

Een Trendyol-order doorloopt een vaste statusflow:

Created → Picking → Invoiced → Shipped → Delivered

Branch flows:
  Cancelled (any time before Shipped)
  Returned (after Delivered, within 14-day window)
  UnDelivered (carrier exception)

Elke overgang activeert zowel een webhook-event (push) als wordt weerspiegeld in de volgende GET /orders-pull (poll). De verkoper is verantwoordelijk voor de overgang Picking → Invoiced → Shipped; de logistieke partners van Trendyol beheersen Shipped → Delivered.

Webhook-ontvangst en idempotentie

Elke webhook draagt een unieke shipmentPackageId. Verwerk deze idempotent — Trendyol probeert events wél opnieuw bij een respons die geen 200 is, en dubbele verwerking aan uw kant (dubbele facturatie, dubbel verzamelen) is een reëel risico. Het pragmatische patroon is:

POST /webhook/trendyol
{
  "supplierId": 123456,
  "shipmentPackageId": 987654321,
  "status": "Picking",
  "timestamp": 1717930000000
}

Handler:
1. Acquire lock on shipmentPackageId
2. Check stored status; if already >= "Picking", return 200 (no-op)
3. Persist new status, schedule downstream actions (e-invoice, picking task)
4. Return HTTP 200 within 3 seconds

Annulerings- en terugbetalingsflow

Door de koper geïnitieerde annuleringen komen binnen als Cancelled-webhooks; door de verkoper geïnitieerde annuleringen worden gepusht via POST /sapigw/suppliers/{id}/orders/{orderId}/cancel met een annuleringsredencode (OUT_OF_STOCK, OTHER enz.). Terugbetalingen voor bezorgde + geretourneerde artikelen worden automatisch door Trendyol afgehandeld; de enige verplichting van de verkoper is de ontvangst van de geretourneerde goederen binnen 48 uur na de scan van de vervoerder te bevestigen.

Trendyol Express-verzendlabel

Zodra een pakket naar de status Picking is verplaatst, vraagt u het verzendlabel op via GET /sapigw/suppliers/{id}/orders/{orderId}/labels — Trendyol retourneert een PDF (en optioneel ZPL voor thermische printers) met de Trendyol Express-barcode, het adres van de koper en het cargo-tracking-nummer. De barcode is het enige carrier-routing-artefact — print, plak, scan in uw WMS, lever af bij een Trendyol Express-afhaalpunt (of plan een koeriersophaling voor verkopers met hoog volume).

5. Voorraad- & prijsupdates in realtime

Het voorraad-prijs-pushpatroon

Trendyol biedt een speciaal endpoint voor voorraad- en prijsupdates: POST /sapigw/suppliers/{id}/products/price-and-inventory. Elke aanroep accepteert tot 1.000 items, met per item barcode, quantity, salePrice en optioneel listPrice. Updates worden binnen seconden toegepast voor voorraad, binnen 2–5 minuten voor prijs (Trendyol cachet prijs voor consistentie van de shopping-feed).

POST /sapigw/suppliers/{id}/products/price-and-inventory
{
  "items": [
    { "barcode": "8690123456789", "quantity": 42, "salePrice": 549.90, "listPrice": 699.90 },
    { "barcode": "8690987654321", "quantity": 0, "salePrice": 199.00 }
  ]
}

De master → local → targets-synchronisatiearchitectuur

Voor verkopers met meerdere verkoopkanalen (Trendyol + Hepsiburada + Çiçeksepeti + eigen shop) is de enige verstandige architectuur een master-voorraad in Zunapro die naar elke doelmarketplace pusht. De Zunapro-productiestack van 2026 draait een cron van 15 minuten plus een event-gedreven push: elke voorraadwijziging in de master activeert een onmiddellijke price-and-inventory-push naar Trendyol, terwijl de cron eventuele consistentie garandeert voor elke push die door de mazen viel. SKU's worden gematcht op barcode (primair) of stockCode (fallback) — nooit op de interne product-ID van Trendyol, die kan veranderen bij categorie-herkoppelingen.

Btw- en prijsweergaveregels

Trendyol-prijzen zijn inclusief btw. Het btw-regime van Turkije (KDV) in 2026 is 20% standaard, 10% verlaagd (voedsel, boeken, medicijnen, basisgoederen) en 1% speciaal (essentiële levensmiddelen, bepaalde landbouwproducten). De verkoper specificeert de vatRate per product en is verantwoordelijk voor het kiezen van het juiste tarief; fouten komen achteraf naar voren als e-factuurafwijzing door GİB, wat kostbaar is om te herstellen.

Trendyol Fast Sale en campagnesynchronisatie

De vlaggenschipcampagnes van Trendyol — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı (Woensdagmarkt) — zijn campagnes met verplichte geschiktheid die de zichtbaarheid van listings verhogen, maar een extra campagnecommissie van 1–3% met zich meebrengen. Verkopers voegen SKU's toe aan campagnes via POST /sapigw/suppliers/{id}/products/campaigns met kortingsprijs-overrides; Zunapro valideert campagne-prijsdrempels automatisch tegen uw master-margeregels om verplichtingen onder de kostprijs te voorkomen.

6. XML-/CSV-alternatief — wanneer (en wanneer niet) te gebruiken

Het XML-pull-model

Trendyol ondersteunt een XML-feedmodel als alternatief voor de REST-POST-flow. De verkoper host een XML-bestand op een publieke HTTPS-URL die de catalogus beschrijft; Trendyol haalt het op met een instelbare cadans (doorgaans elke 1–4 uur). Het XML-schema is gepubliceerd in het Partner-paneel en spiegelt de productobjectvorm van het REST-endpoint — barcode, title, brandId, categoryId, attributes, images, prijs, voorraad.

Hetzelfde patroon wordt ondersteund via CSV (één rij per SKU) voor verkopers wier ERP van nature makkelijker CSV dan XML exporteert.

Vergelijking: REST API vs XML / CSV

Wanneer XML / CSV daadwerkelijk de juiste keuze is

• Legacy-ERP zonder HTTP-clientmogelijkheid die al nachtelijk XML / CSV exporteert
• Langzaam veranderende catalogi (onder 500 SKU's, wekelijkse prijswijzigingen, maandelijkse catalogustoevoegingen)
• Initiële migratie vanuit een andere marketplace waar een eenmalige CSV-export de eerste synchronisatie versnelt

Voor al het andere — order-webhooks, realtime voorraad, campagne-opt-ins, multichannel-synchronisatie — is REST in 2026 het enige haalbare pad. Zunapro ondersteunt beide modi, maar kiest standaard voor REST en gebruikt XML / CSV strikt als ETL-ingestiebron uit legacy-ERP's.

7. Trendyol Express & FBA Trendyol

Trendyol Express — de logistieke laag

Trendyol Express is de volledig eigen logistieke tak van Trendyol — gelanceerd in 2018 en inmiddels het exploiteren van Turkijes dichtste e-commerce-native pakketnetwerk. Tegen 2026 dekt het 50.000+ zelfbedieningslockers en afhaalpunten naast zijn eigen koeriersvloot, en bereikt het 81 provincies met same-day-bezorging in Istanbul, Ankara, Izmir, Bursa en Antalya, en next-day-bezorging naar de rest van het Turkse vasteland. Kopers zien "Hızlı Teslimat" (snelle bezorging)-badges op geschikte listings, en de zoekrangschikking van Trendyol weegt ze agressief mee.

FBA Trendyol — Trendyol-logistiekmagazijn

FBA Trendyol (soms "Trendyol Lojistik Deposu" of "Trendyol Mağaza Plus" genoemd) is het Amazon-FBA-equivalent: verkopers verzenden voorraad naar de fulfilmentcentra van Trendyol in Çorlu (de vlaggenschipfaciliteit, 250.000 m² bij Istanbul), Sancaktepe en Ankara, en Trendyol verzorgt opslag, verzamelen, verpakken, last-mile-bezorging via Trendyol Express en retouren. FBA-listings dragen een aparte "Trendyol'dan Gönderim"-badge en krijgen prioritaire zichtbaarheidsweging in de zoekresultaten.

FBA Trendyol-kosten en geschiktheid

• Onboarding — vraag aan via het Partner-paneel; het commerciële team van Trendyol beoordeelt maandelijks volume, SKU-afmetingen en categoriefit
• Opslagkosten — maandelijks in rekening gebracht per kubieke meter bezette magazijnruimte; varieert per seizoen (Q4-opslag kost meer)
• Pick-and-pack-kosten — vast tarief per order, varieert per pakketgewichtsband (onder 500g, 500g–2kg, 2–5kg, 5–10kg, 10kg+)
• Retourafhandeling — inbegrepen in de pick-and-pack-kosten voor standaardretouren; gemarkeerde condities worden apart gefactureerd

Wanneer FBA Trendyol zinvol is

Het break-evenpunt voor FBA Trendyol ten opzichte van zelf-fulfilment ligt op ruwweg 800–1.200 eenheden per maand per magazijn-SKU voor snelbewegende verbruiksartikelen, elektronica of mode in maatruns. Daaronder is zelf-fulfilment via Trendyol Express-drop-off plus uw eigen contract met Aras / Yurtiçi / DHL meestal goedkoper. Daarboven weegt de conversielift van de "Trendyol'dan Gönderim"-badge plus de same-day-bezorgbelofte bijna altijd op tegen de per-eenheid-fulfilmentkosten.

8. GİB e-factuurintegratie (e-Fatura / e-Arşiv)

Het GİB-mandaat

De Gelir İdaresi Başkanlığı (GİB — Belastingdienst) van Turkije heeft e-Fatura verplicht gemaakt voor elke onderneming met een jaaromzet boven de door GİB gepubliceerde drempel (jaarlijks herzien; ~TRY 3M vanaf 2026) en e-Arşiv Fatura verplicht voor alle B2C-facturen boven ~TRY 30.000 (jaarlijks herzien). Voor actieve Trendyol-verkopers in 2026 is e-Fatura-/e-Arşiv-dekking feitelijk universeel — vrijwel elke marketplace-order moet binnen het orderstatusvenster een GİB-gestempelde elektronische factuur produceren, anders volgen boetes.

De vijf GİB-gecertificeerde integrators

Verkopers kunnen ofwel de portal van GİB rechtstreeks gebruiken (onpraktisch bij marketplace-volumes) of een contract sluiten met een GİB-gecertificeerde Özel Entegratör (Speciale Integrator). De vijf dominante spelers in 2026 zijn:

• Logo Yazılım — de grootste Turkse ERP-leverancier; e-Logo voor factuuruitgifte
• Mikro Yazılım — mid-market ERP- en e-factuurprovider, sterk in het mkb-segment
• Uyumsoft — onafhankelijke integrator met een robuuste REST API en de grootste marketplace-verkopersbasis
• Foriba — enterprise-tier-provider (in 2019 overgenomen door Sovos), sterk in gereguleerde sectoren
• Veriban — snelgroeiend alternatief met competitieve prijzen en een ontwikkelaarsvriendelijke API

De marketplace-e-factuurflow

1. Trendyol webhook: order status -> "Picking"
2. Zunapro pulls order detail (buyer name, VKN/TCKN, address, items)
3. Zunapro POSTs invoice draft to integrator (Logo/Mikro/Uyumsoft/Foriba/Veriban)
4. Integrator signs with e-Signature certificate, submits to GİB
5. GİB returns ETTN (Electronic Document Unique Number)
6. Zunapro stores ETTN, attaches PDF to Trendyol order
7. Zunapro transitions Trendyol order Picking -> Invoiced via API

Praktische keuze voor 2026

Voor nieuwe verkopers zijn Uyumsoft en Veriban het makkelijkst te onboarden (web-aanmelding, REST API, geen on-prem-afhankelijkheid). Verkopers die al Logo of Mikro ERP draaien, kunnen het beste bij het e-factuurproduct van dezelfde leverancier blijven voor boekhoudkundige afstemming. Foriba is de keuze voor grote ondernemingen met complexe belastingworkflows. Zunapro wordt geleverd met alle vijf de integraties achter één configuratiescherm — kies de integrator, plak de API-inloggegevens, en elke Trendyol-order wordt automatisch gefactureerd.

9. Veelvoorkomende fouten en hoe u eromheen ontwerpt

Categorie-mismatch

Symptoom: het batchresultaat toont INVALID_CATEGORY of CATEGORY_NOT_LEAF. Oorzaak: plaatsen in een niet-eindcategorie, of in een eindcategorie waarvan de SKU niet aan de attribuutset voldoet. Oplossing: plaats altijd alleen in eindcategorieën (de API wijst niet-eindcategorieën af) en pre-valideer attributen tegen de required: true-set van de categorie vóór de POST.

Ontbrekende verplichte attributen

Symptoom: MANDATORY_ATTRIBUTE_MISSING op verder geldige SKU's. Oorzaak: Trendyol markeert ~30% van de attributen als verplicht op categoriebasis (gender voor mode, garantie voor elektronica, enz.). Oplossing: cache de per-categorie attribuutvereisten-map en houd POSTs tegen op volledigheid; Zunapro vult automatisch aan uit uw master-taxonomie waar mogelijk.

Voorraadsynchronisatie-vertragingen

Symptoom: een uitverkochte SKU toont nog enkele minuten op voorraad op Trendyol, wat oververkopen veroorzaakt. Oorzaak: price-and-inventory-pushes zijn eventueel consistent met een mediane latency van ~5–8 seconden, en tijdens verkeerspieken (Black Friday, Trendyol Week) kan de wachtrij oplopen tot 30–60 seconden. Oplossing: implementeer een lokale veiligheidsbuffer (reserveer de laatste 1–2 eenheden als out-of-stock-buffer per SKU met hoge velocity) en push voorraadwijzigingen synchroon bij het order-bevestigingsevent, niet alleen bij cron.

Gemiste webhooks

Symptoom: een order-webhook arriveert nooit of uren te laat. Oorzaak: meestal een firewallwijziging aan de verkoperskant, een TLS-certificaatvernieuwing die de webhook-URL brak, of een korte storing die het 5-retry-budget van Trendyol overschreed. Oplossing: draai altijd een parallelle reconciliatie-pull elke 5 minuten tegen /sapigw/suppliers/{id}/orders?status=Created&startDate=...; Zunapro doet dit standaard en voegt elke opgehaalde order idempotent samen met een order die de webhook ook heeft afgeleverd.

Meerdere listings, dezelfde barcode (Mükerrer Listing)

Symptoom: een enkele SKU verschijnt als meerdere Trendyol-listings, en de voorraad wordt op elk anders afgeboekt. Oorzaak: historische samenvoegingen, dubbele barcode-invoeren, of multi-store-fan-out van hetzelfde product. Oplossing: Zunapro's MIN-voorraad-deduplicatiebeleid (geïntroduceerd in onze productie-update van 2026-06-06) klapt alle dubbele listings onder één barcode samen en volgt de minimale voorraadwaarde erover, waardoor de klassieke ramp "twee keer verkocht op twee listings, één levering beloofd" wordt voorkomen.

10. Trendyol-commissie en verkopersvergoedingen 2026

Het commissieschema van Trendyol voor 2026 is getrapt per categorie, met drie brede banden en geen vaste vergoeding per artikel. Deelname aan campagnes (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) voegt een extra 1–3% toe bovenop het categorietarief.

Verkopers-/abonnementsvergoedingen

Trendyol brengt geen maandelijks abonnement in rekening. Er is geen Amazon-achtige "Professional Seller"-tier. Verkopers betalen:

• Categoriecommissie op elke verkoop (8–22%)
• Campagnecommissie bij deelname aan Trendyol Fast Sale / Week (+1–3%)
• Trendyol Express per-zending-vergoeding (betaald door de koper, maar loopt door de P&L van de verkoper)
• FBA Trendyol-opslag + pick-and-pack (alleen bij inschrijving)
• Trendyol Ads CPC (optioneel, beheerd door de verkoper)

Uitbetalingscyclus

Standaardverkopers worden betaald op een T+14-cyclus (14 dagen na orderbezorging), teruggebracht tot T+7 voor verkopers met een top-tier verkopersscore. Betwiste orders, retouren binnen het 14-daagse venster en chargebacks worden ingehouden op de uitbetaling. Uitbetalingen komen binnen op de geregistreerde TR IBAN.

Turks juridisch kader 2026 — wat marketplace-verkopers moeten weten

KDV (btw) en KDV-tariefbanden

De btw van Turkije — KDV (Katma Değer Vergisi) — kent drie tarieven in 2026: 20% standaard, 10% verlaagd (voedsel, boeken, medicijnen, horeca), 1% speciaal (basislevensmiddelen, landbouw). Marketplace-verkopers die in Turkije zijn gevestigd, registreren zich voor KDV via hun lokale belastingkantoor; grensoverschrijdende verkopers boven de digitale-dienstendrempel gebruiken het KDV-niet-ingezetenenregime. Het vatRate-veld op elke Trendyol-product-POST moet overeenkomen met het juridisch juiste tarief — fouten verspreiden zich naar e-facturen en kunnen correctie-aangiften vereisen.

e-Fatura / e-Arşiv (GİB verplicht)

Reeds in detail behandeld in sectie 8. Onderaan de streep voor 2026: elke marketplace-order produceert een GİB-gestempelde elektronische factuur (e-Fatura voor B2B / geregistreerde e-Fatura-ontvangers, e-Arşiv voor B2C). De verkoper is aansprakelijk voor uitgifte binnen het orderstatusvenster. Handmatige uitgifte is onpraktisch bij marketplace-volumes — kies een van de vijf GİB-integrators en automatiseer.

KVKK — Turkse AVG

KVKK (Kişisel Verilerin Korunması Kanunu — Wet nr. 6698) is het gegevensbeschermingsregime van Turkije, structureel vergelijkbaar met de AVG en gehandhaafd door KVKK Kurumu. Marketplaces handelen de toestemming en verwerking aan koperszijde af, maar verkopers blijven gezamenlijke verwerkingsverantwoordelijken voor elk direct klantcontact, marketing of communicatie na aankoop. Boetes voor niet-naleving lopen van TRY 60K tot TRY 3M+ afhankelijk van de klasse van de overtreding.

ETBİS — verplicht e-commerceregister

ETBİS (Elektronik Ticaret Bilgi Sistemi) is het verplichte register van het Ministerie van Handel voor elke e-commerce-exploitant in Turkije, van kracht sinds 2018. Verkopers moeten zich registreren voordat ze op Trendyol listen en jaarlijkse transactievolumes rapporteren. ETBİS-gegevens voeden de handhaving van consumentenbescherming, antifraudescreening en concurrentie-analyse.

Consumentenbescherming — 14 dagen herroeping, 2 jaar garantie

• 14-daags herroepingsrecht — Turkse consumenten mogen elk op afstand gekocht product binnen 14 dagen retourneren, zonder opgaaf van reden (Tüketicinin Korunması Hakkında Kanun, Wet nr. 6502)
• 2 jaar wettelijke garantie — verplicht bij B2C-verkoop, onafhankelijk van elke fabrikantengarantie
• Verplichte Turkstalige productinformatie — titel, beschrijving, garantie, retourbeleid allemaal in het Turks

Logistiek & verzending in Turkije — Trendyol Express eerst

Trendyol Express — de dominante laag

Trendyol Express is de standaardvervoerder op ruwweg 70%+ van de Trendyol-orders in 2026. De koper ziet gratis of goedkope verzending met same-day- of next-day-bezorging in grote metropolen, plus 50.000+ zelfbedieningslockers (Trendyol Hızlı Teslimat Noktaları) waar shoppers pakketten 24/7 ophalen. Verkopers leveren pakketten af bij een Trendyol Express-inleverpunt of plannen een koeriersophaling; de routeringsslip draagt de Trendyol Express-barcode die is verkregen uit de order-label-API.

De andere geïntegreerde vervoerders

• Yurtiçi Kargo — reeds lang gevestigde Turkse koerier, sterk B2C- en B2B-netwerk, geïntegreerd voor Trendyol-orders
• Aras Kargo — concurrent met sterke Anatolische dekking, vaak gebruikt voor zelf-gefulfilde Trendyol-orders
• DHL Kargo — derde grote Turkse koerier, gangbare fallback voor verkopers met hoog volume
• PTT Kargo — staatspostbedrijf, breedste plattelandsbereik, tragere SLA's
• Sürat Kargo — regionale speler, competitief in de Marmara- en Egeïsche regio's

Praktische verzendstack 2026

De pragmatische stack voor 2026 voor een Trendyol-verkoper: Trendyol Express als standaard (dat is wat kopers verwachten), Yurtiçi of Aras als verkoper-zijdige fallback voor zelf-gefulfilde orders die het Trendyol Express-ophaalvenster missen, PTT Kargo voor uitsluitend-rurale postcodes waar geen andere vervoerder rendabel is, en FBA Trendyol voor snelbewegende SKU's zodra het volume de opslagverplichting rechtvaardigt.

Zo begint u met verkopen op Trendyol — 5-stappen-onboarding

1. Trendyol-verkopersaccount

Vraag aan op partner.trendyol.com. Verstrek VKN, Trade Registry Gazette, handtekeningcirculaire, ETBİS-registratiebewijs en TR IBAN. Goedkeuring in 2–5 werkdagen.

2. ETBİS + belastingregistratie

Registreer de juridische entiteit in ETBİS via de portal van het Ministerie van Handel (etbis.gtb.gov.tr) en bevestig de KDV-registratie bij het lokale belastingkantoor. Buitenlandse verkopers die via Trendyol International opereren, stellen ofwel een Turkse vertegenwoordiger aan, ofwel gebruiken ze het import-of-record-programma van Trendyol.

3. Genereer API Key + Secret

Klik vanuit het Partner-paneel → Accountinstellingen → Integratie-informatie op "Create API Key". Kopieer de API Key (40 tekens) en API Secret (40 tekens) onmiddellijk — ze worden slechts één keer getoond. Plak ze in de Trendyol-tegel van Zunapro, waar ze AES-256-versleuteld en gemaskeerd worden opgeslagen.

4. Koppel via het Zunapro-paneel

1. Log in op Zunapro en open de Turkije-module
2. Plak Supplier ID + API Key + API Secret in de Trendyol-integratietegel
3. Voer de automatische gezondheidscontrole uit (inloggegevens, addresses-endpoint, supplier-info)
4. Bevestig de door ML voorgestelde categoriekoppelingen voor uw top 100 SKU's
5. Kies uw e-factuurintegrator (Logo, Mikro, Uyumsoft, Foriba of Veriban) en plak die inloggegevens
6. Schakel "Trendyol Express" + "FBA Trendyol" in (indien ingeschreven)

5. Voer een testorder uit

Plaats 3–5 stage-orders tegen stageapi.trendyol.com om de pick-pack-, label-print-, statusovergang- en terugbetalingsflows end-to-end te oefenen. Zodra alles groen is, zet u de integratie met één toggle over naar productie. De eerste productiesynchronisatie van een catalogus met 5.000 SKU's is voltooid in ruwweg 30–60 minuten, gezien de rate limits van Trendyol.

De drie Trendyol-integratiepaden — vergeleken

Voordat u zich vastlegt op een integratiearchitectuur, helpt het om de drie legitieme paden naast elkaar te vergelijken.

Trendyol-integratie-FAQ 2026