Guida all'integrazione Trendyol 2026: API REST, connessione XML e gestione negozi centralizzata

1. Architettura dell'API Trendyol 2026

La Marketplace API di Trendyol è un'interfaccia RESTful JSON-over-HTTPS pubblicata su un unico URL base di produzione — https://api.trendyol.com — con un ambiente di staging separato su https://stageapi.trendyol.com. Ogni chiamata API viene autenticata tramite HTTP Basic Auth: l'header Authorization trasporta una coppia ApiKey:ApiSecret codificata in base64, e il Supplier ID viene passato come parametro di percorso su ogni endpoint specifico del fornitore. Non c'è un round-trip separato del token di accesso per i venditori diretti — la Basic Auth viene verificata a ogni richiesta — il che mantiene semplice l'integrazione ma implica che le credenziali compromesse debbano essere ruotate immediatamente tramite il pannello Partner.

URL base, autenticazione, header

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'header User-Agent non è cosmetico: il traffic-shaping e la contabilità dei rate limit di Trendyol si basano su di esso. Gli integratori (come Zunapro) inviano {supplierId} - Zunapro; i venditori diretti inviano {supplierId} - SelfIntegration. Header User-Agent impostati erroneamente possono generare risposte 401/403 anche con credenziali valide.

Rate limit e quote

Trendyol applica rate limit per endpoint e per fornitore. I massimali pubblicati per il 2026 sono:

• Endpoint prodotto — tipicamente 60 richieste/minuto per Supplier ID, con tolleranza di picco fino a 90/min per 30 secondi
• Endpoint ordine — tipicamente 600 richieste/minuto (gli ordini sono un endpoint ad alto traffico e bassa latenza per design)
• Endpoint di aggiornamento prezzo e stock — tipicamente 100 richieste/minuto, con ogni richiesta che trasporta fino a 1.000 articoli in un singolo batch
• Ricerche categorie e attributi — tipicamente 30 richieste/minuto (cambiano lentamente, quindi è previsto un caching aggressivo)

Ogni risposta include gli header X-RateLimit-Limit, X-RateLimit-Remaining e, sui 429, Retry-After. Un'integrazione ben costruita utilizza una coda token-bucket per Supplier ID e applica back-pressure sui 429 con backoff esponenziale; Zunapro lo implementa di default così che anche i push massivi di molte migliaia di SKU non superino mai i limiti.

OAuth 2.0 per integratori indipendenti

Per gli integratori indipendenti a livello intermedio (Zunapro e piattaforme SaaS simili che operano per conto di molti fornitori), Trendyol offre un flusso OAuth 2.0 authorization-code anziché la Basic Auth diretta. L'integratore registra un client_id / client_secret presso il team developer relations di Trendyol, il fornitore autorizza l'integratore dal pannello Partner, e l'integratore riceve un token di accesso di 1 ora più un refresh token per il rinnovo. Questo evita di dover mai gestire l'ApiKey / ApiSecret grezzi del fornitore ed è il percorso più adatto agli audit per i clienti enterprise che gestiscono molti negozi Trendyol.

Webhook

Trendyol invia eventi del ciclo di vita dell'ordine al tuo URL webhook registrato: Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. Il payload del webhook è una busta JSON che trasporta l'ID ordine e il nuovo stato; il tuo endpoint deve rispondere con HTTP 200 entro 3 secondi. In caso di fallimento Trendyol ritenta 5 volte con backoff esponenziale, poi mette in pausa l'evento — motivo per cui un pull di riconciliazione ogni 5 minuti contro /sapigw/suppliers/{id}/orders è una rete di sicurezza non facoltativa.

2. Connessione tramite API REST — passo dopo passo

Il percorso ufficiale ottimale per connettersi all'API REST di Trendyol nel 2026 è breve e ben documentato — ma l'ordine delle operazioni conta perché alcuni prerequisiti legali precedono l'API stessa.

2.1 Apri un account venditore Trendyol

Visita partner.trendyol.com e invia una richiesta "Apri un account Trendyol". Ti serviranno:

