Guida al Plugin di Integrazione

Configurazione Generale

• Registrati per un account sviluppatore sulla TikTok Shop Open Platform.

• Accedi all'account e clicca su "Crea un'app".

• Quando crei l'app, prendi nota del Redirect callback URL. Questo è l'URL associato a Magento. Il formato comune è l'URL di Magento seguito da /tts/authorization/code

Esempio:

URL di Magento: http://abc.ttsmagento.com

Il Redirect callback URL dovrebbe essere http://abc.ttsmagento.com/tts/authorization/code

• Dopo aver creato l'app, apri Magento.

• Nella barra laterale dell'Amministratore, vai su Negozio -> Impostazioni -> Configurazione.

• Nel pannello a sinistra, espandi TikTok Shop Connector e scegli TikTok Shop Configuration.

• Espandi la sezione Generale.

App Key/App Secret - Vai su Console -> Gestione App -> Elenco App e seleziona l'app nella TikTok Shop Open Platform. Inserisci nuovamente l'App Key e l'App Secret di TikTok Shop in Magento.

API URL - L'URL utilizzato quando si chiama l'API.

Authorize API URL - L'URL utilizzato per autorizzare l'account TikTok Shop.

Authorize State - Questo viene generato automaticamente durante l'installazione. L'utente non ha bisogno di impostare parametri aggiuntivi.

• Espandi la sezione Dinamico.

• Clicca su Ottieni Access Token. Verrà visualizzata automaticamente una pagina di autorizzazione.

  

• Seleziona il tipo di account.

  

• Accedi all'account TikTok Shop.

  

• Seleziona la casella per accettare i termini e clicca su Autorizza.

  

• La pagina tornerà automaticamente su Magento e visualizzerà questa notifica.

• Clicca su OK.

  

• La pagina si aggiornerà e le informazioni nel modulo Dinamico verranno scritte.

  

• Poiché un account TikTok Shop può avere più negozi, è necessario selezionare un negozio da associare a Magento. Clicca su Carica l'elenco degli ID negozio e seleziona il negozio di destinazione in Shop Id.

  

Spinta Iniziale del Prodotto

La versione iniziale di questo connettore supporta la spinta di prodotti semplici e configurabili da Magento a TikTok Shop.

Passo 1: Mappatura delle Categorie

Nell'interfaccia del connettore, puoi scegliere una categoria di Magento a qualsiasi livello e mappare questa con una categoria di prodotto TikTok Shop di terzo livello.

• Nella barra laterale dell'Amministratore, vai su CATALOGO -> Categoria.

• Nella struttura delle categorie, apri la categoria per modificarla.

• In Categorie in TikTok Shop, seleziona una categoria di prodotto TikTok Shop di terzo livello.

  

• Al termine, clicca su Salva nell'angolo in alto a destra della pagina.

• Ripeti questo processo per ogni categoria che deve essere mappata.

Passo 2: Mappatura degli Attributi del Prodotto

La mappatura degli attributi del prodotto è un passaggio importante. Se le proprietà richieste non corrispondono, la spinta del prodotto fallirà. Il connettore mapperà automaticamente gli attributi del prodotto per i prodotti nella categoria scelta se gli attributi sono esattamente corrispondenti. I commercianti possono anche associare manualmente gli attributi del prodotto di Magento con gli attributi del prodotto di TikTok Shop nell'interfaccia utente.

• Nella barra laterale dell'Amministratore, vai su Negozio -> Impostazioni -> Configurazione.

• Nel pannello a sinistra, espandi TikTok Shop Connector e scegli Prodotti.

  

Etichetta	Descrizione
Categoria	La categoria determina l'ambito delle proprietà del prodotto e di vendita. Le diverse categorie di TikTok Shop hanno attributi diversi che supportano la scelta multipla.
Attributi del Prodotto/Attributi di Vendita	Per abbinare gli attributi dei prodotti di Magento con gli attributi dei prodotti di TikTok Shop, le opzioni degli attributi di TikTok verranno visualizzate in base alla Categoria. Se la Categoria è vuota, il campo scomparirà.
Marca/Larghezza Pacchetto/Altezza Pacchetto/Codice Identificativo del Prodotto/Tipo Codice Identificativo	Attributi inerenti di TikTok Shop. Scegli l'attributo di corrispondenza/mappatura in Magento.

Nota: Colore/Taglia/Codice Identificativo del Prodotto richiedono impostazioni aggiuntive perché devono essere sincronizzati con la variazione del prodotto configurabile. Se non vengono impostati, Magento non può recuperare questi valori durante la sincronizzazione.

Come impostare:

• Nella barra laterale dell'Amministratore in Magento, vai su Negozio -> Attributo -> Prodotto.

• Clicca sull'attributo target.

• Nel pannello a sinistra, scegli Proprietà del Negozio.

• Imposta Usato nella Lista Prodotti su Sì.

  

Passo 3: Spinta del Prodotto

Per Spingere un Singolo Prodotto

• Nella barra laterale dell'Amministratore in Magento, vai su CATALOGO -> Prodotti.

