TikTok Shop & Pinterest-catalogus koppeling: installatie en configuratie

Overzicht

De module koppelt uw PrestaShop 8- of 9-winkel aan twee kanalen:

• TikTok Shop: aanbiedingen aanmaken en bijwerken via de Partner API, voorraad en prijzen versturen, bestellingen importeren, trackingnummers terugsturen.
• Pinterest: TSV-catalogusfeed en, optioneel, realtime-updates via de Catalogs API.

Er is ook een CSV-feed voor TikTok Ads-catalogi. De module staat onder Catalogus > TikTok & Pinterest. Het tabblad Overzicht toont een startchecklist met de resterende stappen.

Installatie

1. Klik in Modules > Modulebeheer op Een module uploaden en kies het ZIP-bestand.
2. Open Catalogus > TikTok & Pinterest.
3. Controleer in het tabblad Instellingen de taal, valuta en het land voor de prijzen (prijzen gaan incl. btw van dat land), en het afbeeldingsformaat. TikTok Shop vereist minstens 600 x 600 pixels.

Pinterest

Alleen feed, zonder app

1. Tabblad Pinterest: schakel Pinterest in en kopieer de feed-URL.
2. Open in Pinterest Business Hub Catalogi > Gegevensbronnen, voeg een bron toe en plak de URL. Pinterest importeert de feed elke 24 uur.

Realtime-updates via de API

1. Maak op developers.pinterest.com een app aan en voeg de redirect-URI uit het Pinterest-tabblad van de module toe.
2. Vul App ID en App secret in, laat Realtime-updates op Ja en klik op Opslaan en Pinterest koppelen.
3. Klik na de koppeling op Gegevensbron op Pinterest aanmaken: de module registreert de feed met de valuta en het land uit de instellingen.

Voorraad-, prijswijzigingen en verwijderingen gaan dan binnen enkele minuten door. Twee minuten na elke verzending leest de module het resultaat van Pinterest. Een afgewezen artikel staat in het tabblad Producten als fout, met de melding van Pinterest.

TikTok Shop

De TikTok Shop-app aanmaken

1. Maak op partner.tiktokshop.com een eigen verkopersapp of een app van een externe dienst aan.
2. Schakel de scopes Product, Order, Fulfillment en Logistics in.
3. Stel als redirect-URL de URL in die in het tabblad TikTok Shop van de module staat.
4. Kopieer de App key, het App secret en, als de app er een heeft, de Service ID.

De winkel koppelen

1. Tabblad TikTok Shop: schakel TikTok in, kies de regio (Europa en rest van de wereld, of Verenigde Staten), vul de gegevens in en klik op Opslaan en TikTok Shop koppelen.
2. Geef de app toestemming op de TikTok-pagina. De module haalt de winkel en het standaardmagazijn op.
3. Kies het magazijn als u er meerdere hebt, en daarna de fabrikant en verantwoordelijke persoon voor de EU. Zijn de lijsten leeg, maak ze dan eerst aan in Seller Center en klik op Lijsten vernieuwen.
4. Klik op Categorieën laden om de TikTok-categorieboom op te halen.

Instellingen van de aanbiedingen

• Verzonden prijs: prijs na PrestaShop-kortingen, of normale prijs als u acties in TikTok beheert.
• Standaardpakket: gewicht en afmetingen voor producten zonder eigen waarden.
• Nieuwe aanbiedingen aanmaken: staat dit uit, dan werkt de module alleen voorraad en prijs van bestaande aanbiedingen bij.

Aanbiedingen die al op TikTok Shop staan

Verkoopt u al op TikTok Shop, start dan Bestaande aanbiedingen koppelen in het tabblad TikTok Shop vóór de eerste synchronisatie. De module koppelt uw aanbiedingen via de verkopers-SKU aan uw producten:

• combinatiereferentie;
• productreferentie, voor een product zonder combinaties;
• het formaat PS12 of PS12-34 dat de module gebruikt.

Een gekoppelde aanbieding behoudt haar TikTok-titel, afbeeldingen en beschrijving: de module beheert alleen voorraad en prijs. Om de PrestaShop-inhoud toe te passen, opent u het productvoorbeeld in het tabblad Producten en klikt u op Inhoud vervangen door PrestaShop-gegevens. Een aanbieding waarvan de SKU’s naar meerdere producten wijzen, wordt als conflict gemeld en niet gekoppeld.

Categoriekoppeling

Het tabblad Categorieën koppelt elke PrestaShop-categorie aan:

• een Google-categorie, gebruikt door Pinterest en de TikTok Ads-feed: typ een paar woorden en kies uit de ingebouwde Google-taxonomie;
• een TikTok Shop-categorie: typ om te zoeken, of klik op Voorstellen zodat TikTok een categorie voorstelt op basis van uw producten.

Een subcategorie zonder eigen koppeling neemt die van de bovenliggende categorie over, grijs weergegeven. Producten gebruiken hun standaardcategorie. Wijzigingen worden samen opgeslagen met Wijzigingen opslaan.

De knop Attributen opent de attributen van de TikTok-categorie. Die met een sterretje zijn verplicht en gelden voor alle producten van de categorie. De koppeling kan als CSV (puntkomma) worden geëxporteerd en geïmporteerd.

TikTok-bestellingen