• VKN (Vergi Kimlik Numarası) — numero fiscale turco (o registrazione aziendale equivalente estera per Trendyol International)
• Gazzetta del Registro delle Imprese (Ticaret Sicil Gazetesi) per società a responsabilità limitata o per azioni
• Circolare delle firme (imza sirküleri)
• Ricevuta di registrazione ETBİS (Elektronik Ticaret Bilgi Sistemi) — obbligatoria per qualsiasi operatore e-commerce turco dal 2018
• Conto bancario (IBAN TR) intestato all'entità legale per i pagamenti del marketplace

L'approvazione richiede tipicamente 2–5 giorni lavorativi. Una volta approvato, il venditore riceve un Supplier ID e l'accesso al pannello Trendyol Partner.

2.2 Genera API Key e Secret

Dal pannello Partner, apri Impostazioni account → Informazioni sull'integrazione e clicca su "Crea API Key". Trendyol genera una API Key di 40 caratteri e un API Secret di 40 caratteri. Entrambi i valori vengono mostrati una sola volta — non possono essere recuperati in seguito. Salvali in un password manager o, meglio ancora, incollali direttamente nel riquadro di integrazione di Zunapro, che li memorizza come segreti mascherati e crittografati con AES-256.

2.3 Prima richiesta di test

Conferma che le credenziali siano attive chiamando l'endpoint delle informazioni sul fornitore:

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"

Una risposta di successo restituisce gli indirizzi di magazzino e reso registrati del fornitore in formato JSON. Un 401 significa che l'header Basic Auth è errato; un 403 significa che il Supplier ID non corrisponde alle credenziali; un 404 significa che il percorso dell'endpoint è malformato.

2.4 Variante OAuth (per integratori multi-fornitore)

Per gli integratori indipendenti, il flusso OAuth 2.0 è il seguente:

1. L'integratore reindirizza il fornitore a:
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. Il fornitore approva l'accesso; Trendyol reindirizza con ?code={authCode}

3. L'integratore scambia il codice con i token:
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

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

I token di accesso sono validi per 1 ora e rinnovabili per 30 giorni. Zunapro gestisce tutti e quattro i passaggi in modo trasparente, così il fornitore vede solo un unico pulsante "Connetti a Trendyol".

2.5 Pubblica il tuo primo prodotto

Usa POST /sapigw/suppliers/{supplierId}/v2/products con un array JSON di articoli. L'oggetto prodotto minimo richiede barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (tipicamente TRY), listPrice, salePrice, vatRate, cargoCompanyId, un array images (1–8 URL) e un array attributes di ID attributo specifici della categoria.

3. Sincronizzazione dei prodotti su larga scala

Caricamento massivo — 1.000 SKU per batch

L'endpoint POST /v2/products di Trendyol accetta fino a 1.000 SKU per singola richiesta JSON. Per i venditori con cataloghi da oltre 10.000 SKU, questa è la differenza tra un onboarding di un'ora e uno di più giorni. Il batch restituisce un batchRequestId per chiamata; Trendyol elabora ogni batch in modo asincrono ed espone il successo / fallimento per SKU una volta completata l'elaborazione (tipicamente entro 1–15 minuti a seconda della profondità della coda di validazione).

Mappatura delle categorie — il passaggio più difficile in assoluto

L'albero delle categorie di Trendyol è profondo e rigoroso. Nel 2026 ci sono circa 12.000 categorie foglia, ciascuna con il proprio set di attributi obbligatori e opzionali. Un jeans elencato sotto "Uomo → Pantaloni → Casual" richiede gli attributi gender, size, color, material e fit-type; uno smartphone sotto "Elettronica → Mobile → Telefoni" richiede brand, model, memory, guaranteeType e warrantyPeriod. Pubblicare un prodotto nella categoria sbagliata, o in quella giusta ma senza un attributo obbligatorio, produce un rifiuto silenzioso nel risultato del batch.

L'approccio consigliato è:

1. Recupera l'albero delle categorie attivo da GET /sapigw/product-categories (metti in cache per 24h)
2. Per ogni categoria foglia, recupera gli attributi obbligatori + opzionali da GET /sapigw/product-categories/{categoryId}/attributes
3. Fai corrispondere gli SKU del tuo catalogo master alle categorie foglia di Trendyol — Zunapro utilizza un mappatore ML addestrato su milioni di annunci storici Trendyol per suggerire categorie da titolo + marca + la tua tassonomia con un tasso di corrispondenza al primo tentativo superiore al 92%
4. Valida ogni SKU rispetto agli attributi obbligatori prima di chiamare l'endpoint POST per evitare di sprecare rate limit su richieste destinate a fallire

Whitelist marchi e brandId

Ogni prodotto deve fare riferimento a un brandId esistente nel registro marchi di Trendyol. I nuovi marchi non possono essere creati al volo — passano attraverso un processo di approvazione manuale tramite il pannello Partner (tipicamente 1–3 giorni lavorativi). Usa GET /sapigw/brands?name={brandName} per cercare un brandId esistente prima di creare prodotti.

Regole di caricamento immagini

• 1–8 immagini per prodotto
• URL pubblici HTTPS (Trendyol esegue il crawling e ri-ospita le immagini sulla propria CDN)
• Minimo 1200×1800 px, sfondo bianco per le categorie moda
• JPG o PNG, massimo ~10 MB per immagine
• La prima immagine diventa la miniatura del risultato di ricerca — vale la pena investirci

Polling dello stato del batch

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

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

4. Gestione ordini — webhook e flusso di stato

Il ciclo di vita dell'ordine 2026

Un ordine Trendyol attraversa un flusso di stato fisso:

Created → Picking → Invoiced → Shipped → Delivered

Flussi alternativi:
  Cancelled (in qualsiasi momento prima di Shipped)
  Returned (dopo Delivered, entro la finestra di 14 giorni)
  UnDelivered (eccezione del corriere)

Ogni transizione genera sia un evento webhook (push) sia si riflette nel successivo pull GET /orders (poll). Il venditore è responsabile della transizione Picking → Invoiced → Shipped; i partner logistici di Trendyol controllano Shipped → Delivered.

Ricezione webhook e idempotenza

Ogni webhook trasporta uno shipmentPackageId univoco. Elaboralo in modo idempotente — Trendyol ritenta effettivamente gli eventi su risposta non-200, e l'elaborazione duplicata dal tuo lato (doppia fatturazione, doppia preparazione) è un rischio reale. Lo schema pragmatico è:

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

Gestore:
1. Acquisire un lock su shipmentPackageId
2. Controllare lo stato memorizzato; se già >= "Picking", restituire 200 (no-op)
3. Persistere il nuovo stato, pianificare le azioni a valle (fattura elettronica, attività di preparazione)
4. Restituire HTTP 200 entro 3 secondi

Flusso di annullamento e rimborso

Gli annullamenti avviati dall'acquirente arrivano come webhook Cancelled; gli annullamenti avviati dal venditore vengono inviati tramite POST /sapigw/suppliers/{id}/orders/{orderId}/cancel con un codice motivo di annullamento (OUT_OF_STOCK, OTHER, ecc.). I rimborsi per gli articoli consegnati e resi vengono gestiti automaticamente da Trendyol; l'unico obbligo del venditore è confermare la ricezione della merce resa entro 48 ore dalla scansione del corriere.

Etichetta di spedizione Trendyol Express

Una volta che un pacco passa allo stato Picking, richiedi l'etichetta di spedizione tramite GET /sapigw/suppliers/{id}/orders/{orderId}/labels — Trendyol restituisce un PDF (e opzionalmente ZPL per stampanti termiche) contenente il codice a barre Trendyol Express, l'indirizzo dell'acquirente e il numero di tracciamento del corriere. Il codice a barre è l'unico artefatto di instradamento del corriere — stampalo, attaccalo, scansionalo nel tuo WMS, consegnalo in un punto di ritiro Trendyol Express (o pianifica il ritiro del corriere per i venditori ad alto volume).

5. Aggiornamenti di stock e prezzo in tempo reale

Il pattern di push stock-prezzo

