O que faz o botão «Ver Devoluções» do Amazon Connector for Odoo

O que faz o botão assim que o carregas

Com o Odoo em português, o botão chama-se Ver Devoluções (View Returns) e está no ecrã Painel (Dashboard), a que se chega a partir do menu Amazon. Esse troço do menu exige a permissão Visualizador (Viewer): se não a tiveres, não vês o troço. O botão existe nas versões 17, 18, 19 e 20 do módulo, e o código aqui descrito é o do Odoo 20.

Ao carregares nele, isto é o que acontece, por ordem:

• O botão trabalha com o painel onde o carregaste, apenas esse.
• Pede a janela de lista das linhas de devolução.
• A essa lista aplica um filtro: a conta Amazon a que o painel pertence e a data de pedido da devolução dentro do intervalo de datas do painel.
• Entrega-te a lista já filtrada.

Nada mais. Tudo o resto que esperarias de um botão destes é o que as ideias abaixo desmontam.

Ideias erradas sobre o botão

«Só aparece quando há devoluções»

A condição da vista diz que o botão se vê sempre, no Odoo 17, 18, 19 e 20. Não depende de existirem devoluções nem de qualquer estado do painel. Se ao carregares a lista vier vazia, o que vês é que nenhuma linha de devolução cumpre o filtro de conta e data.

«Ao carregar, atualizam-se os valores de devoluções do painel»

O código do botão apenas abre a lista. Não conta nada nem guarda nada no painel. Quem recalcula os valores é outro caminho, que funciona sem carregares em nada: a tarefa agendada Amazon SP-API - Atualizar KPIs (Amazon SP-API - Refresh KPIs), que corre todos os dias e vem ativa ao instalar o módulo. Essa tarefa usa exatamente o mesmo filtro de devoluções que o botão: conta as linhas que o cumprem, soma o seu valor reembolsado e guarda ambos os valores no painel.

A consequência prática é que a lista que o botão abre e o valor do painel saem do mesmo critério. A lista constrói-se no momento em que carregas; o valor do painel é o que ficou da última execução da tarefa.

«Mostra todas as devoluções da Amazon»

O filtro inclui a conta Amazon do painel. Cada painel pertence a uma conta, e o botão mostra apenas as devoluções dessa conta, não as de outras que tenhas ligadas.

«O período mede-se pela data em que a devolução foi importada»

O filtro de datas usa a data de pedido da devolução, não a de importação. O comentário do código explica a razão: uma importação do histórico marca com a data do momento tudo o que traz, e isso meteria todas as devoluções antigas no período recente e faria com que o painel não coincidisse com a vista de análise. Com a data de pedido, cada devolução cai no período em que foi pedida.

«O botão modifica devoluções»

O método do botão limita-se a devolver a ação que abre a lista, com o seu filtro. Não escreve em nenhuma devolução nem em nenhum outro registo. É um botão de consulta: podes carregar nele as vezes que quiseres sem alterar dados.

Passo a passo para o usar

1. Entra no menu Amazon. Precisas da permissão Visualizador para ver esse troço.
2. Abre o ecrã Painel da conta que te interessa.
3. Carrega em Ver Devoluções.
4. Revê a lista de linhas de devolução que se abre: já vem filtrada pela conta do painel e pela data de pedido.

Não há um passo prévio de configuração que dependa do botão: vê-se sempre.

Como se chama consoante o idioma

O rótulo muda com o idioma do teu Odoo. Em português é Ver Devoluções; o módulo publica ainda traduções para outros idiomas.

O que precisas para o ter

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, com até três contas Amazon. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Está publicado no Odoo Apps para 17, 18, 19 e 20. Podes ver a ficha no Odoo Apps ou a página do módulo em flexigotech.com.

Se queres ajuda com o teu Odoo

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se estás a montar o Odoo para vender na Amazon e queres rever como se ligam o painel e as devoluções ao resto da tua operação, escreve-nos a partir da página do módulo.

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_kpi_dashboard_views.xml
• Código do módulo: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_kpi_dashboard.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html