Guide d'intégration Trendyol 2026 : API REST, connexion XML & gestion centralisée des boutiques

1. Architecture de l'API Trendyol 2026

L'API Marketplace de Trendyol est une interface RESTful, JSON-sur-HTTPS, publiée sur une unique URL de base de production — https://api.trendyol.com — avec un environnement stage séparé sur https://stageapi.trendyol.com. Chaque appel d'API est authentifié via l'authentification HTTP Basic Auth : l'en-tête Authorization transporte une paire ApiKey:ApiSecret encodée en base64, et le Supplier ID est passé en paramètre de chemin sur chaque endpoint associé à un fournisseur. Il n'y a pas d'échange de jeton d'accès séparé pour les vendeurs en propre — le Basic Auth est vérifié à chaque requête — ce qui garde l'intégration simple mais signifie que des identifiants divulgués doivent être renouvelés immédiatement via le panneau Partner.

URL de base, authentification, en-têtes

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

L'en-tête User-Agent n'est pas cosmétique : le lissage de trafic et la comptabilité de rate-limit de Trendyol s'appuient dessus. Les intégrateurs (comme Zunapro) envoient {supplierId} - Zunapro ; les vendeurs en propre envoient {supplierId} - SelfIntegration. Des en-têtes User-Agent mal renseignés peuvent déclencher des réponses 401/403 même avec des identifiants valides.

Limites de débit et quotas

Trendyol applique des limites de débit par endpoint et par fournisseur. Les plafonds publiés pour 2026 sont :

• Endpoints produit — généralement 60 requêtes/minute par Supplier ID, avec une tolérance de rafale jusqu'à 90/min pendant 30 secondes
• Endpoints commande — généralement 600 requêtes/minute (les commandes sont un endpoint à fort trafic et faible latence par conception)
• Endpoints de mise à jour prix & stock — généralement 100 requêtes/minute, chaque requête pouvant transporter jusqu'à 1 000 SKU dans un seul lot
• Consultations de catégories & attributs — généralement 30 requêtes/minute (elles changent lentement, une mise en cache agressive est donc attendue)

Chaque réponse inclut les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et, sur les 429, Retry-After. Une intégration bien conçue utilise une file d'attente à jetons (token-bucket) par Supplier ID et applique une contre-pression sur les 429 avec un back-off exponentiel ; Zunapro le met en place par défaut afin que même les poussées en masse de plusieurs milliers de SKU ne dépassent jamais les limites.

OAuth 2.0 pour les intégrateurs indépendants

Pour les intégrateurs indépendants en couche intermédiaire (Zunapro et plateformes SaaS similaires agissant au nom de nombreux fournisseurs), Trendyol propose un flux OAuth 2.0 de type authorization-code plutôt que du Basic Auth direct. L'intégrateur enregistre un client_id / client_secret auprès de l'équipe des relations développeurs de Trendyol, le fournisseur autorise l'intégrateur depuis le panneau Partner, et l'intégrateur reçoit un jeton d'accès valable 1 heure plus un refresh token pour le renouvellement. Cela évite d'avoir à manipuler l'ApiKey / ApiSecret brut du fournisseur et constitue la voie propice à l'audit pour les clients d'entreprise gérant de nombreuses boutiques Trendyol.

Webhooks

Trendyol pousse les événements du cycle de vie de la commande vers l'URL de votre webhook enregistré : Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. La charge utile du webhook est une enveloppe JSON transportant l'ID de commande et le nouveau statut ; votre endpoint doit répondre par un HTTP 200 en moins de 3 secondes. En cas d'échec, Trendyol relance 5 fois avec un back-off exponentiel, puis met l'événement de côté — c'est pourquoi une récupération de réconciliation toutes les 5 minutes contre /sapigw/suppliers/{id}/orders est un filet de sécurité non optionnel.

2. Connexion via l'API REST — étape par étape

Le parcours officiel idéal pour se connecter à l'API REST de Trendyol en 2026 est court et bien documenté — mais l'ordre des opérations compte, car certains prérequis légaux se situent en amont de l'API elle-même.

2.1 Ouvrir un compte vendeur Trendyol

