# 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.…

- Pagina: <https://www.datafirefly.com/nl/documentation/dftiktokpinterest/>
- Taal: nl
- Bijgewerkt op: 2026-09-24
- Andere talen: [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), [it](https://www.datafirefly.com/it/documentation/dftiktokpinterest/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftiktokpinterest/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftiktokpinterest/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## 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.

Kies bij multistore één winkel in de contextkiezer: de kanaalinstellingen worden per winkel opgeslagen.

## 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](https://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](https://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.

Het beveiligingstoken beschermt de feed- en cron-URL's. Maakt u een nieuw token aan, werk dan de crontab en de bij Pinterest en TikTok geregistreerde feed-URL's bij.

## 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.