Οδηγός ενσωμάτωσης Trendyol 2026: REST API, σύνδεση XML & κεντρική διαχείριση καταστημάτων

1. Αρχιτεκτονική Trendyol API 2026

Το Marketplace API του Trendyol είναι ένα RESTful interface JSON-over-HTTPS που δημοσιεύεται σε μία βασική διεύθυνση παραγωγής — https://api.trendyol.com — με ένα ξεχωριστό περιβάλλον stage στο https://stageapi.trendyol.com. Κάθε κλήση API πιστοποιείται με HTTP Basic Auth: η κεφαλίδα Authorization μεταφέρει ένα ζεύγος ApiKey:ApiSecret κωδικοποιημένο σε base64, και το Supplier ID περνιέται ως παράμετρος διαδρομής σε κάθε τελικό σημείο με πεδίο εφαρμογής προμηθευτή. Δεν υπάρχει ξεχωριστός γύρος access-token για πωλητές πρώτου μέρους — το Basic Auth ελέγχεται σε κάθε αίτημα — που κρατά την ενσωμάτωση απλή αλλά σημαίνει ότι τα διαρρεύσαντα διαπιστευτήρια πρέπει να εναλλάσσονται άμεσα μέσω του πίνακα Partner.

Βασική διεύθυνση URL, πιστοποίηση, κεφαλίδες

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

Η κεφαλίδα User-Agent δεν είναι διακοσμητική: η διαμόρφωση κίνησης και η καταμέτρηση ορίων ρυθμού του Trendyol βασίζονται σε αυτήν. Οι ενσωματωτές (όπως το Zunapro) αποστέλλουν {supplierId} - Zunapro· οι πωλητές πρώτου μέρους αποστέλλουν {supplierId} - SelfIntegration. Οι λανθασμένα σφραγισμένες κεφαλίδες User-Agent μπορούν να προκαλέσουν αποκρίσεις 401/403 ακόμη και με έγκυρα διαπιστευτήρια.

Όρια ρυθμού και ποσοστώσεις

Το Trendyol επιβάλλει όρια ρυθμού ανά τελικό σημείο, ανά προμηθευτή. Τα δημοσιευμένα ανώτατα όρια για το 2026 είναι:

• Τελικά σημεία προϊόντων — συνήθως 60 αιτήματα/λεπτό ανά Supplier ID, με ανοχή έκρηξης έως 90/λεπτό για 30 δευτερόλεπτα
• Τελικά σημεία παραγγελιών — συνήθως 600 αιτήματα/λεπτό (το τελικό σημείο παραγγελιών είναι εκ σχεδιασμού υψηλής κίνησης και χαμηλής καθυστέρησης)
• Τελικά σημεία ενημέρωσης τιμής & αποθέματος — συνήθως 100 αιτήματα/λεπτό, με κάθε αίτημα να μεταφέρει έως 1.000 SKU σε μία παρτίδα
• Αναζητήσεις κατηγορίας & χαρακτηριστικών — συνήθως 30 αιτήματα/λεπτό (αυτά αλλάζουν αργά, οπότε αναμένεται επιθετική προσωρινή αποθήκευση)

Κάθε απόκριση περιλαμβάνει κεφαλίδες X-RateLimit-Limit, X-RateLimit-Remaining και, στα 429, Retry-After. Μια καλά δομημένη ενσωμάτωση χρησιμοποιεί μια ουρά token-bucket ανά Supplier ID και ασκεί αντίθλιψη στο 429 με εκθετική υποχώρηση· το Zunapro το υλοποιεί από προεπιλογή, ώστε ακόμη και οι μαζικές αποστολές πολλών χιλιάδων SKU να μην ξεπερνούν ποτέ τα όρια.

OAuth 2.0 για ανεξάρτητους ενσωματωτές

Για ανεξάρτητους ενσωματωτές ενδιάμεσου επιπέδου (Zunapro και παρόμοια platform SaaS που ενεργούν εκ μέρους πολλών προμηθευτών), το Trendyol προσφέρει μια ροή OAuth 2.0 authorization-code αντί για άμεσο Basic Auth. Ο ενσωματωτής καταχωρεί ένα client_id / client_secret στην ομάδα developer relations του Trendyol, ο προμηθευτής εξουσιοδοτεί τον ενσωματωτή από τον πίνακα Partner, και ο ενσωματωτής λαμβάνει ένα access token 1 ώρας συν ένα refresh token για επανέκδοση. Αυτό αποφεύγει τον χειρισμό του ακατέργαστου ApiKey / ApiSecret του προμηθευτή και είναι η φιλική προς έλεγχο οδός για εταιρικούς πελάτες που διαχειρίζονται πολλά καταστήματα Trendyol.

Webhooks

Το Trendyol αποστέλλει συμβάντα κύκλου ζωής παραγγελίας στο καταχωρημένο σας URL webhook: Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. Το payload του webhook είναι ένας φάκελος JSON που μεταφέρει το ID παραγγελίας και τη νέα κατάσταση· το τελικό σημείο σας πρέπει να απαντήσει με HTTP 200 εντός 3 δευτερολέπτων. Σε αποτυχία το Trendyol επαναλαμβάνει 5 φορές με εκθετική υποχώρηση και έπειτα παρκάρει το συμβάν — γι' αυτό μια λήψη συμφωνίας κάθε 5 λεπτά στο /sapigw/suppliers/{id}/orders είναι ένα μη προαιρετικό δίχτυ ασφαλείας.

2. Σύνδεση μέσω REST API — βήμα προς βήμα

Η επίσημη ομαλή οδός για τη σύνδεση με το REST API του Trendyol το 2026 είναι σύντομη και καλά τεκμηριωμένη — αλλά η σειρά των ενεργειών έχει σημασία, επειδή ορισμένες νομικές προϋποθέσεις προηγούνται του ίδιου του API.

