Pianifica il trasferimento controllato del catalogo Trendyol verso un negozio di proprietà, occupandoti della mappatura dei campi, delle varianti, dei prezzi, delle scorte, dei contenuti multimediali e della convalida.
Trasferire i prodotti da Trendyol a un canale e-commerce di proprietà non significa copiare titoli e prezzi da un file all’altro. Una migrazione affidabile riconcilia identità dei prodotti, attributi di categoria, relazioni tra varianti, scorte, imposte, diritti sui contenuti multimediali e operazioni successive all’ordine all’interno di un unico modello di dati. L’obiettivo non è interrompere le vendite sul marketplace, ma aprire un canale aggiuntivo in cui il brand abbia il controllo del proprio catalogo.
La documentazione ufficiale per sviluppatori di Trendyol indica V2 come l’area di integrazione attuale. Gli endpoint e i requisiti dei campi possono cambiare: l’implementazione deve quindi seguire sempre la documentazione V2 aggiornata e le autorizzazioni assegnate all’account del venditore. Lo scraping delle pagine, la copia automatizzata dall’interfaccia consumer e l’estrazione non autorizzata dei dati non sono metodi di integrazione sostenibili.
Per prima cosa, stabilisci quali dati possono essere trasferiti
Suddividi i dati in tre categorie:
- Dati master del brand: SKU proprietario del brand, codice a barre, nome del prodotto, descrizione, costo, aliquota fiscale e contenuti multimediali per i quali detiene i diritti d’uso.
- Dati del canale: identificativi del prodotto o del venditore su Trendyol, mappatura delle categorie, prezzo del canale e codici di stato specifici del marketplace.
- Dati che potrebbero appartenere alla piattaforma o a terze parti: recensioni dei clienti, valutazioni, badge, layout delle pagine e contenuti creati dalla piattaforma.
Costruisci il nuovo negozio partendo dalla prima categoria. Conserva la seconda solo per la mappatura e la riconciliazione. Prima di trasferire qualsiasi elemento della terza, verifica esplicitamente i relativi diritti. In particolare, non dare per scontato che valutazioni e recensioni dei clienti siano contenuti di catalogo che il brand può riprodurre liberamente.
Crea un dizionario di mappatura dall’origine alla destinazione
Prima della migrazione, prepara un dizionario dei dati approvato da tutti i responsabili:
| Concetto di origine | Campo di destinazione | Regola di trasformazione | Gestione degli errori |
|---|---|---|---|
| merchantSku | canonicalSku | Rimuovi gli spazi superflui; mantieni maiuscole e minuscole | Metti in quarantena se manca |
| barcode | barcode | Mantieni il formato testuale e gli zeri iniziali | Interrompi in caso di duplicati |
| productMainId | productGroupKey | Raggruppa le varianti sotto un unico prodotto | Segnala le varianti orfane |
| categoryId | targetCategoryId | Usa una tabella di mappatura approvata | Mantieni come bozza se non corrisponde |
| attributes | attributes | Normalizza codice, valore e unità | Non pubblicare se mancano dati obbligatori |
| salePrice | channelPrice | Applica le regole su imposte e margine | Richiedi approvazione sotto la soglia |
| quantity | sourceInventory | Sottrai la scorta di sicurezza; imposta il minimo a zero | Genera un avviso di anomalia |
| imageUrls | mediaAssets | Verifica accessibilità HTTPS, formato e diritti | Non pubblicare i contenuti multimediali che non superano la verifica |
Anche il titolo di un prodotto richiede una valutazione. Un titolo per marketplace pieno di parole chiave potrebbe non essere adatto allo stile editoriale del negozio di proprietà. Mantieni un nome neutro nel catalogo canonico e genera titoli specifici per ciascun canale. Applica lo stesso principio a descrizioni, testi SEO e promesse di consegna.
Il modello delle varianti è il punto cruciale
Le opzioni di colore, taglia e volume possono comparire come righe di prodotto separate nella fonte, mentre il negozio di destinazione le presenta come opzioni nella pagina di dettaglio di un solo prodotto. Mantieni per ogni variante la relazione con SKU, codice a barre, scorte, prezzo e contenuti multimediali specifici.
Ridurre, per esempio, una variante «Nero / 38» a «38» comporta il rischio di spedire l’articolo sbagliato. Una chiave variante può essere una combinazione deterministica di codici colore e taglia, ma deve rimanere stabile. Verifica il prodotto padre e la matrice delle varianti in base a queste condizioni:
- Due varianti dello stesso gruppo hanno la stessa combinazione di opzioni?
- Lo stesso codice a barre è associato a più SKU attivi?
- Ogni variante ha scorte vendibili e un prezzo?
- Un’immagine appartiene al prodotto padre o a un colore specifico?
- Una variante inattiva nella fonte viene riattivata accidentalmente nella destinazione?
Un’architettura di integrazione più sicura
Una pipeline diretta «leggi da Trendyol, scrivi nel negozio live» è fragile. Aggiungi un livello intermedio tracciabile:
Connessione autorizzata alla fonte → area dati grezzi → trasformazione/mappatura → convalida → catalogo canonico → pubblicazione nel negozio
Una risposta grezza con indicazione temporale agevola l’analisi degli incidenti, ma non si devono conservare dati personali o segreti non necessari e l’accesso deve essere limitato. Le trasformazioni devono essere ripetibili: elaborare due volte la stessa versione della fonte non deve creare prodotti duplicati. Una combinazione di identità del venditore sulla fonte, SKU e versione dei dati può fungere da chiave di idempotenza.
Il connettore deve rispettare i limiti ufficiali, riprovare gli errori temporanei aumentando progressivamente l’intervallo tra i tentativi ed evitare di ritentare all’infinito gli errori 4xx permanenti. Le credenziali non devono essere inserite nel codice o nell’URL di un feed: conservale in un sistema di gestione dei segreti e assegna i privilegi minimi necessari. L’account del venditore che usa l’integrazione deve essere esplicitamente autorizzato a farlo.
Separa la migrazione iniziale dalla sincronizzazione continua
Il primo trasferimento del catalogo è un progetto; gli aggiornamenti di scorte e prezzi sono attività continuative.
- Caricamento iniziale: importa descrizione del prodotto, varianti, attributi e contenuti multimediali come bozze.
- Sincronizzazione delle scorte: aggiorna a brevi intervalli la quantità vendibile e applica una scorta di sicurezza per il canale.
- Sincronizzazione dei prezzi: definisci una fonte dei prezzi approvata dal reparto Finance; le modifiche automatizzate non devono scendere sotto il margine minimo.
- Sincronizzazione dei contenuti: inserisci le modifiche in una coda di revisione invece di sovrascrivere automaticamente i contenuti dettagliati del negozio di proprietà.
- Disattivazione: non cancellare un articolo quando scompare o viene chiuso nella fonte; disattivalo mantenendo i collegamenti agli ordini aperti e ai report.
Quando entrambi i canali vendono le stesse scorte fisiche, la «quantità nota più recente» non basta. Occorre gestire la prenotazione tra l’aggiunta al carrello e il pagamento, il rilascio in caso di annullamento e una procedura per le vendite oltre le scorte disponibili. Per i prodotti critici, la protezione più semplice consiste nell’allocare scorte separate per canale o applicare una scorta di sicurezza.
Tre livelli di convalida
Livello 1 — schema: campi obbligatori, tipo, lunghezza, valori consentiti, unicità e relazioni tra riferimenti.
Livello 2 — commerciale: IVA, prezzo di listino e prezzo di vendita, margine minimo di contribuzione, scorte, idoneità alla vendita e diritti sui contenuti multimediali.
Livello 3 — esperienza: visualizzazione su dispositivi mobili, selezione delle varianti, aggiunta al carrello, ricerca/filtri, informazioni di consegna e checkout.
Il report automatizzato di riconciliazione dovrebbe mostrare almeno il numero di prodotti nella fonte rispetto alle righe importate; il numero di SKU e codici a barre univoci; i totali di prodotti padre e varianti; i prodotti pubblicati, in bozza e in quarantena; le immagini non accessibili; e le anomalie di prezzo o scorte. Aggiungi controlli a campione da parte di una persona per ogni categoria.
Esempio pratico di migrazione
Consideriamo un brand di articoli per la casa con 600 righe di prodotti su Trendyol. L’analisi iniziale rivela che corrispondono a 420 prodotti padre e 180 varianti. La prima fase riguarda 80 prodotti padre venduti negli ultimi 90 giorni e con scorte affidabili. La mappatura delle categorie definisce 12 categorie di destinazione, 46 attributi obbligatori e sette conversioni di unità. I prodotti vengono inseriti in un negozio in bozza; 11 codici a barre mancanti, otto SKU duplicati e 17 immagini non accessibili vengono messi in quarantena. Nessun prodotto viene pubblicato finché questi problemi non sono risolti. Dopo l’approvazione, si pubblicano prima 10 prodotti e poi tutti gli 80; 20 ordini di prova verificano scorte, spedizione e resi dall’inizio alla fine.
Matrice RACI: chi è responsabile di ogni decisione sulla migrazione?
| Flusso di lavoro | Responsabile operativo | Responsabile ultimo | Consultati | Informati |
|---|---|---|---|---|
| Connessione ufficiale e sicurezza | Integrazione/tecnologia | Responsabile tecnologia | Referente dell’account Trendyol | E-commerce |
| Mappatura dei campi e delle categorie | Gestione del catalogo | Responsabile e-commerce | Prodotto, SEO | Assistenza |
| Prezzi e imposte | Finance | Responsabile Finance | E-commerce | Management |
| Diritti su contenuti multimediali e testi | Brand/contenuti | Responsabile brand | Legal | Team catalogo |
| Scorte e ordini | Operations | Responsabile Operations | Tecnologia, Finance | Assistenza |
| Decisione di avvio | Project manager | Responsabile e-commerce | Tutti i responsabili dei flussi di lavoro | Azienda |
Checklist per l’avvio
- Sono state verificate la documentazione ufficiale V2 aggiornata e le autorizzazioni dell’account?
- L’identità sulla fonte e lo SKU del brand sono separati e tracciabili?
- Le mappature di categorie e attributi sono versionate e approvate?
- Sono stati convalidati la matrice delle varianti, l’unicità dei codici a barre e i collegamenti ai contenuti multimediali?
- Sono state testate le regole su prezzi, imposte, margine minimo e scorte di sicurezza?
- È possibile rieseguire l’integrazione senza generare prodotti duplicati?
- È stato nominato un responsabile per la coda degli errori, gli avvisi, i nuovi tentativi e le correzioni manuali?
- Sono stati testati almeno uno scenario di annullamento, uno di reso e uno di esaurimento scorte con un ordine realistico?
Una volta stabilizzata la migrazione del catalogo, non limitarti a pubblicare i prodotti nel nuovo negozio. Collega alcune collezioni selezionate alle vetrine dei creator per generare domanda per il nuovo canale. Per il passaggio successivo, consulta la guida ai feed per le vetrine dei creator.
Inizia la procedura di onboarding per i venditori e-commerce oppure crea un account brand per portare il tuo catalogo su un canale di proprietà e in una rete di vendita con influencer, seguendo un processo controllato.