Campos da conta SP-API da Amazon no Odoo: o que significa cada um e o que preencher

Onde está a ficha e o que se vê ao abri-la

As contas abrem-se a partir do menu Amazon › Configuração › Contas (Amazon › Configuration › Accounts). Cada troço pede uma permissão: Amazon pede Visualizador (Viewer), e Configuração e Contas pedem Gestor (Manager). Se não tiver a permissão de um troço, não o vê.

Os campos deste glossário estão em dois separadores da ficha: Identidade (Identity) e Credenciais (Credentials). Com os valores por defeito, em Credenciais não se veem nem o modo de ligação nem os campos da sua própria app da Amazon. Em cada termo abaixo indica-se quando aparece.

Identidade: marketplace e vendedor

Estão no separador Identidade, grupo Marketplace.

ID do marketplace (Marketplace ID)

Identifica o marketplace da Amazon da conta. Também surge como coluna na lista de Contas. A sua ajuda dá como exemplo Exemplo ES: A1RKKUPIHCS9HS, e esse é o valor que o código define por defeito. O que preencher: confirme que o valor corresponde ao marketplace com que vai trabalhar.

ID de vendedor (ID de comerciante) (Seller ID (Merchant ID))

Segundo a sua ajuda, é necessário para a Listings API (fase 2), com o formato de exemplo A2XXXXXXXXXXXX. O que preencher: o seu identificador de vendedor, se for usar a Listings API.

Credenciais: como se liga a conta

Modo de ligação (Connection Mode)

Escolhe como a conta se liga à Amazon. As opções são FlexigoTech Hub (um clique, recomendado) e A sua própria app da Amazon (avançado). Segundo a sua ajuda, com o Hub liga-se num clique através da app da Amazon já publicada pela FlexigoTech, sem conta de programador e sem credenciais LWA para criar; com a sua própria app fornece o seu próprio id e secret de cliente do Login-with-Amazon. Está no separador Credenciais, grupo Modo de ligação, e no ecrã aparece sem etiqueta: só vê as opções. Com os valores por defeito não se vê, e o valor por defeito do código é o Hub. O que preencher: com os valores por defeito não tem de escolher nada; a conta usa o Hub.

Ligação ao Hub (Hub Connection)

Identificador de ligação opaco emitido pelo hub da FlexigoTech ao ligar. É só de leitura e está no grupo Ligar através do FlexigoTech Hub (Connect via FlexigoTech Hub). Só aparece se o modo for o Hub e o campo tiver valor. É esvaziado pelo botão Desligar (Disconnect). O que preencher: nada, é só de leitura.

A sua própria app da Amazon: os campos LWA e OAuth

Todos os termos desta secção só aparecem se o modo de ligação for A sua própria app da Amazon (avançado). Estão no grupo Credenciais LWA (LWA Credentials) do separador Credenciais.

LWA Refresh Token

O token de refrescamento do Login-with-Amazon. A sua ajuda diz: «Preenche-se automaticamente com “Ligar à Amazon”, ou cole-o manualmente.». Só o veem os utilizadores com permissão de gestão das contas da Amazon SP-API. O que preencher: cole à mão o token de refrescamento da sua app do Login-with-Amazon.

Estado das credenciais LWA (LWA credential status)

Só de leitura. Mostra o resultado da última chamada de token do Login-with-Amazon: Not verified yet (o valor por defeito), Valid ou Rejected by Amazon. É preenchido pelo módulo, não por si. Segundo a sua ajuda, Rejected by Amazon quase sempre significa que o segredo de cliente caducou e é preciso gerar um novo no Seller Central.

Segredo de cliente guardado em (Client secret set on)

Só de leitura. É o momento em que o segredo de cliente LWA atual foi guardado aqui; a sua ajuda acrescenta que a Amazon faz caducar cada segredo de cliente passado um número de dias desde que o emite. É preenchido pela tarefa agendada Amazon SP-API - Warn before the LWA client secret expires, que corre todos os dias e está ativa à instalação. O que preencher: nada.

ID da aplicação SP-API (SP-API Application ID)

Está no subgrupo Ligar à Amazon (um clique, sem token manual) (Connect to Amazon (one-click, no manual token)). A sua ajuda diz que é o id da sua aplicação SP-API da Amazon (amzn1.sp.solution... ou amzn1.application...), necessário para a autoinstalação com um clique de “Ligar à Amazon”. O que preencher: o id da sua app.

OAuth Redirect URI a registar (OAuth Redirect URI to register)

Só de leitura, no mesmo subgrupo. A ajuda pede para copiar exatamente esse URL para Seller Central > Apps & Services > Develop Apps > a sua app > “OAuth Redirect URI(s)”, porque a Amazon devolve aí o vendedor após o ecrã de consentimento. Se apontar para outro Odoo (uma compilação antiga do Odoo.sh, produção em vez de testes, .odoo.com em vez do seu domínio próprio), a ligação acaba em This Odoo has no record of your connection attempt. A ajuda acrescenta que o OAuth Login URI é o mesmo endereço terminado em /oauth/login. O que preencher: nada a escrever; copie-o tal qual para o Seller Central.

Aplicação em rascunho (por publicar) (Draft (unpublished) app)

Caixa do mesmo subgrupo, marcada por defeito no código. Segundo a sua ajuda, acrescenta version=beta ao URL de consentimento e autoriza a revisão em rascunho da sua app. Marque-a apenas enquanto a app estiver em rascunho. Quando a Amazon a mostrar como publicada, desmarque-a: se continuar marcada, continua a autorizar-se a revisão em rascunho e a ligação fica associada em silêncio à versão errada. A ajuda esclarece que “the current revision is in draft” no Seller Central significa que tem edições por enviar, não que a app esteja em estado de rascunho.

Campos opcionais e chave de IA

ID da chave de acesso da AWS, chave de acesso secreta da AWS e ARN da função da AWS (AWS Access Key ID, AWS Secret Access Key, AWS Role ARN)

Três campos do separador Credenciais, todos opcionais segundo a sua ajuda. Se preencher o ID da chave e a chave secreta em conjunto, usa-se assinatura AWS SigV4. Se indicar o ARN da função, assume-se essa função através do STS. A chave secreta só a veem os utilizadores com permissão de gestão das contas da Amazon SP-API. O que preencher: deixe-os vazios se não precisar deles; se usar assinatura SigV4, preencha o ID e a chave ao mesmo tempo.

Chave API de IA (LLM) (AI API Key (LLM))

Está no grupo Insights de IA (LLM) (AI Insights (LLM)) do separador Credenciais e só a veem os utilizadores com permissão de gestão das contas da Amazon SP-API. A sua ajuda diz para colar aqui a sua chave gratuita: Gemini em aistudio.google.com/apikey ou Groq em console.groq.com/keys, sem cartão. O que preencher: a sua chave de um desses dois serviços.

Quanto custa e como o ajudamos

O módulo é de pagamento único por versão do Odoo e está publicado no Odoo Apps para 17, 18, 19 e 20; o preço de cada versão vê-se na sua ficha. Além disso, precisa da subscrição do FlexigoTech Cloud com o plano Conector: 49 € por mês ou 490 € por ano, sem IVA, com até 3 contas. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar. Tem mais detalhe na página do módulo.

Se está a implementar o Odoo e quer que o ajudemos a configurar a conta, 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): 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