2.1 Ανοίξτε έναν λογαριασμό πωλητή Trendyol

Επισκεφθείτε το partner.trendyol.com και υποβάλετε μια αίτηση "Άνοιγμα λογαριασμού Trendyol". Θα χρειαστείτε:

• VKN (Vergi Kimlik Numarası) — τουρκικός φορολογικός αριθμός (ή ξένο ισοδύναμο εγγραφής επιχείρησης για το Trendyol International)
• Trade Registry Gazette (Ticaret Sicil Gazetesi) για εταιρείες περιορισμένης ευθύνης ή ανώνυμες εταιρείες
• Δείγμα υπογραφής (imza sirküleri)
• ETBİS (Elektronik Ticaret Bilgi Sistemi) απόδειξη εγγραφής — υποχρεωτική για κάθε φορέα ηλεκτρονικού εμπορίου στην Τουρκία από το 2018
• Τραπεζικός λογαριασμός (IBAN TR) στο όνομα της νομικής οντότητας για πληρωμές marketplace

Η έγκριση διαρκεί συνήθως 2–5 εργάσιμες ημέρες. Μόλις εγκριθεί, ο πωλητής λαμβάνει ένα Supplier ID και πρόσβαση στον πίνακα Trendyol Partner.

2.2 Δημιουργήστε API Key και Secret

Από τον πίνακα Partner, ανοίξτε Ρυθμίσεις λογαριασμού → Πληροφορίες ενσωμάτωσης και κάντε κλικ στο "Create API Key". Το Trendyol δημιουργεί ένα API Key 40 χαρακτήρων και ένα API Secret 40 χαρακτήρων. Και οι δύο τιμές εμφανίζονται μία φορά — δεν μπορούν να ανακτηθούν αργότερα. Αποθηκεύστε τες σε έναν διαχειριστή κωδικών πρόσβασης ή, ακόμη καλύτερα, επικολλήστε τες απευθείας στο πλακίδιο ενσωμάτωσης του Zunapro, το οποίο τις αποθηκεύει ως κρυπτογραφημένα με AES-256, αποκρυμμένα μυστικά.

2.3 Πρώτο αίτημα smoke-test

Επιβεβαιώστε ότι τα διαπιστευτήρια είναι ενεργά καλώντας το τελικό σημείο πληροφοριών προμηθευτή:

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"

Μια επιτυχής απόκριση επιστρέφει τις καταχωρημένες διευθύνσεις αποθήκης και επιστροφών του προμηθευτή σε JSON. Ένα 401 σημαίνει ότι η κεφαλίδα Basic Auth είναι λανθασμένη· ένα 403 σημαίνει ότι το Supplier ID δεν ταιριάζει με τα διαπιστευτήρια· ένα 404 σημαίνει ότι η διαδρομή τελικού σημείου είναι κακοσχηματισμένη.

2.4 Παραλλαγή OAuth (για ενσωματωτές πολλαπλών προμηθευτών)

Για ανεξάρτητους ενσωματωτές, η ροή OAuth 2.0 μοιάζει ως εξής:

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

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

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

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

Τα access token είναι έγκυρα για 1 ώρα και ανανεώσιμα για 30 ημέρες. Το Zunapro χειρίζεται και τα τέσσερα βήματα με διαφάνεια, ώστε ο προμηθευτής να βλέπει μόνο ένα κουμπί "Connect to Trendyol".

2.5 Δημοσιεύστε το πρώτο σας προϊόν

Χρησιμοποιήστε POST /sapigw/suppliers/{supplierId}/v2/products με έναν πίνακα JSON αντικειμένων. Το ελάχιστο αντικείμενο προϊόντος απαιτεί barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (συνήθως TRY), listPrice, salePrice, vatRate, cargoCompanyId, έναν πίνακα images (1–8 URL) και έναν πίνακα attributes με ID χαρακτηριστικών ανά κατηγορία.

3. Συγχρονισμός προϊόντων σε κλίμακα

Μαζική μεταφόρτωση — 1.000 SKU ανά παρτίδα

Το τελικό σημείο POST /v2/products του Trendyol δέχεται έως 1.000 SKU ανά μεμονωμένο αίτημα JSON. Για πωλητές με καταλόγους 10.000+ SKU αυτό είναι η διαφορά μεταξύ ενός onboarding μίας ώρας και ενός πολλών ημερών. Η παρτίδα επιστρέφει ένα batchRequestId ανά κλήση· το Trendyol επεξεργάζεται κάθε παρτίδα ασύγχρονα και εκθέτει την επιτυχία / αποτυχία ανά SKU μόλις ολοκληρωθεί η επεξεργασία (συνήθως εντός 1–15 λεπτών ανάλογα με το βάθος της ουράς επικύρωσης).

Αντιστοίχιση κατηγοριών — το πιο δύσκολο βήμα

Το δέντρο κατηγοριών του Trendyol είναι βαθύ και αυστηρό. Από το 2026 υπάρχουν περίπου 12.000 τελικές κατηγορίες, καθεμία με το δικό της σύνολο υποχρεωτικών και προαιρετικών χαρακτηριστικών. Ένα τζιν που καταχωρείται στο "Ανδρικά → Παντελόνια → Casual" απαιτεί τα χαρακτηριστικά gender, size, color, material και fit-type· ένα smartphone στο "Ηλεκτρονικά → Κινητά → Τηλέφωνα" απαιτεί brand, model, memory, guaranteeType και warrantyPeriod. Η δημοσίευση προϊόντος σε λανθασμένη τελική κατηγορία, ή στη σωστή κατηγορία αλλά με απόν υποχρεωτικό χαρακτηριστικό, παράγει μια σιωπηλή απόρριψη στο αποτέλεσμα της παρτίδας.

Η υποστηριζόμενη προσέγγιση είναι:

1. Αντλήστε το ζωντανό δέντρο κατηγοριών από το GET /sapigw/product-categories (cache για 24 ώρες)
2. Για κάθε τελική κατηγορία, αντλήστε τα υποχρεωτικά + προαιρετικά χαρακτηριστικά από το GET /sapigw/product-categories/{categoryId}/attributes
3. Αντιστοιχίστε τα SKU του master καταλόγου σας στις τελικές κατηγορίες Trendyol — το Zunapro χρησιμοποιεί έναν αντιστοιχιστή ML εκπαιδευμένο σε εκατομμύρια ιστορικές καταχωρίσεις Trendyol για να προτείνει κατηγορίες από τίτλο + μάρκα + την ταξινομία σας με ποσοστό αντιστοίχισης πρώτου περάσματος άνω του 92%
4. Επικυρώστε κάθε SKU έναντι των υποχρεωτικών χαρακτηριστικών πριν καλέσετε το τελικό σημείο POST, για να αποφύγετε τη σπατάλη ορίων ρυθμού σε καταδικασμένα αιτήματα

Λευκή λίστα μάρκας και brandId

Κάθε προϊόν πρέπει να αναφέρεται σε ένα brandId που υπάρχει στο μητρώο μαρκών του Trendyol. Οι νέες μάρκες δεν μπορούν να δημιουργηθούν εν κινήσει — περνούν από μια χειροκίνητη διαδικασία έγκρισης μάρκας μέσω του πίνακα Partner (συνήθως 1–3 εργάσιμες ημέρες). Χρησιμοποιήστε GET /sapigw/brands?name={brandName} για να αναζητήσετε ένα υπάρχον brandId πριν δημιουργήσετε προϊόντα.

Κανόνες μεταφόρτωσης εικόνας

• 1–8 εικόνες ανά προϊόν
• Δημόσια URL HTTPS (το Trendyol κάνει crawl τις εικόνες και τις φιλοξενεί εκ νέου στο CDN του)
• Ελάχιστο 1200×1800 px, λευκό φόντο για κατηγορίες μόδας
• JPG ή PNG, μέγιστο ~10 MB ανά εικόνα
• Η πρώτη εικόνα γίνεται το thumbnail αποτελεσμάτων αναζήτησης — επενδύστε σε αυτήν

Polling κατάστασης παρτίδας

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

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

4. Διαχείριση παραγγελιών — webhooks και η ροή κατάστασης

Ο κύκλος ζωής παραγγελίας του 2026

Μια παραγγελία Trendyol κινείται μέσα από μια σταθερή ροή κατάστασης:

Created → Picking → Invoiced → Shipped → Delivered

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

Κάθε μετάβαση πυροδοτεί τόσο ένα συμβάν webhook (push) όσο και αντικατοπτρίζεται στην επόμενη λήψη GET /orders (poll). Ο πωλητής είναι υπεύθυνος για τη μετάβαση Picking → Invoiced → Shipped· οι συνεργάτες logistics του Trendyol ελέγχουν τη Shipped → Delivered.

Λήψη webhook και ιδεοτονικότητα

Κάθε webhook μεταφέρει ένα μοναδικό shipmentPackageId. Επεξεργαστείτε το idempotent — το Trendyol όντως επαναλαμβάνει συμβάντα σε απόκριση εκτός 200, και η διπλή επεξεργασία από την πλευρά σας (διπλή τιμολόγηση, διπλή συλλογή) είναι πραγματικός κίνδυνος. Το πρακτικό μοτίβο είναι:

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

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

Ροή ακύρωσης και επιστροφής χρημάτων

Οι ακυρώσεις με πρωτοβουλία αγοραστή φτάνουν ως webhook Cancelled· οι ακυρώσεις με πρωτοβουλία πωλητή αποστέλλονται μέσω POST /sapigw/suppliers/{id}/orders/{orderId}/cancel με έναν κωδικό λόγου ακύρωσης (OUT_OF_STOCK, OTHER κ.λπ.). Οι επιστροφές χρημάτων για παραδοθέντα + επιστραφέντα είδη διεκπεραιώνονται αυτόματα από το Trendyol· η μόνη υποχρέωση του πωλητή είναι να επιβεβαιώσει την παραλαβή των επιστραφέντων αγαθών εντός 48 ωρών από τη σάρωση του μεταφορέα.

Ετικέτα αποστολής Trendyol Express

Μόλις ένα δέμα μετακινηθεί στην κατάσταση Picking, ζητήστε την ετικέτα αποστολής μέσω GET /sapigw/suppliers/{id}/orders/{orderId}/labels — το Trendyol επιστρέφει ένα PDF (και προαιρετικά ZPL για θερμικούς εκτυπωτές) που περιέχει τον barcode Trendyol Express, τη διεύθυνση του αγοραστή και τον αριθμό παρακολούθησης cargo. Ο barcode είναι το μοναδικό αντικείμενο δρομολόγησης μεταφορέα — εκτυπώστε, επικολλήστε, σαρώστε στο WMS σας, παραδώστε σε ένα σημείο παραλαβής Trendyol Express (ή προγραμματίστε παραλαβή από courier για πωλητές μεγάλου όγκου).

5. Ενημερώσεις αποθέματος & τιμής σε πραγματικό χρόνο

Το μοτίβο αποστολής αποθέματος-τιμής

Το Trendyol εκθέτει ένα ειδικό τελικό σημείο για ενημερώσεις αποθέματος και τιμής: POST /sapigw/suppliers/{id}/products/price-and-inventory. Κάθε κλήση δέχεται έως 1.000 είδη, με barcode, quantity, salePrice και προαιρετικά listPrice ανά είδος. Οι ενημερώσεις εφαρμόζονται εντός δευτερολέπτων για το απόθεμα, εντός 2–5 λεπτών για την τιμή (το Trendyol αποθηκεύει προσωρινά την τιμή για συνέπεια της τροφοδοσίας αγορών).

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

