O conector da Octopia está publicado para o Odoo 17, 18, 19 e 20. Há duas coisas sobre a API da Octopia que convém saber antes de começar: só aceita client credentials e não tem um ambiente de testes separado. Os testes fazem-se em produção, num canal de venda de teste que a Octopia oferece dentro da própria API.
Passos
- No back office da Octopia, abra a gestão de credenciais da API e crie as suas ou associe as do seu integrador. Se se ligar através de um integrador, tem de o aceitar nesse ecrã.
- No Odoo, vá a Octopia › Configuration › Accounts e crie a conta. Escreva primeiro o Client ID e o Seller ID; o secret, depois.
- Um administrador do Odoo aceita o aviso de que as credenciais e as chamadas à Octopia passam pelo FlexigoTech Cloud. Sem essa aceitação, o secret não é guardado.
- Em Configuration › Sales Channels, escolha o canal de venda predefinido. É o que se usa para publicar ofertas quando não indica outro.
- Deixe descarregar os referenciais: categorias, marcas e transportadoras. A tarefa repete-se todas as semanas; da primeira vez pode executá-la à mão.
- Associe os seus produtos ao catálogo da Octopia. Para vender na Cdiscount, o produto tem de estar em francês.
- Publique as ofertas a partir de Offers › Publication Packages.
- Ative as automatizações da conta que quiser usar: aceitar encomendas, confirmar vendas, declarar o envio ao validar a entrega.


Erros do primeiro dia
| Mensagem | O que se passa | Solução |
|---|---|---|
The Octopia Seller ID must be numeric (e.g. 98979). | Colou o nome da loja ou um código com letras. | Copie o Seller ID numérico do back office. |
Enter the Client ID and the Seller ID before the secret. Nothing was sent. | Escreveu o secret com os outros campos vazios. | Preencha o Client ID e o Seller ID e depois guarde o secret. |
Before saving the secret, an administrator has to accept… | O aviso da nuvem não foi aceite. | Peça a um administrador que o aceite na conta. |
Account '…' has no default sales channel configured. | Não há canal predefinido. | Escolha um na conta ou em Sales Channels. |
Product … is not mapped to the Octopia catalog | O produto não está associado ao seu registo na Octopia. | Associe-o antes de publicar a oferta. |

Encomendas e envios
A API da Octopia não avisa por webhooks: é preciso perguntar-lhe. Por isso, o conector procura encomendas a cada 10 minutos e envia as alterações de preço e stock a cada 15. Um pormenor que costuma confundir: a Octopia não revela a morada do comprador até a encomenda estar em preparação. Ver encomendas acabadas de chegar sem morada é normal; a verificação seguinte preenche-a.
Para declarar um envio, a Octopia exige dimensões e peso em alguns modos de entrega. Se faltarem, o Odoo avisa-o antes de enviar o que quer que seja.

Se também vende noutros canais da Octopia, lembre-se de que o stock do mesmo produto e estado é partilhado por todos. Atualizá-lo num atualiza os restantes.
Continue a ler
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): docs/api-ground-truth.md
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_account.py
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_fulfillment.py
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): models/octopia_ffm_setup.py
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/menu.xml
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_offer_views.xml
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_order_views.xml
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): views/octopia_referential_views.xml
- Código do módulo: flexigobe_octopia_connector 20.0 (dfba2acc): data/octopia_cron_data.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