Het tabblad TikTok-bestellingen voorkomt oververkoop: zonder import verlaagt een TikTok-verkoop alleen de voorraad bij TikTok. Er zijn drie modi:

• PrestaShop-bestellingen aanmaken: elke verkoop wordt een bestelling tegen de op TikTok betaalde prijs (na verkoperskorting) en met de TikTok-verzendkosten. PrestaShop berekent de btw en de voorraad daalt. De betaling staat als „TikTok Shop”, met het TikTok-bestelnummer als transactie.
• Alleen voorraad verlagen: voor bestellingen die via Seller Center of door TikTok worden verzonden.
• Uit.

Bestellingen worden via de cron geïmporteerd. Bij het inschakelen worden de bestellingen van de laatste 24 uur opgehaald. Kies de status van nieuwe bestellingen en de vervoerder. De verzendkosten blijven die van TikTok, ongeacht de vervoerder.

• Annuleringen: een TikTok-annulering zet de bestelling op „Geannuleerd”, of zet in de alleen-voorraadmodus de voorraad terug.
• Fouten: een bestelling met fout (niet-gekoppelde SKU, valuta niet actief) staat in de lijst met de reden en wordt elke 15 minuten opnieuw geprobeerd. Met Opnieuw wordt ze bij de volgende import opnieuw geprobeerd.
• Kopers: ze worden aangemaakt als gastklant met een @tiktokshop.invalid-adres. TikTok verbiedt contact buiten het platform, dus de module blokkeert elke e-mail aan hen.

De PrestaShop-bestelpagina toont een TikTok Shop-blok met het TikTok-nummer, de status en de trackingstatus.

Trackingnummers

Wordt een trackingnummer toegevoegd aan een geïmporteerde bestelling, met de hand of door een vervoerdersmodule, dan gaat het binnen 5 minuten naar TikTok en wordt de TikTok-bestelling als verzonden gemarkeerd. Door TikTok afgehandelde bestellingen worden overgeslagen.

TikTok vraagt een verzendpartner. Koppel in het tabblad TikTok Shop, sectie Vervoerders en TikTok-verzendpartners, elke vervoerder aan een TikTok-partner. Zonder koppeling zoekt de module een partner met dezelfde naam. Vindt ze er geen, dan somt de fout de beschikbare partners op.

Tabblad Producten

Elke regel toont miniatuur, prijs, voorraad, status per kanaal en een kwaliteitsscore op 100 met het belangrijkste probleem. Mogelijke oorzaken zijn:

• ontbrekende afbeelding, prijs nul of korte beschrijving;
• ongeldige EAN;
• niet-gekoppelde categorie;
• meer dan 3 attribuutgroepen voor TikTok.

Filters tonen producten met fouten, uitgesloten producten, producten zonder Google- of TikTok-categorie, of gekoppeld vanuit Seller Center. Vink producten aan om ze in bulk te exporteren, uit te sluiten of een volledige synchronisatie in te plannen. Het voorbeeld toont de varianten zoals ze worden verzonden en laat een titel per kanaal instellen. Nu synchroniseren verstuurt het product direct.

Geavanceerde instellingen

• UTM-parameters: toegevoegd aan de links van de feeds en Pinterest-pins voor attributie in Google Analytics. Leeg laten om uit te schakelen.
• Aangepaste labels: custom_label_0 = categorie, custom_label_1 = prijsklasse, custom_label_2 = actie of normaal.
• Uitsluitingsregels: categorieën (met subcategorieën), merken, minimumprijs incl. btw, en varianten zonder voorraad die uit de feeds en van Pinterest worden gehaald. Een uitgesloten product verdwijnt uit de feeds, wordt van Pinterest verwijderd en op TikTok Shop gedeactiveerd. Een gewijzigde regel zet de hele catalogus opnieuw in de wachtrij.
• Moment van verzenden: direct na elke wijziging (PHP-FPM- of LiteSpeed-hosting) of alleen via cron.

Cron-taak

Kopieer de twee regels uit het tabblad Overzicht naar de crontab van uw hosting:

• elke 5 minuten task=sync: wachtrij, herhalingen, TikTok-bestellingen, tracking, Pinterest-resultaten;
• elk uur task=feeds: opnieuw genereren van de feeds.

Het overzicht toont of de cron in de laatste 20 minuten is gezien. Een API-fout wordt na 2, 4, 8, 16 en 32 minuten opnieuw geprobeerd.

Logboek en probleemoplossing

Het tabblad Logboek bewaart 30 dagen aan gebeurtenissen, filterbaar per kanaal: Pinterest, TikTok, TikTok-bestellingen. API-fouten worden met het volledige antwoord bewaard.

• Een product gaat niet naar TikTok: controleer de score in het tabblad Producten. Een ontbrekende TikTok-categorie of een virtueel product blokkeert het verzenden.
• Een TikTok-bestelling blijft in fout: de verkopers-SKU moet overeenkomen met een PrestaShop-referentie, of de aanbieding moet door de module zijn aangemaakt. Corrigeer en klik op Opnieuw.
• Wijzigingen van een medewerker gaan niet door: PrestaShop voert de hooks van een module niet uit voor een profiel zonder recht „Bekijken” op die module. Geef dat recht, of gebruik Nu synchroniseren in het tabblad Producten.