Rendez-vous sur partner.trendyol.com et soumettez une demande « Ouvrir un compte Trendyol ». Vous aurez besoin de :

• VKN (Vergi Kimlik Numarası) — numéro fiscal turc (ou immatriculation d'entreprise équivalente à l'étranger pour Trendyol International)
• Journal du registre du commerce (Ticaret Sicil Gazetesi) pour les sociétés à responsabilité limitée ou par actions
• Circulaire de signature (imza sirküleri)
• Reçu d'enregistrement ETBİS (Elektronik Ticaret Bilgi Sistemi) — obligatoire pour tout opérateur e-commerce turc depuis 2018
• Compte bancaire (IBAN TR) au nom de l'entité juridique pour les versements de la marketplace

L'approbation prend généralement 2 à 5 jours ouvrés. Une fois approuvé, le vendeur reçoit un Supplier ID et un accès au panneau Partner de Trendyol.

2.2 Générer la clé API et le secret

Depuis le panneau Partner, ouvrez Paramètres du compte → Informations d'intégration et cliquez sur « Créer une clé API ». Trendyol génère une clé API de 40 caractères et un secret API de 40 caractères. Les deux valeurs ne sont affichées qu'une seule fois — elles ne peuvent pas être récupérées ultérieurement. Enregistrez-les dans un gestionnaire de mots de passe ou, mieux, collez-les directement dans la tuile d'intégration de Zunapro qui les conserve sous forme de secrets masqués, chiffrés en AES-256.

2.3 Première requête de test (smoke-test)

Confirmez que les identifiants sont actifs en interrogeant l'endpoint d'informations fournisseur :

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"

Une réponse réussie renvoie les adresses d'entrepôt et de retour enregistrées du fournisseur en JSON. Un 401 signifie que l'en-tête Basic Auth est erroné ; un 403 signifie que le Supplier ID ne correspond pas aux identifiants ; un 404 signifie que le chemin de l'endpoint est mal formé.

2.4 Variante OAuth (pour les intégrateurs multi-fournisseurs)

Pour les intégrateurs indépendants, le flux OAuth 2.0 ressemble à ceci :

1. L'intégrateur redirige le fournisseur vers :
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. Le fournisseur approuve l'accès ; Trendyol redirige en retour avec ?code={authCode}

3. L'intégrateur échange le code contre des jetons :
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

4. Réponse : { access_token, refresh_token, expires_in: 3600 }

Les jetons d'accès sont valables 1 heure et renouvelables pendant 30 jours. Zunapro gère les quatre étapes de façon transparente, si bien que le fournisseur ne voit qu'un unique bouton « Se connecter à Trendyol ».

2.5 Publier votre premier produit

Utilisez POST /sapigw/suppliers/{supplierId}/v2/products avec un tableau JSON d'articles. L'objet produit minimal requiert barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (généralement TRY), listPrice, salePrice, vatRate, cargoCompanyId, un tableau images (1 à 8 URL) et un tableau attributes d'ID d'attributs propres à la catégorie.

3. Synchronisation des produits à grande échelle

Import en masse — 1 000 SKU par lot

L'endpoint POST /v2/products de Trendyol accepte jusqu'à 1 000 SKU par requête JSON. Pour les vendeurs disposant de catalogues de plus de 10 000 SKU, c'est la différence entre un onboarding d'une heure et un onboarding de plusieurs jours. Le lot renvoie un batchRequestId par appel ; Trendyol traite chaque lot de façon asynchrone et expose le succès / échec par SKU une fois le traitement terminé (généralement en 1 à 15 minutes selon la profondeur de la file de validation).

Mappage des catégories — l'étape la plus difficile

L'arborescence de catégories de Trendyol est profonde et stricte. En 2026, il existe environ 12 000 catégories feuilles, chacune avec son propre ensemble d'attributs obligatoires et optionnels. Un jean listé sous « Homme → Pantalons → Décontracté » requiert les attributs gender, size, color, material et fit-type ; un smartphone sous « Électronique → Mobile → Téléphones » requiert brand, model, memory, guaranteeType et warrantyPeriod. Publier un produit dans une mauvaise catégorie feuille, ou dans la bonne catégorie mais en omettant un attribut obligatoire, produit un rejet silencieux dans le résultat du lot.

