Hepsiburada integrációs útmutató 2026: REST API, HepsiJet & központosított eladókezelés

1. Hepsiburada API-architektúra 2026

REST az mpop.hepsiburada.com-on

A Hepsiburada eladói API-ja egy tiszta REST/JSON szolgáltatás, amelyet az ernyő-host, az mpop.hepsiburada.com alatt üzemeltetnek (mpop = „Merchant Platform Open API”). Nincs GraphQL vagy gRPC változat. Minden hitelesített forgalom HTTPS-en keresztül zajlik, a HMS-onboarding során kiadott Merchant ID-hoz kötve. Az API-felület logikai aldoménekre oszlik egyetlen monolitikus gyökér helyett:

• listing-external.hepsiburada.com — listázás CRUD (ár, készlet, listázás állapota)
• mpop.hepsiburada.com/product/api/products — termékfelvitel és kategória-attribútumok
• oms-external.hepsiburada.com — rendeléskezelés (rendelések, csomagok, szállítmányok)
• returns-external.hepsiburada.com — visszaküldések és visszatérítések
• integration.hepsiburada.com/finance — számlafeltöltés és pénzügyi egyeztetés

Minden aldomén ugyanazt a HTTP Basic hitelesítési sémát használja, de saját rate limitet és lapozási konvenciókat kínál. A Zunapro HB-konnektora ezt a szétágazást egyetlen normalizált felület mögé rejti.

Hitelesítés: HTTP Basic HTTPS-en

A Trendyol némileg megengedőbb API-jával vagy az Amazon SP-API OAuth-folyamatával ellentétben a Hepsiburada szándékosan egyszerű HTTP Basic hitelesítési sémát használ: az Authorization fejléc a Basic base64(username:password) értéket hordozza, ahol a username az API-kulcsod, a password pedig a hozzá tartozó titkos kulcs. Minden kérésnek tartalmaznia kell egy User-Agent fejlécet is, amely tartalmazza a Merchant ID-t. A hiányzó vagy hibás User-Agent érték a 401 Unauthorized messze leggyakoribb oka a termelésben.

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

HMS — a Hepsiburada Marketplace Service panel

A HMS panel a merchant.hepsiburada.com címen az API-hoz párosított operatív webkonzol. Minden API-képességnek van HMS-megfelelője — listázás-szerkesztés, rendeléselfogadás, visszatérítés kiadása, pénzügyi egyeztetés —, és a HMS az egyetlen hely, ahol API-kulcsokat állíthatsz elő, HepsiJet átvételi címeket konfigurálhatsz és felhasználói jogosultságokat kezelhetsz. A 2024–2026-os HMS-újratervezés egységes bal oldali navigációt, valós idejű elszámolási jelentést és egy új „API Health” irányítópultot hozott, amely végpontonként mutatja a 4xx/5xx arányokat — felbecsülhetetlen érték egy integráció hibakeresésekor.

Rate limitek és idempotencia

A Hepsiburada nagyvonalú, de érvényesített rate limiteket alkalmaz — jellemzően ~30 kérés/másodperc merchantonként a listázásfrissítéseknél és alacsonyabbat (~10/mp) a rendelési végpontoknál. A tömeges termékimportot külön szabályozzák, és 202 Accepted választ ad egy trackingId-vel; ezután a /import/{trackingId} lekérdezésével pollozod a befejezést. A rendelési API támogatja az idempotenciát a csomag- és rendelés-azonosítókon keresztül, amelyek olvasások között stabilak maradnak.

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

Előfeltételek: HMS-fiók & ETBİS

Bármely API-hívás előtt egy török nyilvántartásba vett vállalkozásnak vergi numarası-val (adószám), ETBİS-regisztrációval (Elektronik Ticaret Bilgi Sistemi — a Kereskedelmi Minisztérium e-kereskedelmi cégnyilvántartása) és török IBAN-nal (TR…) kell onboardolnia a HMS-en keresztül. A KYC-ellenőrzés ETBİS-be regisztrált szervezeteknél általában 1–3 munkanapon belül lezajlik; a nem ETBİS-eladók manuális felülvizsgálati sorba kerülnek, ami 1–2 hetet is igénybe vehet.

