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.

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.

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
