Trendyol w pigułce 2026 — szybki przegląd
Trendyol to bezdyskusyjny lider tureckiego e-commerce z udziałem rynkowym przekraczającym 35% i ścieżką szybkiego ekspansji międzynarodowej (Azerbejdżan, kraje Zatoki Perskiej, Niemcy — Trendyol International). Założony w 2010 roku przez Demet Mutlu, w 2018 roku przejęty przez konsorcjum prowadzone przez Alibaba Group (z udziałem SoftBank, Tiger Global, General Atlantic), wyceniony w 2021 roku na $16,5 miliarda. Z perspektywy polskiego sprzedawcy planującego e-export do Turcji: turecki rynek e-commerce wzrasta o 30–40% rok do roku (kurs liry vs spadek inflacji to dwie zmienne, które trzeba uwzględnić w wycenie), Trendyol agreguje 30M+ kupujących z dominującą pozycją w modzie, kosmetykach, elektronice i kategorii dom & ogród, a e-Fatura GİB jest obowiązkowa od pierwszej faktury B2B/B2C — równolegle do polskiego KSeF w kraju macierzystym. Ten przewodnik prowadzi Pana/Panią przez wszystkie trzy ścieżki integracji API, krok po kroku w 10 minut.
1. Architektura API Trendyol 2026
Trendyol w 2026 roku udostępnia trzy współistniejące warstwy integracji, z których każda spełnia inną rolę w architekturze sklepu. Zrozumienie różnic to fundament — wybór niewłaściwej warstwy skutkuje w skali nadsprzedażą, opóźnionymi statusami lub złamaniem warunków SLA platformy.
Trzy warstwy integracji
REST API — produkcyjny standard 2026
api.trendyol.com/sapigw/suppliers/{supplierId}/... · HTTP Basic Auth + HMAC-SHA256 webhooks · pełne CRUD, zamówienia, faktury
Webhooki zdarzeń — push w czasie rzeczywistym
ORDER_CREATED, PACKAGE_STATUS, RETURN_INITIATED, PRICE_CHANGE_REQUEST · HMAC-SHA256 · retry z exponential backoff
XML / CSV feed — kompatybilność wsteczna
Importer kanału produktowego co 15-30 min · prosty schemat: barcode, name, price, stock, image · brak webhooków
Trendyol Express FBA
Magazyny Tuzla, Tepeoren, Ankara, Izmir · Hızlı Teslimat 24-48h · 50K+ paczkomatów w 81 prowincjach
e-Fatura GİB (obowiązkowa)
Integracja przez Logo, Mikro, Uyumsoft, Foriba lub Veriban · UBL-TR XML · podpis cyfrowy mali mühür
Cron + Event-Driven Sync (Zunapro)
15-min stock pull + push na każdą zmianę · master → local → targets · dedup SKU/barcode + MIN-stok policy
Base URL i wersjonowanie
Wszystkie wywołania API Trendyol kierują się na bazowy URL https://api.trendyol.com/sapigw/suppliers/{supplierId}/. Środowisko sandbox/stage to https://stageapi.trendyol.com — tożsama struktura ścieżek, oddzielne klucze. Trendyol nie wersjonuje API w stylu /v1/, /v2/ — zmiany są wstecznie kompatybilne, a nowe pola są dodawane bez łamania istniejących klientów. W ciągu ostatnich 36 miesięcy Trendyol wprowadził 3 znaczące zmiany schematu (obowiązkowe HMAC dla webhooków od marca 2026, nowy schemat atrybutów wariantów od listopada 2026, rozszerzony schemat e-Fatury od stycznia 2026), wszystkie z 90-dniowym okresem przejściowym.
Uwierzytelnianie — Basic Auth, nie OAuth 2.0
W odróżnieniu od Allegro czy Amazon SP-API, Trendyol stosuje proste uwierzytelnianie HTTP Basic. Każde żądanie wymaga nagłówka Authorization: Basic <base64(apiKey:apiSecret)> oraz nagłówka User-Agent zawierającego identyfikator dostawcy w formacie {supplierId} - SelfIntegration (lub {supplierId} - Zunapro dla integracji partnerskich). Webhook callbacki przychodzące z Trendyol są podpisywane HMAC-SHA256 z apiSecret jako kluczem — podpis trafia w nagłówku X-Trendyol-Signature i wymaga weryfikacji po stronie odbiorcy. Brak rotacji tokenów uprasza implementację, ale wymaga szczególnej dbałości o bezpieczne przechowywanie apiSecret (Zunapro trzyma go zaszyfrowanego AES-256 w tabeli marketplace_credentials z dostępem zawężonym per-tenant).
Gotów / gotowa na integrację Trendyol?
Zunapro łączy Trendyol REST API + webhooki + e-Fatura + Trendyol Express w jednym panelu. Zero kodu, 10 minut konfiguracji, pełna polska obsługa wsparcia.
2. Połączenie przez REST API — krok po kroku
Krok 1: Konto sprzedawcy Trendyol (Satıcı Hesabı)
Przed dotknięciem API potrzebne jest aktywne konto sprzedawcy w Trendyol Seller Center (partner.trendyol.com). Rejestracja wymaga: tureckiego numeru podatkowego (vergi numarası / VKN), rejestracji w ETBİS (Elektronik Ticaret Bilgi Sistemi, prowadzony przez MTM — Ticaret Bakanlığı), umowy z firmą logistyczną (Trendyol Express lub Yurtiçi Kargo / Aras Kargo) oraz integracji e-Fatura z jednym z certyfikowanych integratorów GİB. Polski sprzedawca, który nie posiada tureckiej spółki, ma trzy ścieżki — szczegóły w sekcji „Wymagania prawne" niżej.
Krok 2: Generowanie kluczy API
W partner.trendyol.com → Hesabım › Entegrasyon Bilgileri. Trendyol generuje trzy artefakty: apiKey (32 znaki), apiSecret (32 znaki, widoczny tylko raz — konieczna kopia), supplierId (numeryczny ID konta używany w URL). Zaleca się rotację apiSecret co 6-12 miesięcy i IP whitelist w Hesabım › API IP Kısıtlama (lista IP Zunapro w dokumentacji partnerskiej).
Krok 3: Pierwsze wywołanie — pobranie kategorii
Standardowy „smoke test" polegający na pobraniu drzewa kategorii Trendyol:
GET https://api.trendyol.com/sapigw/product-categories
Odpowiedź to drzewo JSON ze wszystkimi ~6 000 kategoriami Trendyol (od Kadın › Giyim › Elbise po Elektronik › Bilgisayar › Anakart). Każda kategoria ma własny zestaw obowiązkowych atrybutów (categoryAttributes), które trzeba pobrać osobno przez GET /product-categories/{categoryId}/attributes. To kluczowe — produkt bez wymaganych atrybutów zostanie odrzucony walidacją w trybie partii.
Krok 4: Mapowanie kategorii master → Trendyol
Najczęstszy ból integracji to mapowanie wewnętrznej taksonomii sklepu (np. „Damska bluza" w polskim katalogu) na precyzyjną kategorię Trendyol (np. Kadın › Giyim › Sweatshirt, categoryId 411). Zunapro stosuje wbudowany model ML, który na podstawie nazwy produktu, opisu i obrazu wstępnego proponuje 3 kategorie z prawdopodobieństwem — sprzedawca akceptuje jedną kliknięciem. Dla katalogu 1000 SKU mapowanie zajmuje typowo 15-20 minut zamiast wielogodzinnej pracy ręcznej. Po zatwierdzeniu mapowanie jest pamiętane na poziomie reguły (np. „wszystko z kategorii lokalnej #fashion-women-hoodies → Trendyol 411") i automatyzowane na przyszłe pozycje.
Krok 5: Test połączenia
Pełny test obejmuje cztery wywołania w sekwencji: (1) pobranie kategorii — sprawdza Basic Auth; (2) pobranie marek dostawcy — sprawdza supplierId; (3) lista produktów (pusta po świeżej rejestracji) — sprawdza ścieżkę; (4) lista zamówień ostatnich 7 dni — sprawdza pełen scope. Wszystkie cztery zwracają HTTP 200 → integracja jest poprawnie skonfigurowana i można przystąpić do synchronizacji katalogu. Zunapro automatyzuje cały scenariusz testowy w jednym kliknięciu „Sprawdź połączenie".
3. Synchronizacja produktów
Endpoint bulk — 1000 SKU na żądanie
Główny endpoint to POST /products — tablica do 1000 produktów na wywołanie. Tworzenie jest asynchroniczne; Trendyol zwraca batchRequestId, sprzedawca odpytuje GET /products/batch-requests/{batchRequestId}. Pełna walidacja 1000 SKU zajmuje 30-120 sek. Trzy statusy końcowe: SUCCESS (wszystkie OK), FAILED (cała partia odrzucona — schemat lub supplierId), COMPLETED z błędami per-item (większość OK, błędy w items[].failureReasons).
Wymagane pola produktu
Minimalna specyfikacja: barcode (EAN-13/GTIN-12/UPC, klucz idempotencji), title (turecki, max 100 znaków), productMainId (SKU master), brandId z GET /brands, categoryId (kategoria liść), quantity + listPrice + salePrice (TRY), vatRate (KDV 20/10/1), cargoCompanyId, dimensionalWeight (kg), description HTML (max 30 000 znaków), images (min 1 / max 8, HTTPS, min 1200×1800 px dla mody), attributes jako tablica par {attributeId, attributeValueId} zgodna z categoryAttributes.
Walidacja atrybutów — najczęstszy powód odrzucenia
Każda kategoria definiuje obowiązkowe atrybuty (dla „Kadın › Giyim › Elbise": rozmiar, kolor, materiał, długość rękawa, typ wzoru, sezon). Pominięcie zwraca "Mandatory attribute X is missing". Wartości muszą pochodzić ze znormalizowanej listy — np. atrybut „kolor" akceptuje 47 wartości („granat" nie istnieje, mapuje się na „lacivert"). Zunapro utrzymuje słownik tłumaczeń polskich wartości na etykiety Trendyol dla 23 popularnych kategorii fashion i kosmetyków.
Warianty produktu
Warianty modeluje się przez współdzielony productMainId i osobne barcode per wariant. Trendyol grupuje warianty na jednej karcie z przełącznikiem rozmiar/kolor (max 100 wariantów). Każdy ma własny stan i ceny, ale tytuł, kategoria, wspólne atrybuty i obrazy główne dziedziczy.
Wskazówka mapowania: najlepsze wyniki konwersji w polskich katalogach przesyłanych na Trendyol osiąga się, gdy tytuł produktu jest tłumaczony przez tłumacza-natywnego (nie maszynowo) z lokalnymi słowami kluczowymi („pamuklu", „yıkanabilir", „organik pamuk"). Zunapro w pakiecie Polonya→Türkiye oferuje moduł lokalizacji z bazą 8000 słów kluczowych dla 12 wiodących kategorii. Zobacz pakiet e-export →
4. Zarządzanie zamówieniami
Webhook ORDER_CREATED — pierwszy sygnał
Trendyol wysyła zdarzenie ORDER_CREATED w ciągu sekund od złożenia zamówienia. Payload: orderNumber, customerName, customerEmail (zamaskowany dla zgodności z KVKK), shipmentAddress, lista lines (barcode + quantity + price), cargoTrackingNumber jeśli już wygenerowany. Webhook musi zwrócić HTTP 200 w <5 sek; w przeciwnym razie Trendyol ponawia z exponential backoff (1s, 5s, 15s, 60s, 300s) do 6 razy. Po 6 nieudanych próbach zdarzenie ląduje w DLQ wymagającej ręcznej akcji.
Cykl życia statusu paczki
Standardowy obieg packageStatus: Created (zamówienie utworzone) → Picking (sprzedawca potwierdza pobranie przez POST /supplier-orders/{shipmentPackageId}/picking) → Invoiced (e-Fatura zarejestrowana w GİB, Zunapro automatycznie po Picking) → Shipped (paczka odebrana, numer śledzenia uzupełniony) → Delivered (dostawa potwierdzona) lub UnDelivered (paczka wraca do nadawcy).
Anulowanie i zwrot
Klient może anulować do statusu „Shipped". Sprzedawca otrzymuje webhook ORDER_CANCELLED z cancellationReason i odbudowuje stan magazynowy (Zunapro automatycznie). Zwroty po dostawie generują RETURN_INITIATED obsługiwane przez Trendyol Reverse Logistics. Odrzucenie zwrotu wymaga uzasadnienia i wpływa na Mağaza Puanı — kluczowy wskaźnik widoczności w wyszukiwarce.
Trendyol Express — integracja kurierska
Dla użytkowników Trendyol Express numer śledzenia jest generowany automatycznie i przekazywany w ORDER_CREATED. Etykieta PDF (format A6, Code128) pobierana z GET /supplier-orders/{shipmentPackageId}/shipment-labels, paczka przekazana kurierowi w pickupie lub punkcie odbioru.
📦 Zarządzaj wszystkimi zamówieniami z jednego panelu
Zunapro Order Hub konsoliduje zamówienia Trendyol z webhookami w czasie rzeczywistym, automatycznym wystawianiem e-Fatury i etykietami kurierskimi w jednym widoku.
5. Aktualizacja stanu i cen
Endpoint bulk price-and-inventory
Aktualizacja stanu i cen: POST /products/price-and-inventory. Body przyjmuje tablicę do 1000 pozycji z polami: barcode (klucz), quantity (≥0), salePrice (TRY, 2 miejsca), listPrice (≥ salePrice). Endpoint zwraca batchRequestId jak przy tworzeniu produktów. Pełna propagacja stanu w wyszukiwarce zajmuje 15-60 sek.
Strategia synchronizacji — Zunapro pattern
Zunapro stosuje hybrydowy model cron + event-driven: co 15 min pełny pull stanów z master, porównanie z lokalnym cache i wysłanie różnic w partiach po 1000; event-driven push na każdą zmianę w ERP (latencja 2-5 sek); walidacja po push z logiem batchRequestId; polityka MIN-stok dla mukerrer listingu — gdy ten sam barcode istnieje na wielu kontach, stosujemy minimum z wszystkich stanów (lekcja z incydentu czerwiec 2026, gdy duplikaty SKU prowadziły do oversell).
Pułapki cen w lirach tureckich
Lira turecka była w latach 2022-2026 jedną z najbardziej zmiennych walut globalnych. Dla polskiego sprzedawcy wyceniającego w EUR/PLN statyczna cena TRY szybko staje się nieaktualna. Zunapro automatyzuje wycenę: dzienny pull kursu TCMB i ECB, reguły narzutu per kategoria, automatyczna aktualizacja cen w nocy + przekroczenie progu kursu >1,5% w ciągu dnia, floor/ceiling per SKU.
6. Alternatywa XML/CSV
Kiedy XML/CSV ma sens
Mimo że REST API jest standardem 2026, Trendyol nadal wspiera klasyczny feed XML i CSV dla małych sprzedawców i scenariuszy migracji. Use case jest wąski, ale realny:
- Katalog < 200 SKU z niskim tempem zmian (kilka zmian na tydzień)
- Brak zasobów inżynieryjnych po stronie sprzedawcy do utrzymania integracji REST
- Tymczasowy most podczas migracji ze starszego systemu PIM
- Brand testing nowej linii produktowej przed pełnym onboardingiem
Schemat feedu XML
Trendyol XML feed to prosty plik UTF-8 z root element <products> i zagnieżdżonymi <product> o minimalnych polach: barcode, title, category, brand, description, price, list_price, stock, image_1..image_8, currency. Plik hostowany jest po stronie sprzedawcy (HTTPS, autoryzacja Basic opcjonalna), Trendyol pobiera go co 15-30 minut (cykl konfigurowalny w panelu Hesabım › Veri Akışı).
Ograniczenia XML/CSV vs REST
- Brak webhooków zamówień — wymaga polling GET /orders, latencja rośnie z <5s na 5-15 min
- Brak walidacji atrybutów per kategoria — produkty trafiają do statusu „Eksik Bilgi" wymagającego ręcznej naprawy
- Brak wsparcia wariantów grupowanych — każdy wariant osobną kartą, fragmentuje SEO
- Brak bulk price-only updates — każda zmiana wymaga re-pobrania pełnego feedu
W praktyce: sklep z >10 zamówień dziennie wyrasta z XML/CSV. Zunapro oferuje XML/CSV jako warstwę migracji, ale rekomendowanym standardem jest REST od dnia 1.
7. Trendyol Express FBA
Czym jest Trendyol Express Magaza
Trendyol Express to logistyczne ramię Trendyolu (akwizycja Hızlı Pazar w 2020). Składa się z: sieci magazynów fulfillmentowych w Tuzla, Tepeoren, Ankarze, Izmirze, Bursie i Gaziantep (~280 000 m² w 2026); 50 000+ paczkomatów Trendyol Box w 81 prowincjach; sieci kurierskiej own-fleet (Hızlı Teslimat 24-48h); oraz Trendyol Yemek i Trendyol Go (quick commerce 10-30 min).
FBA vs FBM — trzy opcje fulfillmentu
- FBM (Kendin Gönder) — sprzedawca wysyła sam (Trendyol Express, Yurtiçi, Aras, MNG). Opłata zerowa poza prowizją.
- Trendyol Express Magaza (FBA-lite) — stock u sprzedawcy, Trendyol Express odbiera pickupem. ~6-10 TL/paczka, 24-48h.
- Mağaza+ (pełny FBA) — wysyłka hurtowa do Tuzla, Trendyol obsługuje storage+pick+pack+ship+zwroty. 0,40-0,80 TL/m³/dzień + 3-7 TL pick&pack + 8-15 TL shipping.
Opłaty Trendyol Express w 2026
| Model | Opłata pickup | Storage | Pick & pack | SLA dostawa |
|---|---|---|---|---|
| FBM (kendin gönder) | — | — | — | 2-5 dni (wg kuriera) |
| TY Express Magaza | 6-10 TL/paczka | — | — | 24-48h metropoli |
| Mağaza+ FBA | — | 0,40-0,80 TL/m³/dzień | 3-7 TL/paczka | 24h Hızlı Teslimat |
Dla kogo FBA Trendyol się opłaca?
Próg opłacalności pełnego Mağaza+ FBA dla polskiego sprzedawcy cross-border to typowo 300+ zamówień miesięcznie na asortymencie szybko rotującym (moda, kosmetyki, akcesoria, elektronika ≤ 5 kg). Powyżej tego progu importu hurtowego do tureckiego magazynu z opłatą celną jednorazową staje się tańszy niż akumulowana opłata kurierska per-paczka. Dodatkowo karty produktów z badge „Hızlı Teslimat" notują o 25-40% wyższą konwersję w wyszukiwarce Trendyolu. Poniżej tego progu — model FBM lub Trendyol Express Magaza z magazynu polskiego (lub partnera 3PL w Stambule) jest racjonalniejszy.
Wskazówka cross-border: najpopularniejszy model dla polskich sprzedawców testujących turecki rynek to „Polish stock + Trendyol Express Magaza" — magazyn w Polsce, paczka odbierana przez kuriera DHL/UPS w Polsce, przeładowywana w Stambule do sieci Trendyol Express, ostateczna dostawa do paczkomatu Trendyol Box. Czas total 4-7 dni. Zobacz pełny przewodnik logistyki Polska→Turcja →
8. Integracja e-Faktury (GİB)
Czym jest e-Fatura w Turcji
e-Fatura to obowiązkowy turecki system elektronicznych faktur prowadzony przez GİB (Gelir İdaresi Başkanlığı — Urząd Skarbowy Turcji). Każda faktura B2B i B2C przekraczająca określony próg (5000 TL dla osób fizycznych, każda B2B niezależnie od kwoty) musi być wystawiona w formacie UBL-TR XML, podpisana cyfrowo mali mühür (pieczęć finansowa, certyfikat wydawany przez TÜBİTAK), wysłana do GİB przez akredytowanego integratora i archiwizowana przez 10 lat. Z perspektywy polskiego sprzedawcy: system jest filozoficznie podobny do KSeF, ale architektonicznie inny — KSeF używa schematu FA(2) i centralnego API, e-Fatura działa w modelu „GİB jako brama" z integratorami pełniącymi rolę warstwy podpisu i transmisji.
Akredytowani integratorzy e-Fatury 2026
Sprzedawca wybiera jednego z certyfikowanych integratorów (özel entegratör). Pięć największych w 2026:
- Logo — dominujący wśród MŚP, ~150 TL/mies. + 0,30-0,80 TL/fakturę
- Mikro — drugi rynek, retail i restauracje, od 200 TL/mies.
- Uyumsoft — premium enterprise, integracje SAP/Oracle, 500 TL+/mies.
- Foriba (część Sovos) — międzynarodowy gracz, 800-2000 TL/mies.
- Veriban — cloud-native, od 250 TL/mies., najlepsze API dla marketplace
Architektura integracji Zunapro ↔ e-Fatura
Zunapro abstrahuje wybór integratora przez warstwę adapterów. Sprzedawca wybiera Logo / Mikro / Uyumsoft / Foriba / Veriban, wprowadza dane logowania i mapuje konto. Następnie automatycznie: (1) webhook ORDER_CREATED dociera do Zunapro; (2) builder składa obiekt faktury z VAT-rate; (3) adapter konwertuje na UBL-TR XML; (4) integrator podpisuje mali mühür i wysyła do GİB; (5) GİB zwraca UUID ETTN (Evrensel Tekil Tekil Numara); (6) Zunapro zapisuje ETTN + PDF i wysyła link do Trendyolu przez POST /supplier-orders/{shipmentPackageId}/invoice-link; (7) status zamówienia przechodzi na Invoiced.
KSeF (PL) vs e-Fatura (TR) — kluczowe różnice
| Aspekt | KSeF (Polska) | e-Fatura (Turcja) |
|---|---|---|
| Schemat | FA(2) XML własny | UBL-TR XML (UN/CEFACT) |
| Operator | Ministerstwo Finansów — bezpośrednio | GİB przez akredytowanych integratorów |
| Identyfikator | 10-znakowy KSeF ID | UUID ETTN (36 znaków) |
| Podpis | Podpis kwalifikowany / pieczęć elektr. | Mali mühür (TÜBİTAK) |
| Próg B2C | Brak — wszystkie B2B/B2G | 5000 TL dla osób fizycznych |
| Termin wystawienia | 15 dni od dostawy | 7 dni od dostawy |
| Archiwizacja | 10 lat (KSeF przechowuje) | 10 lat (integrator archiwizuje) |
Polski sprzedawca prowadzący równolegle sprzedaż w Polsce (KSeF) i Turcji (e-Fatura) potrzebuje obu warstw — Zunapro hostuje oba w jednym panelu z osobnymi adapterami i wspólnym schematem zamówień.
9. Częste błędy i rozwiązania
HTTP 401 Unauthorized
Trzy źródła: (1) nieprawidłowy Base64 apiKey:apiSecret — częsty błąd to spacja przed dwukropkiem lub newline na końcu (base64.b64encode(f"{apiKey}:{apiSecret}".encode()).decode()); (2) brak nagłówka User-Agent w formacie {supplierId} - SelfIntegration; (3) wyłączony klucz — w panelu Hesabım sprawdzić status „Aktif".
HTTP 429 Too Many Requests
Przekroczenie limitu. Rozwiązanie: respekt nagłówka Retry-After (typowo 30-60 sek), kolejka z workerem ograniczonym do 80 req/min (margines), grupowanie aktualizacji w batche po 1000, wniosek o podwyższony limit dla certyfikowanych integratorów.
Webhook 401/403 — IP whitelisting i podpis HMAC
Trendyol od marca 2026 wymaga walidacji nagłówka X-Trendyol-Signature jako HMAC-SHA256(body, apiSecret). Niezweryfikowanie podpisu lub odrzucenie żądania zwraca 401. Dodatkowo Trendyol publikuje listę IP wychodzących (pula AWS-EU + AWS-TR) — endpoint sprzedawcy musi je akceptować. Certyfikat TLS musi być ważny (Let's Encrypt OK), self-signed są odrzucane.
"Mandatory attribute X is missing"
Walidacja atrybutów per kategoria. Rozwiązanie: pełny pull listy obowiązkowych atrybutów dla każdej kategorii przed importem (GET /product-categories/{categoryId}/attributes z filtrem required=true) i utrzymanie mapowania w warstwie PIM/Zunapro.
"Barcode already exists" przy tworzeniu produktu
Trendyol traktuje barcode jako globalny klucz unikalny w obrębie konta sprzedawcy. Jeśli barcode istnieje, należy używać PUT na istniejący produkt zamiast POST. Zunapro automatycznie wykrywa istniejące barcody i przełącza tryb na update.
"Brand not approved"
Trendyol weryfikuje marki — nieautoryzowane marki są blokowane (np. „własna marka X" wymaga rejestracji marki w panelu i dostarczenia dokumentów własności / OEM). Dla polskich marek autorskich należy złożyć wniosek Marka Başvurusu z dokumentami WIPO/EUIPO lub TÜRKPATENT — czas weryfikacji 7-14 dni roboczych.
e-Fatura: "ETTN already used"
Próba ponownego wystawienia faktury dla zamówienia, które już ma fakturę. Najczęściej spowodowana ponowieniem webhooka przez Trendyol bez idempotencji po stronie integratora. Zunapro implementuje key {orderNumber}+{packageId} jako idempotency-key, eliminując ten błąd.
Stock mismatch — nadsprzedaż
Klasyczna pułapka multi-channel: ten sam SKU sprzedaje się na Trendyolu i na własnym sklepie/innym marketplace, oba systemy aktualizują stan w Trendyolu, ale z opóźnieniem. Rozwiązanie: jeden master źródła prawdy (ERP lub Zunapro) z eventową propagacją do wszystkich kanałów. Polityka MIN-stok dla bezpieczeństwa. Reserve w Zunapro „odlicza" stan natychmiast po webhooku ORDER_CREATED, zanim push dotrze do Trendyolu.
10. Prowizje Trendyol 2026
Prowizje Trendyolu są tiered per kategoria z trzema głównymi pasmami. Aktualna tabela jest dostępna w panelu sprzedawcy w Hesabım › Komisyon Oranları i aktualizowana kwartalnie.
Opłaty dodatkowe poza prowizją
- Opłata za zwrot (iade kargo bedeli) — ~14,90 TL od paczki zwrotnej (płaci sprzedawca)
- Trendyol Ads — CPC — opcjonalne, stawki od 0,50 TL/klik (moda) do 8+ TL/klik (premium electronics)
- Trendyol Boost — promowane miejsca w wyszukiwarce, model CPM, od 5 TL/1000 wyświetleń
- Opłaty Trendyol Express FBA — patrz tabela w sekcji 7
- Opłata transakcyjna PSP — Trendyol absorbuje ją w prowizji, sprzedawca nie ponosi osobno
Kalkulacja netto — przykład
Przykład: sprzedaż damskiej bluzy za 299 TL w kategorii „Kadın › Giyim › Sweatshirt" (prowizja 19%): cena brutto 299 TL − prowizja Trendyol 19% (56,81 TL) − KDV 20% (49,83 TL) − logistyka 8 TL − koszt zakupu ex-works Polska ~175 TL = ~9 TL marży netto per sztukę. To dolny próg opłacalności — typowy polski e-exporter target to 15-25 TL/sztukę przy wolumenie 500-2000 szt./mies. Optymalizacje: wyższa cena katalogowa, lepsze tłumaczenie tytułu, Trendyol Ads, FBA Mağaza+ z badge Hızlı Teslimat.
💰 Sprawdź marżę netto dla swojego asortymentu
Kalkulator marży Zunapro pokazuje netto per SKU po wszystkich opłatach Trendyolu — wybierz kategorię, model logistyki i strategię reklamową w jednym widoku.
Wymagania prawne dla polskiego sprzedawcy na rynku tureckim
Trzy ścieżki wejścia
Polski sprzedawca ma trzy modele prawne:
- (A) Turecka spółka Ltd. Şti. — kapitał min. 50 000 TL, 3-6 tygodni rejestracji w Ticaret Sicil Müdürlüğü, siedziba w Turcji. Pełny dostęp do Trendyol Seller jako natywny sprzedawca. Najwyższe marże, najwyższy nakład organizacyjny.
- (B) Współpraca z tureckim importerem-dystrybutorem — polski sprzedawca dostarcza hurtowo do partnera w Turcji, który rejestruje produkty na własnym koncie. Wejście w kilka dni, ale 15-25% marży po stronie partnera. Dobre na pilotaż.
- (C) E-eksport z Polski — po rejestracji w e-İhracat MTM i statusie „ihracatçı". Faktury w PLN/EUR z polskiej firmy, dostawa cross-border. Wymaga programu Trendyol International (limited rollout 2026).
ETBİS, KEP i KVKK
Każdy sprzedawca musi być zarejestrowany w ETBİS (centralny rejestr MTM, rejestracja bezpłatna online) i posiadać adres KEP (Kayıtlı Elektronik Posta, ~150 TL/rok). KVKK (ustawa 6698) to turecki odpowiednik RODO — sprzedawca jest współadministratorem danych z platformą, wymagana rejestracja w VERBİS dla firm powyżej progu obrotów. RODO i KVKK to dwa równoległe reżimy, filozoficznie zbieżne ale prawnie odrębne.
Logistyka Polska → Turcja
Unia celna UE-Turcja
Najważniejsza informacja dla polskiego eksportera: Polska i Turcja są związane Unią Celną UE-Turcja (umowa z 1995 roku, Decyzja Rady Stowarzyszenia 1/95). Konsekwencja: zerowe cło na większość towarów przemysłowych objętych unią. Wymagany dokument odprawy to świadectwo A.TR (ruch celny) wystawiane przez polski urząd celno-skarbowy — koszt ~30 PLN, czas wystawienia 1-3 dni robocze.
Wyjątki spoza unii celnej
- Wyroby rolne i przetworzone spożywcze — osobne porozumienia preferencyjne, cła 0-15%
- Węgiel i stal — wyłączone z unii (analogicznie do CETA), pełne cła
- Tekstylia z pochodzenia trzeciego — wymagane EUR.1 zamiast A.TR, weryfikacja pochodzenia
KDV (turecki VAT) i odprawa
Standardowa stawka KDV to 20%, obniżone 10% i 1% dla żywności, leków i wybranych produktów. Importer w Turcji (osobą prawną z modelu A/B) płaci KDV przy odprawie, odliczając go potem od KDV sprzedażowego. Każda pozycja musi mieć GTIP (kod celny, 12-cyfrowy odpowiednik HS) — Trendyol nie weryfikuje GTIP, ale celnik tak.
Stos logistyczny dla polskiego sprzedawcy 2026
- FBM cross-border: DHL eCommerce / UPS / FedEx z Polski, 4-7 dni, 35-80 PLN/paczka 2 kg
- FBM przez 3PL Stambuł: konsolidacja w PL, paleta tygodniowo do Stambułu, dystrybucja przez Yurtiçi/Trendyol Express, 1-3 dni w Turcji po odprawie
- FBA Trendyol Mağaza+: hurtowa wysyłka do Tuzla/Tepeoren, Hızlı Teslimat 24-48h. Próg opłacalności ~300 zamówień/mies.
- Drop-shipping z polskiego sklepu: niska poprzeczka, długi czas dostawy → gorsze opinie → spada Mağaza Puanı. Tylko dla testów.
🇹🇷 Jedno polskie konto, 30M tureckich klientów
Zunapro orchestruje integrację Trendyol REST API, e-Fatura GİB, Trendyol Express i synchronizację katalogu z polskim ERP w jednym panelu z polską obsługą supportu.
Jak zacząć sprzedawać na Trendyolu — 5 kroków 2026
1. Konto sprzedawcy Trendyol
Wybierz model prawny (A/B/C powyżej) i zarejestruj się w partner.trendyol.com. Dla modelu A — pełna turecka Ltd. Şti. z numerem podatkowym. Dla modelu B — partner zarejestrowany w Turcji prowadzi konto, polski sprzedawca jest dostawcą hurtowym. Dla modelu C — Trendyol International Cross-Border (limited rollout 2026, kontakt przez Zunapro w celu zgłoszenia).
2. Rejestracja ETBİS + numer podatkowy
Złóż wniosek rejestracyjny w ETBİS (Elektronik Ticaret Bilgi Sistemi) — bezpłatne, online, ~7-14 dni roboczych. Równolegle uzyskaj vergi numarası (numer podatkowy) z urzędu skarbowego (vergi dairesi) — wymaga tureckiego adresu siedziby. Załóż adres KEP do oficjalnej korespondencji administracyjnej.
3. Wygenerowanie kluczy API
W panelu Trendyol Seller Center przejdź do Hesabım › Entegrasyon Bilgileri. Wygeneruj apiKey, apiSecret i odczytaj supplierId. Zapisz bezpiecznie — apiSecret wyświetlany tylko raz. Opcjonalnie skonfiguruj IP whitelisting w API IP Kısıtlama (Zunapro IP listę znajdziesz w dokumentacji partnerskiej).
4. Konfiguracja panelu Zunapro (10 minut)
- Zaloguj się do Zunapro i otwórz moduł Marketplace › Trendyol
- Wprowadź apiKey, apiSecret, supplierId i kliknij „Sprawdź połączenie"
- Wybierz integratora e-Fatura (Logo / Mikro / Uyumsoft / Foriba / Veriban) i wprowadź dane logowania do jego API
- Zaakceptuj automatyczne mapowanie kategorii master → Trendyol (proponowane przez ML)
- Włącz webhooki: ORDER_CREATED, PACKAGE_STATUS, RETURN_INITIATED
- Ustaw politykę synchronizacji stanu (rekomendowane: cron co 15 min + push event-driven)
5. Zamówienie testowe
Z panelu Zunapro kliknij „Wyślij zamówienie testowe" — generuje to syntetyczny payload ORDER_CREATED który przechodzi przez całą pętlę (webhook → Picking → e-Fatura → Shipped → Delivered) bez wpływu na rzeczywiste finanse. Walidacja: (a) faktura UBL-TR wygenerowana z ETTN, (b) status zamówienia zaktualizowany w Trendyol, (c) stan magazynowy zmniejszony i zsynchronizowany z innymi kanałami, (d) etykieta kurierska PDF do druku. Po zielonym świetle: pierwsze prawdziwe zamówienia z marketplace'u płyną bez dalszej interwencji.
Połącz Trendyol z resztą Twojej sprzedaży w 10 minut
REST API + webhooks + e-Fatura GİB + Trendyol Express + synchronizacja stanów z polskim ERP w jednym panelu. Bez kodu, bez długoterminowych umów, pełna polska obsługa wsparcia.
🇹🇷 Rozpocznij integrację Trendyol →FAQ — Trendyol API dla polskiego sprzedawcy
Jak uzyskać klucz API Trendyol jako polski sprzedawca?
Klucz API uzyskuje się w panelu partner.trendyol.com w zakładce Hesabım › Entegrasyon Bilgileri. Wymagany jest aktywny status sprzedawcy z tureckim numerem podatkowym (vergi numarası), rejestracja w systemie ETBİS i akceptacja regulaminu API.
Polski sprzedawca działający przez tureckiego partnera (Ltd. Şti. lub şube) używa numeru VKN tureckiego podmiotu. Bezpośrednia rejestracja zagranicznego NIP nie jest obecnie wspierana — model C (e-eksport bezpośredni z Polski) wymaga programu Trendyol International Cross-Border, dostępnego w 2026 dla wybranych integratorów, w tym Zunapro.
Czy Trendyol API używa OAuth 2.0?
Nie. Trendyol stosuje uwierzytelnianie HTTP Basic Auth z parą apiKey:apiSecret kodowaną Base64. Każde żądanie ma nagłówek Authorization: Basic <base64> oraz User-Agent zawierający supplierId.
Webhook callbacki są podpisywane HMAC-SHA256 (nagłówek X-Trendyol-Signature). Dla porównania: Allegro, Amazon SP-API i Trendyol International Sandbox używają OAuth 2.0. Trendyol PL/TR pozostał przy prostszym modelu — upraszcza to integrację, ale wymaga ostrożnego zarządzania tajnymi kluczami. Zunapro szyfruje credentials AES-256 i izoluje per-tenant.
XML/CSV czy REST API — co wybrać do integracji z Trendyol?
REST API jest standardem dla każdego serio prowadzonego sklepu z >50 SKU lub >10 zamówień dziennie — daje aktualizacje stanów w czasie rzeczywistym, webhooki zamówień, walidację atrybutów i pełną kontrolę nad cyklem życia produktu.
XML/CSV (importer feedu produktowego) sprawdza się tylko dla bardzo prostych katalogów (<200 SKU, niskie tempo zmian) lub jako tymczasowy most podczas migracji. Trendyol pobiera feed XML co 15-30 minut, więc opóźnienie aktualizacji stanu jest wyraźne — w sezonie wyprzedaży ryzyko nadsprzedaży rośnie. Rekomendacja: REST API od dnia 1.
Jakie są limity zapytań (rate limits) Trendyol API w 2026?
Standardowy limit: 100 zapytań/minutę na supplierId dla GET, 50 zapytań/minutę dla POST/PUT. Operacje bulk (/products, /price-and-inventory) przyjmują do 1000 pozycji na żądanie, efektywnie podnosząc przepustowość do 50 000 SKU/min.
Przekroczenie zwraca HTTP 429 z nagłówkiem Retry-After. Trendyol dla certyfikowanych integratorów (jak Zunapro) udostępnia podwyższone limity na wniosek. Praktyka: kolejkowanie z exponential backoff, grupowanie aktualizacji co 2-5 minut, nie po każdej zmianie.
Dla kogo opłaca się Trendyol Express FBA?
Trendyol Express Mağaza+ (pełny FBA) opłaca się sprzedawcom z >300 zamówień/miesiąc na asortymencie szybko rotującym — moda, kosmetyki, akcesoria, elektronika do 5 kg. Magazyny w Tuzla, Tepeoren, Ankarze i Izmirze zapewniają dostawę 24-48h, a badge „Hızlı Teslimat" podnosi konwersję o 25-40%.
Dla polskich sprzedawców cross-border próg opłacalności zaczyna się dopiero, gdy import hurtowy do magazynu tureckiego (z jednorazową odprawą celną) staje się tańszy niż akumulowana opłata logistyczna per-paczka. Poniżej tego progu — model FBM lub Trendyol Express Mağaza (pickup tylko) z polskiego magazynu jest racjonalniejszy.
Jakie są prowizje Trendyol w 2026?
Prowizje Trendyol w 2026 mieszczą się w przedziale 8% - 22% w zależności od kategorii. Niski próg (8-12%): elektronika, telefony, AGD, książki, motoryzacja. Średni (12-17%): dom i ogród, sport, zabawki, hobby, suplementy. Wysoki (17-22%): moda i obuwie, kosmetyki, biżuteria, akcesoria luksusowe.
Do prowizji dochodzi: opłata zwrotu ~14,90 TL/paczka, opcjonalna Trendyol Ads (CPC od 0,50 TL), Trendyol Boost (CPM od 5 TL/1000 wyświetleń). Aktualna tabela kategorii jest publikowana w panelu Hesabım › Komisyon Oranları i synchronizowana przez Zunapro do modułu wyceny netto.
Jak utworzyć zamówienie testowe na sandboxie Trendyol?
Trendyol udostępnia środowisko stage (stageapi.trendyol.com) z osobnymi kluczami testowymi przyznawanymi po podpisaniu NDA z zespołem partnerskim. W panelu Seller Center można też włączyć tryb „Test Sipariş" na produkcji — generuje syntetyczne zamówienie z statusem Created → Picking → Shipped → Delivered, które przechodzi przez całą pętlę webhook bez wpływu na rzeczywiste finanse i stany.
Rekomendowana walidacja: (1) odbiór webhook ORDER_CREATED, (2) potwierdzenie packageStatus, (3) wgranie numeru śledzenia, (4) symulacja anulowania i zwrotu, (5) wystawienie e-Fatury i odebranie ETTN. W Zunapro pełen scenariusz uruchamia się jednym kliknięciem „Wyślij zamówienie testowe".
Dlaczego webhook Trendyol zwraca błąd 401/403?
Najczęstsze przyczyny: (1) brak walidacji nagłówka X-Trendyol-Signature (HMAC-SHA256 z apiSecret) — wymagany od marca 2026; (2) zmiana IP whitelistowanego endpointu — Trendyol wysyła z puli adresów AWS-EU i AWS-TR, lista jest publikowana w dokumentacji; (3) wygaśnięcie certyfikatu TLS (wymagany TLS 1.2+, certyfikaty self-signed odrzucane); (4) nieprawidłowy URL w Hesabım › Webhook Yönetimi (brak slash końcowego lub mixed-content http→https).
Zunapro hostuje endpointy webhook po stronie zunapro.com z automatyczną rotacją certyfikatów Let's Encrypt i walidacją podpisów — te klasy błędów znikają.
Czy mogę prowadzić kilka sklepów Trendyol z jednego panelu Zunapro?
Tak. Zunapro obsługuje wiele kont sprzedawcy Trendyol (każde z własnym supplierId + apiKey) w ramach jednego tenanta. Typowe konfiguracje: osobne konta dla różnych marek własnych, osobne konta detal vs outlet, dedykowane konto na cross-border z polskiego magazynu vs Trendyol Express FBA.
Każdy sklep ma osobne mapowanie kategorii i własne reguły cenowe, ale współdzieli master-katalog SKU. Synchronizacja stanu odbywa się w trybie „first-write-wins" z politykami deduplikacji — w razie kolizji (ten sam barcode na dwóch kontach) Zunapro stosuje regułę MIN-stok dla bezpieczeństwa przed nadsprzedażą (lekcja z incydentu czerwiec 2026, gdzie duplikaty SKU prowadziły do oversell).
Wymagania prawne — czy mogę sprzedawać na Trendyolu z polskiej firmy?
Polski sprzedawca ma trzy ścieżki: (A) turecka spółka Ltd. Şti. (kapitał min. 50 000 TL, 3-6 tygodni rejestracji), (B) współpraca z tureckim importerem-dystrybutorem (najszybciej, niższe marże), (C) e-eksport z polskiej firmy przez program Trendyol International Cross-Border (limited rollout 2026).
Niezależnie od ścieżki wymagana jest rejestracja w ETBİS (Elektronik Ticaret Bilgi Sistemi MTM), zgodność z KVKK (turecki RODO, ustawa 6698) oraz integracja z systemem e-Fatura GİB. Polska firma działająca w modelu C dodatkowo musi prowadzić rejestr eksportowy w polskim US z dokumentami A.TR dla unii celnej UE-Turcja.
Cła i podatki Polska → Turcja: co muszę wiedzieć?
Polska i Turcja są stronami Unii Celnej UE-Turcja (1995, Decyzja Rady Stowarzyszenia 1/95) — zerowe cło na większość towarów przemysłowych. Wymagany dokument: świadectwo A.TR wystawiane przez polski urząd celno-skarbowy, koszt ~30 PLN.
Wyjątki: wyroby rolne, węgiel/stal i tekstylia z pochodzenia trzeciego. KDV (turecki VAT) wynosi 20% standardowo, 10% lub 1% dla wybranych kategorii. Polska firma rejestrująca się jako importer w Turcji musi uzyskać GTIP (kod celny) dla każdej pozycji. Próg de minimis dla przesyłek osobistych: 30 EUR (bez cła) / 1500 EUR (uproszczona odprawa). E-commerce hurtowy wymaga pełnej odprawy z GTIP.
Jak długo trwa pełna integracja Trendyol w Zunapro?
10-15 minut dla katalogu do 1000 SKU. Etapy: (1) wprowadzenie apiKey/apiSecret/supplierId (~2 min), (2) automatyczne wykrycie i mapowanie kategorii (~3 min), (3) pierwszy import katalogu + walidacja atrybutów (~5 min), (4) konfiguracja webhook ORDER_CREATED/PACKAGE_STATUS (~1 min), (5) zamówienie testowe i potwierdzenie pętli (~2 min).
Dla większych katalogów (10 000+ SKU) pierwsza synchronizacja może trwać do godziny, ale wszystkie kolejne aktualizacje są inkrementalne i zajmują sekundy. Konfiguracja e-Fatury (Logo/Mikro/Uyumsoft/Foriba/Veriban) dodaje ~5 minut przy pierwszym podłączeniu.
Czy Zunapro obsługuje równolegle KSeF (Polska) i e-Fatura (Turcja)?
Tak. Zunapro hostuje obie warstwy fakturowania w jednym panelu z osobnymi adapterami. Sprzedawca prowadzący równolegle sprzedaż w Polsce i Turcji ma jeden master katalogu produktów i wspólny schemat zamówień, ale faktury są generowane w odpowiednim systemie wg lokalizacji odbiorcy:
Klient z polskim adresem → KSeF FA(2) XML → 10-znakowy KSeF ID. Klient z tureckim adresem → UBL-TR XML → mali mühür → ETTN UUID przez integratora GİB (Logo/Mikro/Uyumsoft/Foriba/Veriban). Konsolidowane raporty VAT (JPK_V7M dla PL + KDV dla TR) eksportowane z jednego panelu.
Rozpocznij sprzedaż na Trendyolu — 10-minutowa integracja
REST API · webhooks · e-Fatura GİB · Trendyol Express · synchronizacja z polskim ERP — wszystko w jednym panelu Zunapro z polską obsługą supportu. Bez demo, bez długoterminowych umów. Otwórz turecki kanał e-commerce już dziś.
🇹🇷 Połącz Trendyol w 10 minut →Potrzebujesz pomocy?
Powiązana usługa: Marketplace