Lépésről lépésre API-onboarding

1. Hozz létre HMS-fiókot a merchant.hepsiburada.com címen a vergi numarası-val és IBAN-nal. Töltsd fel az ETBİS-tanúsítványodat, aláírási címpéldányodat és adóhatósági dokumentumodat.
2. Generálj API-hitelesítő adatokat a Hesabım → Entegrasyon Bilgileri → API Anahtarı menüpontban. A rendszer visszaad egy felhasználónevet, jelszót és a stabil Merchant ID-dat. Tárold a titkos kulcsokat vaultban — a Hepsiburada nem mutatja meg újra a jelszót.
3. Engedélyezz kimenő IP-ket, ha az integrációs platformod ezt igényli. A Zunapro egy fix kimenő IP-tartományt publikál, így az eladók rögzíthetik a HMS engedélyezési listáján.
4. Füst-teszteld egy listázás-olvasással — hívd meg a GET /listings/merchantid/{MERCHANT_ID}-t, és erősítsd meg a 200 OK-t a meglévő készleteddel.
5. Iratkozz fel webhookokra rendelési eseményekre: POST /webhook-subscriptions a callback URL-eddel és az eseménytípusokkal (order.created, order.cancelled, return.created).
6. Told fel az első terméked a POST /product/api/products/import segítségével — a Hepsiburada egy trackingId-t ad vissza; pollozd, amíg status:DONE nem lesz.
7. Indulj élesben — állítsd az integrációt „Aktif”-ra a HMS-ben, miután a füst-tesztek átmentek.

Fejlécek és gyakori buktatók

A leggyakoribb integrációs regresszió egy hiányzó vagy hibás User-Agent. A Hepsiburada szigorúan megköveteli a {MERCHANT_ID} - {AppName} formátumot; egy alapértelmezett axios/1.6 vagy okhttp/4 User-Agent 401 Unauthorized-ot ad vissza leíró törzs nélkül. Mindig állítsd be a User-Agentet explicit módon, és naplózd a kérés-middleware-edben.

3. Terméksinkronizálás — kategóriafa, attribútumok, variánsok

A kategóriafa

A Hepsiburada katalógusa szigorú három–öt szintű kategóriafaként van felépítve, amelyet a GET /product/api/categories/get-all-categories tesz elérhetővé. Minden terméknek egy levélszintű kategória-ID-hoz kell kapcsolódnia; a köztes csomópontokat VALIDATION_ERROR-ral utasítja el. A 2024-es kategória-átdolgozás összevont több régi csomópontot (a külön listázott „Bluetooth Kulaklık” és „Kablosuz Kulaklık” a „Kablosuz Kulaklık & Bluetooth”-ba olvadt), így minden ennél régebbi integrációnak kategória-leképezés frissítésre van szüksége.

A kötelező attribútumok blokkolják a jóváhagyást

Minden kategória felfed egy listát kötelező és opcionális attribútumokról a GET /product/api/categories/{categoryId}/attributes segítségével. A Trendyollal ellentétben a Hepsiburada a hiányzó kötelező attribútumokat kemény listázás-blokként kezeli — a termék WAITING_FOR_APPROVAL állapotba kerül, és sosem éri el az „Active”-ot, amíg minden kötelező attribútum érvényes keresési értékkel nincs kitöltve. Gyakori vétkesek:

• Márka — pontosan egyeznie kell a Hepsiburada márkanyilvántartásával; az „Apple” és az „APPLE” különböző ID-k
• Szín, méret, kapacitás — szabályozott szótárból húzva, nem szabad szövegből
• Garanciaidő — elektronikánál kötelező, hónapokban kifejezve enumként
• Származási ország (Menşei) — kozmetikumoknál, élelmiszereknél, étrend-kiegészítőknél kötelező

Variánsok: listing & product szétválasztás

