Salta al contingut principal
EU Marketplace

Posada en marxa d'EU Marketplace Connector a Odoo: camps, estats i primera setmana

Per posar en marxa EU Marketplace Connector revises els camps d'empresa, divisa de liquidació i magatzem per defecte i, si vens a Cdiscount, les dades d'Octopia. Després segueixes els estats de cada registre (les connexions en Connected, els anuncis en Active) i, durant la primera setmana, repasses connexions, comandes i liquidacions amb línies no conciliades.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Quins ajustos i camps cal omplir en començar

Quins camps generals he de revisar abans de res?

El mòdul defineix un camp company_id que apunta a res.company (l'empresa), un settlement_currency_id que apunta a res.currency (la divisa) i un default_warehouse_id que apunta a stock.warehouse (el magatzem). També hi ha un camp de text Webhook URL (webhook_url). Abans de continuar, comprova que l'empresa, la divisa i el magatzem que tries són els que vols fer servir amb el connector.

Què demana el mòdul per vendre a Cdiscount a través d'Octopia?

Hi ha un grup de camps amb el prefix octopia_. Això és el que diu l'ajuda de cadascun:

  • Octopia Seller ID (octopia_seller_id): s'envia com a capçalera SellerId en cada crida a Octopia, i l'ajuda remet al back office de venedor de Cdiscount.
  • Octopia Sales Channel (octopia_sales_channel): l'ajuda indica que CDISFR correspon a Cdiscount France.
  • Octopia Delivery Modes (octopia_delivery_modes): els modes de lliurament que s'ofereixen a cada oferta, separats per comes; un dels formats que dona l'ajuda és CODE:cost.
  • Octopia Preparation Time (days) (octopia_preparation_time): un nombre enter, en dies.
  • Octopia VAT Rate (%) (octopia_vat_rate): el tipus d'IVA que es declara a les ofertes, en percentatge. L'ajuda posa com a exemple 20 = 20 % i el descriu com el tipus general francès.

El tipus d'IVA que escriguis és el que el mòdul declara a les teves ofertes, així que confirma'l amb qui et porti la fiscalitat abans de publicar.

On són les correspondències de categories, atributs i transportistes?

El mòdul té diverses llistes relacionades: category_mapping_ids (model mkt.category.mapping), attribute_mapping_ids (mkt.attribute.mapping) i carrier_mapping_ids (mkt.carrier.mapping). Al costat hi ha listing_ids (mkt.listing) i kpi_threshold_ids (mkt.kpi.threshold). Per veure quines columnes demana cada llista, obre-la en una base de proves abans de carregar dades reals.

Què faig amb els logs i amb Sentry?

A Log Retention (days) (mkt_log_retention_days) indiques un nombre de dies: els logs de crides a l'API i de les feines de sincronització més antics que aquest valor es purguen automàticament. Decideix quant historial vols conservar per poder revisar el que passi la primera setmana. A Sentry DSN (mkt_sentry_dsn), si l'omples, les excepcions de sincronització no controlades s'envien a Sentry; si el deixes en blanc, queda desactivat.

Quins estats recorre cada registre

Quin estat han de mostrar una connexió i un anunci?

Entre els camps state del mòdul n'hi ha un amb els valors Draft, Connected, Error i Restricted: és el conjunt on hi ha Connected, l'estat que ensenya la llista de connexions quan la filtres així. Un altre state té Draft, Active, Paused, Ended i Error. Active és l'estat dels anuncis que veus a All Listings amb el filtre Active, al costat del botó Unpublish.

Llista All Listings de Marketplaces filtrada per Active amb tres anuncis
Marketplaces › All Listings amb el filtre Active: producte, connexió, oferta, estat, preu i botó Unpublish.

Quins altres estats defineix el mòdul?

A més dels dos anteriors, el mòdul té aquests camps d'estat:

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

Per veure en quina vista apareix cadascun i què recorre un registre de principi a fi, tens com funciona EU Marketplace Connector per dins.

Què signifiquen els colors Green, Amber i Red?

El mòdul té quatre camps que prenen els valors Green, Amber i Red: cancellation_status, late_shipment_status, return_rate_status i feedback_status. També existeix la llista kpi_threshold_ids, que apunta a mkt.kpi.threshold. Durant la primera setmana, anota quin color té cadascun dels quatre per tenir una referència amb què comparar més endavant.

Què revisar la primera setmana

Què comprovo cada dia a les connexions?

Obre la llista de connexions amb el filtre Connected. A la seqüència de sota n'apareixen quatre: Allegro PL, Bol.com NL, Cdiscount FR i Kaufland DE, amb la seva empresa, el compte de venedor, l'estat Connected i els errors d'API a zero. Si alguna connexió desapareix d'aquest filtre i la trobes en Error o en Restricted, o si el comptador d'errors d'API deixa d'estar a zero, busca el text de l'avís a els missatges d'error i avisos del mòdul abans de publicar més anuncis en aquesta connexió.

Recorregut per comandes, ofertes, liquidacions i connexions d'EU Marketplace Connector
Comandes de marketplace, ofertes amb el filtre Active, Settlements i connexions amb el filtre Connected.

Què miro a comandes, anuncis i liquidacions?

A Marketplaces › Marketplace Orders revisa que cada comanda porta client, marketplace i ID de comanda, i fixa't en el seu estat de facturació. A All Listings, comprova que els anuncis que esperes són en Active i que el preu és el que has posat.

Llista Marketplace Orders amb tres comandes i estat de facturació Nothing to Invoice
Marketplaces › Marketplace Orders: client, marketplace, ID de comanda, comercial, total a zero i estat Nothing to Invoice.

A Marketplaces › Settlements cada fila mostra el període, el pagament total, les línies conciliades i les que no ho estan, i el mètode d'importació. Repassa les línies no conciliades de cada liquidació. I abans que passin els dies que has fixat a Log Retention (days), revisa els logs de les feines de sincronització que t'interessin, perquè els més antics es purguen.

Llista Settlements amb tres liquidacions de Bol.com NL, Kaufland DE i Allegro PL
Marketplaces › Settlements: període, pagament total en EUR, línies conciliades i no conciliades i mètode d'importació.

Què costa i com t'ajuda FlexigoTech

EU Marketplace Connector està publicat a Odoo Apps per a Odoo 17, 18, 19 i 20, a 9 € sense IVA per versió d'Odoo, pagament únic, segons la fitxa d'Odoo Apps. Aquest pagament no és tot el que costa: en les quatre versions el mòdul necessita la subscripció a FlexigoTech Cloud, pla Connector, de 49 €/mes o 490 €/any sense IVA, amb fins a 3 comptes de la plataforma (el pla Pro, 98 €/mes o 980 €/any sense IVA, admet fins a 10). La connexió passa per FlexigoTech Cloud, que guarda xifrades les credencials, vigila la sincronització i avisa per correu si falla.

Si prefereixes no fer la posada en marxa tot sol, a FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida, per exemple per a un marketplace o un flux concret de la teva empresa.

Continua llegint

Com funciona EU Marketplace Connector a Odoo: menús, tasques i glossariMenús, estats en pantalla i tasques programades d'EU Marketplace Connector per a Odoo, explicats com a glossari per a qui ja treballa amb Odoo.Errors d'EU Marketplace Connector a Odoo: què vol dir cada missatge i què ferEls missatges d'error d'EU Marketplace Connector a Odoo, amb el seu text literal: credencials a FlexigoTech Cloud, Allegro, Octopia, comandes, devolucions.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts