Οδηγός ενσωμάτωσης Hepsiburada 2026: REST API, HepsiJet & κεντρική διαχείριση πωλητών

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

REST στο mpop.hepsiburada.com

Το API πωλητή της Hepsiburada είναι μια καθαρή υπηρεσία REST/JSON που φιλοξενείται κάτω από τον host-ομπρέλα mpop.hepsiburada.com (mpop = «Merchant Platform Open API»). Δεν υπάρχει παραλλαγή GraphQL ή gRPC. Όλη η επικυρωμένη κίνηση γίνεται μέσω HTTPS, συνδεδεμένη με ένα Merchant ID που εκδίδεται κατά το onboarding HMS. Η επιφάνεια του API χωρίζεται σε λογικά υπο-domain αντί για μία μονολιθική ρίζα:

• listing-external.hepsiburada.com — CRUD καταχωρίσεων (τιμή, απόθεμα, κατάσταση καταχώρισης)
• mpop.hepsiburada.com/product/api/products — δημιουργία προϊόντος και χαρακτηριστικά κατηγορίας
• oms-external.hepsiburada.com — διαχείριση παραγγελιών (παραγγελίες, δέματα, αποστολές)
• returns-external.hepsiburada.com — επιστροφές και επιστροφές χρημάτων
• integration.hepsiburada.com/finance — μεταφόρτωση τιμολογίων και οικονομική συμφωνία

Κάθε υπο-domain μοιράζεται το ίδιο σχήμα ελέγχου ταυτότητας HTTP Basic αλλά εκθέτει τα δικά του όρια ρυθμού και συμβάσεις σελιδοποίησης. Ο σύνδεσμος HB του Zunapro αφαιρεί αυτή τη διασπορά πίσω από μια ενιαία κανονικοποιημένη διεπαφή.

Έλεγχος ταυτότητας: HTTP Basic μέσω HTTPS

Σε αντίθεση με το ελαφρώς πιο επιτρεπτικό API του Trendyol ή τη ροή OAuth του SP-API του Amazon, η Hepsiburada χρησιμοποιεί ένα σκόπιμα απλό σχήμα ελέγχου ταυτότητας HTTP Basic: η κεφαλίδα Authorization μεταφέρει Basic base64(username:password), όπου το username είναι το κλειδί API σας και το password το ζευγαρωμένο μυστικό. Κάθε αίτημα πρέπει επίσης να φέρει μια κεφαλίδα User-Agent που περιλαμβάνει το Merchant ID σας. Οι ελλείπουσες ή κακοσχηματισμένες τιμές User-Agent είναι η πιο συνηθισμένη αιτία 401 Unauthorized στην παραγωγή.

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

HMS — Το πάνελ Hepsiburada Marketplace Service

Το πάνελ HMS στο merchant.hepsiburada.com είναι η λειτουργική διαδικτυακή κονσόλα σε αντιστοιχία με το API. Κάθε δυνατότητα του API έχει ένα ισοδύναμο HMS — επεξεργασία καταχωρίσεων, αποδοχή παραγγελίας, έκδοση επιστροφής χρημάτων, οικονομική συμφωνία — και το HMS είναι το μόνο μέρος όπου παρέχετε κλειδιά API, ρυθμίζετε διευθύνσεις παραλαβής HepsiJet και διαχειρίζεστε δικαιώματα χρηστών. Ο επανασχεδιασμός HMS 2024–2026 έφερε ενοποιημένη αριστερή πλοήγηση, αναφορές διακανονισμού σε πραγματικό χρόνο και έναν νέο πίνακα «API Health» που εμφανίζει τα ποσοστά 4xx/5xx ανά endpoint, κάτι ανεκτίμητο κατά τον εντοπισμό σφαλμάτων μιας ενσωμάτωσης.

Όρια ρυθμού και ιδεμποτεντικότητα

Η Hepsiburada εφαρμόζει γενναιόδωρα αλλά επιβαλλόμενα όρια ρυθμού — τυπικά ~30 αιτήματα/δευτερόλεπτο ανά έμπορο στις ενημερώσεις καταχωρίσεων και χαμηλότερα (~10/δ) στα endpoint παραγγελιών. Οι μαζικές εισαγωγές προϊόντων περιορίζονται ξεχωριστά και επιστρέφουν 202 Accepted με ένα trackingId· στη συνέχεια κάνετε polling στο /import/{trackingId} για ολοκλήρωση. Το API παραγγελιών υποστηρίζει ιδεμποτεντικότητα μέσω των αναγνωριστικών δέματος και παραγγελίας που παραμένουν σταθερά μεταξύ αναγνώσεων.

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

Προϋποθέσεις: Λογαριασμός HMS & ETBİS

Πριν από οποιαδήποτε κλήση API, μια επιχείρηση εγγεγραμμένη στην Τουρκία με vergi numarası (αριθμό φορολογικού μητρώου), εγγραφή ETBİS (Elektronik Ticaret Bilgi Sistemi — το μητρώο επιχειρήσεων ηλεκτρονικού εμπορίου του Υπουργείου Εμπορίου) και ένα τουρκικό IBAN (TR…) πρέπει να κάνει onboarding μέσω HMS. Ο έλεγχος KYC συνήθως ολοκληρώνεται εντός 1–3 εργάσιμων ημερών για οντότητες εγγεγραμμένες στο ETBİS· οι μη-ETBİS πωλητές δρομολογούνται σε ουρά χειροκίνητης εξέτασης που μπορεί να πάρει 1–2 εβδομάδες.