A Hepsiburada szigorúbb product vs listing szétválasztást használ, mint a legtöbb versenytárs. Egyetlen product-nak (HB-SKU, belső azonosító) sok listing-je (merchantSku) lehet — eladónként egy, saját árral, készlettel, állapottal (új/felújított) és garanciával. Variáns termékeknél (pl. póló S/M/L × Piros/Kék/Fekete) minden kombináció külön product csomópont, opcionálisan egy varyantGroupID alá csoportosítva, hogy a terméklap szín- és méret-swatch-eket mutasson.

Tömeges import trackingId-vel

A termelési katalógus-feltöltések a POST /product/api/products/import-ot használják kérésenként legfeljebb 100 termékből álló tömbbel. Az API egy trackingId-t ad vissza; az integrátoroknak a GET /product/api/products/import/{trackingId}-t kell pollozniuk, amíg az állapot DONE nem lesz, majd soronként végigmenni az eredményeken a validációs hibák miatt. A Zunapro 100 soros darabokban kötegeli az importot, újrapróbálja a lágy hibákat, és sorszintű hibajelentéseket jelenít meg az eladói panelben.

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. Rendeléskezelés — webhookok, állapotfolyam, címkék

A rendelés életciklusa

Egy Hepsiburada-rendelés egy rögzített állapotgépen halad át, amelyet minden integrációnak implementálnia kell. Az állapotok számítanak — a korai átmenetek büntetőpontokat váltanak ki az eladói pontszámod ellen:

• Open — rendelés beérkezett, elfogadásra vár (24 órás SLA a legtöbb kategóriában, 48 óra bútoroknál)
• InProgress / Picking — az eladó nyugtázta, komissiózás és csomagolás
• Packaged — csomag létrehozva az API-n keresztül, futárátadásra várva
• Shipped — a futár beszkennelte a csomagot; a nyomkövetési szám aktív
• Delivered — az utolsó mérföld megerősítette a kézbesítést
• Cancelled / Returned — visszaküldési portál a vásárló vagy az eladó által kezdeményezve

Webhook vs pollozás

A Hepsiburada támogatja mind a webhookokat (előnyben részesített), mind a pollozást. A webhookokat Merchant ID-nként konfigurálják a HMS-ben vagy a POST /webhook-subscriptions-on keresztül; a platform JSON eseményeket küld a HTTPS-végpontodra HMAC-aláírásokkal az X-HB-Signature fejlécben. A pollozás visszaesik a GET /orders?status=Open&offset=0&limit=100-ra egy 30–60 másodperces cronon. A Zunapro alapból webhookokat használ egy 5 perces pollozó egyeztetővel, amely elkapja az elmulasztott eseményeket — ez egy nadrágszíj-és-nadrágtartó minta, amely a rendelés-teljesség 99,99% felett tartja.

Szállítási címkék: HepsiJet automatikus generálás

Amikor a rendelést Packaged-ként jelölöd meg kiválasztott HepsiJettel, az API automatikusan generál egy nyomtatható PDF szállítási címkét, és visszaad egy letöltési URL-t plusz egy nyomkövetési számot. Nincs külön címke-kérés — a címke a csomaglétrehozási válaszba van csomagolva:

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

A visszaküldési portál

A visszaküldéseket a vásárló kezdeményezi a Hepsiburada szabványos visszaküldési portálján (Iade Talepleri) keresztül, és a GET /returns?status=Open-en jelennek meg az eladóknak. Az eladóknak 3 munkanapjuk van a visszaküldés jóváhagyására vagy vitatására; ezután automatikus jóváhagyás lép életbe. A jóváhagyott visszaküldések visszatérítést váltanak ki a Hepsiburada fizetési vonalán (amelyet az eladó a következő pénzügyi elszámoláson lát), a készletet pedig újra jóvá kell írni a PUT /listings/{merchantSku}/stock segítségével.

5. Készlet- & ársinkronizálás — valós idő, Buy Box, átárazó

A készletvégpont

A készletet a listázási API-n keresztül frissítik egy delta-tudatos payloaddal:

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

A végpont ugyanabban a hívásban fogadja el az árat és a készletet, de a Hepsiburada belső gyorsítótárának 30–90 másodpercig tarthat, míg az áruházba propagálódik. A tömeges frissítések a POST /listings/import-ot használják ugyanazzal a trackingId-mintával, mint a termékimport.