Trendyol espone un endpoint dedicato per gli aggiornamenti di stock e prezzo: POST /sapigw/suppliers/{id}/products/price-and-inventory. Ogni chiamata accetta fino a 1.000 articoli, con barcode, quantity, salePrice e listPrice opzionale per articolo. Gli aggiornamenti si applicano entro pochi secondi per lo stock, entro 2–5 minuti per il prezzo (Trendyol mette in cache il prezzo per coerenza del feed di shopping).

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'architettura di sincronizzazione master → locale → target

Per i venditori che gestiscono più canali di vendita (Trendyol + Hepsiburada + Çiçeksepeti + negozio proprio), l'unica architettura sensata è un inventario master in Zunapro che invia i dati a ogni marketplace target. Lo stack di produzione Zunapro 2026 esegue un cron ogni 15 minuti più un push event-driven: qualsiasi variazione di stock nel master genera un push immediato di prezzo-e-inventario verso Trendyol, mentre il cron garantisce l'eventual consistency per qualsiasi push che sia sfuggito. Gli SKU vengono abbinati per codice a barre (primario) o stockCode (fallback) — mai per l'ID prodotto interno di Trendyol, che può cambiare a seguito di ri-mappature di categoria.

Regole IVA e visualizzazione prezzo

I prezzi Trendyol sono comprensivi di IVA. Il regime IVA (KDV) turco del 2026 prevede 20% standard, 10% ridotta (alimenti, libri, medicinali, beni di base) e 1% speciale (generi alimentari essenziali, alcuni prodotti agricoli). Il venditore specifica il vatRate per prodotto ed è responsabile della scelta dell'aliquota corretta; gli errori si manifestano successivamente come rifiuto della fattura elettronica da parte del GİB, la cui correzione è costosa.

Trendyol Fast Sale e sincronizzazione delle campagne

Le campagne di punta di Trendyol — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı (Mercato del Mercoledì) — sono campagne a idoneità obbligatoria che aumentano la visibilità degli annunci ma comportano una commissione di campagna aggiuntiva dell'1–3%. I venditori iscrivono gli SKU alle campagne tramite POST /sapigw/suppliers/{id}/products/campaigns con sovrapprezzi scontati; Zunapro convalida automaticamente le soglie minime di prezzo delle campagne rispetto alle tue regole di margine master per prevenire impegni sotto costo.

6. Alternativa XML / CSV — quando usarla (e quando no)

Il modello di pull XML

Trendyol supporta un modello di feed XML come alternativa al flusso REST POST. Il venditore ospita un file XML su un URL HTTPS pubblico che descrive il catalogo; Trendyol lo recupera con una cadenza configurabile (tipicamente ogni 1–4 ore). Lo schema XML è pubblicato nel pannello Partner e rispecchia la forma dell'oggetto prodotto dell'endpoint REST — codice a barre, titolo, brandId, categoryId, attributi, immagini, prezzo, stock.

Lo stesso pattern è supportato anche via CSV (una riga per SKU) per i venditori il cui ERP esporta CSV più naturalmente dell'XML.

Confronto: API REST vs XML / CSV

Quando XML / CSV è davvero la scelta giusta

• ERP legacy senza capacità client HTTP che già esporta XML / CSV ogni notte
• Cataloghi a bassa variabilità (sotto i 500 SKU, variazioni di prezzo settimanali, aggiunte al catalogo mensili)
• Migrazione iniziale da un altro marketplace dove un export CSV una tantum accelera la prima sincronizzazione

Per tutto il resto — webhook ordini, stock in tempo reale, adesioni alle campagne, sincronizzazione multicanale — REST è l'unico percorso praticabile nel 2026. Zunapro supporta entrambe le modalità ma utilizza REST come predefinito e usa XML / CSV strettamente come fonte di ingestione ETL da ERP legacy.

7. Trendyol Express e FBA Trendyol

Trendyol Express — il livello logistico

Trendyol Express è il braccio logistico interamente di proprietà di Trendyol — lanciato nel 2018 e che oggi gestisce la rete di pacchi e-commerce-nativa più densa della Turchia. Nel 2026 copre oltre 50.000 locker self-service e punti di ritiro insieme alla propria flotta di corrieri, raggiungendo 81 province con consegna in giornata a Istanbul, Ankara, Izmir, Bursa e Antalya, e consegna il giorno successivo nel resto della Turchia continentale. Gli acquirenti vedono badge "Hızlı Teslimat" (consegna rapida) sugli annunci idonei, e il ranking di ricerca di Trendyol li pesa in modo aggressivo.