Η αρχιτεκτονική συγχρονισμού master → local → targets

Για πωλητές που τρέχουν πολλαπλά κανάλια πωλήσεων (Trendyol + Hepsiburada + Çiçeksepeti + δικό τους κατάστημα), η μόνη λογική αρχιτεκτονική είναι ένα master απόθεμα στο Zunapro που αποστέλλει σε κάθε marketplace-στόχο. Η στοίβα παραγωγής Zunapro του 2026 τρέχει ένα cron 15 λεπτών συν αποστολή καθοδηγούμενη από συμβάντα: κάθε αλλαγή αποθέματος στο master πυροδοτεί μια άμεση αποστολή price-and-inventory στο Trendyol, ενώ το cron διασφαλίζει τελική συνέπεια για κάθε αποστολή που ξέφυγε. Τα SKU αντιστοιχίζονται με barcode (πρωτεύον) ή stockCode (εφεδρικό) — ποτέ με το εσωτερικό product ID του Trendyol, το οποίο μπορεί να αλλάξει σε επανα-αντιστοιχίσεις κατηγοριών.

Κανόνες ΦΠΑ και εμφάνισης τιμής

Οι τιμές Trendyol περιλαμβάνουν ΦΠΑ. Το καθεστώς ΦΠΑ (KDV) της Τουρκίας το 2026 είναι 20% κανονικό, 10% μειωμένο (τρόφιμα, βιβλία, φάρμακα, βασικά αγαθά) και 1% ειδικό (βασικά τρόφιμα, ορισμένα γεωργικά προϊόντα). Ο πωλητής καθορίζει το vatRate ανά προϊόν και είναι υπεύθυνος για την επιλογή του σωστού συντελεστή· τα λάθη εμφανίζονται εκ των υστέρων ως απόρριψη ηλεκτρονικού τιμολογίου από το GİB, κάτι που είναι δαπανηρό να διορθωθεί.

Trendyol Fast Sale και συγχρονισμός καμπάνιας

Οι εμβληματικές καμπάνιες του Trendyol — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı (Αγορά Τετάρτης) — είναι καμπάνιες υποχρεωτικής επιλεξιμότητας που ενισχύουν την ορατότητα καταχώρισης αλλά συνεπάγονται επιπλέον προμήθεια καμπάνιας 1–3%. Οι πωλητές εντάσσουν SKU σε καμπάνιες μέσω POST /sapigw/suppliers/{id}/products/campaigns με υπερβάσεις εκπτωτικής τιμής· το Zunapro επικυρώνει αυτόματα τα κατώτατα όρια τιμής καμπάνιας έναντι των κανόνων master περιθωρίου σας για να αποτρέψει δεσμεύσεις κάτω του κόστους.

6. Εναλλακτική XML / CSV — πότε (και πότε όχι) να τη χρησιμοποιήσετε

Το μοντέλο άντλησης XML

Το Trendyol υποστηρίζει ένα μοντέλο τροφοδοσίας XML ως εναλλακτική της ροής REST POST. Ο πωλητής φιλοξενεί ένα αρχείο XML σε μια δημόσια URL HTTPS που περιγράφει τον κατάλογο· το Trendyol το αντλεί με μια διαμορφώσιμη συχνότητα (συνήθως κάθε 1–4 ώρες). Το σχήμα XML δημοσιεύεται στον πίνακα Partner και αντικατοπτρίζει τη μορφή αντικειμένου προϊόντος του τελικού σημείου REST — barcode, title, brandId, categoryId, attributes, images, τιμή, απόθεμα.

Το ίδιο μοτίβο υποστηρίζεται μέσω CSV (μία γραμμή ανά SKU) για πωλητές των οποίων το ERP εξάγει πιο φυσικά CSV παρά XML.

Σύγκριση: REST API vs XML / CSV

Πότε το XML / CSV είναι πραγματικά η σωστή επιλογή

• Παλαιού τύπου ERP χωρίς δυνατότητα HTTP-client που ήδη εξάγει XML / CSV νυχτερινά
• Αργά μεταβαλλόμενοι κατάλογοι (κάτω από 500 SKU, εβδομαδιαίες αλλαγές τιμής, μηνιαίες προσθήκες καταλόγου)
• Αρχική μετεγκατάσταση από άλλο marketplace όπου μια εφάπαξ εξαγωγή CSV επιταχύνει τον πρώτο συγχρονισμό

Για όλα τα άλλα — webhooks παραγγελιών, απόθεμα σε πραγματικό χρόνο, εντάξεις σε καμπάνιες, συγχρονισμός πολλαπλών καναλιών — το REST είναι η μόνη βιώσιμη οδός το 2026. Το Zunapro υποστηρίζει και τους δύο τρόπους αλλά προεπιλέγει το REST και χρησιμοποιεί το XML / CSV αυστηρά ως πηγή ενσωμάτωσης ETL από παλαιού τύπου ERP.

7. Trendyol Express & FBA Trendyol

Trendyol Express — το επίπεδο logistics

Το Trendyol Express είναι το πλήρως ιδιόκτητο τμήμα logistics του Trendyol — ξεκίνησε το 2018 και τώρα λειτουργεί το πυκνότερο δίκτυο δεμάτων native ηλεκτρονικού εμπορίου της Τουρκίας. Έως το 2026 καλύπτει 50.000+ θυρίδες αυτοεξυπηρέτησης και σημεία παραλαβής παράλληλα με τον δικό του στόλο διανομέων, φτάνοντας σε 81 επαρχίες με αυθημερόν παράδοση στην Κωνσταντινούπολη, Άγκυρα, Σμύρνη, Προύσα και Αττάλεια, και παράδοση την επόμενη ημέρα στην υπόλοιπη ηπειρωτική Τουρκία. Οι αγοραστές βλέπουν σήματα "Hızlı Teslimat" (γρήγορη παράδοση) σε επιλέξιμες καταχωρίσεις, και η κατάταξη αναζήτησης του Trendyol τα σταθμίζει επιθετικά.

