Trendyol integrációs útmutató 2026: REST API, XML-kapcsolat és központosított áruházkezelés

1. Trendyol API architektúra 2026

A Trendyol piactéri API-ja egy RESTful, JSON-over-HTTPS interfész, amelyet egyetlen éles alap URL-en tesznek közzé — https://api.trendyol.com — külön stage környezettel a https://stageapi.trendyol.com címen. Minden API hívást HTTP Basic Auth hitelesít: az Authorization fejléc egy base64-kódolt ApiKey:ApiSecret párt hordoz, a Beszállítói azonosítót pedig útvonalparaméterként adják át minden beszállító-szintű végponton. Nincs külön hozzáférési token-kör az elsődleges eladók számára — a Basic Auth minden kérésnél ellenőrzésre kerül —, ami egyszerűvé teszi az integrációt, de azt jelenti, hogy a kiszivárgott hitelesítő adatokat azonnal rotálni kell a Partner panelen keresztül.

Alap URL, hitelesítés, fejlécek

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

A User-Agent fejléc nem kozmetikai jellegű: a Trendyol forgalomformálása és sebességkorlát-elszámolása erre épül. Az integrátorok (mint a Zunapro) {supplierId} - Zunapro értéket küldenek; az elsődleges eladók {supplierId} - SelfIntegration értéket. A hibásan beállított User-Agent fejlécek 401/403 válaszokat válthatnak ki érvényes hitelesítő adatok mellett is.

Sebességkorlátok és kvóták

A Trendyol végpontonkénti, beszállítónkénti sebességkorlátokat érvényesít. A közzétett 2026-os plafonok:

• Termékvégpontok — jellemzően 60 kérés/perc Beszállítói azonosítónként, 90/perc csúcsterhelési tűréssel 30 másodpercig
• Rendelésvégpontok — jellemzően 600 kérés/perc (a rendelések tervezésnél fogva nagy forgalmú, alacsony késleltetésű végpontok)
• Ár- és készletfrissítési végpontok — jellemzően 100 kérés/perc, kérésenként akár 1000 tétel kötegelésével
• Kategória- és attribútum-lekérdezések — jellemzően 30 kérés/perc (ezek lassan változnak, ezért agresszív gyorsítótárazás javasolt)

Minden válasz tartalmazza az X-RateLimit-Limit, X-RateLimit-Remaining fejléceket, és 429-es hibák esetén a Retry-After fejlécet. Egy jól felépített integráció Beszállítói azonosítónkénti token-bucket sort használ, és exponenciális visszalépéssel reagál a 429-es hibákra; a Zunapro ezt alapértelmezetten megvalósítja, így még a több ezer SKU-t érintő tömeges push műveletek sem lépik túl a korlátokat.

OAuth 2.0 független integrátoroknak

A független köztes rétegű integrátorok (a Zunapro és hasonló SaaS platformok, amelyek sok beszállító nevében járnak el) számára a Trendyol egy OAuth 2.0 authorization-code folyamatot kínál a közvetlen Basic Auth helyett. Az integrátor regisztrál egy client_id / client_secret párt a Trendyol fejlesztői kapcsolattartó csapatánál, a beszállító engedélyezi az integrátort a Partner panelről, és az integrátor egy 1 órás hozzáférési tokent kap, valamint egy frissítő tokent az újbóli kibocsátáshoz. Ez elkerüli, hogy valaha is kezelni kelljen a beszállító nyers ApiKey / ApiSecret párját, és ez az auditbarát út a sok Trendyol áruházat kezelő vállalati ügyfelek számára.

Webhookok

A Trendyol rendelés-életciklus eseményeket küld a regisztrált webhook URL-edre: Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. A webhook payload egy JSON boríték, amely hordozza a rendelésazonosítót és az új státuszt; a végpontodnak 3 másodpercen belül HTTP 200-zal kell válaszolnia. Hiba esetén a Trendyol ötször próbálkozik újra exponenciális visszalépéssel, majd parkolja az eseményt — ezért nem elhagyható egy 5 perces egyeztető lekérdezés a /sapigw/suppliers/{id}/orders ellen biztonsági hálóként.

2. Csatlakozás REST API-n keresztül — lépésről lépésre

A Trendyol REST API-jához való csatlakozás hivatalos folyamata 2026-ban rövid és jól dokumentált — de a műveletek sorrendje számít, mert néhány jogi előfeltétel megelőzi magát az API-t.

2.1 Trendyol eladói fiók nyitása

Látogass el a partner.trendyol.com oldalra, és nyújts be egy "Trendyol fiók nyitása" kérelmet. Szükséged lesz:

• VKN (Vergi Kimlik Numarası) — török adóazonosító szám (vagy külföldi megfelelő cégbejegyzés a Trendyol International esetében)
• Cégjegyzéki közlöny (Ticaret Sicil Gazetesi) korlátolt felelősségű vagy részvénytársaságok esetén
• Aláírási címpéldány (imza sirküleri)
• ETBİS (Elektronik Ticaret Bilgi Sistemi) regisztrációs igazolás — kötelező minden török e-kereskedelmi szereplő számára 2018 óta
• Bankszámla (IBAN TR) a jogi entitás nevén a piactéri kifizetésekhez

A jóváhagyás jellemzően 2–5 munkanapot vesz igénybe. A jóváhagyás után az eladó megkapja a Beszállítói azonosítót és hozzáférést a Trendyol Partner panelhez.

2.2 API kulcs és titkos kulcs generálása

A Partner panelen nyisd meg a Fiókbeállítások → Integrációs adatok menüpontot, és kattints az "API kulcs létrehozása" gombra. A Trendyol generál egy 40 karakteres API kulcsot és egy 40 karakteres API titkos kulcsot. Mindkét érték csak egyszer jelenik meg — később nem kérhetők le. Mentsd el őket egy jelszókezelőben, vagy még jobb, illeszd be közvetlenül a Zunapro integrációs csempéjébe, amely AES-256 titkosítású, maszkolt titkokként tárolja őket.

2.3 Első próbakérés

Erősítsd meg, hogy a hitelesítő adatok élnek, a beszállítói-információ végpont meghívásával:

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"

Egy sikeres válasz visszaadja a beszállító regisztrált raktár- és visszaküldési címeit JSON formátumban. A 401-es hiba azt jelenti, hogy a Basic Auth fejléc hibás; a 403-as, hogy a Beszállítói azonosító nem egyezik a hitelesítő adatokkal; a 404-es, hogy a végpont útvonala hibásan formázott.

2.4 OAuth variáns (több beszállítós integrátoroknak)

Független integrátorok esetében az OAuth 2.0 folyamat így néz ki:

1. Az integrátor átirányítja a beszállítót ide:
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. A beszállító jóváhagyja a hozzáférést; a Trendyol visszairányít ?code={authCode} paraméterrel

3. Az integrátor beváltja a kódot tokenekre:
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

4. Válasz: { access_token, refresh_token, expires_in: 3600 }

A hozzáférési tokenek 1 óráig érvényesek, és 30 napig megújíthatók. A Zunapro mind a négy lépést átláthatóan kezeli, így a beszállító csak egyetlen "Csatlakozás a Trendyolhoz" gombot lát.

2.5 Az első termék feltöltése

Használd a POST /sapigw/suppliers/{supplierId}/v2/products végpontot egy JSON tömbbel a tételekhez. A minimális termékobjektum megköveteli a barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (jellemzően TRY), listPrice, salePrice, vatRate, cargoCompanyId mezőket, egy images tömböt (1–8 URL) és egy attributes tömböt a kategóriaspecifikus attribútum-azonosítókkal.

3. Termékszinkronizálás nagy méretekben

Tömeges feltöltés — 1000 SKU kötegenként

A Trendyol POST /v2/products végpontja akár 1000 SKU-t is elfogad egyetlen JSON kérésben. A 10 000+ SKU-s katalógussal rendelkező eladók számára ez a különbség az egyórás és a több napos onboarding között. A köteg egy batchRequestId-t ad vissza hívásonként; a Trendyol aszinkron módon dolgozza fel az egyes kötegeket, és az SKU-nkénti sikert / hibát a feldolgozás befejezése után teszi elérhetővé (jellemzően 1–15 percen belül, a validációs sor mélységétől függően).

Kategória-hozzárendelés — a legnehezebb lépés

A Trendyol kategóriafája mély és szigorú. 2026-ban körülbelül 12 000 végkategória létezik, mindegyik saját kötelező és opcionális attribútumkészlettel. Egy "Férfi → Nadrág → Alkalmi" kategóriába sorolt farmernek gender, size, color, material és fit-type attribútumokra van szüksége; egy "Elektronika → Mobil → Telefonok" kategóriájú okostelefonnak brand, model, memory, guaranteeType és warrantyPeriod attribútumokra. Egy termék hibás végkategóriába helyezése, vagy a megfelelő kategóriába helyezése kötelező attribútum nélkül, néma elutasítást eredményez a köteg eredményében.

A támogatott megközelítés a következő:

1. Kérd le az élő kategóriafát a GET /sapigw/product-categories végpontról (gyorsítótárazd 24 órára)
2. Minden végkategóriához kérd le a kötelező + opcionális attribútumokat a GET /sapigw/product-categories/{categoryId}/attributes végpontról
3. Illeszd a mester katalógusod SKU-jait a Trendyol végkategóriáihoz — a Zunapro egy ML-alapú hozzárendelőt használ, amelyet több millió korábbi Trendyol termékleírás alapján tanítottak, és amely a cím + márka + a taxonómiád alapján javasol kategóriákat 92%+ elsőre-találati aránnyal
4. Validáld minden SKU-t a kötelező attribútumok ellenében a POST végpont meghívása előtt, hogy elkerüld a sebességkorlát pazarlását biztosan sikertelen kérésekre

Márka-jegyzék és brandId

Minden terméknek olyan brandId-re kell hivatkoznia, amely szerepel a Trendyol márkanyilvántartásában. Új márkákat nem lehet menet közben létrehozni — kézi márkajóváhagyási folyamaton mennek keresztül a Partner panelen (jellemzően 1–3 munkanap). Használd a GET /sapigw/brands?name={brandName} végpontot a meglévő brandId kikereséséhez termékek létrehozása előtt.

Képfeltöltési szabályok

• 1–8 kép termékenként
• Nyilvános, HTTPS URL-ek (a Trendyol lehívja és újratárolja a képeket saját CDN-jén)
• Minimum 1200×1800 px, fehér háttér divatkategóriáknál
• JPG vagy PNG, max ~10 MB képenként
• Az első kép lesz a keresési találati miniatűr — érdemes befektetni bele

Köteg-státusz lekérdezés

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

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

4. Rendeléskezelés — webhookok és a státuszfolyamat

A 2026-os rendelés-életciklus

Egy Trendyol rendelés egy fix státuszfolyamaton halad végig:

Created → Picking → Invoiced → Shipped → Delivered

Elágazó folyamatok:
  Cancelled (bármikor a Shipped előtt)
  Returned (Delivered után, 14 napos ablakon belül)
  UnDelivered (futár kivétel)

Minden átmenet elindít egy webhook eseményt (push), és megjelenik a következő GET /orders lekérdezésben (poll) is. Az eladó felelős a Picking → Invoiced → Shipped átmenetért; a Trendyol logisztikai partnerei irányítják a Shipped → Delivered átmenetet.

Webhook fogadás és idempotencia

Minden webhook egy egyedi shipmentPackageId-t hordoz. Dolgozd fel idempotens módon — a Trendyol újrapróbálja az eseményeket nem-200-as válasz esetén, és a nálad történő duplikált feldolgozás (dupla számlázás, dupla összekészítés) valós kockázat. A pragmatikus minta a következő:

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

Kezelő:
1. Zárolás megszerzése a shipmentPackageId-on
2. A tárolt státusz ellenőrzése; ha már >= "Picking", visszaadás 200-zal (no-op)
3. Az új státusz mentése, a lekövetkező műveletek ütemezése (e-számla, összekészítési feladat)
4. HTTP 200 visszaadása 3 másodpercen belül

Lemondási és visszatérítési folyamat

A vevő által kezdeményezett lemondások Cancelled webhookként érkeznek; az eladó által kezdeményezett lemondásokat a POST /sapigw/suppliers/{id}/orders/{orderId}/cancel végponton keresztül küldik el egy lemondási okkóddal (OUT_OF_STOCK, OTHER stb.). A kiszállított és visszaküldött tételek visszatérítését a Trendyol automatikusan kezeli; az eladó egyetlen kötelezettsége a visszaküldött áru átvételének megerősítése a futár beolvasásától számított 48 órán belül.

Trendyol Express szállítási címke

Amint egy csomag Picking státuszba kerül, kérd le a szállítási címkét a GET /sapigw/suppliers/{id}/orders/{orderId}/labels végponton — a Trendyol egy PDF-et ad vissza (és opcionálisan ZPL-t hőnyomtatókhoz), amely tartalmazza a Trendyol Express vonalkódot, a vevő címét és a futárkövetési számot. A vonalkód az egyetlen szállítási irányítási elem — nyomtasd ki, ragaszd fel, olvasd be a WMS-edbe, add le egy Trendyol Express átvételi ponton (vagy ütemezz futárfelvételt nagy forgalmú eladóknak).

5. Készlet- és árfrissítések valós időben

A készlet-ár push minta

