Naar hoofdinhoud
Plytix

Plytix API vanuit Odoo: sleutel, wachtwoord, token en limieten

Voor de Plytix API heb je een API-sleutel met wachtwoord nodig, een token dat na 900 seconden verloopt, en je moet twee limieten tegelijk respecteren. De Plytix-koppeling voor Odoo doet dat voor je via FlexigoTech Cloud. Dit vraagt de API en zo ziet het eruit in Odoo.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 14 november 2026

In het kort

Module
Plytix
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
4 min

De sleutel en het wachtwoord van de Plytix API

In Plytix maak je de sleutel aan onder Account, dan API en dan API Keys. Alleen gebruikers met de rol Owner of Admin kunnen dat. Bij elke sleutel toont Plytix een wachtwoord. De API heeft ze allebei nodig.

In Odoo plak je ze onder Plytix › Configuratie › Plytix-accounts, in de velden API-sleutel en API-wachtwoord. Ze gaan samen of helemaal niet: ontbreekt er één, dan verstuurt de koppeling niets. Voordat je ze opslaat, moet een beheerder accepteren dat FlexigoTech Cloud ze bewaart.

Dashboard van de Plytix-koppeling in Odoo
Plytix in Odoo: het gekoppelde account en de vier stappen om te starten (demogegevens).

Het token dat 900 seconden geldig is

De Plytix API authenticeert in twee stappen. Eerst ruil je het paar van sleutel en wachtwoord bij de authenticatiedienst van Plytix in voor een token. Dat token is precies 900 seconden geldig. Daarna draagt elke aanroep het token.

Koppel je Plytix zelf, dan moet je het paar bewaren, het token opvragen en het vernieuwen voordat het verloopt. Met de koppeling doet FlexigoTech Cloud dat. Het bewaart het paar versleuteld, vraagt het token op, vernieuwt het en zet het op elke aanroep. Odoo bewaart het paar niet en het token ook niet.

Twee limieten tegelijk

Plytix beperkt aanroepen met twee tellers tegelijk: één per 10 seconden en één per uur. Beide hangen af van je abonnement. De koppeling remt al af vóór het versturen, om er niet overheen te gaan. Gaat ze er toch overheen, dan antwoordt Plytix met een 429 die zegt hoe lang je moet wachten (header Retry-After) en wat de limiet is (RateLimit-Limit en RateLimit-Window).

De prijspagina van Plytix (www.plytix.com/pricing, gelezen op 12 november 2026) geeft het abonnement Standard 2.000 aanroepen per uur, Pro 15.000 en Enterprise 25.000. Standard is alleen gratis tot 100 SKU's; met meer SKU's betaal je ervoor. De API-documentatie van Plytix voegt toe dat de limieten van het abonnement afhangen en dat je accountmanager de limieten van jouw account bevestigt.

In het Odoo-account kies je je abonnement in het veld Abonnement, en de koppeling vult beide limieten in:

  • Standard: 20 aanroepen per 10 seconden en 2.000 per uur.
  • Pro: 50 aanroepen per 10 seconden en 15.000 per uur.
  • Enterprise: 50 aanroepen per 10 seconden en 25.000 per uur.
  • Eigen limieten: die beginnen bij 20 en 2.000, en die vul je zelf in.

Dit zijn de cijfers van versie 1.3.0 van de koppeling; de cijfers per uur komen van de prijspagina van Plytix. Bij de update gaat een account dat nog de eerdere cijfers heeft (Standard 5.000 per uur, Enterprise 15.000) vanzelf naar de nieuwe, en een account waarvan iemand de limieten heeft gewijzigd blijft zoals het was. Beide limietvelden kun je met de hand aanpassen en ze accepteren niet minder dan 1 aanroep. Komt er een 429, dan slaat de koppeling de limiet die Plytix noemt op in het account en wacht ze zo lang als Plytix vraagt: tot 15 seconden binnen dezelfde aanroep; duurt het wachten langer, dan pauzeert ze de synchronisatie zonder iets als mislukt te markeren, en wat overblijft gaat daarna weg.