L'approche recommandée est :

1. Récupérer l'arborescence de catégories en direct depuis GET /sapigw/product-categories (mise en cache 24 h)
2. Pour chaque catégorie feuille, récupérer les attributs obligatoires + optionnels depuis GET /sapigw/product-categories/{categoryId}/attributes
3. Faire correspondre les SKU de votre catalogue maître aux catégories feuilles Trendyol — Zunapro utilise un mappeur ML entraîné sur des millions d'annonces Trendyol historiques pour suggérer les catégories à partir du titre + de la marque + de votre taxonomie, avec un taux de correspondance au premier essai supérieur à 92 %
4. Valider chaque SKU par rapport aux attributs obligatoires avant d'appeler l'endpoint POST, afin d'éviter de gaspiller du rate-limit sur des requêtes vouées à l'échec

Liste blanche des marques et brandId

Chaque produit doit référencer un brandId qui existe dans le registre des marques de Trendyol. Les nouvelles marques ne peuvent pas être créées à la volée — elles passent par un processus manuel d'approbation de marque via le panneau Partner (généralement 1 à 3 jours ouvrés). Utilisez GET /sapigw/brands?name={brandName} pour rechercher un brandId existant avant de créer des produits.

Règles d'upload des images

• 1 à 8 images par produit
• URL HTTPS publiques (Trendyol explore et ré-héberge les images sur son CDN)
• Minimum 1200×1800 px, fond blanc pour les catégories mode
• JPG ou PNG, max ~10 Mo par image
• La première image devient la vignette dans les résultats de recherche — soignez-la

Interrogation du statut du lot

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. Gestion des commandes — webhooks et flux de statut

Le cycle de vie de la commande 2026

Une commande Trendyol suit un flux de statuts fixe :

Created → Picking → Invoiced → Shipped → Delivered

Flux dérivés :
  Cancelled (à tout moment avant Shipped)
  Returned (après Delivered, dans la fenêtre de 14 jours)
  UnDelivered (exception transporteur)

Chaque transition déclenche à la fois un événement webhook (push) et se reflète dans la prochaine récupération GET /orders (poll). Le vendeur est responsable des transitions Picking → Invoiced → Shipped ; les partenaires logistiques de Trendyol contrôlent Shipped → Delivered.

Réception des webhooks et idempotence

Chaque webhook transporte un shipmentPackageId unique. Traitez-le de façon idempotente — Trendyol relance bien les événements sur une réponse non-200, et un double traitement de votre côté (double facturation, double préparation) est un risque réel. Le schéma pragmatique est :

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

Handler :
1. Acquérir un verrou sur shipmentPackageId
2. Vérifier le statut stocké ; s'il est déjà >= "Picking", renvoyer 200 (no-op)
3. Persister le nouveau statut, planifier les actions en aval (facture électronique, tâche de préparation)
4. Renvoyer un HTTP 200 en moins de 3 secondes

Flux d'annulation et de remboursement

Les annulations à l'initiative de l'acheteur arrivent sous forme de webhooks Cancelled ; les annulations à l'initiative du vendeur sont poussées via POST /sapigw/suppliers/{id}/orders/{orderId}/cancel avec un code de motif d'annulation (OUT_OF_STOCK, OTHER, etc.). Les remboursements pour les articles livrés + retournés sont gérés automatiquement par Trendyol ; la seule obligation du vendeur est de confirmer la réception des marchandises retournées dans les 48 heures suivant le scan du transporteur.

Étiquette d'expédition Trendyol Express

Une fois qu'un colis est passé au statut Picking, demandez l'étiquette d'expédition via GET /sapigw/suppliers/{id}/orders/{orderId}/labels — Trendyol renvoie un PDF (et optionnellement du ZPL pour les imprimantes thermiques) contenant le code-barres Trendyol Express, l'adresse de l'acheteur et le numéro de suivi du colis. Le code-barres est l'unique artefact de routage transporteur — imprimez-le, apposez-le, scannez-le dans votre WMS, déposez-le à un point de collecte Trendyol Express (ou planifiez un enlèvement par coursier pour les vendeurs à fort volume).