A Trendyol egy dedikált végpontot kínál a készlet- és árfrissítésekhez: POST /sapigw/suppliers/{id}/products/price-and-inventory. Minden hívás akár 1000 tételt is elfogad, a barcode, quantity, salePrice és opcionális listPrice mezőkkel tételenként. A frissítések másodpercek alatt érvényesülnek a készlet esetében, 2–5 percen belül az ár esetében (a Trendyol gyorsítótárazza az árat a vásárlási feed konzisztenciája érdekében).

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 }
  ]
}

A mester → helyi → célpiacok szinkron architektúra

Azoknak az eladóknak, akik több értékesítési csatornát futtatnak (Trendyol + Hepsiburada + Çiçeksepeti + saját bolt), az egyetlen ésszerű architektúra egy mester készlet a Zunapróban, amely minden célpiacra pusholja az adatokat. A 2026-os Zunapro éles stack egy 15 perces cront futtat esemény-vezérelt pusholással kiegészítve: bármilyen készletváltozás a mesterben azonnali ár-készlet pusht indít el a Trendyol felé, míg a cron biztosítja az eventual consistency-t minden olyan push esetében, amely esetleg kimaradt volna. Az SKU-kat vonalkód alapján (elsődleges) vagy stockCode alapján (tartalék) illesztik — soha nem a Trendyol belső termékazonosítója alapján, amely megváltozhat kategória-újratérképezéskor.

ÁFA és ármegjelenítési szabályok

A Trendyol árai ÁFA-t tartalmaznak. Törökország 2026-os ÁFA (KDV) rendszere 20% standard, 10% csökkentett (élelmiszer, könyvek, gyógyszerek, alapvető cikkek) és 1% speciális (alapvető élelmiszerek, bizonyos mezőgazdasági termékek) kulcsokat alkalmaz. Az eladó adja meg a vatRate értéket termékenként, és felelős a helyes kulcs kiválasztásáért; a hibák utólag e-számla-elutasításként jelentkeznek a GİB részéről, amelynek orvoslása költséges.

Trendyol Fast Sale és kampányszinkron

A Trendyol zászlóshajó kampányai — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı (szerdai piac) — kötelező jogosultsági kampányok, amelyek növelik a hirdetés láthatóságát, de további 1–3%-os kampányjutalékkal járnak. Az eladók a POST /sapigw/suppliers/{id}/products/campaigns végponton keresztül léptetik be az SKU-kat a kampányokba kedvezményes ár-felülírásokkal; a Zunapro automatikusan validálja a kampányár-küszöböket a mester árrés-szabályaid ellenében, hogy megelőzze az önköltség alatti vállalásokat.

6. XML / CSV alternatíva — mikor (és mikor nem) érdemes használni

Az XML lekérési modell

A Trendyol egy XML feed modellt is támogat a REST POST folyamat alternatívájaként. Az eladó egy nyilvános HTTPS URL-en tárol egy XML fájlt, amely leírja a katalógust; a Trendyol egy konfigurálható ütemben (jellemzően 1–4 óránként) lekéri azt. Az XML séma a Partner panelen kerül közzétételre, és tükrözi a REST végpont termékobjektum-alakját — vonalkód, cím, brandId, categoryId, attribútumok, képek, ár, készlet.

Ugyanez a minta CSV-n keresztül is támogatott (soronként egy SKU) azoknak az eladóknak, akiknek az ERP-je természetesebben exportál CSV-t, mint XML-t.

Összehasonlítás: REST API vs XML / CSV

Mikor jó választás valójában az XML / CSV

• Régi ERP HTTP-kliens képesség nélkül, amely már exportál XML / CSV-t éjszakánként
• Lassan változó katalógusok (500 SKU alatt, heti árváltozások, havi katalógusbővítés)
• Kezdeti migráció egy másik piactérről, ahol egy egyszeri CSV export felgyorsítja az első szinkront

Minden más esetben — rendelés webhookok, valós idejű készlet, kampányba lépés, többcsatornás szinkron — a REST az egyetlen életképes út 2026-ban. A Zunapro mindkét módot támogatja, de alapértelmezetten a REST-et használja, és az XML / CSV-t szigorúan ETL beviteli forrásként kezeli régi ERP-kből.

7. Trendyol Express és FBA Trendyol

Trendyol Express — a logisztikai réteg

A Trendyol Express a Trendyol teljes egészében saját tulajdonú logisztikai szárnya — 2018-ban indult, és mára Törökország legsűrűbb e-kereskedelem-natív csomaghálózatát üzemelteti. 2026-ra 50 000+ önkiszolgáló automatát és átvételi pontot fed le saját futárflottája mellett, 81 tartományt érintve aznapi kiszállítással Isztambulban, Ankarában, Izmirben, Bursában és Antalyában, és másnapi kiszállítással a törökországi szárazföld többi részére. A vásárlók "Hızlı Teslimat" (gyors kiszállítás) jelvényeket látnak a jogosult hirdetéseken, és a Trendyol keresési rangsorolása agresszíven súlyozza ezeket.