FBA Trendyol — magazzino logistico Trendyol

L'FBA Trendyol (a volte chiamato "Trendyol Lojistik Deposu" o "Trendyol Mağaza Plus") è l'equivalente dell'Amazon FBA: i venditori spediscono l'inventario ai centri di fulfillment di Trendyol a Çorlu (la struttura di punta, 250.000 m² vicino a Istanbul), Sancaktepe e Ankara, e Trendyol gestisce lo stoccaggio, il picking, l'imballaggio, la consegna dell'ultimo miglio tramite Trendyol Express, e i resi. Gli annunci FBA hanno un badge distintivo "Trendyol'dan Gönderim" e ricevono una ponderazione di visibilità prioritaria nella ricerca.

Costi e idoneità FBA Trendyol

• Onboarding — richiedi tramite il pannello Partner; il team commerciale di Trendyol esamina il volume mensile, le dimensioni degli SKU e l'adattamento alla categoria
• Costo di stoccaggio — fatturato mensilmente per metro cubo di spazio di magazzino occupato; varia in base alla stagione (il magazzinaggio nel Q4 costa di più)
• Costo pick-and-pack — tariffa fissa per ordine, varia in base alla fascia di peso del pacco (sotto 500g, 500g–2kg, 2–5kg, 5–10kg, oltre 10kg)
• Gestione resi — inclusa nel costo pick-and-pack per i resi standard; le condizioni segnalate vengono fatturate separatamente

Quando ha senso l'FBA Trendyol

Il punto di pareggio dell'FBA Trendyol rispetto all'auto-fulfillment è di circa 800–1.200 unità al mese per SKU di magazzino per i beni di consumo, l'elettronica o la moda a taglie in rapido movimento. Al di sotto, l'auto-fulfillment tramite il ritiro Trendyol Express più il proprio contratto Aras / Yurtiçi / MNG è generalmente più economico. Al di sopra, l'aumento di conversione dovuto al badge "Trendyol'dan Gönderim" più la promessa di consegna in giornata quasi sempre supera il costo di fulfillment per unità.

8. Integrazione fattura elettronica GİB (e-Fatura / e-Arşiv)

Il mandato GİB

Il Gelir İdaresi Başkanlığı (GİB — Amministrazione delle Entrate) turco ha reso obbligatoria l'e-Fatura per qualsiasi azienda con fatturato annuo superiore alla soglia pubblicata dal GİB (rivista annualmente; circa 3 milioni di TRY nel 2026) e l'e-Arşiv Fatura obbligatoria per tutte le fatture B2C superiori a circa 30.000 TRY (rivista annualmente). Per i venditori Trendyol attivi nel 2026, la copertura e-Fatura / e-Arşiv è effettivamente universale — praticamente ogni ordine di marketplace deve produrre una fattura elettronica timbrata dal GİB entro la finestra di stato dell'ordine, pena sanzioni.

I cinque integratori certificati GİB

I venditori possono utilizzare direttamente il portale del GİB (poco pratico ai volumi del marketplace) oppure contrattare con un Özel Entegratör (integratore speciale) certificato GİB. I cinque attori dominanti nel 2026 sono:

• Logo Yazılım — il più grande fornitore ERP turco; e-Logo per l'emissione delle fatture
• Mikro Yazılım — fornitore ERP e fattura elettronica di fascia media, forte nel segmento PMI
• Uyumsoft — integratore indipendente con una solida API REST e la più ampia base di venditori marketplace
• Foriba — fornitore di livello enterprise (acquisito da Sovos nel 2019), forte nei settori regolamentati
• Veriban — alternativa in rapida crescita con prezzi competitivi e API developer-friendly

Il flusso di fatturazione elettronica del marketplace