Zoekopdrachten: 20 attributen en 100 resultaten per pagina

Zoekopdrachten van de Plytix API geven standaard weinig velden terug. Elk attribuut moet je bij naam opvragen, en Plytix staat er hoogstens 20 per zoekopdracht toe. Heb je er meer nodig, dan doet de koppeling meerdere rondes en voegt ze samen op de product-ID. Elke pagina levert hoogstens 100 resultaten. Daarboven antwoordt de API met een fout 422.

Wat de koppeling met de API doet

De koppeling matcht producten, varianten en subvarianten op SKU. Identificeert de SKU het record niet, dan maakt ze geen koppeling. Je vindt dit onder Plytix › Producten › Matchen op SKU en de import onder Plytix › Producten › Importeren uit Plytix.

Er zijn twee geplande taken voor wijzigingen: gewijzigde producten elke 6 uur importeren en elke 12 uur exporteren. Beide staan standaard uit. Je zet ze aan nadat je de veldkoppeling en de richting van elke synchronisatie hebt gecontroleerd.

Lijst met producten die aan Plytix gekoppeld zijn in Odoo
Gekoppelde producten: wat uit Plytix komt en of het actueel is (demogegevens).

Wat je nodig hebt

Je hebt een actief Plytix-account met API-sleutel nodig. De koppeling staat in Odoo Apps voor Odoo 17, 18, 19 en 20 en heeft het abonnement op FlexigoTech Cloud nodig. Alle details staan op de pagina van de koppeling.

Waar staat de documentatie van de Plytix API?

Op apidocs.plytix.com. De koppeling werkt via HTTPS met de REST-API van Plytix.

Wat gebeurt er als Plytix met een 429 antwoordt?

De koppeling remt al af vóór het versturen, op basis van de limieten van het account. Komt er toch een 429, dan slaat ze de limiet op die Plytix noemt en wacht ze zo lang als Plytix vraagt, tot 15 seconden binnen dezelfde aanroep. Duurt het wachten langer, dan pauzeert de synchronisatie zonder iets als mislukt te markeren, en wat overblijft gaat weg zodra Plytix het toelaat.

Kan ik het gratis abonnement van Plytix gebruiken?

Ja, als je tot 100 SKU's beheert: zoveel geeft Plytix volgens zijn prijspagina gratis bij Standard. In het account kies je Standard en de koppeling begint met 20 aanroepen per 10 seconden en 2.000 per uur. De koppeling heeft wel het abonnement op FlexigoTech Cloud nodig.

Bewaart Odoo mijn Plytix-sleutel?

Nee. FlexigoTech Cloud bewaart de sleutel en het wachtwoord, versleuteld, na toestemming van een beheerder.

Lees verder

Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen

  • Broncode van de module: flexigobe_plytix_connector 20.0 (6d411531): __manifest__.py
  • Broncode van de module: flexigobe_plytix_connector 20.0 (6d411531): static/description/index.html
  • Broncode van de module: flexigobe_plytix_connector 20.0 (6d411531): models/plytix_account.py
  • Broncode van de module: flexigobe_plytix_connector 20.0 (6d411531): data/plytix_cron_data.xml
  • Broncode van de module: flexigobe_plytix_connector 20.0 (6d411531): views/plytix_menus.xml
  • Broncode van de module: flexigobe_plytix_connector 20.0 (6d411531): models/plytix_api_client.py
  • www.plytix.com/pricing/
  • docs.plytix.com/reference/v1-v2/rate-limits/
  • Broncode van de module: flexigobe_plytix_connector 20.0 (40f61773): models/plytix_account.py
  • Broncode van de module: flexigobe_plytix_connector 20.0 (40f61773): migrations/1.3.0/post-migrate.py
  • Broncode van de module: flexigobe_plytix_connector 20.0 (40f61773): models/plytix_api_client.py