Valós idő vs cron-szinkron

A termelési szintű eladók eseményvezérelt szinkront használnak (minden készletváltozás az ERP-dben másodperceken belül egy PUT-ot indít a Hepsiburadára) egy 15 perces cron helyett. A csak-cron szinkron kockázata a túl-eladás csúcsidőszakokban (Ramazan kampányası, Black Friday, Efsane Cuma). A Zunapro hibrid modellje azonnali PUT-okat és egy 15 perces egyeztetőt indít elejtett események esetére — ugyanaz a minta, amelyet a master→local→targets ár- és készlet-automatikus szinkronizálási architektúránkban dokumentálunk.

A Buy Box megnyerése

A Hepsiburada Buy Boxát (a „Sepete Ekle” alapértelmezett ajánlat egy megosztott terméklapon) egy súlyozott képlet ítéli oda, amely kombinálja:

• Ár — versenyképes a legalacsonyabb érvényes ajánlat 1–2%-án belül
• Készlet állapota — mélység, frissesség, nemrégiben nem volt készlethiány
• Kézbesítési ígéret — a HepsiJet minden más egyenlőség esetén nyer
• Eladói értékelés — minimum 9,0+ a kézbesítési és szolgáltatási KPI-kben
• Rendelési hibaarány — a lemondások, késői szállítások, visszaküldések büntetve vannak

Egy jól hangolt átárazó, amely 5–10 percenként újraértékeli a versenytárs-árakat, tipikusan 15–30%-kal növeli a Buy Box részesedést a versengő SKU-knál.

6. HepsiJet — saját futárhálózat

A Hepsiburada vertikálisan integrált utolsó mérföldje

A HepsiJet a Hepsiburada saját utolsó mérföldes futárhálózata, amelyet 2017-ben indítottak, hogy megtörjék a Yurtiçitől és Aras Kargótól való függést az időkritikus SKU-knál. 2026-ra a HepsiJet 1500+ átvételi pontot üzemeltet 81 tartományban, aznapi kézbesítést futtat Isztambulban, Ankarában és Izmirben, és több mint 2500 járműből álló saját flottát, valamint franchise-shubeler hálózatát használja.

Vonalkód-szabvány és címkeformátum

Minden HepsiJet szállítási címke egy Code-128 vonalkódot hordoz, amely egy 12 karakteres, HJ előtaggal ellátott nyomkövetési számot kódol (például HJ73219840TR). Az API által generált PDF-címke A6-os elrendezést használ, amely alkalmas hőnyomtatókhoz; a címkék közvetlenül nyomtathatók az integrált ZPL-soron keresztül.

Aznapi & Yarın Kapında

A HepsiJet két prémium kézbesítési szintet kínál, amelyek láthatók a terméklapon:

• „Yarın Kapında” — másnapi kézbesítés 81 tartományban, ha a rendelést helyi idő szerint 14:00 előtt adják fel
• „Bugün Kapında” — aznapi kézbesítés Isztambulban, Ankarában, Izmirben, Bursában, Adanában a 11:00 előtt leadott rendeléseknél

Mindkét jelvény érdemben növeli a konverziót — a Hepsiburada saját adatai 15–25%-os konverziónövekedésre mutatnak a jelvényeket viselő listázásokon, ami nagyjából megfelel a Trendyol „Hızlı Teslimat” hatásának.

Átvétel vs Şubeye Bırak

Az eladók választhatnak HepsiJet átvétel (a futár begyűjt a raktárból, csomagonként számlázva) és Şubeye Bırak (az eladó a legközelebbi HepsiJet fiókban adja le a csomagokat, csomagonként olcsóbb, de operatíve nehezebb) között. Az integrációs API mindkettőt támogatja — a csomagválasz tartalmaz egy pickupAddressId mezőt, amely meghatározza az útvonalat.

7. HepsiLojistik — az FBA-modell

Mi az a HepsiLojistik