Onboarding API βήμα προς βήμα

1. Δημιουργήστε λογαριασμό HMS στο merchant.hepsiburada.com με το vergi numarası και το IBAN σας. Ανεβάστε το πιστοποιητικό ETBİS, το δείγμα υπογραφής και το φορολογικό σας έγγραφο.
2. Δημιουργήστε διαπιστευτήρια API στο Hesabım → Entegrasyon Bilgileri → API Anahtarı. Το σύστημα επιστρέφει ένα username, password και το σταθερό Merchant ID σας. Αποθηκεύστε τα μυστικά σε vault — η Hepsiburada δεν θα εμφανίσει ξανά το password.
3. Προσθέστε εξερχόμενες IP στη λίστα επιτρεπόμενων αν η πλατφόρμα ενσωμάτωσής σας το απαιτεί. Το Zunapro δημοσιεύει ένα σταθερό εύρος εξερχόμενων IP ώστε οι πωλητές να το καρφιτσώσουν στη λίστα επιτρεπόμενων του HMS.
4. Δοκιμή smoke με μια ανάγνωση καταχώρισης — καλέστε το GET /listings/merchantid/{MERCHANT_ID} και επιβεβαιώστε ένα 200 OK με το υπάρχον απόθεμά σας.
5. Εγγραφείτε σε webhooks για συμβάντα παραγγελιών: POST /webhook-subscriptions με το callback URL σας και τους τύπους συμβάντων (order.created, order.cancelled, return.created).
6. Στείλτε το πρώτο σας προϊόν χρησιμοποιώντας το POST /product/api/products/import — η Hepsiburada επιστρέφει ένα trackingId· κάντε polling μέχρι status:DONE.
7. Ζωντανά — αλλάξτε την ενσωμάτωση σε «Aktif» στο HMS μόλις περάσουν οι δοκιμές smoke.

Κεφαλίδες και συνήθεις παγίδες

Η πιο συχνή παλινδρόμηση ενσωμάτωσης είναι μια ελλείπουσα ή κακοσχηματισμένη User-Agent. Η Hepsiburada απαιτεί αυστηρά τη μορφή {MERCHANT_ID} - {AppName}· ένα προεπιλεγμένο axios/1.6 ή okhttp/4 User-Agent επιστρέφει 401 Unauthorized χωρίς περιγραφικό σώμα. Ορίζετε πάντα το User-Agent ρητά και καταγράφετέ το στο middleware αιτημάτων σας.

3. Συγχρονισμός προϊόντων — Δέντρο κατηγοριών, χαρακτηριστικά, παραλλαγές

Το δέντρο κατηγοριών

Ο κατάλογος της Hepsiburada είναι οργανωμένος ως αυστηρό δέντρο κατηγοριών τριών έως πέντε επιπέδων που εκτίθεται μέσω του GET /product/api/categories/get-all-categories. Κάθε προϊόν πρέπει να αντιστοιχίζεται σε ένα ID κατηγορίας επιπέδου φύλλου· οι ενδιάμεσοι κόμβοι απορρίπτονται με VALIDATION_ERROR. Η αναθεώρηση κατηγοριών του 2024 συγχώνευσε αρκετούς παλαιούς κόμβους (τα ξεχωριστά καταχωρημένα «Bluetooth Kulaklık» και «Kablosuz Kulaklık» συγχωνεύτηκαν σε «Kablosuz Kulaklık & Bluetooth»), οπότε κάθε ενσωμάτωση παλαιότερη από αυτό χρειάζεται ανανέωση αντιστοίχισης κατηγοριών.

Τα υποχρεωτικά χαρακτηριστικά μπλοκάρουν την έγκριση

Κάθε κατηγορία εκθέτει μια λίστα υποχρεωτικών και προαιρετικών χαρακτηριστικών μέσω του GET /product/api/categories/{categoryId}/attributes. Σε αντίθεση με το Trendyol, η Hepsiburada αντιμετωπίζει τα ελλείποντα υποχρεωτικά χαρακτηριστικά ως σκληρό μπλοκάρισμα καταχώρισης — το προϊόν εισέρχεται σε κατάσταση WAITING_FOR_APPROVAL και δεν φτάνει ποτέ στο «Active» μέχρι να συμπληρωθεί κάθε απαιτούμενο χαρακτηριστικό με έγκυρη τιμή αναζήτησης. Συνήθεις παραβάτες:

• Μάρκα — πρέπει να ταιριάζει ακριβώς με το μητρώο μαρκών της Hepsiburada· το «Apple» και το «APPLE» είναι διαφορετικά ID
• Χρώμα, μέγεθος, χωρητικότητα — αντλούνται από ελεγχόμενα λεξιλόγια, όχι ελεύθερο κείμενο
• Περίοδος εγγύησης — απαιτείται για ηλεκτρονικά, εκφρασμένη σε μήνες ως enum
• Χώρα προέλευσης (Menşei) — απαιτείται για καλλυντικά, τρόφιμα, συμπληρώματα

Παραλλαγές: Διαχωρισμός listing & product