FBA Trendyol — αποθήκη logistics Trendyol

Το FBA Trendyol (μερικές φορές αποκαλούμενο "Trendyol Lojistik Deposu" ή "Trendyol Mağaza Plus") είναι το ισοδύναμο του Amazon-FBA: οι πωλητές αποστέλλουν απόθεμα στα κέντρα εκτέλεσης του Trendyol στο Çorlu (η εμβληματική εγκατάσταση, 250.000 m² κοντά στην Κωνσταντινούπολη), το Sancaktepe και την Άγκυρα, και το Trendyol χειρίζεται την αποθήκευση, τη συλλογή, τη συσκευασία, την παράδοση last-mile μέσω Trendyol Express και τις επιστροφές. Οι καταχωρίσεις FBA φέρουν ένα διακριτό σήμα "Trendyol'dan Gönderim" και λαμβάνουν προτεραιότητα στάθμισης ορατότητας στην αναζήτηση.

Χρεώσεις και επιλεξιμότητα FBA Trendyol

• Onboarding — υποβάλετε αίτηση μέσω του πίνακα Partner· η εμπορική ομάδα του Trendyol εξετάζει τον μηνιαίο όγκο, τις διαστάσεις SKU και την καταλληλότητα κατηγορίας
• Χρέωση αποθήκευσης — χρεώνεται μηνιαίως ανά κυβικό μέτρο κατειλημμένου χώρου αποθήκης· ποικίλλει ανά εποχή (η αποθήκευση Q4 κοστίζει περισσότερο)
• Χρέωση pick-and-pack — σταθερή χρέωση ανά παραγγελία, ποικίλλει ανά ζώνη βάρους δέματος (κάτω από 500g, 500g–2kg, 2–5kg, 5–10kg, 10kg+)
• Διαχείριση επιστροφών — περιλαμβάνεται στη χρέωση pick-and-pack για τυπικές επιστροφές· οι επισημασμένες συνθήκες χρεώνονται ξεχωριστά

Πότε έχει νόημα το FBA Trendyol

Το σημείο εξισορρόπησης για το FBA Trendyol έναντι της αυτο-εκτέλεσης είναι περίπου 800–1.200 μονάδες ανά μήνα ανά SKU αποθήκης για ταχέως κινούμενα αναλώσιμα, ηλεκτρονικά ή μόδα σε σειρές μεγεθών. Κάτω από αυτό, η αυτο-εκτέλεση μέσω παράδοσης Trendyol Express συν το δικό σας συμβόλαιο Aras / Yurtiçi / DHL είναι συνήθως φθηνότερη. Πάνω από αυτό, η αύξηση μετατροπών από το σήμα "Trendyol'dan Gönderim" συν την υπόσχεση αυθημερόν παράδοσης σχεδόν πάντα υπερτερεί του κόστους εκτέλεσης ανά μονάδα.

8. Ενσωμάτωση ηλεκτρονικού τιμολογίου GİB (e-Fatura / e-Arşiv)

Η εντολή GİB

Η Gelir İdaresi Başkanlığı (GİB — Διοίκηση Εσόδων) της Τουρκίας έχει καταστήσει το e-Fatura υποχρεωτικό για κάθε επιχείρηση με ετήσιο κύκλο εργασιών πάνω από το κατώφλι που δημοσιεύει το GİB (αναθεωρείται ετησίως· ~TRY 3M από το 2026) και το e-Arşiv Fatura υποχρεωτικό για όλα τα τιμολόγια B2C πάνω από ~TRY 30.000 (αναθεωρείται ετησίως). Για τους ενεργούς πωλητές Trendyol το 2026, η κάλυψη e-Fatura / e-Arşiv είναι ουσιαστικά καθολική — σχεδόν κάθε παραγγελία marketplace πρέπει να παράγει ένα ηλεκτρονικό τιμολόγιο σφραγισμένο από το GİB εντός του παραθύρου κατάστασης παραγγελίας, αλλιώς επιβάλλονται κυρώσεις.

Οι πέντε πιστοποιημένοι από το GİB ενσωματωτές

Οι πωλητές μπορούν είτε να χρησιμοποιήσουν απευθείας την πύλη του GİB (μη πρακτικό σε όγκους marketplace) είτε να συνάψουν συμβόλαιο με έναν πιστοποιημένο από το GİB Özel Entegratör (Ειδικός Ενσωματωτής). Οι πέντε κυρίαρχοι παίκτες το 2026 είναι:

• Logo Yazılım — ο μεγαλύτερος τουρκικός προμηθευτής ERP· e-Logo για έκδοση τιμολογίων
• Mikro Yazılım — προμηθευτής ERP και ηλεκτρονικού τιμολογίου μεσαίας αγοράς, ισχυρός στο τμήμα ΜΜΕ
• Uyumsoft — ανεξάρτητος ενσωματωτής με ένα ανθεκτικό REST API και τη μεγαλύτερη βάση πωλητών marketplace
• Foriba — προμηθευτής enterprise-tier (εξαγοράστηκε από τη Sovos το 2019), ισχυρός σε ρυθμιζόμενες βιομηχανίες
• Veriban — ταχέως αναπτυσσόμενη εναλλακτική με ανταγωνιστικές τιμές και ένα φιλικό προς προγραμματιστές API

Η ροή ηλεκτρονικού τιμολογίου marketplace

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

Πρακτική επιλογή 2026