A HepsiLojistik a Hepsiburada piactér-általi teljesítés szolgáltatása — a török megfelelője az Amazon FBA-nak, a Trendyol TFC-nek és az Allegro One Fulfillmentnek. Az eladók tömegesen szállítják a készletet a Hepsiburada teljesítési központjaiba; a Hepsiburada kezeli a tárolást, komissiózást, csomagolást, utolsó mérföldes kézbesítést (HepsiJeten keresztül) és visszaküldéseket. A HepsiLojistik-rendelések egy megkülönböztető „Hepsiburada Garanti” jelvényt viselnek, és a legmagasabb láthatósági súlyozásra jogosultak a Buy Box képletben.

A teljesítési központ hálózata

• Gebze (Kocaeli) — zászlóshajó teljesítési központ, ~150 000 m², Isztambult + Marmarát szolgálja ki
• Çorlu (Tekirdağ) — 2023-ban hozzáadva, Nyugat-Törökország + Balkán határon átnyúló forgalomra fókuszálva
• Kemalpaşa (Izmir) — égei-tengeri lefedettség, 2024-ben nyílt Délnyugat-Törökország számára
• Ankara (Polatlı) — közép-anatóliai csomópont, a fővárosi régió kézbesítésére optimalizálva

A díjstruktúra

A HepsiLojistik árazása egy egységenkénti teljesítési díjból plusz havi tárolásból áll:

• Teljesítési díj egységenként — jellemzően ₺25–₺75 a súlysávtól és kategóriától függően
• Havi tárolás — m³-enként havonta számlázva, sebesség szerint sávozva (a hosszú farkú SKU-k többet fizetnek)
• Beérkező szállítás — az eladó fizeti a beérkezést a teljesítési központba
• Visszaküldés-kezelés — a teljesítési díjba beleértve a szabályzatnak megfelelő visszaküldéseknél

Jelentkezés & onboarding

A HepsiLojistik alapból nem nyitott. Az eladók a HMS → Lojistik Hizmetleri → HepsiLojistik Başvuru útján jelentkeznek, megadva 6 hónap értékesítési előzményt és egy cél-SKU-listát. A Hepsiburada a havi ~500 rendelés feletti eladókat részesíti előnyben kiszámítható keresleti mintákkal; az alacsonyabb volumenű eladók általában az önálló HepsiJet-átvételi modellen maradnak.

8. e-számla (e-Fatura) integráció — GİB & ERP

A GİB e-Fatura kötelező

Törökország GİB-je (Gelir İdaresi Başkanlığı — Bevételi Hivatal) megköveteli az e-Faturát (a GİB portálra benyújtott strukturált XML-számlák) minden olyan cégtől, amely az éves árbevételi küszöb felett van (jelenleg ~₺3M, a 2026-os módosítások alapján e-kereskedelmi eladóknál csökkentve). A küszöb alatt az e-Arşiv Fatura érvényes — ugyanúgy elektronikus, csak az aláírásnál kicsit könnyebb. A piactéri rendelések nem mentesülnek: minden B2C és B2B piactéri rendelés elektronikus számlát igényel, amelyet a feladási eseménytől számított 7 napon belül kell kiállítani.

A Hepsiburada számlavégpontja

A Hepsiburada felfed egy pénzügyi végpontot a számlafeltöltéshez — az eladók (vagy e-Fatura integrátoraik) feltöltik a GİB UUID-t és a kiállított számla PDF-renderelését, amely aztán a vásárlónak a rendeléslapon a szabványos „Faturayı İndir” linken keresztül jelenik meg:

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

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

Kompatibilis ERP- & e-Fatura-szolgáltatók

A legtöbb török eladó a mögöttes számlát az ERP-jén / e-Fatura entegratörén keresztül állítja ki, és az eredményt a Hepsiburadára továbbítja. A Zunapro natív konnektorokat szállít a következőkhöz:

• Logo Tiger 3 / Logo Wings — Törökország legelterjedtebben telepített ERP-je
• Mikro Yazılım — erős a KKV-kiskereskedelemben
• Netsis (SAP-partner) — vállalati eladók számára
• Foriba, Uyumsoft, Digital Planet, izibiz — tisztán GİB e-Fatura integrátorok

A KVKK-réteg