• Nella lista dei prodotti, seleziona la casella accanto al prodotto target da spingere su TikTok Shop. Se necessario, imposta i filtri in cima a ciascuna colonna per visualizzare solo i record che vuoi includere.

  

• Imposta il controllo Azioni su Azione TikTok Shop e seleziona Spingi Prodotto.

  

• Seleziona il negozio e il magazzino di destinazione. Al termine, clicca su Procedi e tornerai automaticamente alla pagina della lista.

  

• Se la spinta ha successo, verrà visualizzata una notifica di successo nella parte superiore della pagina della lista dei prodotti.

  

• Se la spinta fallisce, verrà visualizzata una notifica di errore nella parte superiore della pagina. Controlla gli attributi del prodotto in base al messaggio di errore e riprova a spingere il prodotto.

• Una volta che i prodotti sono stati spinti su TikTok Shop, gli ID dei prodotti di TikTok Shop verranno restituiti dal connettore a Magento. TikTok Shop Synced verrà aggiornato su Sì, e questi ID saranno registrati nei prodotti corrispondenti in Magento per future mappature dei prodotti. Puoi verificare queste informazioni nella pagina della lista dei prodotti.

  

• Puoi anche trovare questo prodotto cercando il suo ID di prodotto di TikTok Shop in TikTok Shop.

  

Per la Spinta in Lotti

• Seleziona più caselle di controllo dei prodotti target o utilizza una delle seguenti azioni per selezionare un gruppo di record:

  • Seleziona o deseleziona tutto

  • Seleziona o deseleziona tutto in questa pagina

• Se necessario, imposta i filtri in cima a ciascuna colonna per visualizzare solo i record che desideri includere.

  

• Ripeti il processo per la spinta di un singolo prodotto.

• Al termine, verrà visualizzata una notifica con il risultato della spinta nell'interfaccia utente.

  

Nota: Permetti al programma di aggiornare e processare i dati. (Questo potrebbe richiedere qualche minuto.)

Notifica di Spinta Prodotto Riuscita

• Una notifica di spinta prodotto riuscita apparirà sul sito web Magento nella parte superiore della pagina.

• Clicca su "Visualizza Dettagli."

• La notifica mostrerà il numero di articoli che sono stati spinti con successo su TikTok Shop.

  

  

Gestione/aggiornamenti Prodotti in Corso

Per i prodotti che sono stati spinti con successo su TikTok Shop, gli aggiornamenti futuri delle informazioni sui prodotti sono limitati a inventario e prezzo in questa versione iniziale.

Impostazione di Aggiornamento Manuale del Prodotto

• Nella barra laterale dell'Amministratore in Magento, vai su CATALOGO -> Prodotti.

• Nella lista dei prodotti, seleziona ciascun record che desideri aggiornare.

• Imposta il controllo Azioni su Azione TikTok Shop e clicca su Spingi Prezzo/Spingi Stock.

• (Visualizza in Magento):

  

• Se selezioni "Spingi Prezzo", sarà necessario selezionare il negozio target. Se selezioni "Spingi Stock", sarà necessario selezionare sia il negozio target che il magazzino. Dopo il completamento, clicca su Procedi nell'angolo in alto a destra della pagina e tornerai automaticamente alla pagina della lista.

  

• Una notifica con il risultato della spinta verrà mostrata nell'interfaccia utente.

  

• Se la spinta ha successo, puoi verificare se le informazioni sul prodotto in TikTok Shop sono state sincronizzate con Magento.

Impostazione di Spinta Automatica dei Prodotti

Il connettore TikTok Shop Magento supporta la sincronizzazione automatica di inventario e prezzo. Quando i dati del prezzo e dell'inventario cambiano, il connettore sincronizzerà automaticamente le informazioni con TikTok Shop. La spinta automatica e manuale daranno gli stessi risultati e aggiorneranno i prodotti da Magento a TikTok Shop.

Step 1: Configurazione Prezzo & Inventario

• Nella barra laterale dell'Amministratore in Magento, vai su Store -> Settings -> Configuration.

• Nel pannello a sinistra, espandi TikTok Shop Connector e scegli Price & Inventory Sync.

• Espandi le sezioni Price Sync Setting e Inventory Sync Setting.

• Imposta Enable su Yes.

  

• Al termine, clicca su Save Config.

Step 2: Configurazione dell'Indice

• Nella barra laterale dell'Amministratore in Magento, vai su System -> Tools -> Index Management.

• Seleziona la casella di Product EAV/Inventory/Stock/Product Price/Catalog Search.

• Imposta il controllo Azioni su Update by Schedule e clicca su Submit.

  

Spinta Automatica degli Ordini

Quando un ordine viene effettuato su TikTok Shop, il connettore spingerà automaticamente l'ordine su Magento.

Come controllare un ordine:

• Nella barra laterale dell'Amministratore, vai su SALES -> Orders.

• Puoi sfogliare la lista pagina per pagina o cercare ordini specifici. Usa i controlli standard per ordinare e filtrare la lista, quindi applica le azioni sugli ordini selezionati.