Για νέους πωλητές, το Uyumsoft και το Veriban είναι τα ευκολότερα στο onboarding (εγγραφή web, REST API, χωρίς εξάρτηση on-prem). Οι πωλητές που ήδη τρέχουν Logo ή Mikro ERP θα πρέπει να παραμείνουν στο προϊόν ηλεκτρονικού τιμολογίου του ίδιου προμηθευτή για λογιστική συμφωνία. Το Foriba είναι η επιλογή για μεγάλες επιχειρήσεις με σύνθετες φορολογικές ροές εργασίας. Το Zunapro διατίθεται με όλες τις πέντε ενσωματώσεις πίσω από μία οθόνη διαμόρφωσης — επιλέξτε τον ενσωματωτή, επικολλήστε τα διαπιστευτήρια API, και κάθε παραγγελία Trendyol τιμολογείται αυτόματα.

9. Συνήθη σφάλματα και πώς να σχεδιάσετε γύρω από αυτά

Αναντιστοιχία κατηγορίας

Σύμπτωμα: το αποτέλεσμα παρτίδας δείχνει INVALID_CATEGORY ή CATEGORY_NOT_LEAF. Αιτία: δημοσίευση σε μη τελική κατηγορία, ή σε τελική κατηγορία της οποίας το σύνολο χαρακτηριστικών δεν ταιριάζει με το SKU. Διόρθωση: δημοσιεύετε πάντα μόνο σε τελικές κατηγορίες (το API απορρίπτει τις μη τελικές) και προεπικυρώστε τα χαρακτηριστικά έναντι του συνόλου required: true της κατηγορίας πριν από το POST.

Απόντα υποχρεωτικά χαρακτηριστικά

Σύμπτωμα: MANDATORY_ATTRIBUTE_MISSING σε κατά τα άλλα έγκυρα SKU. Αιτία: το Trendyol επισημαίνει ~30% των χαρακτηριστικών ως υποχρεωτικά σε βάση ανά κατηγορία (φύλο για μόδα, εγγύηση για ηλεκτρονικά κ.λπ.). Διόρθωση: αποθηκεύστε προσωρινά τον χάρτη απαιτήσεων χαρακτηριστικών ανά κατηγορία και ελέγξτε τα POST ως προς την πληρότητα· το Zunapro συμπληρώνει αυτόματα από την master ταξινομία σας όπου είναι δυνατόν.

Καθυστερήσεις συγχρονισμού αποθέματος

Σύμπτωμα: ένα εξαντλημένο SKU εξακολουθεί να εμφανίζεται διαθέσιμο στο Trendyol για αρκετά λεπτά, προκαλώντας υπερπωλήσεις. Αιτία: οι αποστολές price-and-inventory είναι τελικά συνεπείς με διάμεση καθυστέρηση ~5–8 δευτερολέπτων, και κατά τις αιχμές κίνησης (Black Friday, Trendyol Week) η ουρά μπορεί να φτάσει τα 30–60 δευτερόλεπτα. Διόρθωση: υλοποιήστε ένα τοπικό buffer ασφαλείας (κρατήστε τις τελευταίες 1–2 μονάδες ως buffer εκτός αποθέματος ανά SKU υψηλής ταχύτητας) και αποστείλετε τις αλλαγές αποθέματος σύγχρονα στο συμβάν επιβεβαίωσης παραγγελίας, όχι μόνο στο cron.

Χαμένα webhooks

Σύμπτωμα: ένα webhook παραγγελίας δεν φτάνει ποτέ ή φτάνει με ώρες καθυστέρηση. Αιτία: συνήθως μια αλλαγή τείχους προστασίας από την πλευρά του πωλητή, μια ανανέωση πιστοποιητικού TLS που έσπασε το URL webhook, ή μια σύντομη διακοπή που ξεπέρασε τον προϋπολογισμό 5 επαναλήψεων του Trendyol. Διόρθωση: εκτελείτε πάντα μια παράλληλη λήψη συμφωνίας κάθε 5 λεπτά στο /sapigw/suppliers/{id}/orders?status=Created&startDate=...· το Zunapro το κάνει από προεπιλογή και συγχωνεύει idempotent κάθε αντληθείσα παραγγελία που το webhook επίσης παρέδωσε.

Πολλαπλές καταχωρίσεις, ίδιος barcode (Mükerrer Listing)

Σύμπτωμα: ένα μοναδικό SKU εμφανίζεται ως πολλαπλές καταχωρίσεις Trendyol, και το απόθεμα μειώνεται διαφορετικά σε καθεμία. Αιτία: ιστορικές συγχωνεύσεις, διπλές καταχωρίσεις barcode, ή fan-out πολλαπλών καταστημάτων του ίδιου προϊόντος. Διόρθωση: η πολιτική αφαίρεσης διπλότυπων MIN-αποθέματος του Zunapro (που εισήχθη στην ενημέρωση παραγωγής μας 2026-06-06) συμπτύσσει όλες τις διπλές καταχωρίσεις κάτω από έναν barcode και παρακολουθεί την ελάχιστη τιμή αποθέματος μεταξύ τους, αποτρέποντας την κλασική καταστροφή "πουλήθηκε δύο φορές σε δύο καταχωρίσεις, υποσχέθηκε μία παράδοση".

10. Προμήθεια Trendyol και χρεώσεις πωλητή 2026

Το πρόγραμμα προμηθειών του Trendyol για το 2026 είναι κλιμακωτό ανά κατηγορία, με τρεις ευρείες ζώνες και καμία σταθερή χρέωση ανά τεμάχιο. Η συμμετοχή σε καμπάνιες (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) προσθέτει ένα επιπλέον 1–3% πάνω από το ποσοστό κατηγορίας.

Χρεώσεις πωλητή / συνδρομής

Το Trendyol δεν χρεώνει μηνιαία συνδρομή. Δεν υπάρχει βαθμίδα "Professional Seller" τύπου Amazon. Οι πωλητές πληρώνουν:

• Προμήθεια κατηγορίας σε κάθε πώληση (8–22%)
• Προμήθεια καμπάνιας κατά τη συμμετοχή σε Trendyol Fast Sale / Week (+1–3%)
• Trendyol Express χρέωση ανά αποστολή (πληρώνεται από τον αγοραστή, αλλά ρέει μέσα από το P&L του πωλητή)
• FBA Trendyol αποθήκευση + pick-and-pack (μόνο εάν είναι εγγεγραμμένος)
• Trendyol Ads CPC (προαιρετικό, ελεγχόμενο από τον πωλητή)

Κύκλος πληρωμών

Οι τυπικοί πωλητές πληρώνονται σε κύκλο T+14 (14 ημέρες μετά την παράδοση παραγγελίας), μειωμένο σε T+7 για πωλητές με βαθμολογία πωλητή κορυφαίας βαθμίδας. Οι αμφισβητούμενες παραγγελίες, οι επιστροφές εντός του παραθύρου 14 ημερών και τα chargeback κρατούνται έναντι της πληρωμής. Οι πληρωμές καταλήγουν στο καταχωρημένο TR IBAN.

Τουρκικό νομικό πλαίσιο 2026 — τι πρέπει να γνωρίζουν οι πωλητές marketplace

KDV (ΦΠΑ) και ζώνες συντελεστή KDV

Ο ΦΠΑ της Τουρκίας — KDV (Katma Değer Vergisi) — έχει τρεις συντελεστές το 2026: 20% κανονικός, 10% μειωμένος (τρόφιμα, βιβλία, φάρμακα, εστίαση), 1% ειδικός (βασικά τρόφιμα, γεωργικά). Οι πωλητές marketplace με έδρα στην Τουρκία εγγράφονται για KDV μέσω της τοπικής εφορίας τους· οι διασυνοριακοί πωλητές πάνω από το κατώφλι ψηφιακών υπηρεσιών χρησιμοποιούν το καθεστώς KDV μη κατοίκων. Το πεδίο vatRate σε κάθε POST προϊόντος Trendyol πρέπει να ταιριάζει με τον νομικά σωστό συντελεστή — τα λάθη διαδίδονται στα ηλεκτρονικά τιμολόγια και μπορεί να απαιτήσουν διορθωτικές δηλώσεις.

e-Fatura / e-Arşiv (υποχρεωτικό GİB)

Έχει ήδη καλυφθεί λεπτομερώς στην ενότητα 8. Το συμπέρασμα για το 2026: κάθε παραγγελία marketplace παράγει ένα ηλεκτρονικό τιμολόγιο σφραγισμένο από το GİB (e-Fatura για B2B / εγγεγραμμένους παραλήπτες e-Fatura, e-Arşiv για B2C). Ο πωλητής είναι υπεύθυνος για την έκδοση εντός του παραθύρου κατάστασης παραγγελίας. Η χειροκίνητη έκδοση είναι μη πρακτική σε όγκους marketplace — επιλέξτε έναν από τους πέντε ενσωματωτές GİB και αυτοματοποιήστε.

KVKK — τουρκικός GDPR

Ο KVKK (Kişisel Verilerin Korunması Kanunu — Νόμος αρ. 6698) είναι το καθεστώς προστασίας δεδομένων της Τουρκίας, δομικά παρόμοιο με τον GDPR και επιβαλλόμενο από την KVKK Kurumu. Τα marketplace χειρίζονται τη συναίνεση και την επεξεργασία από την πλευρά του αγοραστή, αλλά οι πωλητές παραμένουν από κοινού υπεύθυνοι επεξεργασίας για κάθε άμεση επικοινωνία εξυπηρέτησης πελατών, μάρκετινγκ ή επικοινωνία μετά την αγορά. Οι κυρώσεις για μη συμμόρφωση κυμαίνονται από TRY 60K έως TRY 3M+ ανάλογα με την κλάση της παράβασης.

ETBİS — υποχρεωτικό μητρώο ηλεκτρονικού εμπορίου

Το ETBİS (Elektronik Ticaret Bilgi Sistemi) είναι το υποχρεωτικό μητρώο του Υπουργείου Εμπορίου για κάθε φορέα ηλεκτρονικού εμπορίου στην Τουρκία, σε ισχύ από το 2018. Οι πωλητές πρέπει να εγγραφούν πριν κάνουν καταχωρίσεις στο Trendyol και να αναφέρουν ετήσιους όγκους συναλλαγών. Τα δεδομένα ETBİS τροφοδοτούν την επιβολή προστασίας καταναλωτή, τον έλεγχο κατά της απάτης και τα analytics ανταγωνισμού.

Προστασία καταναλωτή — υπαναχώρηση 14 ημερών, εγγύηση 2 ετών

• Δικαίωμα υπαναχώρησης 14 ημερών — οι Τούρκοι καταναλωτές μπορούν να επιστρέψουν κάθε προϊόν που αγοράστηκε εξ αποστάσεως εντός 14 ημερών, χωρίς λόγο (Tüketicinin Korunması Hakkında Kanun, Νόμος αρ. 6502)
• Νόμιμη εγγύηση 2 ετών — υποχρεωτική στις πωλήσεις B2C, ανεξάρτητη από κάθε εγγύηση κατασκευαστή
• Υποχρεωτική πληροφόρηση προϊόντος στην τουρκική γλώσσα — τίτλος, περιγραφή, εγγύηση, πολιτική επιστροφών όλα στα τουρκικά

Logistics & αποστολή στην Τουρκία — Trendyol Express πρώτα

Trendyol Express — το κυρίαρχο επίπεδο