A számlavezetéken átfolyó vásárlói személyes adatokat (PII) Törökország KVKK-ja (Kişisel Verilerin Korunması Kanunu — a személyes adatok védelméről szóló törvény) szabályozza, a GDPR-egyenértékű helyi szabályozás, amelyet a KVKK Kurumu (Adatvédelmi Hatóság) érvényesít. Az eladók a rendelés-oldali PII közös adatkezelői, és ahol alkalmazandó, regisztrálniuk kell az adatkezelési tevékenységeket a VERBİS-en.

9. Gyakori hibák és megoldások

Legfontosabb termelési hibák

HTTP / kód	Tünet	Kiváltó ok	Megoldás
401 Unauthorized	Minden kérés elutasítva	Hiányzó vagy hibás User-Agent fejléc	Állítsd be a User-Agent: {MERCHANT_ID} - {AppName}-et explicit módon
403 Forbidden	Adott végpont blokkolva	Az API-kulcsnak nincs jogköre; a merchant nincs jóváhagyva a modulhoz	Add ki újra a kulcsot a HMS-ben teljes jogkörökkel, lépj kapcsolatba a Merchant Supporttal
VALIDATION_ERROR	A termék WAITING_FOR_APPROVAL-ban ragadt	Kötelező kategória-attribútum hiányzik vagy érvénytelen keresési érték	Kérd le a /categories/{id}/attributes-t, töltsd ki a kötelező mezőket érvényes enum-értékekkel
BRAND_NOT_FOUND	A termékimport elutasítva	A márkanév nem egyezik pontosan a HB márkanyilvántartással	Kérdezd le a /brands?name=...-t, használd a visszaadott ID-t, kérj márkalétrehozást, ha hiányzik
429 Too Many Requests	Burst-forgalom throttlingolva	Túllépted a ~30 kérés/mp-et listázásokon vagy ~10/mp-et rendeléseken	Implementálj exponenciális visszatartást Retry-After fejléc-támogatással
STOCK_UPDATE_DELAY	Az áruház 30–90 mp-ig elavult készletet mutat	Gyorsítótár-propagálási késés, nem hiba	Preventíven csökkentsd a készletet a túl-eladás kockázatánál; egyeztess a késés után
HEPSIJET_PICKUP_FAIL	Csomag létrehozva, de nincs futár-begyűjtés	Rossz pickupAddressId vagy a HepsiJet lefedettségén kívüli cím	Ellenőrizd az átvételi címet a HMS-ben, válts Yurtiçi/Aras-ra a kizárt irányítószámoknál
INVOICE_UPLOAD_REJECTED	Az e-Fatura feltöltés 400-at ad vissza	Érvénytelen UUID-formátum vagy PDF base64-sérülés	Validáld az UUID v4 formátumot, kódold újra a PDF-et, próbáld újra idempotens számlaszámmal

Diagnosztikai munkafolyamat

Amikor egy Hepsiburada-integráció furán kezd viselkedni, a Zunapro által követett diagnosztikai sorrend:

1. Ellenőrizd a HMS → API Health irányítópultot a végpont-szintű hibaarányokért
2. Validáld a User-Agentet és a Basic-auth hitelesítő adatokat egy curl füst-teszttel
3. Vizsgáld meg az X-Request-Id fejlécet egy hibás válaszból — a Hepsiburada Merchant Support megköveteli egy jegy nyomon követéséhez
4. Hasonlítsd össze a developers.hepsiburada.com changeloggal a legutóbbi sémaváltozásokért

10. Hepsiburada jutalék 2026 — 8%-tól 22%-ig

A Hepsiburada 2026-os jutaléktáblázata kategória-sávozott, negyedévente publikálva a HMS-ben a Hesabım → Komisyon Oranları alatt, és három tág sávra plusz néhány kilógó kategóriára (arany, autóipar, nagy háztartási gépek) bontva.

2026-os jutalék-összehasonlítás — Hepsiburada vs Trendyol vs Amazon TR

