# Connettore TikTok Shop e Catalogo Pinterest: installazione e configurazione > Presentazione Il modulo collega il tuo negozio PrestaShop 8 o 9 a due canali: TikTok Shop: creazione e aggiornamento degli annunci con l'API Partner, invio di stock e prezzi, importazione… - Pagina: - Lingua: it - Aggiornato il: 2026-09-24 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dftiktokpinterest/index.md), [en](https://www.datafirefly.com/en/documentation/dftiktokpinterest/index.md), [es](https://www.datafirefly.com/es/documentation/dftiktokpinterest/index.md), [de](https://www.datafirefly.com/de/documentation/dftiktokpinterest/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftiktokpinterest/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftiktokpinterest/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftiktokpinterest/index.md) - Indice: ## Presentazione Il modulo collega il tuo negozio PrestaShop 8 o 9 a due canali: - **TikTok Shop**: creazione e aggiornamento degli annunci con l'API Partner, invio di stock e prezzi, importazione degli ordini, invio dei numeri di tracciamento. - **Pinterest**: feed di catalogo TSV e, se vuoi, aggiornamenti in tempo reale con l'API Catalogs. È incluso anche un feed CSV per i cataloghi TikTok Ads. Il modulo si trova in **Catalogo > TikTok & Pinterest**. La scheda _Panoramica_ mostra una checklist di avvio con i passaggi mancanti. ## Installazione 1. In **Moduli > Gestione moduli**, clicca su _Carica un modulo_ e scegli il file ZIP. 2. Apri **Catalogo > TikTok & Pinterest**. 3. Nella scheda _Impostazioni_, controlla lingua, valuta e paese usati per i prezzi (inviati IVA inclusa per quel paese) e la dimensione delle immagini. TikTok Shop richiede almeno 600 x 600 pixel. In multinegozio, seleziona un negozio nel selettore di contesto: le impostazioni dei canali sono salvate per negozio. ## Pinterest ### Solo feed, senza app 1. Scheda _Pinterest_: attiva Pinterest e copia l'URL del feed. 2. In Pinterest Business Hub apri **Cataloghi > Origini dati**, aggiungi un'origine e incolla l'URL. Pinterest importa il feed ogni 24 ore. ### Aggiornamenti in tempo reale via API 1. Su [developers.pinterest.com](https://developers.pinterest.com/), crea un'app e aggiungi l'URI di reindirizzamento mostrato nella scheda Pinterest del modulo. 2. Inserisci App ID e App secret, lascia _Aggiornamenti in tempo reale_ su Sì e clicca su _Salva e collega Pinterest_. 3. Una volta collegato, clicca su _Crea l'origine dati su Pinterest_: il modulo registra il feed con valuta e paese delle impostazioni. Variazioni di stock, prezzo e rimozioni partono in pochi minuti. Due minuti dopo ogni invio il modulo legge l'esito di Pinterest. Un articolo rifiutato risulta in errore nella scheda _Prodotti_ con il messaggio di Pinterest. ## TikTok Shop ### Creare l'app TikTok Shop 1. Su [partner.tiktokshop.com](https://partner.tiktokshop.com/), crea un'app venditore personalizzata o un'app di servizio di terze parti. 2. Attiva gli scope **Product**, **Order**, **Fulfillment** e **Logistics**. 3. Imposta come URL di reindirizzamento quello mostrato nella scheda _TikTok Shop_ del modulo. 4. Copia App key, App secret e, se presente, il Service ID. ### Collegare il negozio 1. Scheda _TikTok Shop_: attiva TikTok, scegli la regione (Europa e resto del mondo, o Stati Uniti), inserisci le credenziali e clicca su _Salva e collega TikTok Shop_. 2. Autorizza l'app sulla pagina TikTok. Il modulo recupera il negozio e il magazzino predefinito. 3. Scegli il magazzino se ne hai più di uno, poi produttore e persona responsabile per l'UE. Se gli elenchi sono vuoti, creali prima nel Seller Center e clicca su _Aggiorna elenchi_. 4. Clicca su _Carica le categorie_ per scaricare l'albero delle categorie TikTok. ### Impostazioni degli annunci - **Prezzo inviato**: dopo gli sconti PrestaShop, o prezzo normale se gestisci le promozioni su TikTok. - **Pacco predefinito**: peso e dimensioni per i prodotti che non li hanno. - **Crea nuovi annunci**: se disattivato, il modulo aggiorna solo stock e prezzo degli annunci già online. ## Annunci già presenti su TikTok Shop Se vendi già su TikTok Shop, avvia _Collega gli annunci esistenti_ nella scheda TikTok Shop **prima della prima sincronizzazione**. Il modulo collega gli annunci ai tuoi prodotti tramite SKU venditore: - riferimento della combinazione; - riferimento del prodotto, per un prodotto senza combinazioni; - formato PS12 o PS12-34 usato dal modulo. Un annuncio collegato mantiene titolo, immagini e descrizione TikTok: il modulo gestisce solo stock e prezzo. Per applicare il contenuto PrestaShop, apri l'anteprima del prodotto nella scheda Prodotti e clicca su _Sostituisci il contenuto con i dati PrestaShop_. Un annuncio i cui SKU puntano a più prodotti viene segnalato come conflitto e non collegato. ## Mappatura delle categorie La scheda _Categorie_ associa ogni categoria PrestaShop a: - una **categoria Google**, usata da Pinterest e dal feed TikTok Ads: digita qualche parola e scegli nella tassonomia Google integrata; - una **categoria TikTok Shop**: digita per cercare, oppure clicca su _Suggerisci_ perché TikTok proponga la categoria in base ai tuoi prodotti. Una sottocategoria senza mappatura propria eredita quella del genitore, mostrata in grigio. I prodotti usano la loro categoria predefinita. Le modifiche si salvano insieme con _Salva le modifiche_. Il pulsante _Attributi_ apre gli attributi della categoria TikTok. Quelli con l'asterisco sono obbligatori e valgono per tutti i prodotti della categoria. La mappatura si esporta e importa in CSV (separatore punto e virgola). ## Ordini TikTok La scheda _Ordini TikTok_ evita la sovravendita: senza importazione, una vendita su TikTok abbassa lo stock solo su TikTok. Le modalità sono tre: - **Crea ordini PrestaShop**: ogni vendita diventa un ordine al prezzo pagato su TikTok (sconto venditore dedotto) e con le spese di spedizione TikTok. L'IVA la calcola PrestaShop e lo stock scende. Il pagamento compare come «TikTok Shop», con il numero d'ordine TikTok come transazione. - **Scala solo lo stock**: per ordini spediti dal Seller Center o da TikTok. - **Disattivato**. Gli ordini vengono importati dal cron. All'attivazione vengono recuperati quelli delle ultime 24 ore. Scegli lo stato dei nuovi ordini e il corriere. Le spese di spedizione restano quelle pagate su TikTok, qualunque sia il corriere. - **Annullamenti**: un annullamento su TikTok porta l'ordine su «Annullato», o ripristina lo stock in modalità solo stock. - **Errori**: un ordine in errore (SKU non collegato, valuta non attiva) compare con il motivo ed è ritentato ogni 15 minuti. Il pulsante _Riprova_ lo ripropone alla prossima importazione. - **Acquirenti**: sono creati come clienti ospiti con un indirizzo @tiktokshop.invalid. TikTok vieta di contattarli fuori dalla piattaforma, quindi il modulo blocca qualsiasi e-mail a loro destinata. La scheda ordine PrestaShop mostra un blocco TikTok Shop con numero TikTok, stato e tracciamento. ## Numeri di tracciamento Quando un numero di tracciamento viene aggiunto a un ordine importato, a mano o da un modulo corriere, viene inviato a TikTok entro 5 minuti e l'ordine TikTok risulta spedito. Gli ordini evasi da TikTok sono ignorati. TikTok richiede un fornitore di spedizione. Nella scheda TikTok Shop, sezione _Corrieri e fornitori di spedizione TikTok_, associa ogni corriere a un fornitore TikTok. Senza associazione, il modulo cerca un fornitore con lo stesso nome. Se non lo trova, l'errore elenca i fornitori disponibili. ## Scheda Prodotti Ogni riga mostra miniatura, prezzo, stock, stato su ogni canale e un punteggio qualità su 100 con il problema principale. Le cause possibili sono: - immagine mancante, prezzo zero o descrizione breve; - EAN non valido; - categoria non associata; - più di 3 gruppi di attributi per TikTok. I filtri mostrano i prodotti in errore, esclusi, senza categoria Google o TikTok, o collegati dal Seller Center. Seleziona i prodotti per esportarli o escluderli in massa, o per mettere in coda una sincronizzazione completa. L'anteprima mostra le varianti come saranno inviate e permette un titolo per canale. _Sincronizza ora_ invia subito il prodotto. ## Impostazioni avanzate - **Parametri UTM**: aggiunti ai link dei feed e dei pin Pinterest per l'attribuzione in Google Analytics. Lascia vuoto per disattivarli. - **Etichette personalizzate**: custom_label_0 = categoria, custom_label_1 = fascia di prezzo, custom_label_2 = promo o normale. - **Regole di esclusione**: categorie (sottocategorie comprese), marchi, prezzo minimo IVA inclusa, e varianti esaurite tolte dai feed e da Pinterest. Un prodotto escluso viene tolto dai feed, eliminato da Pinterest e disattivato su TikTok Shop. Modificare una regola rimette in coda tutto il catalogo. - **Momento dell'invio**: subito dopo ogni modifica (hosting PHP-FPM o LiteSpeed), o solo tramite cron. ## Attività cron Copia le due righe della scheda _Panoramica_ nella crontab del tuo hosting: - ogni 5 minuti, `task=sync`: coda, nuovi tentativi, ordini TikTok, tracciamento, esiti Pinterest; - ogni ora, `task=feeds`: rigenerazione dei feed. La panoramica indica se il cron è stato visto negli ultimi 20 minuti. Un errore dell'API viene ritentato dopo 2, 4, 8, 16 e 32 minuti. Il token di sicurezza protegge gli URL dei feed e del cron. Se lo rigeneri, aggiorna la crontab e gli URL dei feed registrati su Pinterest e TikTok. ## Log e risoluzione dei problemi La scheda _Log_ conserva 30 giorni di eventi, filtrabili per canale: Pinterest, TikTok, ordini TikTok. Gli errori dell'API sono salvati con la risposta completa. - **Un prodotto non parte su TikTok**: controlla il suo punteggio nella scheda Prodotti. Una categoria TikTok mancante o un prodotto virtuale bloccano l'invio. - **Un ordine TikTok resta in errore**: lo SKU venditore deve corrispondere a un riferimento PrestaShop, o l'annuncio deve essere stato creato dal modulo. Correggi e clicca su _Riprova_. - **Le modifiche di un dipendente non partono**: PrestaShop non esegue gli hook di un modulo per un profilo senza permesso «Visualizza» su quel modulo. Concedi il permesso o usa _Sincronizza ora_ nella scheda Prodotti.