FBA Trendyol — Trendyol logisztikai raktár

Az FBA Trendyol (néha "Trendyol Lojistik Deposu" vagy "Trendyol Mağaza Plus" néven is emlegetik) az Amazon FBA megfelelője: az eladók a Trendyol teljesítési központjaiba szállítják a készletüket Çorluban (a zászlóshajó létesítmény, 250 000 m² Isztambul közelében), Sancaktepe-ben és Ankarában, a Trendyol pedig kezeli a tárolást, összekészítést, csomagolást, az utolsó mérföldes kiszállítást a Trendyol Expressen keresztül, és a visszaküldéseket. Az FBA hirdetések megkülönböztető "Trendyol'dan Gönderim" jelvényt kapnak, és elsőbbségi láthatósági súlyozást élveznek a keresésben.

FBA Trendyol díjak és jogosultság

• Onboarding — jelentkezés a Partner panelen keresztül; a Trendyol kereskedelmi csapata felülvizsgálja a havi forgalmat, az SKU méreteit és a kategóriaillesztést
• Tárolási díj — havonta számlázva a raktártér elfoglalt köbmétere alapján; szezontól függően változik (Q4-ben magasabb a tárolási költség)
• Összekészítési és csomagolási díj — rendelésenkénti fix díj, a csomag súlysávjától függően változik (500g alatt, 500g–2kg, 2–5kg, 5–10kg, 10kg felett)
• Visszaküldés-kezelés — a szabványos visszaküldéseknél az összekészítési és csomagolási díjban benne foglaltatik; a megjelölt állapotokat külön számlázzák

Mikor éri meg az FBA Trendyol

Az FBA Trendyol megtérülési pontja az önteljesítéssel szemben körülbelül havi 800–1200 egység raktári SKU-nként a gyorsan mozgó fogyasztási cikkek, elektronika vagy méretskálás divatcikkek esetében. Ez alatt az önteljesítés a Trendyol Express leadási ponttal és saját Aras / Yurtiçi / MNG szerződéssel általában olcsóbb. E fölött a "Trendyol'dan Gönderim" jelvényből és az aznapi kiszállítási ígéretből származó konverziónövekedés szinte mindig felülmúlja az egységenkénti teljesítési költséget.

8. GİB e-számla integráció (e-Fatura / e-Arşiv)

A GİB kötelezettség

Törökország Gelir İdaresi Başkanlığı (GİB — Adóhatóság) kötelezővé tette az e-Faturát minden olyan vállalkozás számára, amelynek éves forgalma meghaladja a GİB által közzétett küszöböt (évente felülvizsgálva; kb. 3 millió TRY 2026-ban), és az e-Arşiv Faturát kötelezővé tette minden B2C számlára kb. 30 000 TRY felett (évente felülvizsgálva). A 2026-os aktív Trendyol eladók számára az e-Fatura / e-Arşiv lefedettség gyakorlatilag egyetemes — szinte minden piactéri rendelésnek GİB-pecséttel ellátott elektronikus számlát kell generálnia a rendelésstátusz-ablakon belül, különben büntetéssel néz szembe.

Az öt GİB-hitelesített integrátor

Az eladók vagy közvetlenül a GİB portálját használhatják (piactéri méretekben nem praktikus), vagy szerződhetnek egy GİB-hitelesített Özel Entegratörrel (speciális integrátor). Az öt domináns szereplő 2026-ban:

• Logo Yazılım — a legnagyobb török ERP-gyártó; e-Logo a számlakibocsátáshoz
• Mikro Yazılım — középpiaci ERP és e-számla szolgáltató, erős a KKV szegmensben
• Uyumsoft — független integrátor robusztus REST API-val és a legnagyobb piactéri eladói bázissal
• Foriba — vállalati szintű szolgáltató (a Sovos vásárolta fel 2019-ben), erős a szabályozott iparágakban
• Veriban — gyorsan növekvő alternatíva versenyképes árazással és fejlesztőbarát API-val

A piactéri e-számla folyamat