Piactér	Alacsony szint	Közepes szint	Magas szint	Előfizetés / egyéb
Hepsiburada	8% – 12%	12% – 17%	15% – 22%	Ingyenes fiók · HepsiAd opcionális · HepsiLojistik díjak, ha használod
Trendyol	9% – 13%	13% – 18%	16% – 24%	Ingyenes fiók · TFC díjak, ha használod · Trendyol Ads opcionális
Amazon TR	5% – 12%	12% – 17%	15% – 22%	Professional Seller ~₺99 / hó · FBA díjak, ha használod
n11	6% – 10%	10% – 15%	13% – 18%	Ingyenes fiók · n11 Pro előfizetési szint opcionális
Çiçeksepeti	10% – 14%	14% – 18%	16% – 22%	Ingyenes fiók · aznapi virág/ajándékozás specializáció

A táblázat olvasata: A Hepsiburada nagyjából egy szinten van az Amazon TR-rel, és minden sávban valamivel olcsóbb a Trendyolnál. A megkülönböztető nem a jutalék, hanem a logisztika — a HepsiJet saját utolsó mérföldje strukturális előnyt ad a Hepsiburadának a kézbesítési ígéreteknél a nagyvárosokban, míg a Trendyol nagyobb felhasználói bázisa ellensúlyozza a valamivel magasabb díjait.

Török jogi keret 2026 — áfa, e-Fatura, KVKK, ETBİS

Áfa (KDV) kulcsok 2026

Törökország áfája — a KDV (Katma Değer Vergisi) — 2026-ban három törvényes kulcsot használ:

• 20% általános kulcs — a legtöbb fogyasztási cikk, elektronika, divat, otthon & lakás
• 10% kedvezményes kulcs — alapvető élelmiszerek, bizonyos kategóriák textíliái, könyvek, vendéglátás
• 1% szuper-kedvezményes — alapélelmiszerek (kenyér, tej, tojás), mezőgazdasági inputok, bizonyos orvosi

A piactéri eladók a regionális Vergi Dairesin (adóhivatal) keresztül regisztrálnak a KDV-re; a határon átnyúló eladók a 2024 után Törökország nemrég kibővített különleges áfa-rendszerét használhatják az e-kereskedelemre.

e-Fatura & e-Arşiv — GİB-mandátum

• e-Fatura — a GİB-hez benyújtott strukturált XML-számlák, az éves árbevételi küszöb felett és minden e-kereskedelmi eladó számára kötelező a 2026-os módosítások alapján
• e-Arşiv Fatura — ugyanúgy elektronikus, de könnyebb; B2C-hez az e-Fatura küszöb alatt
• 7 napos kiállítási ablak — minden piactéri rendelés elektronikus számlát igényel a feladástól számított 7 napon belül
• e-İrsaliye, e-Müstahsil, e-Smm — kísérő dokumentumok logisztikai, mezőgazdasági és szabadúszó folyamatokhoz

KVKK — Törökország GDPR-megfelelője

A KVKK (Kişisel Verilerin Korunması Kanunu), amely 2016 óta hatályos és 2024-ben a GDPR-hoz igazítva szigorodott, szabályozza a személyes adatok feldolgozását. A piactéri eladók közös adatkezelők a rendelés-oldali PII-nél (név, cím, telefon, IBAN, ahol releváns), és kötelesek:

• Regisztrálni a VERBİS-en (Veri Sorumluları Sicil Bilgi Sistemi), ha a küszöbök felett vannak
• Fenntartani egy írásos adatvédelmi szabályzatot (Aydınlatma Metni), amely a vásárlók számára elérhető
• Tiszteletben tartani az érintetti jogokat (hozzáférés, helyesbítés, törlés) 30 napon belül
• Jelenteni az adatvédelmi incidenseket a KVKK Kurumu felé 72 órán belül

ETBİS — az e-kereskedelmi cégnyilvántartás

Az ETBİS (Elektronik Ticaret Bilgi Sistemi), amelyet a Kereskedelmi Minisztérium (Ticaret Bakanlığı) működtet, a kötelező nyilvántartás minden Törökországban működő e-kereskedelmi vállalkozás számára. A regisztráció ingyenes és online; az ETBİS-számot meg kell jeleníteni a piactéri eladói profilokban és a saját üzletek láblécében. A Hepsiburada KYC-je automatikusan ellenőrzi az ETBİS-t az onboarding során.

