Saltar para o conteúdo principal
Plytix

Plytix API a partir do Odoo: chave, palavra-passe, token e limites

Para falar com a API do Plytix são precisas uma chave de API e a respetiva palavra-passe, um token que expira ao fim de 900 segundos e o respeito por dois limites de chamadas ao mesmo tempo. O conector Plytix para Odoo faz isso através da FlexigoTech Cloud. Isto é o que a API pede e como fica no Odoo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 14 de novembro de 2026

O essencial

Módulo
Plytix
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

A chave e a palavra-passe da API do Plytix

No Plytix, a chave cria-se em Account, depois API e depois API Keys. Só os utilizadores Owner e Admin a podem criar. Cada chave vem com uma palavra-passe que o Plytix mostra ao lado. A API precisa das duas.

No Odoo cola-as em Plytix › Configuração › Contas Plytix, nos campos Chave de API e Palavra-passe de API. Vão juntas ou não vai nenhuma: se faltar uma, o conector não envia nada. Antes de as guardar, um administrador tem de aceitar que a FlexigoTech Cloud as guarde.

Painel do conector Plytix no Odoo
Plytix no Odoo: a conta ligada e os quatro passos da configuração (dados de demonstração).

O token que dura 900 segundos

A API do Plytix autentica em dois passos. Primeiro troca-se o par de chave e palavra-passe por um token no serviço de autenticação do Plytix. Esse token dura exatamente 900 segundos. Depois, cada chamada leva o token.

Se integrar o Plytix por conta própria, tem de guardar o par, pedir o token e renová-lo antes de expirar. Com o conector, quem o faz é a FlexigoTech Cloud. Guarda o par cifrado, pede o token, renova-o e coloca-o em cada chamada. O Odoo não guarda nem o par nem o token.

Dois limites de chamadas ao mesmo tempo

O Plytix limita as chamadas com dois contadores ao mesmo tempo: um por cada 10 segundos e outro por hora. Ambos dependem do seu plano. O conector abranda antes de enviar para não os ultrapassar. Se mesmo assim os ultrapassar, o Plytix responde com um 429 que diz quanto tempo esperar (cabeçalho Retry-After) e qual é o limite (RateLimit-Limit e RateLimit-Window).

A página de preços do Plytix (www.plytix.com/pricing, lida a 12 de novembro de 2026) dá 2.000 chamadas por hora ao plano Standard, 15.000 ao Pro e 25.000 ao Enterprise. O Standard só é gratuito até 100 SKU; com mais SKU, é pago. A documentação da API acrescenta que os limites dependem do plano e que os da sua conta lhe são confirmados pelo seu gestor de conta.

Na conta do Odoo escolhe o seu plano no campo Plano, e o conector preenche os dois limites:

  • Standard: 20 chamadas a cada 10 segundos e 2.000 por hora.
  • Pro: 50 chamadas a cada 10 segundos e 15.000 por hora.
  • Enterprise: 50 chamadas a cada 10 segundos e 25.000 por hora.
  • Limites próprios: começam em 20 e 2.000, e escreve-os aqui.

São os valores da versão 1.3.0 do conector; os valores por hora vêm da página de preços do Plytix. Ao atualizar, uma conta que continuava com os valores anteriores (Standard, 5.000 por hora; Enterprise, 15.000) passa sozinha para os novos, e uma conta cujos limites alguém alterou fica como estava. Os dois campos de limites podem ser alterados à mão e não aceitam menos de 1 chamada. Se chegar um 429, o conector guarda na conta o limite indicado pelo Plytix e espera o tempo que ele pede: até 15 segundos, dentro da mesma chamada; se a espera for mais longa, põe a sincronização em pausa, sem marcar nada como falhado, e o que resta sai depois.

Pesquisas: 20 atributos e 100 resultados por página

As pesquisas da API do Plytix devolvem poucos campos por defeito. Cada atributo tem de ser pedido pelo nome, e o Plytix aceita no máximo 20 por pesquisa. Se precisar de mais, o conector faz várias passagens e junta-as pelo identificador do produto. Cada página traz no máximo 100 resultados. Acima disso, a API responde com um erro 422.

O que o conector faz com a API

O conector emparelha produtos, variantes e subvariantes por SKU. Se o SKU não identificar o registo, não cria o emparelhamento. Encontra-o em Plytix › Produtos › Emparelhar por SKU, e a importação em Plytix › Produtos › Importar do Plytix.

Há duas tarefas agendadas para as alterações: importar os produtos alterados a cada 6 horas e exportá-los a cada 12 horas. Ambas vêm desativadas. Ativa-as depois de rever a correspondência de campos e o sentido de cada sincronização.

Lista de produtos ligados ao Plytix no Odoo
Produtos ligados: o que vem do Plytix e se está atualizado (dados de demonstração).

O que precisa

Precisa de uma conta Plytix ativa com a respetiva chave de API. O conector está no Odoo Apps para Odoo 17, 18, 19 e 20 e precisa da subscrição FlexigoTech Cloud. Todos os detalhes estão na página do conector.

Onde está a documentação da API do Plytix?

Em apidocs.plytix.com. O conector trabalha com a API REST do Plytix por HTTPS.

O que acontece se o Plytix responder com um 429?

O conector abranda antes de enviar, de acordo com os limites da conta. Se mesmo assim chegar um 429, guarda o limite indicado pelo Plytix e espera o tempo que ele pede, até 15 segundos dentro da mesma chamada. Se a espera for mais longa, a sincronização fica em pausa sem marcar nada como falhado, e o que resta sai quando o Plytix o permitir.

Posso usar o plano gratuito do Plytix?

Sim, se gerir até 100 SKU: é o que o Plytix dá gratuitamente no Standard, segundo a sua página de preços. Na conta escolhe Standard e o conector começa com 20 chamadas a cada 10 segundos e 2.000 por hora. O conector continua a precisar da subscrição FlexigoTech Cloud.

O Odoo guarda a minha chave do Plytix?

Não. A chave e a palavra-passe ficam guardadas na FlexigoTech Cloud, cifradas, depois do consentimento de um administrador.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

  • Código do módulo: flexigobe_plytix_connector 20.0 (6d411531): __manifest__.py
  • Código do módulo: flexigobe_plytix_connector 20.0 (6d411531): static/description/index.html
  • Código do módulo: flexigobe_plytix_connector 20.0 (6d411531): models/plytix_account.py
  • Código do módulo: flexigobe_plytix_connector 20.0 (6d411531): data/plytix_cron_data.xml
  • Código do módulo: flexigobe_plytix_connector 20.0 (6d411531): views/plytix_menus.xml
  • Código do 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 do módulo: flexigobe_plytix_connector 20.0 (40f61773): models/plytix_account.py
  • Código do módulo: flexigobe_plytix_connector 20.0 (40f61773): migrations/1.3.0/post-migrate.py
  • Código do módulo: flexigobe_plytix_connector 20.0 (40f61773): models/plytix_api_client.py