1. Trendyol webhook: rendelésstátusz -> "Picking"
2. A Zunapro lekéri a rendelés részleteit (vevő neve, VKN/TCKN, cím, tételek)
3. A Zunapro elküldi a számlatervezetet az integrátornak (Logo/Mikro/Uyumsoft/Foriba/Veriban)
4. Az integrátor e-aláírási tanúsítvánnyal aláírja, benyújtja a GİB-nek
5. A GİB visszaadja az ETTN-t (elektronikus dokumentum egyedi száma)
6. A Zunapro tárolja az ETTN-t, csatolja a PDF-et a Trendyol rendeléshez
7. A Zunapro átvezeti a Trendyol rendelést Picking -> Invoiced státuszba az API-n keresztül

Gyakorlati 2026-os választás

Új eladók számára az Uyumsoft és a Veriban a legkönnyebben bevezethető (webes regisztráció, REST API, nincs helyszíni függőség). A már Logo vagy Mikro ERP-t futtató eladóknak érdemes ugyanannál a szolgáltatónál maradniuk az e-számla termékkel a könyvelési egyeztetés érdekében. A Foriba a választás nagyvállalatok számára összetett adófolyamatokkal. A Zunapro mind az öt integrációt tartalmazza egyetlen konfigurációs képernyő mögött — válaszd ki az integrátort, illeszd be az API hitelesítő adatokat, és minden Trendyol rendelés automatikusan számlázásra kerül.

9. Gyakori hibák és azok kezelésének módja

Kategória-eltérés

Tünet: a köteg eredménye INVALID_CATEGORY vagy CATEGORY_NOT_LEAF hibát mutat. Ok: nem végkategóriába való feltöltés, vagy olyan végkategóriába, amelynek attribútumkészletével az SKU nem egyezik. Megoldás: mindig csak végkategóriákba tölts fel (az API elutasítja a nem-végkategóriákat), és validáld előre az attribútumokat a kategória required: true készlete ellenében a POST előtt.

Hiányzó kötelező attribútumok

Tünet: MANDATORY_ATTRIBUTE_MISSING egyébként érvényes SKU-kon. Ok: a Trendyol az attribútumok kb. 30%-át kategóriánként kötelezővé teszi (nem divatcikkeknél, garancia elektronikánál stb.). Megoldás: gyorsítótárazd a kategóriánkénti attribútum-követelmény térképet, és zárold ki a POST-okat a teljesség alapján; a Zunapro automatikusan kitölti a mester taxonómiádból, ahol lehetséges.

Készletszinkron-késések

Tünet: egy elfogyott SKU még mindig raktáron lévőnek mutatkozik a Trendyolon néhány percig, ami túlértékesítést okoz. Ok: az ár-készlet pushok eventually consistent jellegűek ~5–8 másodperces medián késleltetéssel, és forgalmi csúcsok idején (Black Friday, Trendyol Week) a sor 30–60 másodpercre nyúlhat. Megoldás: valósíts meg egy helyi biztonsági puffert (tartsd fenn az utolsó 1–2 egységet elfogyottként pufferként magas forgalmú SKU-nkénti), és pushold a készletváltozásokat szinkron módon a rendelés-megerősítési eseménynél, ne csak cron alapján.

Webhook kimaradások

Tünet: a rendelés webhookja soha nem érkezik meg, vagy órákkal később érkezik. Ok: általában egy tűzfalváltozás az eladó oldalán, egy TLS-tanúsítvány megújítás, amely megszakította a webhook URL-t, vagy egy rövid kiesés, amely meghaladta a Trendyol 5-szörös újrapróbálkozási keretét. Megoldás: mindig futtass egy párhuzamos 5 perces egyeztető lekérdezést a /sapigw/suppliers/{id}/orders?status=Created&startDate=... ellen; a Zunapro ezt alapértelmezetten megteszi, és idempotens módon egyesíti bármely lekérdezett rendelést azzal, amelyet a webhook is szállított.

Több hirdetés, ugyanaz a vonalkód (Mükerrer Listing)

Tünet: egyetlen SKU több Trendyol hirdetésként jelenik meg, és a készlet eltérően csökken mindegyiken. Ok: korábbi összevonások, duplikált vonalkód-bejegyzések, vagy több áruházas azonos-termék szétágazás. Megoldás: a Zunapro MIN-készlet deduplikációs szabályzata (bevezetve a 2026-06-06-i éles frissítésben) egyetlen vonalkód alá vonja össze az összes duplikált hirdetést, és nyomon követi a minimum készletértéket közöttük, megakadályozva a klasszikus "kétszer eladva két hirdetésen, egy kiszállítás ígérve" katasztrófát.

10. Trendyol jutalék és eladói díjak 2026

A Trendyol 2026-os jutaléktáblázata kategóriánként tagolt, három tág sávval és fix tételenkénti díj nélkül. A kampányrészvétel (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) további 1–3%-ot ad a kategóriaráta felett.

