O que faz o botão «Sincronizar detalhe do razão FBA» no Odoo

O que o Odoo faz sozinho, sem carregar em nada

A tarefa agendada Amazon SP-API - Sincronizar relatório de detalhe do livro-razão FBA (opt-in) (Amazon SP-API - Sync FBA ledger detail report (opt-in)) executa-se uma vez por dia e está ativa desde que o módulo é instalado. Só trata as contas ativas que têm a sincronização do detalhe ativada e, para cada uma, lança a mesma sincronização que o botão.

Há diferenças face à execução manual: o resumo marca como origem a tarefa agendada em vez de manual, não é publicado no chatter da conta e, se falhar uma conta, a tarefa deixa um aviso no registo do servidor e continua com a seguinte. O botão não faz essa seleção de contas: trabalha sobre a conta em que o carregas.

O botão existe nas ramificações do Odoo 17, 18, 19 e 20 e vê-se sempre no ecrã Contas (Accounts), sem qualquer condição.

O caso da Casa Olivar: do menu ao resumo

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

A Casa Olivar é uma loja inventada que vende azeite e conservas com FBA e usa o conector no Odoo 20. A Marta, da administração, tem a permissão Gestor e quer rever o histórico de eventos de uma conta sem esperar pela tarefa do dia.

1. Entra por Amazon › Configuração › Contas (Amazon › Configuration › Accounts) e abre a conta.
2. No separador Relatórios FBA (opt-in) (FBA Reports (opt-in)), dentro do grupo Auditoria de Pedidos de Reembolso (encontre dinheiro que a Amazon lhe deve) (Reimbursement Claim Audit (find money Amazon owes you)), está a caixa Auditoria de reembolsos FBA (FBA reimbursement audit), desativada por defeito. A Marta quer que a sincronização passe também pela auditoria de pedidos da conta, por isso ativa-a.
3. Carrega em Sincronizar detalhe do razão FBA. A ação fica a consultar a Amazon, com uma pausa entre consultas, até o relatório terminar, falhar ou se esgotarem as tentativas.
4. Quando termina com resumo, a conta guarda a data e o texto da execução e publica esse resumo no seu chatter.
5. Se o estado do relatório que consta do resumo não for DONE, dessa execução não se importa nada e a Marta pode voltar a lançá-la mais tarde. Se for DONE mas a Amazon não entregar o documento do relatório, o resumo indica-o e também não se importa nada. Se houver documento, o resumo acrescenta quantas linhas trazia o relatório e quantas foram capturadas, atualizadas ou ignoradas.

O colega Íñigo só tem a permissão Visualizador: não vê os níveis Configuração e Contas do menu, pelo que não chega a este ecrã.

No dia seguinte, a tarefa agendada volta a fazer o mesmo sem que ninguém carregue em nada, mas só nas contas ativas que tenham a sincronização do detalhe ativada.

O que verifica antes de chamar a Amazon

O caminho Amazon › Configuração › Contas tem permissões por nível: Amazon pede Visualizador, e tanto Configuração como Contas pedem Gestor. Sem essa permissão não vês esses níveis.

Ao carregar no botão, a primeira coisa é uma verificação no servidor: se não és superutilizador, tens de ter a permissão Gestor (Manager) do conector ou a de Definições. Depois verifica se podes escrever nessa conta. O superutilizador passa sem a verificação de grupos, e a tarefa agendada também não passa por ela, porque chama diretamente a sincronização.

O que faz por dentro, por ordem

1. Verifica as permissões, como acabaste de ver.
2. Trabalha com uma única conta.
3. Pede à Amazon que crie o relatório de detalhe do livro FBA. Se a Amazon não devolver o identificador do relatório, a ação é interrompida.
4. Consulta o estado do relatório até ser DONE, CANCELLED ou FATAL, ou até esgotar as tentativas. O número de tentativas e os segundos entre elas são tirados da conta; se não houver valor, o código usa doze tentativas com dez segundos de pausa.
5. Se o relatório não ficar em DONE, guarda a data e o resumo com o estado em que ficou, publica-o no chatter e termina sem importar nada.
6. Se estiver em DONE mas a Amazon não fornecer documento do relatório, faz o mesmo: resumo guardado, sem importar nada e sem contagens de linhas.
7. Se houver documento, descarrega-o e passa-o à importação do histórico de eventos do livro da conta.
8. Se Auditoria de reembolsos FBA estiver ativada, a sincronização passa também pela auditoria de pedidos da conta.
9. Guarda a data e o resumo e publica o resumo no chatter.

O resumo inclui a conta, a origem (manual se o lançares tu), o identificador e o estado do relatório e, se chegar a importar-se, a contagem de linhas, capturadas, atualizadas e ignoradas.

O que muda no teu Odoo e o que não muda

• Acumula-se o histórico de eventos do livro da conta.
• A conta guarda a data e o resumo da última execução, e o chatter recebe uma nota com o resumo.
• Com Auditoria de reembolsos FBA ativada, a sincronização passa também pela auditoria de pedidos. A sua ajuda diz que, ao ativá-la, a sincronização também acumula eventos de perdido, danificado e encontrado, e que a auditoria os cruza com os reembolsos das liquidações para apurar as unidades que a Amazon ainda deve, com valor estimado e data limite de reclamação. É uma análise só de leitura.
• Segundo o próprio código, é uma sincronização independente que não toca no stock FBA: só acumula histórico por evento para a auditoria de reembolsos.

O aviso que pode travar a ação

Ao carregar em Sincronizar detalhe do razão FBA pode surgir este aviso: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Surge quando não és superutilizador e não tens a permissão Gestor do conector nem a de Definições. Resolve-se como diz o próprio texto: pede a um gestor que te conceda o acesso de Gestor.

O que aprender com o caso

• A tarefa diária sincroniza as contas ativas que têm a sincronização do detalhe ativada; o botão serve para a lançar manualmente na conta que tens aberta.
• A permissão é verificada ao carregar, além de limitar o menu.
• O estado do relatório no resumo diz-te se houve importação.
• A caixa Auditoria de reembolsos FBA decide se a sincronização passa também pela auditoria de pedidos.

Como a FlexigoTech te ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. A página do módulo e a sua ficha no Odoo Apps têm os detalhes de compra. O módulo é de pagamento único por versão e precisa da subscrição do FlexigoTech Cloud, plano Conector (49 €/mês ou 490 €/ano, sem IVA). A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar.

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