Botão «Sincronizar Expedições Processadas por FBA»: mitos e realidade

Onde está e o que acontece ao premi-lo

O botão Sincronizar Expedições Processadas por FBA está no ecrã Contas, a que chega por Amazon › Configuração › Contas (Amazon › Configuration › Accounts). O primeiro nível Amazon pede a permissão Visualizador (Viewer); os níveis Configuração e Contas pedem Gestor (Manager). O botão existe nas versões 17, 18, 19 e 20 e vê-se sempre.

Ao premi-lo, o módulo faz primeiro uma verificação de permissões: deixa passar se pertencer ao grupo de gestores do conector ou tiver acesso às Definições, e verifica ainda que pode escrever na conta. Depois lança a sincronização dessa conta, marcando-a como manual. Segundo o código do Odoo 20, essa sincronização segue esta ordem:

• Se o módulo devolver uma nota prévia, regista-a na conta e termina antes de pedir o relatório à Amazon.
• Se a opção opcional da conta não estiver assinalada, regista «A sincronização de expedições FBA enviadas está desativada na conta.» (Sync of shipped FBA shipments is disabled on the account.) e termina.
• Pede à Amazon um relatório de expedições FBA.
• Consulta o estado do relatório várias vezes, esperando entre cada consulta. Deixa de consultar quando a Amazon o dá por terminado, cancelado ou falhado, ou quando se esgotam as tentativas.
• Se o relatório não estiver pronto, regista o estado e termina sem importar nada: «A Amazon não gerou um relatório de envios FBA expedidos utilizável.» (Amazon did not generate a usable dispatched FBA shipments report.) se estiver cancelado ou falhado, ou «O sondagem do relatório expirou. Tente novamente dentro de alguns minutos.» (Report polling timed out. Try again in a few minutes.) se as tentativas se esgotaram.
• Se o relatório estiver pronto mas sem documento, regista «Relatório CONCLUÍDO sem reportDocumentId.» (DONE report without reportDocumentId.) e termina.
• Se tiver documento, descarrega-o e passa-o ao importador de linhas de expedições FBA.

Quando termina pela nota prévia, pela opção desassinalada, por um relatório inutilizável ou por um relatório sem documento, o módulo guarda na conta a data e o resultado. Se o lançou com o botão, deixa ainda esse resultado como mensagem na conta; a tarefa agendada não deixa mensagem.

Ideias erradas sobre o botão

Mito: «O botão é a forma normal de trazer as expedições FBA»

A realidade é outra: existe um caminho automático. A tarefa agendada Amazon SP-API - Sincronizar envios FBA expedidos (Amazon SP-API - Sync dispatched FBA shipments) corre a cada 30 minutos e está ativa ao instalar. Apanha as contas ativas que tenham assinalada a opção Sincronizar expedições processadas por FBA (opcional) (Sync FBA fulfilled shipments (opt-in)) e lança a mesma sincronização, com origem na tarefa agendada e sem deixar mensagem na conta. Se uma conta falhar, o módulo regista-o no registo do servidor, guarda o erro nessa conta e continua com as restantes. O botão serve para a lançar à mão nesse momento.

Mito: «Premi-lo ativa a sincronização da conta»

Não a ativa. A opção Sincronizar expedições processadas por FBA (opcional) está desassinalada por omissão e o botão não a assinala. Se continuar desassinalada, a sincronização regista que está desativada na conta e termina sem pedir o relatório. A opção está na ficha de Contas, separador FBA e Stock, grupo Sincronização de Inventário FBA (ATIVA por omissão) · Envios Concluídos (opt-in) (FBA Inventory Sync (ON by default) · Fulfilled Shipments (opt-in)). A sua ajuda diz: «Lê os envios FBA realmente expedidos da Amazon utilizando a Reports API.»

Mito: «Qualquer pessoa que veja o menu da Amazon pode premi-lo»

Um utilizador com Visualizador vê Amazon, mas Configuração e Contas pedem Gestor. Além disso, o módulo volta a verificar a permissão ao premir. Se não pertencer ao grupo de gestores do conector nem tiver acesso às Definições, a ação é interrompida com esta mensagem:

You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

A solução é a que diz a mensagem: peça a um gestor que lhe dê o acesso. O botão vê-se sempre, pelo que o que o trava é essa verificação e não a sua visibilidade.

Mito: «Ao premi-lo, as expedições aparecem de imediato»

O módulo não lê as expedições diretamente: pede um relatório à Amazon e consulta o seu estado até estar pronto. Se a Amazon o cancelar, falhar ou não terminar dentro das tentativas de consulta, essa passagem acaba sem importar nada e deixa o estado registado. Pode voltar a lançá-la com outra pressão do botão; a tarefa agendada também a repete nas contas com a opção assinalada.

No mesmo grupo do separador FBA e Stock há outra opção, Expedições FBA: atualizar automaticamente as encomendas Odoo (FBA shipments: auto-update Odoo orders), que vem assinalada por omissão. A sua ajuda diz: «Se ativado, as encomendas Odoo associadas são marcadas como PartiallyShipped/Shipped apenas quando a Amazon reporta a expedição FBA efetiva.»

Mito: «O botão só existe na última versão»

Está nas versões 17, 18, 19 e 20. A sua etiqueta depende do idioma do seu Odoo, porque o módulo traz traduções publicadas; com o Odoo em português de Portugal vê-lo-á como Sincronizar Expedições Processadas por FBA.

O que verificar após a primeira pressão

Abra a ficha da conta em Amazon › Configuração › Contas e confirme no separador FBA e Stock que a opção opcional está no estado que pretende. Se a passagem terminou sem importar, veja o resultado que ficou registado na conta, que indica porque parou. Se o seu utilizador receber a mensagem de permissões, peça a um gestor que lhe dê o acesso ou que faça a alteração.

Custo e ajuda da FlexigoTech

O módulo é de pagamento único por versão do Odoo e precisa da subscrição FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, até 3 contas da Amazon. Essa ligação guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar. Está publicado no Odoo Apps para 17.0, 18.0, 19.0 e 20.0 (ficha); tem também a página do módulo.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, caso precise de ajustar este fluxo à sua empresa.

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/en/services.html
• flexigotech.com/precios.html