Η Hepsiburada χρησιμοποιεί έναν αυστηρότερο διαχωρισμό product vs listing από τους περισσότερους ανταγωνιστές. Ένα μόνο product (HB-SKU, εσωτερικό αναγνωριστικό) μπορεί να έχει πολλά listings (merchantSku) — ένα ανά πωλητή, με τη δική του τιμή, απόθεμα, κατάσταση (καινούριο/ανακαινισμένο) και εγγύηση. Για προϊόντα παραλλαγών (π.χ. μπλουζάκι σε S/M/L × Κόκκινο/Μπλε/Μαύρο), κάθε συνδυασμός είναι ξεχωριστός κόμβος product, προαιρετικά ομαδοποιημένος κάτω από ένα varyantGroupID ώστε η σελίδα προϊόντος να εμφανίζει δείγματα χρώματος και μεγέθους.

Μαζική εισαγωγή μέσω trackingId

Οι μεταφορτώσεις καταλόγου παραγωγής χρησιμοποιούν το POST /product/api/products/import με έναν πίνακα έως 100 προϊόντων ανά αίτημα. Το API επιστρέφει ένα trackingId· οι ενσωματωτές πρέπει να κάνουν polling στο GET /product/api/products/import/{trackingId} μέχρι η κατάσταση να είναι DONE και στη συνέχεια να διατρέξουν τα αποτελέσματα ανά γραμμή για σφάλματα επικύρωσης. Το Zunapro ομαδοποιεί τις εισαγωγές σε τμήματα 100 γραμμών, επαναλαμβάνει τις ήπιες αποτυχίες και εμφανίζει αναφορές σφαλμάτων σε επίπεδο γραμμής μέσα στο πάνελ πωλητή.

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. Διαχείριση παραγγελιών — Webhooks, ροή κατάστασης, ετικέτες

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

Μια παραγγελία Hepsiburada κινείται μέσα από μια σταθερή μηχανή καταστάσεων που κάθε ενσωμάτωση πρέπει να υλοποιεί. Οι καταστάσεις έχουν σημασία — οι πρόωρες μεταβάσεις προκαλούν πόντους ποινής στη βαθμολογία πωλητή σας:

• Open — η παραγγελία παρελήφθη, αναμένει αποδοχή (SLA 24 ωρών στις περισσότερες κατηγορίες, 48ω σε έπιπλα)
• InProgress / Picking — ο πωλητής αναγνώρισε, picking και συσκευασία
• Packaged — το δέμα δημιουργήθηκε μέσω API, αναμένει παράδοση στον μεταφορέα
• Shipped — ο μεταφορέας σάρωσε το δέμα· ο αριθμός παρακολούθησης ενεργός
• Delivered — η τελευταία μίλια επιβεβαίωσε την παράδοση
• Cancelled / Returned — πύλη επιστροφών που ξεκίνησε ο πελάτης ή ο έμπορος

Webhook vs polling

Η Hepsiburada υποστηρίζει τόσο webhooks (προτιμώμενα) όσο και polling. Τα webhooks ρυθμίζονται ανά Merchant ID στο HMS ή μέσω POST /webhook-subscriptions· η πλατφόρμα ωθεί συμβάντα JSON στο HTTPS endpoint σας με υπογραφές HMAC στην κεφαλίδα X-HB-Signature. Το polling επιστρέφει στο GET /orders?status=Open&offset=0&limit=100 σε ένα cron 30–60 δευτερολέπτων. Το Zunapro προεπιλέγει webhooks με έναν συμφιλιωτή polling 5 λεπτών που πιάνει τυχόν χαμένα συμβάντα — ένα μοτίβο ζώνης-και-τιράντας που κρατά την πληρότητα παραγγελιών πάνω από 99,99%.

Ετικέτες αποστολής: Αυτόματη δημιουργία HepsiJet

Όταν σημαίνετε μια παραγγελία ως Packaged με επιλεγμένο HepsiJet, το API δημιουργεί αυτόματα μια εκτυπώσιμη ετικέτα αποστολής PDF και επιστρέφει ένα URL λήψης συν έναν αριθμό παρακολούθησης. Δεν υπάρχει ξεχωριστό αίτημα ετικέτας — η ετικέτα συνοδεύει την απόκριση δημιουργίας δέματος:

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

Η πύλη επιστροφών

Οι επιστροφές ξεκινούν από τον πελάτη μέσω της τυπικής πύλης επιστροφών της Hepsiburada (Iade Talepleri) και εμφανίζονται στους πωλητές μέσω του GET /returns?status=Open. Οι πωλητές έχουν 3 εργάσιμες ημέρες για να εγκρίνουν ή να αμφισβητήσουν την επιστροφή· η αυτόματη έγκριση ενεργοποιείται μετά από αυτό. Οι εγκεκριμένες επιστροφές προκαλούν επιστροφή χρημάτων μέσω της γραμμής πληρωμών της Hepsiburada (την οποία ο πωλητής θα δει στον επόμενο οικονομικό διακανονισμό), και το απόθεμα θα πρέπει να πιστωθεί εκ νέου μέσω PUT /listings/{merchantSku}/stock.

5. Συγχρονισμός αποθέματος & τιμής — Πραγματικός χρόνος, Buy Box, repricer

Το endpoint αποθέματος

Το απόθεμα ενημερώνεται μέσω του API καταχωρίσεων με ένα payload που γνωρίζει το delta:

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

Το endpoint δέχεται τιμή και απόθεμα στην ίδια κλήση, αλλά η εσωτερική cache της Hepsiburada μπορεί να χρειαστεί 30–90 δευτερόλεπτα για να διαδοθεί στο κατάστημα. Οι μαζικές ενημερώσεις χρησιμοποιούν το POST /listings/import με το ίδιο μοτίβο trackingId όπως η εισαγωγή προϊόντων.

Πραγματικός χρόνος vs συγχρονισμός cron

Οι πωλητές επιπέδου παραγωγής χρησιμοποιούν συγχρονισμό οδηγούμενο από συμβάντα (κάθε αλλαγή αποθέματος στο ERP σας πυροδοτεί ένα PUT στη Hepsiburada μέσα σε δευτερόλεπτα) αντί για ένα cron 15 λεπτών. Ο κίνδυνος του συγχρονισμού μόνο-cron είναι η υπερπώληση κατά τις περιόδους flash (Ramazan kampanyası, Black Friday, Efsane Cuma). Το υβριδικό μοντέλο του Zunapro πυροδοτεί άμεσα PUT και έναν συμφιλιωτή 15 λεπτών σε περίπτωση απώλειας συμβάντων — το ίδιο μοτίβο που τεκμηριώνεται στην αρχιτεκτονική αυτόματου συγχρονισμού τιμής & αποθέματος master→local→targets.

Κατακτώντας το Buy Box

Το Buy Box της Hepsiburada (η προεπιλεγμένη προσφορά «Sepete Ekle» σε μια κοινή σελίδα προϊόντος) απονέμεται από έναν σταθμισμένο τύπο που συνδυάζει:

• Τιμή — ανταγωνιστική εντός 1–2% της χαμηλότερης έγκυρης προσφοράς
• Υγεία αποθέματος — βάθος, φρεσκάδα, καμία πρόσφατη εξάντληση
• Υπόσχεση παράδοσης — το HepsiJet κερδίζει με τα υπόλοιπα ίσα
• Αξιολόγηση πωλητή — ελάχιστο 9,0+ σε KPI παράδοσης και εξυπηρέτησης
• Ποσοστό ελαττωματικών παραγγελιών — ακυρώσεις, καθυστερημένες αποστολές, επιστροφές τιμωρούνται

Ένας καλά ρυθμισμένος repricer που επαναξιολογεί τις τιμές ανταγωνιστών κάθε 5–10 λεπτά τυπικά αυξάνει το μερίδιο Buy Box κατά 15–30% σε αμφισβητούμενα SKU.

6. HepsiJet — Ιδιόκτητο δίκτυο ταχυμεταφορών

Η κάθετα ενσωματωμένη τελευταία μίλια της Hepsiburada

Το HepsiJet είναι το ιδιόκτητο δίκτυο ταχυμεταφορών τελευταίας μίλιας της Hepsiburada, που ξεκίνησε το 2017 για να σπάσει την εξάρτηση από Yurtiçi και Aras Kargo σε SKU κρίσιμα ως προς τον χρόνο. Έως το 2026 το HepsiJet λειτουργεί 1.500+ σημεία παραλαβής σε 81 επαρχίες, εκτελεί αυθημερόν παράδοση σε Κωνσταντινούπολη, Άγκυρα και Σμύρνη, και χρησιμοποιεί τον δικό του στόλο άνω των 2.500 οχημάτων συν ένα δίκτυο από franchisee shubeleri.

Πρότυπο barcode και μορφή ετικέτας

Κάθε ετικέτα αποστολής HepsiJet φέρει ένα barcode Code-128 που κωδικοποιεί έναν αριθμό παρακολούθησης 12 χαρακτήρων με πρόθεμα HJ (για παράδειγμα HJ73219840TR). Η ετικέτα PDF που δημιουργείται από το API χρησιμοποιεί διάταξη A6 κατάλληλη για θερμικούς εκτυπωτές· οι ετικέτες μπορούν να εκτυπωθούν απευθείας μέσω της ενσωματωμένης ουράς ZPL.

Αυθημερόν & Yarın Kapında

Το HepsiJet προσφέρει δύο premium επίπεδα παράδοσης ορατά στη σελίδα προϊόντος:

• «Yarın Kapında» — παράδοση την επόμενη μέρα σε 81 επαρχίες όταν η παραγγελία αποστέλλεται πριν τις 14:00 τοπική ώρα
• «Bugün Kapında» — αυθημερόν παράδοση σε Κωνσταντινούπολη, Άγκυρα, Σμύρνη, Μπούρσα, Άδανα για παραγγελίες πριν τις 11:00

Και τα δύο σήματα αυξάνουν ουσιαστικά τη μετατροπή — τα δικά της δεδομένα της Hepsiburada δείχνουν αύξηση μετατροπής 15–25% στις καταχωρίσεις που φέρουν τα σήματα, κάτι περίπου ισοδύναμο με το αποτέλεσμα «Hızlı Teslimat» του Trendyol.

Παραλαβή vs Şubeye Bırak

Οι πωλητές επιλέγουν μεταξύ παραλαβής HepsiJet (ο μεταφορέας παραλαμβάνει από την αποθήκη, χρεώνεται ανά δέμα) και Şubeye Bırak (ο πωλητής αφήνει τα δέματα στο πλησιέστερο υποκατάστημα HepsiJet, φθηνότερο ανά δέμα αλλά βαρύτερο λειτουργικά). Το API ενσωμάτωσης υποστηρίζει και τα δύο — η απόκριση δέματος περιλαμβάνει ένα πεδίο pickupAddressId που καθορίζει τη δρομολόγηση.

