Quando é preciso carregar e onde está
É preciso carregar no botão ou o inventário FBA já se sincroniza sozinho?
Sincroniza-se sozinho. A tarefa agendada Amazon SP-API - Sincronizar inventário FBA oficial (Amazon SP-API - Sync official FBA inventory) está ativa ao instalar o módulo e executa-se a cada 30 minutos. Percorre as contas ativas que têm a sincronização de inventário FBA ligada e lança, para cada uma, a mesma leitura que faz o botão. O botão serve para quando quer essa leitura agora, sem esperar pela passagem seguinte da tarefa.
Onde está o botão e quando se vê?
Está no ecrã Contas, a que se chega por Amazon › Configuração › Contas (Amazon › Configuration › Accounts). Cada troço do menu exige uma permissão e, se não tiver uma delas, não vê esse troço: Amazon exige Visualizador (Viewer), e Configuração (Configuration) e Contas exigem Gestor (Manager). O botão Sincronizar Inventário FBA Oficial não depende de nenhum estado nem de nenhuma caixa: vê-se sempre e existe nos ramos do Odoo 17, 18, 19 e 20.

Sincronizar Inventário FBA Oficial.Em que se distingue o botão da tarefa agendada?
Chegam ao mesmo método de sincronização, mas com diferenças. O botão lança-o com origem manual e a tarefa com origem de tarefa agendada, e o resultado guardado indica qual foi. Antes de sincronizar, o botão verifica permissões e a configuração do stock, e a tarefa chama diretamente a sincronização. Além disso, quando a API de relatórios está em pausa ou o relatório não termina bem, o botão deixa o resultado como nota no chatter da conta; a tarefa, nesses casos, só o guarda na conta. Se a tarefa falhar numa conta, o módulo regista o erro, guarda-o como resultado dessa conta e passa à seguinte.

O que faz o botão, por ordem
O que se segue vem do código publicado do Odoo 20.
O que verifica antes de falar com a Amazon?
Primeiro as permissões e depois a configuração do stock. Quanto às permissões: exceto em execuções com privilégios de superutilizador, tem de pertencer ao grupo Gestor (Manager) do conector ou ao das Definições. Se não pertencer a nenhum dos dois, para com a mensagem que verá mais abaixo. Depois, o módulo verifica se pode escrever na conta; se lhe faltar essa permissão, o Odoo também a interrompe. Quanto ao stock: se a caixa Aplicar stock FBA oficial às localizações Odoo (Apply official FBA stock to Odoo locations) estiver ativa e faltar a localização de origem do stock FBM, a conta deixa um aviso no seu chatter. Não interrompe o botão: a sincronização continua.
O que pede à Amazon e como espera pela resposta?
A menos que a API de relatórios esteja em pausa (explica-se na pergunta seguinte), cria um relatório de inventário do tipo configurado na conta e consulta o seu estado repetidamente até a Amazon o dar por terminado, cancelado ou fatal, ou até esgotar as tentativas. Se não houver valores configurados, o código usa doze tentativas com dez segundos entre cada uma. Quando o relatório termina bem, o módulo prossegue com o seu documento; se a Amazon o der por terminado mas sem documento, regista-o no resultado.
O que acontece se a API de relatórios estiver em pausa ou o relatório não terminar?
Se o módulo detetar que a API de relatórios está em pausa (cooldown), não cria o relatório: regista-o no resultado e, nalguns casos, o resultado acrescenta Reports API em tempo de espera. A repetir a leitura atual via getInventorySummaries. (Reports API in cooldown. Retrying the current read via getInventorySummaries.). Se criar o relatório mas a Amazon o cancelar, devolver um erro fatal ou não terminar dentro do tempo de espera, o resultado inclui o identificador e o estado do relatório juntamente com o aviso correspondente (por exemplo O sondagem do relatório expirou. Tente novamente dentro de alguns minutos.) e, nalguns casos, acrescenta A ler o stock FBA atual via getInventorySummaries (alternativa). (Reading current FBA stock via getInventorySummaries (fallback).). Em todos estes casos a conta guarda data e resultado e, com o botão, fica ainda a nota no chatter.
O que muda no Odoo e que erro pode surgir
O botão altera o stock das minhas localizações do Odoo?
Depende da caixa Aplicar stock FBA oficial às localizações Odoo, que está na ficha da conta, separador FBA e Stock (FBA & Stock), grupo Localizações (Locations). A sua ajuda diz: «Se ativado, atualiza as localizações Odoo configuradas para a quantidade oficial da Amazon.». No código vem desativada por predefinição, pelo que é você quem decide se a ativa, e convém ver antes se a conta lhe deixa o aviso da localização de origem do stock FBM.
O que acrescenta a auditoria de reembolsos?
A caixa Auditoria de reembolsos FBA (FBA reimbursement audit) está na ficha da conta, separador Relatórios FBA (opt-in) (FBA Reports (opt-in)), grupo Auditoria de Pedidos de Reembolso (encontre dinheiro que a Amazon lhe deve). Vem desativada por predefinição. A sua ajuda diz: «Desligado por predefinição. Quando ligado, a sincronização do razão de inventário também acumula eventos de perdidos/danificados/encontrados e a auditoria cruza-os com os reembolsos das liquidações, revelando as unidades que a Amazon ainda deve (com valor estimado e prazo de reclamação). Análise apenas de leitura.»
Que erro pode dar ao carregar no botão e como se resolve?
Uma das mensagens que podem parar o botão é esta: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access. Aparece ao carregar em Sincronizar Inventário FBA Oficial quando o seu utilizador não pertence nem ao grupo Gestor do conector nem ao das Definições. Resolve-se pedindo a quem administra o Odoo que lhe dê o acesso Gestor do conector, ou usando um utilizador que já o tenha.

O que precisa para o usar
O módulo é de pagamento único por versão do Odoo (publicado para Odoo 17, 18, 19 e 20) e requer a subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA. A ligação à Amazon passa pelo FlexigoTech Cloud. Tem mais dados na página do módulo e na ficha do Odoo Apps.
Se está a implementar o Odoo e quer decidir com calma que localizações devem receber o stock do FBA, ou precisa de uma integração à medida, na FlexigoTech implementamos o Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações.
Continue a ler
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_account_views.xml
- Código do módulo: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_account.py
- apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
