Saltar para o conteúdo principal
EU Marketplace

Arranque do EU Marketplace Connector no Odoo: campos, estados e primeira semana

Para arrancar o EU Marketplace Connector, revês os campos da empresa, a moeda de liquidação e o armazém por defeito e, se vendes na Cdiscount, os dados da Octopia. Depois acompanhas os estados de cada registo (as ligações em Connected, os anúncios em Active) e, durante a primeira semana, revês ligações, encomendas e liquidações com linhas não reconciliadas.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

Que definições e campos preencher no início

Que campos gerais tenho de rever antes de mais?

O módulo define um campo company_id que aponta para res.company (a empresa), um settlement_currency_id que aponta para res.currency (a moeda) e um default_warehouse_id que aponta para stock.warehouse (o armazém). Existe também um campo de texto Webhook URL (webhook_url). Antes de avançares, confirma que a empresa, a moeda e o armazém que escolhes são os que queres usar com o conector.

Que pede o módulo para vender na Cdiscount através da Octopia?

Há um grupo de campos com o prefixo octopia_. Isto é o que diz a ajuda de cada um:

  • Octopia Seller ID (octopia_seller_id): é enviado como cabeçalho SellerId em cada chamada à Octopia, e a ajuda remete para o back office de vendedor da Cdiscount.
  • Octopia Sales Channel (octopia_sales_channel): a ajuda indica que CDISFR corresponde à Cdiscount France.
  • Octopia Delivery Modes (octopia_delivery_modes): os modos de entrega oferecidos em cada oferta, separados por vírgulas; um dos formatos que a ajuda indica é CODE:cost.
  • Octopia Preparation Time (days) (octopia_preparation_time): um número inteiro, em dias.
  • Octopia VAT Rate (%) (octopia_vat_rate): a taxa de IVA declarada nas ofertas, em percentagem. A ajuda dá como exemplo 20 = 20 % e descreve-a como a taxa geral francesa.

A taxa de IVA que escreveres é a que o módulo declara nas tuas ofertas, por isso confirma-a com quem trata da tua fiscalidade antes de publicar.

Onde estão as correspondências de categorias, atributos e transportadoras?

O módulo tem várias listas relacionadas: category_mapping_ids (modelo mkt.category.mapping), attribute_mapping_ids (mkt.attribute.mapping) e carrier_mapping_ids (mkt.carrier.mapping). Junto a elas estão listing_ids (mkt.listing) e kpi_threshold_ids (mkt.kpi.threshold). Para ver que colunas pede cada lista, abre-a numa base de dados de testes antes de carregares dados reais.

Que faço com os logs e com o Sentry?

Em Log Retention (days) (mkt_log_retention_days) indicas um número de dias: os logs das chamadas à API e dos trabalhos de sincronização mais antigos do que esse valor são eliminados automaticamente. Decide quanto histórico queres conservar para poderes rever o que acontecer na primeira semana. Em Sentry DSN (mkt_sentry_dsn), se o preencheres, as exceções de sincronização não tratadas são enviadas para o Sentry; se o deixares em branco, fica desativado.

Que estados percorre cada registo

Que estado devem mostrar uma ligação e um anúncio?

Entre os campos state do módulo há um com os valores Draft, Connected, Error e Restricted: é o conjunto onde está Connected, o estado que a lista de ligações mostra quando a filtras assim. Outro state tem Draft, Active, Paused, Ended e Error. Active é o estado dos anúncios que vês em All Listings com o filtro Active, junto ao botão Unpublish.

Lista All Listings de Marketplaces filtrada por Active com três anúncios
Marketplaces › All Listings com o filtro Active: produto, ligação, oferta, estado, preço e botão Unpublish.

Que outros estados define o módulo?

Além dos dois anteriores, o módulo tem estes campos de estado:

  • status_flag: Normal, Address Incomplete e Cancelled (post-fulfilment).
  • Um state com Requested, In Transit, Received, Approved, Rejected e Refunded.
  • Um state com Draft, Matched e Posted.
  • Um match_status com Matched, Unmatched e Partial.
  • Um state com Running, Done e Failed.

Para ver em que vista aparece cada um e o que percorre um registo do princípio ao fim, tens como funciona o EU Marketplace Connector por dentro.

Que significam as cores Green, Amber e Red?

O módulo tem quatro campos que tomam os valores Green, Amber e Red: cancellation_status, late_shipment_status, return_rate_status e feedback_status. Existe também a lista kpi_threshold_ids, que aponta para mkt.kpi.threshold. Durante a primeira semana, anota que cor tem cada um dos quatro para teres uma referência com que comparar mais tarde.

O que rever na primeira semana

O que verifico todos os dias nas ligações?

Abre a lista de ligações com o filtro Connected. Na sequência abaixo aparecem quatro: Allegro PL, Bol.com NL, Cdiscount FR e Kaufland DE, com a respetiva empresa, a conta de vendedor, o estado Connected e os erros de API a zero. Se alguma ligação desaparecer desse filtro e a encontrares em Error ou em Restricted, ou se o contador de erros de API deixar de estar a zero, procura o texto do aviso em as mensagens de erro e avisos do módulo antes de publicares mais anúncios nessa ligação.

Percurso por encomendas, ofertas, liquidações e ligações do EU Marketplace Connector
Encomendas de marketplace, ofertas com o filtro Active, Settlements e ligações com o filtro Connected.

O que vejo em encomendas, anúncios e liquidações?

Em Marketplaces › Marketplace Orders verifica se cada encomenda traz cliente, marketplace e ID de encomenda, e repara no respetivo estado de faturação. Em All Listings, confirma que os anúncios que esperas estão em Active e que o preço é o que definiste.

Lista Marketplace Orders com três encomendas e estado de faturação Nothing to Invoice
Marketplaces › Marketplace Orders: cliente, marketplace, ID de encomenda, comercial, total a zero e estado Nothing to Invoice.

Em Marketplaces › Settlements cada linha mostra o período, o pagamento total, as linhas reconciliadas e as não reconciliadas, e o método de importação. Revê as linhas não reconciliadas de cada liquidação. E antes de passarem os dias que fixaste em Log Retention (days), revê os logs dos trabalhos de sincronização que te interessem, porque os mais antigos são eliminados.

Lista Settlements com três liquidações de Bol.com NL, Kaufland DE e Allegro PL
Marketplaces › Settlements: período, pagamento total em EUR, linhas reconciliadas e não reconciliadas e método de importação.

Quanto custa e como te ajuda a FlexigoTech

O EU Marketplace Connector está publicado no Odoo Apps para Odoo 17, 18, 19 e 20, a 9 € sem IVA por versão do Odoo, pagamento único, segundo a ficha do Odoo Apps. Esse pagamento não é tudo o que custa: nas quatro versões o módulo precisa da subscrição do FlexigoTech Cloud, plano Conector, de 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma (o plano Pro, 98 €/mês ou 980 €/ano sem IVA, admite até 10). A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar.

Se preferires não fazer o arranque sozinho, na FlexigoTech implementamos Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida, por exemplo para um marketplace ou um fluxo concreto da tua empresa.

Continue a ler

Como funciona o EU Marketplace Connector no Odoo: menus, tarefas e glossárioMenus, estados no ecrã e tarefas agendadas do EU Marketplace Connector para Odoo, explicados em glossário para quem já trabalha com Odoo.Erros do EU Marketplace Connector no Odoo: o que significa cada mensagem e o que fazerAs mensagens de erro do EU Marketplace Connector no Odoo, com o texto literal: credenciais na FlexigoTech Cloud, Allegro, Octopia, encomendas, devoluções.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes