Vai al contenuto principale
Plytix

Plytix API da Odoo: chiave, password, token e limiti di chiamate

Per parlare con l'API di Plytix servono una chiave API con la sua password, un token che scade dopo 900 secondi e il rispetto di due limiti di chiamate insieme. Il connettore Plytix per Odoo lo fa per te tramite FlexigoTech Cloud. Ecco cosa chiede l'API e come appare in Odoo.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 14 novembre 2026

In breve

Modulo
Plytix
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0 · nelle fonti collegate in fondo
Lettura
4 min

La chiave e la password dell'API di Plytix

In Plytix la chiave si crea in Account, poi API e poi API Keys. Solo gli utenti Owner e Admin possono crearla. Ogni chiave arriva con una password che Plytix mostra accanto. L'API ha bisogno di entrambe.

In Odoo le incolli in Plytix › Configurazione › Account Plytix, nei campi Chiave API e Password API. Vanno insieme o non parte niente: se ne manca una, il connettore non invia nulla. Prima di salvarle, un amministratore deve accettare che FlexigoTech Cloud le conservi.

Pannello del connettore Plytix in Odoo
Plytix in Odoo: l'account collegato e i quattro passi dell'avvio (dati dimostrativi).

Il token che dura 900 secondi

L'API di Plytix autentica in due passaggi. Prima la coppia di chiave e password si scambia con un token presso il servizio di autenticazione di Plytix. Quel token dura esattamente 900 secondi. Poi ogni chiamata porta il token.

Se integri Plytix da solo, devi conservare la coppia, chiedere il token e rinnovarlo prima che scada. Con il connettore se ne occupa FlexigoTech Cloud. Conserva la coppia cifrata, chiede il token, lo rinnova e lo mette in ogni chiamata. Odoo non conserva né la coppia né il token.

Due limiti di chiamate insieme

Plytix limita le chiamate con due contatori insieme: uno ogni 10 secondi e uno all'ora. Entrambi dipendono dal tuo piano. Il connettore rallenta prima di inviare per non superarli. Se li supera comunque, Plytix risponde con un 429 che dice quanto aspettare (intestazione Retry-After) e qual è il limite (RateLimit-Limit e RateLimit-Window).

La pagina dei prezzi di Plytix (www.plytix.com/pricing, letta il 12 novembre 2026) dà 2.000 chiamate all'ora al piano Standard, 15.000 al Pro e 25.000 all'Enterprise. Standard è gratuito solo fino a 100 SKU; con più SKU è a pagamento. La documentazione della sua API aggiunge che i limiti dipendono dal piano e che quelli del tuo account te li conferma il tuo account manager.

Nell'account di Odoo scegli il tuo piano nel campo Piano, e il connettore compila i due limiti:

  • Standard: 20 chiamate ogni 10 secondi e 2.000 all'ora.
  • Pro: 50 chiamate ogni 10 secondi e 15.000 all'ora.
  • Enterprise: 50 chiamate ogni 10 secondi e 25.000 all'ora.
  • Limiti personalizzati: partono da 20 e 2.000, e li scrivi tu.

Sono i valori della versione 1.3.0 del connettore; quelli orari vengono dalla pagina dei prezzi di Plytix. Con l'aggiornamento, un account rimasto sui valori precedenti (Standard, 5.000 all'ora; Enterprise, 15.000) passa da solo ai nuovi, e un account i cui limiti sono stati cambiati da qualcuno resta com'era. I due campi dei limiti si possono cambiare a mano e non accettano meno di 1 chiamata. Se arriva un 429, il connettore salva nell'account il limite indicato da Plytix e aspetta il tempo che chiede: fino a 15 secondi, dentro la stessa chiamata; se l'attesa è più lunga, mette in pausa la sincronizzazione, senza segnare nulla come fallito, e ciò che resta parte dopo.

Ricerche: 20 attributi e 100 risultati per pagina

Le ricerche dell'API di Plytix restituiscono pochi campi di default. Ogni attributo va chiesto per nome, e Plytix ne accetta al massimo 20 per ricerca. Se te ne servono di più, il connettore fa più passaggi e li unisce sull'identificativo del prodotto. Ogni pagina porta al massimo 100 risultati. Oltre, l'API risponde con un errore 422.

Cosa fa il connettore con l'API

Il connettore abbina prodotti, varianti e sottovarianti tramite SKU. Se lo SKU non identifica il record, non crea l'abbinamento. Lo trovi in Plytix › Prodotti › Abbina tramite SKU, e l'importazione in Plytix › Prodotti › Importa da Plytix.

Ci sono due attività pianificate per le modifiche: importare i prodotti cambiati ogni 6 ore ed esportarli ogni 12 ore. Entrambe arrivano disattivate. Le attivi tu dopo aver controllato la corrispondenza dei campi e la direzione di ogni sincronizzazione.

Elenco dei prodotti collegati a Plytix in Odoo
Prodotti collegati: cosa arriva da Plytix e se è aggiornato (dati dimostrativi).

Cosa ti serve

Ti serve un account Plytix attivo con la sua chiave API. Il connettore è su Odoo Apps per Odoo 17, 18, 19 e 20 e ha bisogno dell'abbonamento a FlexigoTech Cloud. Tutti i dettagli sono nella pagina del connettore.

Dove trovo la documentazione dell'API di Plytix?

Su apidocs.plytix.com. Il connettore lavora con l'API REST di Plytix via HTTPS.

Cosa succede se Plytix risponde con un 429?

Il connettore rallenta prima di inviare, in base ai limiti dell'account. Se arriva comunque un 429, salva il limite indicato da Plytix e aspetta il tempo che chiede, fino a 15 secondi dentro la stessa chiamata. Se l'attesa è più lunga, la sincronizzazione va in pausa senza segnare nulla come fallito, e ciò che resta parte quando Plytix lo consente.

Posso usare il piano gratuito di Plytix?

Sì, se gestisci fino a 100 SKU: è quello che Plytix dà gratis con Standard, secondo la sua pagina dei prezzi. Nell'account scegli Standard e il connettore parte da 20 chiamate ogni 10 secondi e 2.000 all'ora. Il connettore ha comunque bisogno dell'abbonamento a FlexigoTech Cloud.

Odoo conserva la mia chiave Plytix?

No. Chiave e password le conserva FlexigoTech Cloud, cifrate, dopo il consenso di un amministratore.

Continua a leggere

Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti

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