1. Webhook Trendyol: stato ordine -> "Picking"
2. Zunapro recupera i dettagli dell'ordine (nome acquirente, VKN/TCKN, indirizzo, articoli)
3. Zunapro invia la bozza di fattura all'integratore (Logo/Mikro/Uyumsoft/Foriba/Veriban)
4. L'integratore firma con certificato di firma elettronica, invia al GİB
5. Il GİB restituisce l'ETTN (numero univoco del documento elettronico)
6. Zunapro memorizza l'ETTN, allega il PDF all'ordine Trendyol
7. Zunapro fa transitare l'ordine Trendyol da Picking -> Invoiced tramite API

Scelta pratica per il 2026

Per i nuovi venditori, Uyumsoft e Veriban sono i più semplici da attivare (registrazione web, API REST, nessuna dipendenza on-premise). I venditori che già utilizzano ERP Logo o Mikro dovrebbero rimanere sul prodotto di fatturazione elettronica dello stesso fornitore per la riconciliazione contabile. Foriba è la scelta per le grandi aziende con flussi fiscali complessi. Zunapro include tutte e cinque le integrazioni dietro un'unica schermata di configurazione — scegli l'integratore, incolla le credenziali API, e ogni ordine Trendyol viene fatturato automaticamente.

9. Errori comuni e come progettare per evitarli

Discrepanza di categoria

Sintomo: il risultato del batch mostra INVALID_CATEGORY o CATEGORY_NOT_LEAF. Causa: pubblicazione in una categoria non foglia, o in una categoria foglia il cui set di attributi lo SKU non soddisfa. Soluzione: pubblica sempre solo in categorie foglia (l'API rifiuta le categorie non foglia), e pre-valida gli attributi rispetto al set required: true della categoria prima del POST.

Attributi obbligatori mancanti

Sintomo: MANDATORY_ATTRIBUTE_MISSING su SKU altrimenti validi. Causa: Trendyol contrassegna circa il 30% degli attributi come obbligatori su base per-categoria (genere per la moda, garanzia per l'elettronica, ecc.). Soluzione: memorizza in cache la mappa dei requisiti degli attributi per categoria e blocca i POST in base alla completezza; Zunapro compila automaticamente dalla tua tassonomia master dove possibile.

Ritardi di sincronizzazione dello stock

Sintomo: uno SKU esaurito appare ancora disponibile su Trendyol per diversi minuti, causando overselling. Causa: i push di prezzo-inventario sono eventually consistent con una latenza mediana di ~5–8 secondi, e durante i picchi di traffico (Black Friday, Trendyol Week) la coda può estendersi a 30–60 secondi. Soluzione: implementa un buffer di sicurezza locale (riserva le ultime 1–2 unità come buffer esaurito per SKU ad alta velocità) e invia le variazioni di stock in modo sincrono all'evento di conferma dell'ordine, non solo tramite cron.

Webhook mancati

Sintomo: il webhook dell'ordine non arriva mai o arriva con ore di ritardo. Causa: di solito una modifica al firewall lato venditore, un rinnovo del certificato TLS che ha interrotto l'URL del webhook, o un'interruzione breve che ha superato il budget di 5 tentativi di Trendyol. Soluzione: esegui sempre un pull di riconciliazione parallelo ogni 5 minuti contro /sapigw/suppliers/{id}/orders?status=Created&startDate=...; Zunapro lo fa di default e unisce in modo idempotente qualsiasi ordine recuperato anche consegnato dal webhook.

Annunci multipli, stesso codice a barre (Mükerrer Listing)

Sintomo: un singolo SKU appare come più annunci Trendyol, e lo stock decrementa diversamente su ciascuno. Causa: fusioni storiche, voci di codice a barre duplicate, o fan-out dello stesso prodotto su più negozi. Soluzione: la policy di deduplicazione MIN-stock di Zunapro (introdotta nell'aggiornamento di produzione del 2026-06-06) unisce tutti gli annunci duplicati sotto un unico codice a barre e traccia il valore minimo di stock tra di essi, prevenendo il classico disastro "venduto due volte su due annunci, una sola consegna promessa".

10. Commissioni Trendyol e costi venditore 2026

Il listino commissioni 2026 di Trendyol è suddiviso per categoria, con tre fasce ampie e nessun costo fisso per articolo. La partecipazione alle campagne (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) aggiunge un ulteriore 1–3% oltre alla tariffa di categoria.

Costi venditore / abbonamento

Trendyol non addebita un abbonamento mensile. Non esiste un livello "Professional Seller" in stile Amazon. I venditori pagano:

• Commissione di categoria su ogni vendita (8–22%)
• Commissione di campagna quando partecipano a Trendyol Fast Sale / Week (+1–3%)
• Trendyol Express tariffa per spedizione (pagata dall'acquirente, ma incide sul conto economico del venditore)
• Stoccaggio + pick-and-pack FBA Trendyol (solo se iscritti)
• Trendyol Ads CPC (facoltativo, controllato dal venditore)

Ciclo di pagamento

I venditori standard vengono pagati con un ciclo T+14 (14 giorni dopo la consegna dell'ordine), ridotto a T+7 per i venditori con un punteggio di livello superiore. Gli ordini contestati, i resi entro la finestra di 14 giorni e i chargeback vengono trattenuti dal pagamento. I pagamenti confluiscono nell'IBAN TR registrato.

Quadro giuridico turco 2026 — cosa devono sapere i venditori marketplace

KDV (IVA) e fasce di aliquota KDV

L'IVA turca — il KDV (Katma Değer Vergisi) — nel 2026 prevede tre aliquote: 20% standard, 10% ridotta (alimenti, libri, medicinali, ospitalità), 1% speciale (generi alimentari di base, agricoltura). I venditori marketplace domiciliati in Turchia si registrano per il KDV tramite il proprio ufficio delle imposte locale; i venditori cross-border oltre la soglia dei servizi digitali utilizzano il regime KDV per non residenti. Il campo vatRate su ogni POST di prodotto Trendyol deve corrispondere all'aliquota legalmente corretta — gli errori si propagano alle fatture elettroniche e possono richiedere dichiarazioni di correzione.

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

Già trattato in dettaglio nella sezione 8. In sintesi per il 2026: ogni ordine di marketplace genera una fattura elettronica timbrata dal GİB (e-Fatura per B2B / destinatari e-Fatura registrati, e-Arşiv per B2C). Il venditore è responsabile dell'emissione entro la finestra di stato dell'ordine. L'emissione manuale non è pratica ai volumi del marketplace — scegli uno dei cinque integratori GİB e automatizza.

KVKK — il GDPR turco

Il KVKK (Kişisel Verilerin Korunması Kanunu — Legge n. 6698) è il regime di protezione dei dati turco, strutturalmente simile al GDPR e applicato dal KVKK Kurumu. I marketplace gestiscono il consenso e il trattamento lato acquirente, ma i venditori restano contitolari per qualsiasi contatto diretto con il servizio clienti, marketing o comunicazione post-acquisto. Le sanzioni per la non conformità vanno da 60.000 TRY a oltre 3 milioni di TRY a seconda della classe di infrazione.

ETBİS — registro e-commerce obbligatorio

L'ETBİS (Elektronik Ticaret Bilgi Sistemi) è il registro obbligatorio del Ministero del Commercio per qualsiasi operatore e-commerce in Turchia, in vigore dal 2018. I venditori devono registrarsi prima di pubblicare annunci su Trendyol e riportare i volumi di transazione annuali. I dati ETBİS alimentano l'applicazione della tutela dei consumatori, lo screening antifrode e l'analisi della concorrenza.

Tutela del consumatore — recesso di 14 giorni, garanzia di 2 anni

• Diritto di recesso di 14 giorni — i consumatori turchi possono restituire qualsiasi prodotto acquistato a distanza entro 14 giorni, senza necessità di motivazione (Tüketicinin Korunması Hakkında Kanun, Legge n. 6502)
• Garanzia legale di 2 anni — obbligatoria sulle vendite B2C, indipendentemente da qualsiasi garanzia del produttore
• Informazioni sul prodotto obbligatorie in lingua turca — titolo, descrizione, garanzia, politica di reso tutti in turco

Logistica e spedizioni in Turchia — Trendyol Express prima di tutto

Trendyol Express — il livello dominante

Trendyol Express è il corriere predefinito su circa il 70%+ degli ordini Trendyol nel 2026. L'acquirente vede spedizione gratuita o a basso costo con consegna in giornata o il giorno successivo nelle principali aree metropolitane, oltre a oltre 50.000 locker self-service (Trendyol Hızlı Teslimat Noktaları) dove gli acquirenti ritirano i pacchi 24/7. I venditori consegnano i pacchi in un punto di raccolta Trendyol Express oppure pianificano il ritiro del corriere; la distinta di instradamento trasporta il codice a barre Trendyol Express ottenuto dall'API dell'etichetta ordine.

Gli altri corrieri integrati

• Yurtiçi Kargo — corriere turco storico, forte rete B2C e B2B, integrato per gli ordini Trendyol
• Aras Kargo — concorrente con forte copertura anatolica, spesso utilizzato per ordini Trendyol auto-evasi
• MNG Kargo — terzo grande corriere turco, fallback comune per venditori ad alto volume
• PTT Kargo — operatore postale statale, la copertura rurale più ampia, SLA più lenti
• Sürat Kargo — attore regionale, competitivo nelle regioni di Marmara ed Egeo

Stack di spedizione pratico per il 2026

Lo stack pragmatico 2026 per un venditore Trendyol: Trendyol Express come predefinito (è ciò che gli acquirenti si aspettano), Yurtiçi o Aras come fallback lato venditore per gli ordini auto-evasi che perdono la finestra di ritiro Trendyol Express, PTT Kargo per i CAP solo rurali dove nessun altro corriere è economico, e FBA Trendyol per gli SKU a rapido movimento una volta che il volume giustifica l'impegno di stoccaggio.

Come iniziare a vendere su Trendyol — onboarding in 5 passi

1. Account venditore Trendyol

Fai domanda su partner.trendyol.com. Fornisci VKN, Gazzetta del Registro delle Imprese, circolare delle firme, ricevuta di registrazione ETBİS e IBAN TR. Approvazione in 2–5 giorni lavorativi.

2. ETBİS + registrazione fiscale

Registra l'entità legale nell'ETBİS tramite il portale del Ministero del Commercio (etbis.gtb.gov.tr) e conferma la registrazione KDV presso l'ufficio delle imposte locale. I venditori esteri che operano tramite Trendyol International nominano un rappresentante turco oppure utilizzano il programma import-of-record di Trendyol.

3. Genera API Key + Secret

Dal pannello Partner → Impostazioni account → Informazioni sull'integrazione, clicca su "Crea API Key". Copia l'API Key (40 caratteri) e l'API Secret (40 caratteri) immediatamente — vengono mostrati una sola volta. Incollali nel riquadro Trendyol di Zunapro dove vengono memorizzati crittografati AES-256 e mascherati.

4. Connettiti tramite il pannello Zunapro

1. Accedi a Zunapro e apri il modulo Turchia
2. Incolla Supplier ID + API Key + API Secret nel riquadro di integrazione Trendyol
3. Esegui il controllo di salute automatico (credenziali, endpoint indirizzi, informazioni fornitore)
4. Conferma le mappature di categoria suggerite dall'ML per i tuoi primi 100 SKU
5. Scegli il tuo integratore di fatturazione elettronica (Logo, Mikro, Uyumsoft, Foriba o Veriban) e incolla quelle credenziali
6. Attiva "Trendyol Express" + "FBA Trendyol" (se iscritto)

5. Esegui un ordine di prova

Piazza 3–5 ordini di staging contro stageapi.trendyol.com per esercitare i flussi di pick-pack, stampa etichetta, transizione di stato e rimborso end-to-end. Una volta tutto verde, passa l'integrazione in produzione con un solo interruttore. La prima sincronizzazione in produzione di un catalogo da 5.000 SKU si completa in circa 30–60 minuti dati i rate limit di Trendyol.

I tre percorsi di integrazione Trendyol — a confronto

Prima di impegnarti in un'architettura di integrazione, è utile confrontare fianco a fianco i tre percorsi legittimi.

FAQ sull'integrazione Trendyol 2026