5. Mises à jour de stock & prix en temps réel

Le schéma de poussée stock-prix

Trendyol expose un endpoint dédié aux mises à jour de stock et de prix : POST /sapigw/suppliers/{id}/products/price-and-inventory. Chaque appel accepte jusqu'à 1 000 articles, avec barcode, quantity, salePrice et, en option, listPrice par article. Les mises à jour s'appliquent en quelques secondes pour le stock, et en 2 à 5 minutes pour le prix (Trendyol met le prix en cache pour la cohérence du flux d'achat).

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

L'architecture de synchronisation Maître → Local → Cibles

Pour les vendeurs opérant plusieurs canaux de vente (Trendyol + Hepsiburada + Çiçeksepeti + boutique propre), la seule architecture saine est un inventaire maître dans Zunapro qui pousse vers chaque marketplace cible. La pile de production Zunapro 2026 exécute un cron toutes les 15 minutes plus une poussée pilotée par les événements : tout changement de stock dans le maître déclenche une poussée immédiate price-and-inventory vers Trendyol, tandis que le cron garantit une cohérence à terme pour toute poussée qui serait passée entre les mailles. Les SKU sont appariés par barcode (primaire) ou stockCode (repli) — jamais par l'ID produit interne de Trendyol, qui peut changer lors des ré-affectations de catégorie.

Règles de TVA et d'affichage des prix

Les prix Trendyol sont TTC (TVA incluse). Le régime de TVA (KDV) 2026 de la Turquie est de 20 % standard, 10 % réduit (alimentation, livres, médicaments, biens de base) et 1 % spécial (denrées alimentaires essentielles, certains produits agricoles). Le vendeur spécifie le vatRate par produit et est responsable du choix du taux correct ; les erreurs sont signalées a posteriori sous forme de rejet de facture électronique par le GİB, ce qui est coûteux à corriger.

Trendyol Fast Sale et synchronisation des campagnes

Les campagnes phares de Trendyol — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı (Marché du mercredi) — sont des campagnes à éligibilité obligatoire qui augmentent la visibilité des annonces mais entraînent une commission de campagne supplémentaire de 1 à 3 %. Les vendeurs inscrivent des SKU aux campagnes via POST /sapigw/suppliers/{id}/products/campaigns avec des remplacements de prix remisés ; Zunapro valide automatiquement les prix planchers de campagne par rapport à vos règles de marge maîtresses pour éviter des engagements à perte.

6. Alternative XML / CSV — quand (et quand ne pas) l'utiliser

Le modèle de pull XML

Trendyol prend en charge un modèle de flux XML comme alternative au flux POST REST. Le vendeur héberge un fichier XML à une URL HTTPS publique décrivant le catalogue ; Trendyol le récupère selon une cadence configurable (généralement toutes les 1 à 4 heures). Le schéma XML est publié dans le panneau Partner et reflète la forme de l'objet produit de l'endpoint REST — barcode, title, brandId, categoryId, attributes, images, prix, stock.

Le même schéma est pris en charge via CSV (une ligne par SKU) pour les vendeurs dont l'ERP exporte plus naturellement en CSV qu'en XML.

Comparaison : API REST vs XML / CSV

Quand XML / CSV est réellement le bon choix

• ERP hérité sans capacité de client HTTP qui exporte déjà du XML / CSV chaque nuit
• Catalogues peu changeants (moins de 500 SKU, changements de prix hebdomadaires, ajouts de catalogue mensuels)
• Migration initiale depuis une autre marketplace où un export CSV unique accélère la première synchronisation

Pour tout le reste — webhooks de commande, stock en temps réel, inscriptions aux campagnes, synchronisation multicanal — REST est la seule voie viable en 2026. Zunapro prend en charge les deux modes mais utilise REST par défaut et le XML / CSV strictement comme source d'ingestion ETL depuis les ERP hérités.

7. Trendyol Express & FBA Trendyol

Trendyol Express — la couche logistique

Trendyol Express est la branche logistique détenue à 100 % par Trendyol — lancée en 2018 et opérant aujourd'hui le réseau de colis natif e-commerce le plus dense de Turquie. D'ici 2026, il couvre plus de 50 000 casiers en libre-service et points de retrait aux côtés de sa propre flotte de coursiers, desservant 81 provinces avec la livraison le jour même à Istanbul, Ankara, Izmir, Bursa et Antalya, et la livraison le lendemain vers le reste de la Turquie continentale. Les acheteurs voient des badges « Hızlı Teslimat » (livraison rapide) sur les annonces éligibles, et le classement de recherche de Trendyol les pondère fortement.

FBA Trendyol — l'entrepôt logistique Trendyol

FBA Trendyol (parfois appelé « Trendyol Lojistik Deposu » ou « Trendyol Mağaza Plus ») est l'équivalent d'Amazon-FBA : les vendeurs expédient leur inventaire vers les centres de traitement de Trendyol à Çorlu (l'installation phare, 250 000 m² près d'Istanbul), Sancaktepe et Ankara, et Trendyol prend en charge le stockage, la préparation, l'emballage, la livraison du dernier kilomètre via Trendyol Express, et les retours. Les annonces FBA portent un badge distinct « Trendyol'dan Gönderim » et bénéficient d'une pondération de visibilité prioritaire dans la recherche.

Frais et éligibilité FBA Trendyol

• Onboarding — postulez via le panneau Partner ; l'équipe commerciale de Trendyol examine le volume mensuel, les dimensions des SKU et l'adéquation de la catégorie
• Frais de stockage — facturés mensuellement par mètre cube d'espace d'entrepôt occupé ; varient selon la saison (le stockage coûte plus cher au T4)
• Frais de préparation et d'emballage (pick-and-pack) — tarif forfaitaire par commande, variable selon la tranche de poids du colis (moins de 500 g, 500 g–2 kg, 2–5 kg, 5–10 kg, 10 kg+)
• Gestion des retours — incluse dans les frais de pick-and-pack pour les retours standard ; les conditions signalées sont facturées séparément

Quand FBA Trendyol a du sens

Le seuil de rentabilité de FBA Trendyol par rapport à l'auto-expédition se situe autour de 800 à 1 200 unités par mois et par SKU d'entrepôt pour les consommables, l'électronique ou la mode en gammes de tailles à rotation rapide. En dessous, l'auto-expédition via le dépôt Trendyol Express plus votre propre contrat Aras / Yurtiçi / DHL est généralement moins chère. Au-dessus, le gain de conversion du badge « Trendyol'dan Gönderim » plus la promesse de livraison le jour même l'emporte presque toujours sur le coût unitaire de traitement.

8. Intégration de la facture électronique GİB (e-Fatura / e-Arşiv)

Le mandat GİB

La Gelir İdaresi Başkanlığı (GİB — Administration fiscale) de Turquie a rendu l'e-Fatura obligatoire pour toute entreprise dont le chiffre d'affaires annuel dépasse le seuil publié par le GİB (révisé chaque année ; environ 3 M TRY en 2026) et l'e-Arşiv Fatura obligatoire pour toutes les factures B2C au-dessus d'environ 30 000 TRY (révisé chaque année). Pour les vendeurs Trendyol actifs en 2026, la couverture e-Fatura / e-Arşiv est de fait universelle — pratiquement chaque commande de marketplace doit produire une facture électronique tamponnée par le GİB dans la fenêtre de statut de commande, sous peine de pénalités.

Les cinq intégrateurs certifiés GİB

Les vendeurs peuvent soit utiliser directement le portail du GİB (impraticable aux volumes de marketplace), soit contracter avec un Özel Entegratör (intégrateur spécial) certifié GİB. Les cinq acteurs dominants en 2026 sont :

• Logo Yazılım — le plus grand éditeur d'ERP turc ; e-Logo pour l'émission de factures
• Mikro Yazılım — éditeur d'ERP et fournisseur de facture électronique du milieu de marché, fort sur le segment PME
• Uyumsoft — intégrateur indépendant avec une API REST robuste et la plus grande base de vendeurs de marketplace
• Foriba — fournisseur de niveau entreprise (racheté par Sovos en 2019), fort dans les secteurs réglementés
• Veriban — alternative en forte croissance, tarifs compétitifs et API conviviale pour les développeurs

Le flux de facture électronique de marketplace

1. Webhook Trendyol : statut de commande -> "Picking"
2. Zunapro récupère le détail de la commande (nom de l'acheteur, VKN/TCKN, adresse, articles)
3. Zunapro POST le brouillon de facture à l'intégrateur (Logo/Mikro/Uyumsoft/Foriba/Veriban)
4. L'intégrateur signe avec le certificat de signature électronique, soumet au GİB
5. Le GİB renvoie l'ETTN (Numéro unique de document électronique)
6. Zunapro stocke l'ETTN, joint le PDF à la commande Trendyol
7. Zunapro fait passer la commande Trendyol de Picking -> Invoiced via l'API

Choix pratique en 2026

Pour les nouveaux vendeurs, Uyumsoft et Veriban sont les plus faciles à intégrer (inscription web, API REST, aucune dépendance on-premise). Les vendeurs utilisant déjà un ERP Logo ou Mikro devraient rester sur le produit de facture électronique du même éditeur pour la réconciliation comptable. Foriba est le choix des grandes entreprises aux workflows fiscaux complexes. Zunapro est livré avec les cinq intégrations derrière un unique écran de configuration — choisissez l'intégrateur, collez les identifiants API, et chaque commande Trendyol génère automatiquement sa facture.

9. Erreurs courantes et comment concevoir votre système pour les éviter

Discordance de catégorie

Symptôme : le résultat du lot affiche INVALID_CATEGORY ou CATEGORY_NOT_LEAF. Cause : publication dans une catégorie non-feuille, ou dans une catégorie feuille dont le SKU ne correspond pas à l'ensemble d'attributs. Correctif : publiez toujours uniquement dans des catégories feuilles (l'API rejette les non-feuilles), et pré-validez les attributs par rapport à l'ensemble required: true de la catégorie avant le POST.

Attributs obligatoires manquants

Symptôme : MANDATORY_ATTRIBUTE_MISSING sur des SKU par ailleurs valides. Cause : Trendyol marque environ 30 % des attributs comme obligatoires selon la catégorie (genre pour la mode, garantie pour l'électronique, etc.). Correctif : mettez en cache la carte des attributs obligatoires par catégorie et bloquez les POST selon la complétude ; Zunapro auto-remplit à partir de votre taxonomie maîtresse là où c'est possible.

Retards de synchronisation du stock

Symptôme : un SKU épuisé apparaît encore en stock sur Trendyol pendant plusieurs minutes, provoquant des surventes. Cause : les poussées price-and-inventory sont cohérentes à terme, avec une latence médiane d'environ 5 à 8 secondes, et lors des pics de trafic (Black Friday, Trendyol Week) la file peut s'étirer à 30–60 secondes. Correctif : mettez en place un tampon de sécurité local (réservez les 1 à 2 dernières unités comme tampon en rupture de stock par SKU à forte vélocité) et poussez les changements de stock de façon synchrone sur l'événement de confirmation de commande, pas seulement sur le cron.

Webhooks manqués

Symptôme : le webhook de commande n'arrive jamais ou arrive avec des heures de retard. Cause : généralement un changement de pare-feu côté vendeur, un renouvellement de certificat TLS qui a cassé l'URL du webhook, ou une brève panne ayant dépassé le budget de 5 relances de Trendyol. Correctif : exécutez toujours une récupération de réconciliation parallèle toutes les 5 minutes contre /sapigw/suppliers/{id}/orders?status=Created&startDate=... ; Zunapro le fait par défaut et fusionne de façon idempotente toute commande récupérée que le webhook aurait également livrée.

Plusieurs annonces, même code-barres (Mükerrer Listing)

Symptôme : un même SKU apparaît sous plusieurs annonces Trendyol, et le stock se décrémente différemment sur chacune. Cause : fusions historiques, entrées de code-barres en double, ou éparpillement d'un même produit sur plusieurs boutiques. Correctif : la politique de déduplication au stock MIN de Zunapro (introduite dans notre mise à jour de production du 06/06/2026) regroupe toutes les annonces en double sous un même code-barres et suit la valeur de stock minimale entre elles, évitant le classique désastre « vendu deux fois sur deux annonces, une seule livraison promise ».

10. Commission Trendyol et frais vendeur 2026

Le barème de commissions 2026 de Trendyol est échelonné par catégorie, avec trois grandes tranches et sans frais fixes par article. La participation aux campagnes (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) ajoute 1 à 3 % au-dessus du taux de catégorie.

Frais vendeur / d'abonnement

Trendyol ne facture pas d'abonnement mensuel. Il n'y a pas de palier « Vendeur professionnel » à la Amazon. Les vendeurs paient :

• Commission de catégorie sur chaque vente (8–22 %)
• Commission de campagne en cas de participation à Trendyol Fast Sale / Week (+1–3 %)
• Trendyol Express frais par expédition (payés par l'acheteur, mais transitant par le compte de résultat du vendeur)
• FBA Trendyol stockage + pick-and-pack (uniquement si inscrit)
• Trendyol Ads CPC (optionnel, contrôlé par le vendeur)

Cycle de versement

Les vendeurs standard sont payés sur un cycle T+14 (14 jours après la livraison de la commande), réduit à T+7 pour les vendeurs ayant un score vendeur de premier plan. Les commandes contestées, les retours dans la fenêtre de 14 jours et les rétrofacturations sont retenus sur le versement. Les versements arrivent sur l'IBAN TR enregistré.

Cadre juridique turc 2026 — ce que les vendeurs de marketplace doivent savoir

KDV (TVA) et tranches de taux de KDV

La TVA turque — KDV (Katma Değer Vergisi) — comporte trois taux en 2026 : 20 % standard, 10 % réduit (alimentation, livres, médicaments, hôtellerie), 1 % spécial (denrées de base, agriculture). Les vendeurs de marketplace domiciliés en Turquie s'enregistrent à la KDV via leur bureau des impôts local ; les vendeurs transfrontaliers au-dessus du seuil des services numériques utilisent le régime de KDV des non-résidents. Le champ vatRate de chaque POST de produit Trendyol doit correspondre au taux légalement correct — les erreurs se propagent aux factures électroniques et peuvent nécessiter des déclarations rectificatives.

e-Fatura / e-Arşiv (obligatoire GİB)

Déjà couvert en détail à la section 8. En résumé pour 2026 : chaque commande de marketplace produit une facture électronique tamponnée par le GİB (e-Fatura pour le B2B / destinataires e-Fatura enregistrés, e-Arşiv pour le B2C). Le vendeur est responsable de l'émission dans la fenêtre de statut de commande. L'émission manuelle est impraticable aux volumes de marketplace — choisissez l'un des cinq intégrateurs GİB et automatisez.

KVKK — le RGPD turc

La KVKK (Kişisel Verilerin Korunması Kanunu — Loi n° 6698) est le régime turc de protection des données, structurellement similaire au RGPD et appliqué par la KVKK Kurumu. Les marketplaces gèrent le consentement et le traitement côté acheteur, mais les vendeurs restent co-responsables du traitement pour tout contact SAV direct, marketing ou communication post-achat. Les sanctions en cas de non-conformité vont de 60 K TRY à plus de 3 M TRY selon la classe d'infraction.

ETBİS — registre e-commerce obligatoire

ETBİS (Elektronik Ticaret Bilgi Sistemi) est le registre obligatoire du ministère du Commerce pour tout opérateur e-commerce en Turquie, en vigueur depuis 2018. Les vendeurs doivent s'enregistrer avant de lister sur Trendyol et déclarer leurs volumes de transactions annuels. Les données ETBİS alimentent l'application de la protection des consommateurs, le filtrage anti-fraude et l'analyse concurrentielle.

Protection des consommateurs — rétractation de 14 jours, garantie de 2 ans

• Droit de rétractation de 14 jours — les consommateurs turcs peuvent retourner tout produit acheté à distance dans les 14 jours, sans motif (Tüketicinin Korunması Hakkında Kanun, Loi n° 6502)
• Garantie légale de 2 ans — obligatoire sur les ventes B2C, indépendante de toute garantie du fabricant
• Information produit obligatoire en langue turque — titre, description, garantie, politique de retour, le tout en turc

Logistique & expédition en Turquie — Trendyol Express d'abord

Trendyol Express — la couche dominante

Trendyol Express est le transporteur par défaut sur environ 70 %+ des commandes Trendyol en 2026. L'acheteur voit une expédition gratuite ou à faible coût avec livraison le jour même ou le lendemain dans les grandes métropoles, plus plus de 50 000 casiers en libre-service (Trendyol Hızlı Teslimat Noktaları) où les acheteurs retirent leurs colis 24h/24. Les vendeurs déposent soit les colis à un point de collecte Trendyol Express, soit planifient un enlèvement par coursier ; le bordereau de routage porte le code-barres Trendyol Express obtenu via l'API d'étiquette de commande.

Les autres transporteurs intégrés

• Yurtiçi Kargo — coursier turc de longue date, réseau B2C et B2B solide, intégré pour les commandes Trendyol
• Aras Kargo — concurrent avec une forte couverture anatolienne, souvent utilisé pour les commandes Trendyol auto-expédiées
• DHL Kargo — troisième grand coursier turc, repli courant pour les vendeurs à fort volume
• PTT Kargo — opérateur postal d'État, la plus large portée rurale, SLA plus lents
• Sürat Kargo — acteur régional, compétitif dans les régions de Marmara et de l'Égée

Pile d'expédition pratique 2026

La pile pragmatique 2026 pour un vendeur Trendyol : Trendyol Express par défaut (c'est ce que les acheteurs attendent), Yurtiçi ou Aras comme repli côté vendeur pour les commandes auto-expédiées qui manquent la fenêtre d'enlèvement Trendyol Express, PTT Kargo pour les codes postaux uniquement ruraux où aucun autre transporteur n'est économique, et FBA Trendyol pour les SKU à rotation rapide une fois que le volume justifie l'engagement de stockage.

Comment commencer à vendre sur Trendyol — onboarding en 5 étapes

1. Compte vendeur Trendyol

Postulez sur partner.trendyol.com. Fournissez le VKN, le Journal du registre du commerce, la circulaire de signature, le reçu d'enregistrement ETBİS et l'IBAN TR. Approbation en 2 à 5 jours ouvrés.

2. ETBİS + enregistrement fiscal

Enregistrez l'entité juridique dans ETBİS via le portail du ministère du Commerce (etbis.gtb.gov.tr) et confirmez l'enregistrement KDV auprès du bureau des impôts local. Les vendeurs étrangers opérant via Trendyol International désignent soit un représentant turc, soit utilisent le programme d'importateur officiel de Trendyol.

3. Générer la clé API + le secret

Depuis le panneau Partner → Paramètres du compte → Informations d'intégration, cliquez sur « Créer une clé API ». Copiez immédiatement la clé API (40 caractères) et le secret API (40 caractères) — ils ne sont affichés qu'une seule fois. Collez-les dans la tuile Trendyol de Zunapro où ils sont conservés chiffrés en AES-256 et masqués.

4. Se connecter via le panneau Zunapro

1. Connectez-vous à Zunapro et ouvrez le module Turquie
2. Collez le Supplier ID + API Key + API Secret dans la tuile d'intégration Trendyol
3. Lancez le contrôle de santé automatique (identifiants, endpoint adresses, informations fournisseur)
4. Confirmez les mappages de catégories suggérés par le ML pour vos 100 principaux SKU
5. Choisissez votre intégrateur de facture électronique (Logo, Mikro, Uyumsoft, Foriba ou Veriban) et collez ces identifiants
6. Activez « Trendyol Express » + « FBA Trendyol » (si inscrit)

5. Effectuer une commande de test

Passez 3 à 5 commandes de test contre stageapi.trendyol.com pour exercer de bout en bout les flux de pick-pack, d'impression d'étiquette, de transition de statut et de remboursement. Une fois au vert, basculez l'intégration en production d'un simple interrupteur. La première synchronisation de production d'un catalogue de 5 000 SKU se termine en environ 30 à 60 minutes compte tenu des limites de débit de Trendyol.

Les trois voies d'intégration Trendyol — comparées

Avant de vous engager sur une architecture d'intégration, il est utile de comparer côte à côte les trois voies légitimes.

FAQ intégration Trendyol 2026