Botão «Sincronizar cálculo de IVA» do Amazon Connector para Odoo: lista de verificação

O botão existe nas versões 17.0, 18.0, 19.0 e 20.0 do Odoo e, em todas elas, aparece sempre no ecrã Contas.

Primeiro, o que o Odoo faz sem que carregue em nada

A sincronização do relatório de cálculo de IVA tem um caminho automático, e esse é o caminho normal. A tarefa agendada Amazon SP-API - Sincronizar relatório de Cálculo de IVA (opt-in) (Amazon SP-API - Sync VAT Calculation report (opt-in)) é executada uma vez por dia e está ativa ao instalar o módulo.

A tarefa percorre as contas ativas que têm a sincronização do relatório de IVA ativada e sincroniza cada uma com a origem CRON. Nesse caminho não se publica a mensagem de resumo na conta. Se uma conta der erro, a tarefa não pára e segue para a seguinte.

O botão é a exceção: serve para lançar essa mesma sincronização manualmente, sobre uma conta concreta e no momento em que quiser.

Antes de carregar

• Chega ao ecrã pelo menu Amazon › Configuração › Contas (Amazon › Configuration › Accounts). Os níveis Configuração (Configuration) e Contas exigem a permissão Gestor; o nível Amazon exige Visualizador (Viewer). Se não tiver uma dessas permissões, não vê esse nível do menu.

• O seu utilizador é Gestor do conector da Amazon ou tem acesso às Definições. É a primeira coisa que o botão verifica e, se não se cumprir, a ação pára com esta mensagem: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

• Além desses grupos, o botão verifica se pode escrever nessa conta.

• Tem aberta a conta da Amazon que quer sincronizar. O botão atua sobre uma única conta de cada vez.

• A subscrição do FlexigoTech Cloud está ativa (mais abaixo, o plano).

Ao carregar em Sincronizar cálculo de IVA

No Odoo 20.0, estes são os passos, por ordem:

• Verifica as suas permissões, como descrito acima. Se falhar, não se faz mais nada.

• Pede à Amazon que crie o relatório de cálculo de IVA para a conta.

• Consulta várias vezes o estado do relatório, com uma pausa entre consultas, até a Amazon o dar por concluído (DONE), cancelado (CANCELLED) ou falhado (FATAL), ou até esgotar as tentativas.

• Se o relatório estiver pronto (DONE) e trouxer um documento, processa-o com o marketplace da conta e com um limite de linhas por execução, e o resumo acrescenta os contadores de linhas.

• Guarda o resultado na conta e, ao lançá-lo com o botão, publica também o resumo como mensagem na própria conta (a tarefa diária não o publica).

O que se guarda e que resumo deixa

• A conta guarda a data e a hora da última execução e o texto do resultado. Isto acontece tanto se o relatório for processado como se a Amazon não entregar um utilizável.

• Leia o resumo. Começa sempre com estas linhas:

• Sincronização do relatório de Cálculo de IVA da Amazon concluída. (Amazon VAT Calculation report sync finished.)
• Conta: … (Account: …)
• Origem: … (Source: …), que indica se a sincronização foi manual ou da tarefa agendada.

Se o relatório chegar a ser consultado, o resumo acrescenta ainda:

• ID do relatório: … (Report ID: …)
• Estado do relatório: … (Report status: …)

Se o relatório for processado, acrescenta também estes contadores:

• Linhas do relatório: … (Report rows: …)
• Linhas processadas: … (Processed rows: …)
• Criados: … (Created: …)
• Atualizado: … (Updated: …)
• Ignorado: … (Skipped: …)
• Com erro: … (With error: …)

Se a Amazon não entregar o relatório

Nestes casos o botão não processa nenhuma linha, mas guarda o resumo na conta e, ao lançá-lo com o botão, publica-o também como mensagem:

• O estado do relatório é CANCELLED ou FATAL: o resumo acrescenta A Amazon não gerou um relatório de Cálculo de IVA utilizável. (Amazon did not generate a usable VAT Calculation report.)

• O relatório não chega a um estado final após as consultas: o resumo acrescenta O sondagem do relatório expirou. Tente novamente dentro de alguns minutos. (Report polling timed out. Try again in a few minutes.) Espere uns minutos e volte a carregar no botão.

• O relatório chega a DONE mas sem documento: o resumo acrescenta Relatório CONCLUÍDO sem reportDocumentId. (DONE report without reportDocumentId.) e a sincronização termina aí.

Como se chama o botão consoante o idioma

O rótulo depende do idioma do seu Odoo. Com o Odoo em português de Portugal chama-se Sincronizar cálculo de IVA, e o módulo traz o rótulo traduzido para outros idiomas.

Depois de sincronizar

• Abra a mensagem publicada na conta e veja a linha Estado do relatório: … para saber em que estado ficou o relatório.

• Reveja os contadores Linhas do relatório: …, Linhas processadas: … e Com erro: …, e tome nota deles para os comparar com a execução seguinte.

• Lembre-se de que a tarefa diária continuará a lançar a sincronização por si nas contas que a tenham ativada. O botão serve para a lançar manualmente.

• Se lhe aparecer a mensagem de permissões, peça a um gestor que lhe dê acesso de Gestor, como indica o próprio texto.

Custo e ajuda

O módulo é de pagamento único por versão do Odoo e precisa da subscrição do FlexigoTech Cloud. O plano Conector custa 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá, e os dados ficam no seu Odoo. Tem a ficha no Odoo Apps e a página do módulo.

Se está a implementar o Odoo e quer rever como esta sincronização se encaixa na sua contabilidade, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

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