Eladói / előfizetési díjak

A Trendyol nem számít fel havi előfizetést. Nincs Amazon-stílusú "Professional Seller" szint. Az eladók a következőket fizetik:

• Kategóriajutalék minden eladás után (8–22%)
• Kampányjutalék a Trendyol Fast Sale / Week részvétel esetén (+1–3%)
• Trendyol Express szállítmányonkénti díj (a vevő fizeti, de az eladó eredménykimutatásán is átfolyik)
• FBA Trendyol tárolás + összekészítés-csomagolás (csak beiratkozás esetén)
• Trendyol Ads CPC (opcionális, az eladó irányítja)

Kifizetési ciklus

A standard eladókat T+14 ciklusban fizetik ki (14 nappal a rendelés kiszállítása után), amely T+7-re csökken a legjobb eladói pontszámmal rendelkező eladók számára. A vitatott rendelések, a 14 napos ablakon belüli visszaküldések és a visszaterhelések visszatartásra kerülnek a kifizetéstől. A kifizetések a regisztrált TR IBAN-ra érkeznek.

Török jogi keretrendszer 2026 — amit a piactéri eladóknak tudniuk kell

KDV (ÁFA) és KDV kulcssávok

Törökország ÁFA-ja — a KDV (Katma Değer Vergisi) — 2026-ban három kulcsot alkalmaz: 20% standard, 10% csökkentett (élelmiszer, könyvek, gyógyszerek, vendéglátás), 1% speciális (alapvető élelmiszerek, mezőgazdaság). A Törökországban székhellyel rendelkező piactéri eladók a helyi adóhivatalon keresztül regisztrálnak KDV-re; a digitális szolgáltatási küszöb feletti határon átnyúló eladók a KDV nem rezidens rendszerét használják. A vatRate mezőnek minden Trendyol termék POST-on meg kell egyeznie a jogilag helyes kulccsal — a hibák átterjednek az e-számlákra, és javítási bevallásokat igényelhetnek.

e-Fatura / e-Arşiv (GİB kötelező)

Már részletesen tárgyalva a 8. szakaszban. A lényeg 2026-ra: minden piactéri rendelés GİB-pecséttel ellátott elektronikus számlát generál (e-Fatura B2B / regisztrált e-Fatura befogadók számára, e-Arşiv B2C-re). Az eladó felelős a kibocsátásért a rendelésstátusz-ablakon belül. A kézi kibocsátás piactéri méretekben nem praktikus — válaszd ki az öt GİB integrátor egyikét, és automatizálj.

KVKK — a török GDPR

A KVKK (Kişisel Verilerin Korunması Kanunu — 6698. törvény) Törökország adatvédelmi rendszere, szerkezetileg hasonló a GDPR-hoz, és a KVKK Kurumu hajtja végre. A piacterek kezelik a vevő oldali hozzájárulást és feldolgozást, de az eladók közös adatkezelők maradnak minden közvetlen ügyfélszolgálati kapcsolat, marketing vagy vásárlás utáni kommunikáció esetében. A meg nem felelés büntetései 60 ezer TRY-tól 3 millió TRY+ig terjednek a jogsértés osztályától függően.

ETBİS — kötelező e-kereskedelmi nyilvántartás

Az ETBİS (Elektronik Ticaret Bilgi Sistemi) a Kereskedelmi Minisztérium kötelező nyilvántartása bármely törökországi e-kereskedelmi szereplő számára, 2018 óta hatályban. Az eladóknak regisztrálniuk kell, mielőtt a Trendyolon hirdetnének, és jelenteniük kell az éves tranzakciós volumeneket. Az ETBİS adatai a fogyasztóvédelmi végrehajtást, a csalás elleni szűrést és a versenyanalitikát táplálják.

Fogyasztóvédelem — 14 napos elállás, 2 éves jótállás

• 14 napos elállási jog — a török fogyasztók bármely távollévők között vásárolt terméket 14 napon belül visszaküldhetik, indoklás nélkül (Tüketicinin Korunması Hakkında Kanun, 6502. törvény)
• 2 éves törvényes jótállás — kötelező B2C értékesítéseknél, függetlenül bármilyen gyártói garanciától
• Kötelező török nyelvű termékinformáció — cím, leírás, jótállás, visszaküldési szabályzat mind törökül

Logisztika és szállítás Törökországban — elsősorban a Trendyol Express

Trendyol Express — a domináns réteg