7. HepsiLojistik — Το μοντέλο FBA

Τι είναι το HepsiLojistik

Το HepsiLojistik είναι η υπηρεσία fulfillment-by-marketplace της Hepsiburada — το τουρκικό ανάλογο του Amazon FBA, του Trendyol TFC και του Allegro One Fulfillment. Οι πωλητές στέλνουν απόθεμα μαζικά στα κέντρα fulfillment της Hepsiburada· η Hepsiburada αναλαμβάνει αποθήκευση, picking, συσκευασία, παράδοση τελευταίας μίλιας (μέσω HepsiJet) και επιστροφές. Οι παραγγελίες HepsiLojistik φέρουν ένα ξεχωριστό σήμα «Hepsiburada Garanti» και δικαιούνται την υψηλότερη στάθμιση ορατότητας στον τύπο του Buy Box.

Το δίκτυο κέντρων fulfillment

• Gebze (Kocaeli) — ναυαρχίδα κέντρο fulfillment, ~150.000 m², εξυπηρετεί Κωνσταντινούπολη + Μαρμαρά
• Çorlu (Tekirdağ) — προστέθηκε το 2023, εστιασμένο σε Δυτική Τουρκία + διασυνοριακά Βαλκάνια
• Kemalpaşa (Izmir) — κάλυψη Αιγαίου, άνοιξε το 2024 για Νοτιοδυτική Τουρκία
• Ankara (Polatlı) — κόμβος κεντρικής Ανατολίας, βελτιστοποιημένος για παράδοση στην περιοχή της πρωτεύουσας

Η δομή χρεώσεων

Η τιμολόγηση HepsiLojistik δημοσιεύεται ως χρέωση fulfillment ανά μονάδα συν μηνιαία αποθήκευση:

• Χρέωση fulfillment ανά μονάδα — τυπικά ₺25–₺75 ανάλογα με τη ζώνη βάρους και την κατηγορία
• Μηνιαία αποθήκευση — χρεώνεται ανά m³ ανά μήνα, κλιμακωτά κατά ταχύτητα (τα SKU μακράς ουράς πληρώνουν περισσότερα)
• Εισερχόμενη αποστολή — ο πωλητής πληρώνει την εισερχόμενη προς το κέντρο fulfillment
• Διαχείριση επιστροφών — περιλαμβάνεται στη χρέωση fulfillment για επιστροφές εντός πολιτικής

Αίτηση & onboarding

Το HepsiLojistik δεν είναι ανοιχτό από προεπιλογή. Οι πωλητές υποβάλλουν αίτηση μέσω HMS → Lojistik Hizmetleri → HepsiLojistik Başvuru, παρέχοντας 6 μήνες ιστορικού πωλήσεων και μια λίστα στόχων SKU. Η Hepsiburada δίνει προτεραιότητα σε πωλητές άνω των ~500 μηνιαίων παραγγελιών με προβλέψιμα μοτίβα ζήτησης· οι πωλητές χαμηλότερου όγκου συνήθως παραμένουν στο αυτόνομο μοντέλο παραλαβής HepsiJet.

8. Ενσωμάτωση e-Τιμολογίου (e-Fatura) — GİB & ERP

Το GİB e-Fatura είναι υποχρεωτικό

Το GİB της Τουρκίας (Gelir İdaresi Başkanlığı — Διοίκηση Εσόδων) απαιτεί e-Fatura (δομημένα τιμολόγια XML που υποβάλλονται στην πύλη GİB) για όλες τις εταιρείες άνω του ετήσιου ορίου τζίρου (επί του παρόντος ~₺3M, μειωμένο για πωλητές ηλεκτρονικού εμπορίου βάσει των τροποποιήσεων του 2026). Κάτω από το όριο, ισχύει το e-Arşiv Fatura — εξίσου ηλεκτρονικό, ελαφρώς πιο ελαφρύ στην υπογραφή. Οι παραγγελίες marketplace δεν εξαιρούνται: κάθε παραγγελία marketplace B2C και B2B απαιτεί ηλεκτρονικό τιμολόγιο που εκδίδεται εντός 7 ημερών από το συμβάν αποστολής.

Το endpoint τιμολογίου της Hepsiburada

Η Hepsiburada εκθέτει ένα οικονομικό endpoint για μεταφορτώσεις τιμολογίων — οι πωλητές (ή οι ενσωματωτές e-Fatura τους) ωθούν το GİB UUID και την απόδοση PDF του εκδοθέντος τιμολογίου, το οποίο στη συνέχεια εμφανίζεται στον πελάτη μέσω του τυπικού συνδέσμου «Faturayı İndir» στη σελίδα παραγγελίας:

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

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

Συμβατοί πάροχοι ERP & e-Fatura

Οι περισσότεροι Τούρκοι πωλητές εκδίδουν το υποκείμενο τιμολόγιο μέσω του ERP / e-Fatura entegratör τους και διοχετεύουν το αποτέλεσμα στη Hepsiburada. Το Zunapro παρέχει εγγενείς συνδέσμους για:

• Logo Tiger 3 / Logo Wings — το πιο ευρέως εγκατεστημένο ERP της Τουρκίας
• Mikro Yazılım — ισχυρό στο λιανικό εμπόριο ΜΜΕ
• Netsis (SAP partner) — για εταιρικούς πωλητές
• Foriba, Uyumsoft, Digital Planet, izibiz — καθαρόαιμοι ενσωματωτές GİB e-Fatura

Το στρώμα KVKK

Τα προσωπικά δεδομένα πελατών (PII) που ρέουν μέσω της ροής τιμολόγησης διέπονται από τον τουρκικό KVKK (Kişisel Verilerin Korunması Kanunu — Νόμος για την Προστασία Προσωπικών Δεδομένων), το ισοδύναμο με GDPR τοπικό κανονισμό που επιβάλλεται από την KVKK Kurumu (Αρχή Προστασίας Δεδομένων). Οι πωλητές είναι από κοινού υπεύθυνοι επεξεργασίας των PII πλευράς παραγγελίας και πρέπει να καταχωρούν τις δραστηριότητες επεξεργασίας στο VERBİS όπου εφαρμόζεται.

9. Συνήθη σφάλματα και λύσεις

Κορυφαία σφάλματα παραγωγής

HTTP / Κωδικός	Σύμπτωμα	Βασική αιτία	Διόρθωση
401 Unauthorized	Όλα τα αιτήματα απορρίπτονται	Ελλείπουσα ή κακοσχηματισμένη κεφαλίδα User-Agent	Ορίστε το User-Agent: {MERCHANT_ID} - {AppName} ρητά
403 Forbidden	Συγκεκριμένο endpoint μπλοκαρισμένο	Το κλειδί API δεν έχει scope· ο έμπορος δεν είναι εγκεκριμένος για το module	Επανεκδώστε το κλειδί στο HMS με πλήρη scope, επικοινωνήστε με το Merchant Support
VALIDATION_ERROR	Το προϊόν κόλλησε στο WAITING_FOR_APPROVAL	Υποχρεωτικό χαρακτηριστικό κατηγορίας ελλείπει ή μη έγκυρη τιμή αναζήτησης	Ανακτήστε το /categories/{id}/attributes, συμπληρώστε τα απαιτούμενα πεδία με έγκυρες τιμές enum
BRAND_NOT_FOUND	Η εισαγωγή προϊόντος απορρίφθηκε	Η συμβολοσειρά μάρκας δεν ταιριάζει ακριβώς με το μητρώο μαρκών HB	Αναζητήστε το /brands?name=..., χρησιμοποιήστε το επιστρεφόμενο ID, ζητήστε δημιουργία μάρκας αν λείπει
429 Too Many Requests	Η κίνηση burst περιορίστηκε	Ξεπεράσατε τα ~30 αιτ/δ σε καταχωρίσεις ή ~10/δ σε παραγγελίες	Υλοποιήστε εκθετική υποχώρηση με υποστήριξη κεφαλίδας Retry-After
STOCK_UPDATE_DELAY	Το κατάστημα δείχνει παλιό απόθεμα για 30–90δ	Καθυστέρηση διάδοσης cache, όχι σφάλμα	Μειώστε προληπτικά το απόθεμα σε κίνδυνο υπερπώλησης· συμφιλιώστε μετά την καθυστέρηση
HEPSIJET_PICKUP_FAIL	Το δέμα δημιουργήθηκε αλλά δεν έγινε παραλαβή από μεταφορέα	Λάθος pickupAddressId ή διεύθυνση εκτός κάλυψης HepsiJet	Επαληθεύστε τη διεύθυνση παραλαβής στο HMS, καταφύγετε σε Yurtiçi/Aras για εξαιρούμενους ΤΚ
INVOICE_UPLOAD_REJECTED	Η μεταφόρτωση e-Fatura επιστρέφει 400	Μη έγκυρη μορφή UUID ή αλλοίωση PDF base64	Επικυρώστε τη μορφή UUID v4, επανακωδικοποιήστε το PDF, δοκιμάστε ξανά με ιδεμποτεντικό αριθμό τιμολογίου

Ροή διαγνωστικού

Όταν μια ενσωμάτωση Hepsiburada αρχίζει να συμπεριφέρεται περίεργα, η διαγνωστική σειρά που ακολουθεί το Zunapro είναι:

1. Ελέγξτε τον πίνακα HMS → API Health για ποσοστά σφαλμάτων σε επίπεδο endpoint
2. Επικυρώστε το User-Agent και τα διαπιστευτήρια Basic-auth με μια δοκιμή smoke curl
3. Επιθεωρήστε την κεφαλίδα X-Request-Id από μια αποτυχημένη απόκριση — το Merchant Support της Hepsiburada την απαιτεί για να εντοπίσει ένα ticket
4. Συγκρίνετε με το changelog του developers.hepsiburada.com για πρόσφατες αλλαγές σχήματος

10. Προμήθεια Hepsiburada 2026 — 8% έως 22%

Το πρόγραμμα προμηθειών της Hepsiburada για το 2026 είναι κλιμακωμένο ανά κατηγορία, δημοσιεύεται τριμηνιαία στο HMS στο Hesabım → Komisyon Oranları και χωρίζεται σε τρεις ευρείες ζώνες συν μερικές ακραίες κατηγορίες (χρυσός, αυτοκίνητα, μεγάλες οικιακές συσκευές).

Σύγκριση προμηθειών 2026 — Hepsiburada vs Trendyol vs Amazon TR