• Se il prodotto ordinato è sincronizzato da TikTok Shop, la casella accanto all'ordine mostrerà TTS order come Yes.

• Visualizza in Magento:

  

Adempimento Ordini (In Arrivo)

Lo stato dell'ordine (non pagato, in attesa di spedizione, in attesa di raccolta, ecc.) in TikTok Shop e Magento sarà registrato durante la configurazione iniziale per la sincronizzazione futura degli ordini. Quando lo stato dell'ordine cambia in TikTok Shop, si sincronizzerà anche in Magento.

Ordine di Spedizione della Piattaforma

Se l'opzione di spedizione è Spedizione Standard, l'ordine viene evaso in TikTok Shop. Lo stato dell'ordine e i dettagli (informazioni sul tracciamento) verranno spinti da TikTok Shop a Magento e la spedizione sarà organizzata in TikTok Shop.

Fase 1: Non Pagato

Quando il cliente ordina un prodotto ma non ha ancora pagato in TikTok Shop, lo stato dell'ordine in TikTok Shop è Non Pagato, e Magento non registrerà l'ordine.

(Vedi in TikTok Shop):

Fase 2: In Attesa di Spedizione

Quando il cliente paga per l'ordine, lo stato dell'ordine in TikTok Shop diventerà "In Attesa di Spedizione", e non ci sarà ancora un record dell'ordine in Magento.

Fase 3: In Attesa di Ritiro

Dopo che la spedizione dell'ordine è stata organizzata, lo stato dell'ordine cambierà in "In Attesa di Ritiro" in TikTok Shop, e l'ordine verrà sincronizzato con Magento. Lo stato dell'ordine in Magento sarà "Completato", e potrai trovare l'ID dell'ordine di TikTok Shop nei dettagli dell'ordine.

La fattura e la spedizione verranno create. Per verificarlo, clicca nel pannello a sinistra dei dettagli dell'ordine e scegli "Fatture" o "Spedizioni."

Fase 4: Consegnato

Dopo che il pacco viene consegnato, lo stato dell'ordine in TikTok Shop cambierà in "Consegnato", ma rimarrà invariato in Magento.

Fase 5: Completato

Dopo che lo stato dell'ordine cambia in "Completato" in TikTok Shop, lo stato rimarrà invariato in Magento.

Spedizione da Parte del Commerciante

Se l'opzione di spedizione è "Spedito dal Venditore", la spedizione dell'ordine sarà evasa in Magento. L'aggiornamento della spedizione verrà inviato da Magento a TikTok Shop, includendo le informazioni di tracciamento. Questo accadrà con il cambiamento dello stato dell'ordine in Magento.

Entrambi i tipi di ordini hanno lo stesso stato nelle prime due fasi. Se lo stato dell'ordine è Non Pagato in TikTok Shop, non ci sarà alcun record di questo ordine in Magento. Quando il cliente paga per l'ordine, lo stato dell'ordine diventerà "In Attesa di Spedizione". A questo punto, l'ordine verrà sincronizzato con Magento. Dopo che lo stato dell'ordine sarà "In elaborazione" in Magento, l'ID dell'ordine di TikTok Shop potrà essere trovato nei dettagli dell'ordine.

Ricorda di aggiornare le informazioni di tracciamento in Magento se l'opzione di spedizione è "Spedito dal venditore."

Come aggiornare:

• Nella barra laterale dell'Amministratore in Magento, vai su SALES > Orders.

• Clicca sull'ordine per entrare nei dettagli dell'ordine.

• Nel pannello in alto, scegli Ship per entrare in "Nuova Spedizione."

• Clicca su Aggiungi Numero di Tracciamento.

• Seleziona il Corriere e inserisci il Numero di Tracciamento. Un fornitore di spedizione di TikTok Shop verrà creato in Magento durante la configurazione del connettore. Puoi scegliere un corriere supportato da TikTok Shop.

• Quando completato, clicca su Invia Spedizione.

• Nel pannello a sinistra, scegli Spedizione. Verrà creata una spedizione, e le informazioni di tracciamento possono essere verificate cliccando sulla spedizione.

• Lo stato dell'ordine sarà "Completato" in Magento, e le informazioni di tracciamento verranno inviate a TikTok Shop. Lo stato dell'ordine sarà "In Transito" in TikTok Shop.

Reso e Rimborso

Il processo di reso e rimborso verrà avviato, elaborato e completato in TikTok Shop. Una volta completato, questo aggiornamento verrà sincronizzato con Magento, e Magento creerà una nota di credito per questo ordine in base all'importo del rimborso. Lo stato dell'ordine verrà automaticamente cambiato in "Chiuso".

Come verificarlo:

• Quando il processo è completato in TikTok Shop, vai su SALES > Orders nella barra laterale dell'Amministratore di Magento.

• Clicca sull'ordine target per entrare nei dettagli dell'ordine.

• Nel pannello a sinistra, scegli "Credit Memos". Una nota di credito è stata creata, e le informazioni sul rimborso possono essere verificate cliccando su questa nota.