Logisztika & szállítás — HepsiJet elsőként, Yurtiçi/Aras tartalék

Az alapértelmezett: HepsiJet

A HepsiJet az alapértelmezett futár a Hepsiburada-rendeléseknél, és az egyetlen, amely automatikusan aktiválja a „Yarın Kapında” / „Bugün Kapında” jelvényeket. A legtöbb nagyvárosi eladó számára a volumen 80–100%-ának HepsiJeten keresztüli irányítása a helyes választás.

Integrált harmadik felek futárszolgálatai

A Hepsiburada Törökország bevett nemzeti futárszolgálataival is integrálódik, a szállítási címkéket ugyanazon a csomaglétrehozási végponton keresztül generálva, egyszerűen a cargoCompany érték módosításával:

• Yurtiçi Kargo — legsűrűbb vidéki lefedettség, erős a kelet-anatóliai irányítószámokon, amelyeket a HepsiJet kizár
• Aras Kargo — versenyképes B2B SLA-k, népszerű bútoroknál és terjedelmes áruknál
• DHL Kargo — rugalmas aznapi ablakok kiválasztott folyosókon
• PTT Kargo — állami postai szolgáltató, vidéki elérés, lassabb SLA-k
• UPS Türkiye / DHL — nemzetközi határon átnyúló útvonalak

Útvonal-logika a Zunapróban

A Zunapro logisztikai routere minden rendelést egy konfigurálható mátrix ellenében értékel — súly, cél-irányítószám, deklarált érték, SKU-osztály —, és alapból a HepsiJetet választja, a kizárt irányítószámoknál a Yurtiçire, a 30 kg feletti csomagoknál pedig az Arasra visszaesve. A kiválasztott futárt ugyanazon a Hepsiburada csomagvégponton keresztül továbbítja, így a vásárló egyetlen nyomkövetési élményt lát.

Hogyan kezdj el árulni a Hepsiburadán — 2026 lépésről lépésre

Az 5 lépéses indítás

1. Regisztrálj az ETBİS-en & HMS-en — nyisd meg az ETBİS-rekordodat az etbis.ticaret.gov.tr címen, majd onboardolj a merchant.hepsiburada.com-on a vergi numarası-val, IBAN-nal és aláírási címpéldánnyal. A KYC 1–3 munkanapon belül lezajlik.
2. Generálj API-hitelesítő adatokat — Hesabım → Entegrasyon Bilgileri → API Anahtarı. Tárold a felhasználónevet/jelszót a vaultodban; jegyezd fel a Merchant ID-t a User-Agent fejlécekhez.
3. Kösd be az e-Faturát — válaszd ki a GİB-integrátorodat (Logo, Mikro, Foriba, izibiz), és erősítsd meg, hogy a Hepsiburada számlafeltöltési végpontja elérhető. Teszteld egy B2C-rendeléssel.
4. Válaszd meg a logisztikai stackedet — HepsiJet átvétel vs Şubeye Bırak, plusz Yurtiçi/Aras tartalék a kizárt irányítószámokhoz. Készítsd elő a címkéket és csomagolóanyagokat.
5. Csatlakozz a Zunaprón keresztül (10 perc) — illeszd be az API-hitelesítő adatokat a Hepsiburada csempébe, képezd le a mastercatalógusodat, engedélyezd a HepsiJet automatikus címkéket és az e-Faturát, kapcsold élesbe.

A Zunapro csatlakozási folyamata

1. Jelentkezz be a Zunapróba, és nyisd meg a Törökország modult
2. Kattints a „Hepsiburada csatlakoztatása”-ra — illeszd be az API-felhasználónevet, jelszót és Merchant ID-t
3. Automatikus kategória-leképezés — a Zunapro ML levél-kategória leképezéseket javasol minden master SKU-hoz; erősítsd meg néhány kattintással
4. Engedélyezd a HepsiJet automatikus címkéket + e-Faturát — egy-egy kapcsolóval
5. Indulj élesben — egy 1000 SKU-s katalógus első listázás-szinkronja nagyjából 10 perc alatt lezajlik; a webhookok automatikusan regisztrálnak

Hepsiburada integrációs GYIK 2026