Marketplace	Χαμηλή βαθμίδα	Μεσαία βαθμίδα	Υψηλή βαθμίδα	Συνδρομή / Άλλο
Hepsiburada	8% – 12%	12% – 17%	15% – 22%	Δωρεάν λογαριασμός · HepsiAd προαιρετικό · χρεώσεις HepsiLojistik αν χρησιμοποιηθεί
Trendyol	9% – 13%	13% – 18%	16% – 24%	Δωρεάν λογαριασμός · χρεώσεις TFC αν χρησιμοποιηθεί · Trendyol Ads προαιρετικό
Amazon TR	5% – 12%	12% – 17%	15% – 22%	Professional Seller ~₺99 / μήνα · χρεώσεις FBA αν χρησιμοποιηθεί
n11	6% – 10%	10% – 15%	13% – 18%	Δωρεάν λογαριασμός · βαθμίδα συνδρομής n11 Pro προαιρετική
Çiçeksepeti	10% – 14%	14% – 18%	16% – 22%	Δωρεάν λογαριασμός · εξειδίκευση σε αυθημερόν λουλούδια/δώρα

Ανάγνωση του πίνακα: Η Hepsiburada είναι περίπου στο ίδιο επίπεδο με το Amazon TR και ελαφρώς φθηνότερη από το Trendyol σε όλες τις ζώνες. Ο διαφοροποιητικός παράγοντας δεν είναι η προμήθεια αλλά τα logistics — η ιδιόκτητη τελευταία μίλια του HepsiJet δίνει στη Hepsiburada δομικό πλεονέκτημα στις υποσχέσεις παράδοσης στις μεγάλες μητροπόλεις, ενώ η μεγαλύτερη βάση χρηστών του Trendyol αντισταθμίζει τις ελαφρώς υψηλότερες χρεώσεις του.

Τουρκικό νομικό πλαίσιο 2026 — ΦΠΑ, e-Fatura, KVKK, ETBİS

Συντελεστές ΦΠΑ (KDV) 2026

Ο ΦΠΑ της Τουρκίας — KDV (Katma Değer Vergisi) — χρησιμοποιεί τρεις θεσμοθετημένους συντελεστές το 2026:

• 20% κανονικός συντελεστής — τα περισσότερα καταναλωτικά αγαθά, ηλεκτρονικά, μόδα, σπίτι & διαβίωση
• 10% μειωμένος συντελεστής — βασικά τρόφιμα, κλωστοϋφαντουργικά ορισμένων κατηγοριών, βιβλία, φιλοξενία
• 1% υπερμειωμένος — βασικά τρόφιμα (ψωμί, γάλα, αυγά), γεωργικές εισροές, ορισμένα ιατρικά

Οι πωλητές marketplace εγγράφονται για KDV μέσω της περιφερειακής Vergi Dairesi (εφορίας)· οι διασυνοριακοί πωλητές μπορούν να χρησιμοποιήσουν το πρόσφατα διευρυμένο ειδικό καθεστώς ΦΠΑ της Τουρκίας για το ηλεκτρονικό εμπόριο μετά το 2024.

e-Fatura & e-Arşiv — Εντολή GİB

• e-Fatura — δομημένα τιμολόγια XML που υποβάλλονται στο GİB, υποχρεωτικά άνω του ετήσιου ορίου τζίρου και για όλους τους πωλητές ηλεκτρονικού εμπορίου βάσει των τροποποιήσεων του 2026
• e-Arşiv Fatura — εξίσου ηλεκτρονικό αλλά ελαφρύτερο· για B2C κάτω από το όριο e-Fatura
• Παράθυρο έκδοσης 7 ημερών — κάθε παραγγελία marketplace απαιτεί ηλεκτρονικό τιμολόγιο εντός 7 ημερών από την αποστολή
• e-İrsaliye, e-Müstahsil, e-Smm — συνοδευτικά έγγραφα για ροές logistics, γεωργικές και ελεύθερων επαγγελματιών

KVKK — Το ισοδύναμο GDPR της Τουρκίας

Ο KVKK (Kişisel Verilerin Korunması Kanunu), σε ισχύ από το 2016 και ενισχυμένος το 2024 σε ευθυγράμμιση με το GDPR, ρυθμίζει την επεξεργασία προσωπικών δεδομένων. Οι πωλητές marketplace είναι από κοινού υπεύθυνοι επεξεργασίας για τα PII πλευράς παραγγελίας (όνομα, διεύθυνση, τηλέφωνο, IBAN όπου σχετίζεται) και πρέπει:

• Να εγγραφούν στο VERBİS (Veri Sorumluları Sicil Bilgi Sistemi) αν είναι άνω των ορίων
• Να διατηρούν μια γραπτή πολιτική απορρήτου (Aydınlatma Metni) προσβάσιμη στους πελάτες
• Να τηρούν τα δικαιώματα των υποκειμένων δεδομένων (πρόσβαση, διόρθωση, διαγραφή) εντός 30 ημερών
• Να αναφέρουν παραβιάσεις στην KVKK Kurumu εντός 72 ωρών

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

