Saltar al contenido principal
Plytix

Plytix API desde Odoo: clave, contraseña, token y límites de llamadas

Para hablar con la API de Plytix hacen falta una clave de API y su contraseña, un token que caduca a los 900 segundos y respetar dos límites de llamadas a la vez. El conector de Plytix para Odoo lo hace por ti a través de FlexigoTech Cloud. Esto es lo que pide la API y cómo queda en Odoo.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 14 de noviembre de 2026

Lo esencial

Módulo
Plytix
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
5 min

La clave y la contraseña de la API de Plytix

En Plytix, la clave se crea en Account, después API y después API Keys. Solo los usuarios Owner y Admin pueden crearla. Cada clave viene con una contraseña que Plytix muestra a su lado. La API necesita las dos.

En Odoo las pegas en Plytix › Configuración › Cuentas de Plytix, en los campos Clave de API y Contraseña de API. Van juntas o no va ninguna: si falta una, el conector no envía nada. Antes de guardarlas, un administrador tiene que aceptar que FlexigoTech Cloud las guarde.

Panel del conector de Plytix en Odoo
Plytix en Odoo: la cuenta conectada y los cuatro pasos de la puesta en marcha (datos de demostración).

El token que dura 900 segundos

La API de Plytix autentica en dos pasos. Primero se cambia la pareja de clave y contraseña por un token en el servicio de autenticación de Plytix. Ese token dura exactamente 900 segundos. Después, cada llamada lleva el token.

Si integras Plytix por tu cuenta, tienes que guardar la pareja, pedir el token y renovarlo antes de que caduque. Con el conector lo hace FlexigoTech Cloud. Guarda la pareja cifrada, pide el token, lo renueva y lo pone en cada llamada. Odoo no guarda ni la pareja ni el token.

Dos límites de llamadas a la vez

Plytix limita las llamadas con dos contadores al mismo tiempo: uno por cada 10 segundos y otro por hora. Los dos dependen de tu plan. El conector se frena antes de enviar para no pasarse. Si aun así se pasa, Plytix responde con un 429 que dice cuánto esperar (cabecera Retry-After) y cuál es el límite (RateLimit-Limit y RateLimit-Window).

La página de precios de Plytix (www.plytix.com/pricing, leída el 12 de noviembre de 2026) da 2.000 llamadas por hora al plan Standard, 15.000 al Pro y 25.000 al Enterprise. Standard solo es gratis hasta 100 SKU; con más SKU es de pago. La documentación de su API añade que los límites dependen del plan y que los de tu cuenta te los confirma tu gestor de cuenta.

En la cuenta de Odoo eliges tu plan en el campo Plan, y el conector rellena los dos límites:

  • Standard: 20 llamadas cada 10 segundos y 2.000 por hora.
  • Pro: 50 llamadas cada 10 segundos y 15.000 por hora.
  • Enterprise: 50 llamadas cada 10 segundos y 25.000 por hora.
  • Límites propios: empiezan en 20 y 2.000, y los escribes tú.

Son las cifras de la versión 1.3.0 del conector; las de por hora salen de la página de precios de Plytix. Al actualizar, una cuenta que seguía con las cifras anteriores (Standard, 5.000 por hora; Enterprise, 15.000) pasa sola a las nuevas, y una cuenta cuyos límites cambió alguien se queda como estaba. Los dos campos de límites se pueden cambiar a mano y no aceptan menos de 1 llamada. Si llega un 429, el conector guarda en la cuenta el límite que dice Plytix y espera lo que pide: hasta 15 segundos, dentro de la misma llamada; si la espera es más larga, pone la sincronización en pausa, sin marcar nada como fallido, y lo que queda sale después.

Búsquedas: 20 atributos y 100 resultados por página

Las búsquedas de la API de Plytix devuelven pocos campos por defecto. Hay que pedir cada atributo por su nombre, y Plytix admite como mucho 20 por búsqueda. Si necesitas más, el conector hace varias pasadas y las une por el identificador del producto. Cada página trae como mucho 100 resultados. Con más, la API responde con un error 422.

Qué hace el conector con la API

El conector empareja productos, variantes y subvariantes por SKU. Si el SKU no identifica el registro, no crea el emparejamiento. Lo tienes en Plytix › Productos › Emparejar por SKU, y la importación en Plytix › Productos › Importar de Plytix.

Hay dos tareas programadas para los cambios: importar los productos cambiados cada 6 horas y exportarlos cada 12 horas. Las dos vienen desactivadas. Las activas tú cuando hayas revisado la correspondencia de campos y el sentido de cada sincronización.

Lista de productos vinculados con Plytix en Odoo
Productos vinculados: qué viene de Plytix y si está al día (datos de demostración).

Lo que necesitas

Necesitas una cuenta de Plytix activa con su clave de API. El conector está en Odoo Apps para Odoo 17, 18, 19 y 20 y necesita la suscripción a FlexigoTech Cloud. Todos los detalles están en la página del conector.

¿Dónde está la documentación de la API de Plytix?

En apidocs.plytix.com. El conector trabaja contra la API REST de Plytix por HTTPS.

¿Qué pasa si Plytix responde con un 429?

El conector se frena antes de enviar, según los límites de la cuenta. Si aun así llega un 429, guarda el límite que dice Plytix y espera lo que pide, hasta 15 segundos dentro de la misma llamada. Si la espera es más larga, la sincronización se pone en pausa sin marcar nada como fallido, y lo que queda sale cuando Plytix lo permite.

¿Puedo usar el plan gratuito de Plytix?

Sí, si gestionas hasta 100 SKU: es lo que Plytix da gratis en Standard, según su página de precios. En la cuenta eliges Standard y el conector empieza con 20 llamadas cada 10 segundos y 2.000 por hora. El conector sigue necesitando la suscripción a FlexigoTech Cloud.

¿Guarda Odoo mi clave de Plytix?

No. La clave y la contraseña las guarda FlexigoTech Cloud, cifradas, después del consentimiento de un administrador.

Sigue leyendo

Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes

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