A Trendyol Express az alapértelmezett futár a Trendyol rendelések kb. 70%+-án 2026-ban. A vevő ingyenes vagy alacsony költségű szállítást lát aznapi vagy másnapi kiszállítással a nagyobb nagyvárosokban, valamint 50 000+ önkiszolgáló automatát (Trendyol Hızlı Teslimat Noktaları), ahol a vásárlók 0–24 órában vehetik át csomagjaikat. Az eladók vagy leadják a csomagokat egy Trendyol Express gyűjtőponton, vagy futárfelvételt ütemeznek; az útvonalcédula a rendelés-címke API-ból kapott Trendyol Express vonalkódot hordozza.

A többi integrált futár

• Yurtiçi Kargo — régóta működő török futárcég, erős B2C és B2B hálózat, integrálva a Trendyol rendelésekhez
• Aras Kargo — versenytárs erős anatóliai lefedettséggel, gyakran használják önteljesítésű Trendyol rendelésekhez
• MNG Kargo — a harmadik nagy török futárcég, gyakori tartalék nagy forgalmú eladóknak
• PTT Kargo — állami postai szolgáltató, a legszélesebb vidéki lefedettség, lassabb SLA-k
• Sürat Kargo — regionális szereplő, versenyképes a Marmara és Égei régiókban

Gyakorlati 2026-os szállítási stack

A pragmatikus 2026-os stack egy Trendyol eladó számára: Trendyol Express alapértelmezettként (ezt várják el a vevők), Yurtiçi vagy Aras eladó oldali tartalékként az önteljesítésű rendelésekhez, amelyek lekésik a Trendyol Express felvételi ablakot, PTT Kargo a csak vidéki irányítószámokhoz, ahol egyetlen más futár sem gazdaságos, és FBA Trendyol a gyorsan mozgó SKU-khoz, amint a forgalom indokolja a tárolási elköteleződést.

Hogyan kezdj el árulni a Trendyolon — 5 lépéses onboarding

1. Trendyol eladói fiók

Jelentkezz a partner.trendyol.com oldalon. Add meg a VKN-t, a cégjegyzéki közlönyt, az aláírási címpéldányt, az ETBİS regisztrációs igazolást és a TR IBAN-t. Jóváhagyás 2–5 munkanapon belül.

2. ETBİS + adóregisztráció

Regisztráld a jogi entitást az ETBİS-ben a Kereskedelmi Minisztérium portálján (etbis.gtb.gov.tr) keresztül, és erősítsd meg a KDV-regisztrációt a helyi adóhivatalnál. A Trendyol International-on keresztül működő külföldi eladók vagy kineveznek egy török képviselőt, vagy a Trendyol import-of-record programját használják.

3. API kulcs + titkos kulcs generálása

A Partner panel → Fiókbeállítások → Integrációs adatok menüpontból kattints az "API kulcs létrehozása" gombra. Másold ki az API kulcsot (40 karakter) és az API titkos kulcsot (40 karakter) azonnal — csak egyszer jelennek meg. Illeszd be őket a Zunapro Trendyol csempéjébe, ahol AES-256 titkosítva és maszkolva tárolódnak.

4. Csatlakozás a Zunapro panelen keresztül

1. Jelentkezz be a Zunapróba, és nyisd meg a Törökország modult
2. Illeszd be a Beszállítói azonosítót + API kulcsot + API titkos kulcsot a Trendyol integrációs csempébe
3. Futtasd az automatikus állapotellenőrzést (hitelesítő adatok, címek végpont, beszállítói információ)
4. Erősítsd meg az ML által javasolt kategória-hozzárendeléseket a top 100 SKU-hoz
5. Válaszd ki az e-számla integrátorodat (Logo, Mikro, Uyumsoft, Foriba vagy Veriban), és illeszd be azokat a hitelesítő adatokat
6. Kapcsold be a "Trendyol Express"-t + "FBA Trendyol"-t (ha be vagy iratkozva)

5. Futtass egy teszt rendelést

Helyezz el 3–5 stage rendelést a stageapi.trendyol.com ellen, hogy végigfuttasd a pick-pack, címkenyomtatás, státuszátmenet és visszatérítés folyamatokat elejétől a végéig. Ha minden zöld, kapcsold az integrációt élesre egyetlen kapcsolóval. Egy 5000 SKU-s katalógus első éles szinkronja körülbelül 30–60 percen belül befejeződik a Trendyol sebességkorlátai mellett.

A három Trendyol integrációs út — összehasonlítva

Mielőtt elköteleződnél egy integrációs architektúra mellett, érdemes egymás mellett összehasonlítani a három legitim utat.

Trendyol integrációs GYIK 2026