Salta al contingut principal
Plytix

Plytix API des d'Odoo: clau, contrasenya, testimoni i límits de crides

Per parlar amb l'API de Plytix calen una clau d'API i la seva contrasenya, un testimoni que caduca als 900 segons i respectar dos límits de crides alhora. El connector de Plytix per a Odoo ho fa per tu a través de FlexigoTech Cloud. Això és el que demana l'API i com queda a Odoo.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 14 de novembre de 2026

L'essencial

Mòdul
Plytix
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

La clau i la contrasenya de l'API de Plytix

A Plytix, la clau es crea a Account, després API i després API Keys. Només els usuaris Owner i Admin la poden crear. Cada clau ve amb una contrasenya que Plytix mostra al costat. L'API necessita totes dues.

A Odoo les enganxes a Plytix › Configuration › Plytix accounts, als camps API Key i API Password. El connector no té traducció al català, i per això Odoo mostra aquests rètols en anglès. Van juntes o no va cap: si en falta una, el connector no envia res. Abans de desar-les, un administrador ha d'acceptar que FlexigoTech Cloud les guardi.

Tauler del connector de Plytix a Odoo
Plytix a Odoo: el compte connectat i els quatre passos de la posada en marxa (dades de demostració).

El testimoni que dura 900 segons

L'API de Plytix autentica en dos passos. Primer es canvia la parella de clau i contrasenya per un testimoni al servei d'autenticació de Plytix. Aquest testimoni dura exactament 900 segons. Després, cada crida porta el testimoni.

Si integres Plytix pel teu compte, has de guardar la parella, demanar el testimoni i renovar-lo abans que caduqui. Amb el connector ho fa FlexigoTech Cloud. Guarda la parella xifrada, demana el testimoni, el renova i el posa a cada crida. Odoo no guarda ni la parella ni el testimoni.

Dos límits de crides alhora

Plytix limita les crides amb dos comptadors alhora: un per cada 10 segons i un altre per hora. Tots dos depenen del teu pla. El connector es frena abans d'enviar per no passar-se'n. Si tot i així se'n passa, Plytix respon amb un 429 que diu quant cal esperar (capçalera Retry-After) i quin és el límit (RateLimit-Limit i RateLimit-Window).

La pàgina de preus de Plytix (www.plytix.com/pricing, llegida el 12 de novembre de 2026) dona 2.000 crides per hora al pla Standard, 15.000 al Pro i 25.000 a l'Enterprise. Standard només és gratuït fins a 100 SKU; amb més SKU és de pagament. La documentació de la seva API afegeix que els límits depenen del pla i que els del teu compte te'ls confirma el teu gestor de compte.

Al compte d'Odoo tries el pla al camp Plan, i el connector omple els dos límits:

  • Standard: 20 crides cada 10 segons i 2.000 per hora.
  • Pro: 50 crides cada 10 segons i 15.000 per hora.
  • Enterprise: 50 crides cada 10 segons i 25.000 per hora.
  • Límits propis: comencen en 20 i 2.000, i els escrius tu.

Són les xifres de la versió 1.3.0 del connector; les de per hora surten de la pàgina de preus de Plytix. En actualitzar, un compte que seguia amb les xifres anteriors (Standard, 5.000 per hora; Enterprise, 15.000) passa sol a les noves, i un compte els límits del qual algú va canviar es queda com estava. Els dos camps de límits es poden canviar a mà i no accepten menys d'1 crida. Si arriba un 429, el connector desa al compte el límit que diu Plytix i espera el que demana: fins a 15 segons, dins de la mateixa crida; si l'espera és més llarga, posa la sincronització en pausa, sense marcar res com a fallit, i el que queda surt després.

Cerques: 20 atributs i 100 resultats per pàgina

Les cerques de l'API de Plytix retornen pocs camps per defecte. Cal demanar cada atribut pel seu nom, i Plytix n'admet com a molt 20 per cerca. Si en necessites més, el connector fa diverses passades i les uneix per l'identificador del producte. Cada pàgina porta com a molt 100 resultats. Amb més, l'API respon amb un error 422.

Què fa el connector amb l'API

El connector aparella productes, variants i subvariants per SKU. Si l'SKU no identifica el registre, no crea l'aparellament. Ho tens a Plytix › Products › Match by SKU, i la importació a Plytix › Products › Import from Plytix.

Hi ha dues tasques programades per als canvis: importar els productes canviats cada 6 hores i exportar-los cada 12 hores. Totes dues vénen desactivades. Les actives tu quan hagis revisat la correspondència de camps i el sentit de cada sincronització.

Llista de productes vinculats amb Plytix a Odoo
Productes vinculats: què ve de Plytix i si està al dia (dades de demostració).

El que necessites

Necessites un compte de Plytix actiu amb la seva clau d'API. El connector és a Odoo Apps per a Odoo 17, 18, 19 i 20 i necessita la subscripció a FlexigoTech Cloud. Tots els detalls són a la pàgina del connector.

On és la documentació de l'API de Plytix?

A apidocs.plytix.com. El connector treballa contra l'API REST de Plytix per HTTPS.

Què passa si Plytix respon amb un 429?

El connector es frena abans d'enviar segons els límits del compte. Si tot i així arriba un 429, desa el límit que diu Plytix i espera el que demana, fins a 15 segons dins de la mateixa crida. Si l'espera és més llarga, la sincronització es posa en pausa sense marcar res com a fallit, i el que queda surt quan Plytix ho permet.

Puc fer servir el pla gratuït de Plytix?

Sí, si gestiones fins a 100 SKU: és el que Plytix dona gratis amb Standard, segons la seva pàgina de preus. Al compte tries Standard i el connector comença amb 20 crides cada 10 segons i 2.000 per hora. El connector continua necessitant la subscripció a FlexigoTech Cloud.

Odoo desa la meva clau de Plytix?

No. La clau i la contrasenya les guarda FlexigoTech Cloud, xifrades, després del consentiment d'un administrador.

Continua llegint

Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts

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