Το Trendyol Express είναι ο προεπιλεγμένος μεταφορέας σε περίπου 70%+ των παραγγελιών Trendyol το 2026. Ο αγοραστής βλέπει δωρεάν ή χαμηλού κόστους αποστολή με αυθημερόν ή επόμενης ημέρας παράδοση στις μεγάλες μητροπόλεις, συν 50.000+ θυρίδες αυτοεξυπηρέτησης (Trendyol Hızlı Teslimat Noktaları) όπου οι αγοραστές παραλαμβάνουν δέματα 24/7. Οι πωλητές είτε παραδίδουν δέματα σε ένα σημείο συλλογής Trendyol Express είτε προγραμματίζουν παραλαβή από courier· το δελτίο δρομολόγησης φέρει τον barcode Trendyol Express που λαμβάνεται από το API ετικέτας παραγγελίας.

Οι άλλοι ενσωματωμένοι μεταφορείς

• Yurtiçi Kargo — μακροχρόνια εδραιωμένος τουρκικός courier, ισχυρό δίκτυο B2C και B2B, ενσωματωμένος για παραγγελίες Trendyol
• Aras Kargo — ανταγωνιστής με ισχυρή κάλυψη Ανατολίας, συχνά χρησιμοποιείται για αυτο-εκτελούμενες παραγγελίες Trendyol
• DHL Kargo — τρίτος μεγάλος τουρκικός courier, συνήθης εφεδρεία για πωλητές μεγάλου όγκου
• PTT Kargo — κρατικός ταχυδρομικός φορέας, ευρύτερη αγροτική εμβέλεια, βραδύτερα SLA
• Sürat Kargo — περιφερειακός παίκτης, ανταγωνιστικός στις περιοχές Μαρμαρά και Αιγαίου

Πρακτική στοίβα αποστολής 2026

Η πρακτική στοίβα του 2026 για έναν πωλητή Trendyol: Trendyol Express ως προεπιλογή (είναι αυτό που περιμένουν οι αγοραστές), Yurtiçi ή Aras ως εφεδρεία από την πλευρά του πωλητή για αυτο-εκτελούμενες παραγγελίες που χάνουν το παράθυρο παραλαβής Trendyol Express, PTT Kargo για αποκλειστικά αγροτικούς ταχυδρομικούς κώδικες όπου κανένας άλλος μεταφορέας δεν είναι οικονομικός, και FBA Trendyol για ταχέως κινούμενα SKU μόλις ο όγκος δικαιολογήσει τη δέσμευση αποθήκευσης.

Πώς να ξεκινήσετε να πουλάτε στο Trendyol — onboarding 5 βημάτων

1. Λογαριασμός πωλητή Trendyol

Υποβάλετε αίτηση στο partner.trendyol.com. Παρέχετε VKN, Trade Registry Gazette, δείγμα υπογραφής, απόδειξη εγγραφής ETBİS και TR IBAN. Έγκριση σε 2–5 εργάσιμες ημέρες.

2. ETBİS + φορολογική εγγραφή

Εγγράψτε τη νομική οντότητα στο ETBİS μέσω της πύλης του Υπουργείου Εμπορίου (etbis.gtb.gov.tr) και επιβεβαιώστε την εγγραφή KDV στην τοπική εφορία. Οι ξένοι πωλητές που λειτουργούν μέσω Trendyol International είτε διορίζουν έναν Τούρκο εκπρόσωπο είτε χρησιμοποιούν το πρόγραμμα εισαγωγής ως καταχωρημένος εισαγωγέας του Trendyol.

3. Δημιουργήστε API Key + Secret

Από τον πίνακα Partner → Ρυθμίσεις λογαριασμού → Πληροφορίες ενσωμάτωσης, κάντε κλικ στο "Create API Key". Αντιγράψτε το API Key (40 χαρακτήρες) και το API Secret (40 χαρακτήρες) αμέσως — εμφανίζονται μόνο μία φορά. Επικολλήστε τα στο πλακίδιο Trendyol του Zunapro όπου αποθηκεύονται κρυπτογραφημένα με AES-256 και αποκρυμμένα.

4. Σύνδεση μέσω του πίνακα Zunapro

1. Συνδεθείτε στο Zunapro και ανοίξτε τη μονάδα Τουρκίας
2. Επικολλήστε Supplier ID + API Key + API Secret στο πλακίδιο ενσωμάτωσης Trendyol
3. Εκτελέστε τον αυτόματο έλεγχο υγείας (διαπιστευτήρια, τελικό σημείο addresses, πληροφορίες προμηθευτή)
4. Επιβεβαιώστε τις προτεινόμενες από ML αντιστοιχίσεις κατηγοριών για τα κορυφαία 100 SKU σας
5. Επιλέξτε τον ενσωματωτή ηλεκτρονικού τιμολογίου σας (Logo, Mikro, Uyumsoft, Foriba ή Veriban) και επικολλήστε αυτά τα διαπιστευτήρια
6. Ενεργοποιήστε "Trendyol Express" + "FBA Trendyol" (εάν είστε εγγεγραμμένος)

5. Εκτελέστε μια δοκιμαστική παραγγελία

Τοποθετήστε 3–5 παραγγελίες stage στο stageapi.trendyol.com για να ασκήσετε τις ροές pick-pack, εκτύπωσης ετικέτας, μετάβασης κατάστασης και επιστροφής χρημάτων από άκρο σε άκρο. Μόλις όλα είναι πράσινα, μεταφέρετε την ενσωμάτωση στην παραγωγή με ένα κουμπί. Ο πρώτος συγχρονισμός παραγωγής ενός καταλόγου 5.000 SKU ολοκληρώνεται σε περίπου 30–60 λεπτά δεδομένων των ορίων ρυθμού του Trendyol.

Οι τρεις οδοί ενσωμάτωσης Trendyol — σε σύγκριση

Πριν δεσμευτείτε σε μια αρχιτεκτονική ενσωμάτωσης, βοηθά να συγκρίνετε τις τρεις νόμιμες οδούς δίπλα-δίπλα.

Συχνές ερωτήσεις ενσωμάτωσης Trendyol 2026