Το ETBİS (Elektronik Ticaret Bilgi Sistemi), που διαχειρίζεται το Υπουργείο Εμπορίου (Ticaret Bakanlığı), είναι το υποχρεωτικό μητρώο για κάθε επιχείρηση ηλεκτρονικού εμπορίου που λειτουργεί στην Τουρκία. Η εγγραφή είναι δωρεάν και online· ο αριθμός ETBİS πρέπει να εμφανίζεται στα προφίλ πωλητή marketplace και στα footer των ιδιόκτητων καταστημάτων. Ο έλεγχος KYC της Hepsiburada ελέγχει αυτόματα το ETBİS κατά το onboarding.

Logistics & αποστολή — HepsiJet πρώτα, Yurtiçi/Aras εφεδρικά

Η προεπιλογή: HepsiJet

Το HepsiJet είναι ο προεπιλεγμένος μεταφορέας για τις παραγγελίες Hepsiburada και ο μόνος που ενεργοποιεί αυτόματα τα σήματα «Yarın Kapında» / «Bugün Kapında». Για τους περισσότερους πωλητές στις μεγάλες μητροπόλεις, η δρομολόγηση του 80–100% του όγκου μέσω HepsiJet είναι η σωστή επιλογή.

Ενσωματωμένοι μεταφορείς τρίτων

Η Hepsiburada ενσωματώνεται επίσης με τους καθιερωμένους εθνικούς μεταφορείς της Τουρκίας, με τις ετικέτες αποστολής να δημιουργούνται μέσω του ίδιου endpoint δημιουργίας δέματος απλώς αλλάζοντας την τιμή cargoCompany:

• Yurtiçi Kargo — πυκνότερη αγροτική κάλυψη, ισχυρή σε ΤΚ Ανατολικής Ανατολίας που εξαιρεί το HepsiJet
• Aras Kargo — ανταγωνιστικά B2B SLA, δημοφιλή για έπιπλα και ογκώδη αγαθά
• DHL Kargo — ευέλικτα αυθημερόν παράθυρα σε επιλεγμένους διαδρόμους
• PTT Kargo — κρατικός ταχυδρομικός φορέας, αγροτική εμβέλεια, βραδύτερα SLA
• UPS Türkiye / DHL — διεθνείς διασυνοριακές γραμμές

Λογική δρομολόγησης στο Zunapro

Ο δρομολογητής logistics του Zunapro αξιολογεί κάθε παραγγελία έναντι ενός διαμορφώσιμου πίνακα — βάρος, ΤΚ προορισμού, δηλωμένη αξία, κλάση SKU — και επιλέγει HepsiJet από προεπιλογή, καταφεύγοντας σε Yurtiçi για εξαιρούμενους ΤΚ και σε Aras για δέματα άνω των 30 kg. Ο επιλεγμένος μεταφορέας ωθείται μέσω του ίδιου endpoint δέματος της Hepsiburada, ώστε ο πελάτης να βλέπει μια ενιαία εμπειρία παρακολούθησης.

Πώς να ξεκινήσετε να πουλάτε στη Hepsiburada — 2026 βήμα προς βήμα

Η εκκίνηση 5 βημάτων

1. Εγγραφείτε στο ETBİS & HMS — ανοίξτε το ETBİS record σας μέσω etbis.ticaret.gov.tr, στη συνέχεια κάντε onboarding στο merchant.hepsiburada.com με vergi numarası, IBAN και δείγμα υπογραφής. Το KYC ολοκληρώνεται σε 1–3 εργάσιμες ημέρες.
2. Δημιουργήστε διαπιστευτήρια API — Hesabım → Entegrasyon Bilgileri → API Anahtarı. Αποθηκεύστε username/password στο vault σας· σημειώστε το Merchant ID για τις κεφαλίδες User-Agent.
3. Συνδέστε το e-Fatura — επιλέξτε τον GİB integrator σας (Logo, Mikro, Foriba, izibiz) και επιβεβαιώστε ότι το endpoint μεταφόρτωσης τιμολογίων της Hepsiburada είναι προσβάσιμο. Δοκιμάστε με μία παραγγελία B2C.
4. Επιλέξτε το stack logistics σας — παραλαβή HepsiJet vs Şubeye Bırak, συν εφεδρικό Yurtiçi/Aras για εξαιρούμενους ΤΚ. Προετοιμάστε ετικέτες και υλικά συσκευασίας.
5. Συνδεθείτε μέσω Zunapro (10 λεπτά) — επικολλήστε τα διαπιστευτήρια API στο πλακίδιο Hepsiburada, αντιστοιχίστε τον master κατάλογό σας, ενεργοποιήστε τις αυτόματες ετικέτες HepsiJet και το e-Fatura, ανοίξτε τον διακόπτη ζωντανά.

Η ροή σύνδεσης Zunapro

1. Συνδεθείτε στο Zunapro και ανοίξτε το module Τουρκίας
2. Κάντε κλικ στο «Σύνδεση Hepsiburada» — επικολλήστε το username API, το password και το Merchant ID
3. Αυτόματη αντιστοίχιση κατηγοριών — το ML του Zunapro προτείνει αντιστοιχίσεις κατηγορίας-φύλλου για κάθε master SKU· επιβεβαιώστε με λίγα κλικ
4. Ενεργοποιήστε τις αυτόματες ετικέτες HepsiJet + e-Fatura — ένας διακόπτης το καθένα
5. Ζωντανά — ο πρώτος συγχρονισμός καταχωρίσεων ενός καταλόγου 1.000 SKU ολοκληρώνεται σε περίπου 10 λεπτά· τα webhooks εγγράφονται αυτόματα

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