Vai al contenuto principale
EU Marketplace

Messa in funzione di EU Marketplace Connector in Odoo: campi, stati e prima settimana

Per mettere in funzione EU Marketplace Connector controlli i campi di azienda, valuta di liquidazione e magazzino predefinito e, se vendi su Cdiscount, i dati di Octopia. Poi segui gli stati di ogni record (le connessioni in Connected, gli annunci in Active) e, durante la prima settimana, ripassi connessioni, ordini e liquidazioni con righe non riconciliate.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 4 novembre 2026

In breve

Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0 · nelle fonti collegate in fondo
Lettura
5 min

Quali impostazioni e campi compilare all'inizio

Quali campi generali devo controllare prima di tutto?

Il modulo definisce un campo company_id che punta a res.company (l'azienda), un settlement_currency_id che punta a res.currency (la valuta) e un default_warehouse_id che punta a stock.warehouse (il magazzino). C'è anche un campo di testo Webhook URL (webhook_url). Prima di proseguire, verifica che l'azienda, la valuta e il magazzino che scegli siano quelli che vuoi usare con il connettore.

Cosa richiede il modulo per vendere su Cdiscount tramite Octopia?

C'è un gruppo di campi con il prefisso octopia_. Ecco cosa dice l'aiuto di ciascuno:

  • Octopia Seller ID (octopia_seller_id): viene inviato come intestazione SellerId in ogni chiamata a Octopia, e l'aiuto rimanda al back office venditore di Cdiscount.
  • Octopia Sales Channel (octopia_sales_channel): l'aiuto indica che CDISFR corrisponde a Cdiscount France.
  • Octopia Delivery Modes (octopia_delivery_modes): le modalità di consegna offerte in ogni offerta, separate da virgole; uno dei formati indicati dall'aiuto è CODE:cost.
  • Octopia Preparation Time (days) (octopia_preparation_time): un numero intero, in giorni.
  • Octopia VAT Rate (%) (octopia_vat_rate): l'aliquota IVA dichiarata nelle offerte, in percentuale. L'aiuto riporta come esempio 20 = 20 % e la descrive come l'aliquota generale francese.

L'aliquota IVA che scrivi è quella che il modulo dichiara nelle tue offerte, quindi confermala con chi segue la tua fiscalità prima di pubblicare.

Dove si trovano le corrispondenze di categorie, attributi e vettori?

Il modulo ha diverse liste collegate: category_mapping_ids (modello mkt.category.mapping), attribute_mapping_ids (mkt.attribute.mapping) e carrier_mapping_ids (mkt.carrier.mapping). Accanto a queste ci sono listing_ids (mkt.listing) e kpi_threshold_ids (mkt.kpi.threshold). Per vedere quali colonne richiede ciascuna lista, aprila in un database di prova prima di caricare dati reali.

Cosa faccio con i log e con Sentry?

In Log Retention (days) (mkt_log_retention_days) indichi un numero di giorni: i log delle chiamate all'API e dei processi di sincronizzazione più vecchi di quel valore vengono eliminati automaticamente. Decidi quanto storico vuoi conservare per poter controllare ciò che accade nella prima settimana. In Sentry DSN (mkt_sentry_dsn), se lo compili, le eccezioni di sincronizzazione non gestite vengono inviate a Sentry; se lo lasci vuoto, resta disattivato.

Quali stati attraversa ogni record

Quale stato devono mostrare una connessione e un annuncio?

Tra i campi state del modulo ce n'è uno con i valori Draft, Connected, Error e Restricted: è l'insieme in cui si trova Connected, lo stato che mostra la lista delle connessioni quando la filtri così. Un altro state ha Draft, Active, Paused, Ended e Error. Active è lo stato degli annunci che vedi in All Listings con il filtro Active, accanto al pulsante Unpublish.

Lista All Listings di Marketplaces filtrata per Active con tre annunci
Marketplaces › All Listings con il filtro Active: prodotto, connessione, offerta, stato, prezzo e pulsante Unpublish.

Quali altri stati definisce il modulo?

Oltre ai due precedenti, il modulo ha questi campi di stato:

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

Per vedere in quale vista compare ciascuno e cosa attraversa un record dall'inizio alla fine, trovi come funziona EU Marketplace Connector dall'interno.

Cosa significano i colori Green, Amber e Red?

Il modulo ha quattro campi che assumono i valori Green, Amber e Red: cancellation_status, late_shipment_status, return_rate_status e feedback_status. Esiste anche la lista kpi_threshold_ids, che punta a mkt.kpi.threshold. Durante la prima settimana, annota quale colore ha ciascuno dei quattro per avere un riferimento con cui confrontarti più avanti.

Cosa controllare la prima settimana

Cosa controllo ogni giorno nelle connessioni?

Apri la lista delle connessioni con il filtro Connected. Nella sequenza qui sotto ne compaiono quattro: Allegro PL, Bol.com NL, Cdiscount FR e Kaufland DE, con la loro azienda, l'account venditore, lo stato Connected e gli errori API a zero. Se una connessione sparisce da quel filtro e la trovi in Error o in Restricted, o se il contatore degli errori API non è più a zero, cerca il testo dell'avviso in i messaggi di errore e gli avvisi del modulo prima di pubblicare altri annunci su quella connessione.

Percorso tra ordini, offerte, liquidazioni e connessioni di EU Marketplace Connector
Ordini marketplace, offerte con il filtro Active, Settlements e connessioni con il filtro Connected.

Cosa guardo in ordini, annunci e liquidazioni?

In Marketplaces › Marketplace Orders verifica che ogni ordine abbia cliente, marketplace e ID ordine, e controlla il suo stato di fatturazione. In All Listings, verifica che gli annunci che ti aspetti siano in Active e che il prezzo sia quello che hai impostato.

Lista Marketplace Orders con tre ordini e stato di fatturazione Nothing to Invoice
Marketplaces › Marketplace Orders: cliente, marketplace, ID ordine, commerciale, totale a zero e stato Nothing to Invoice.

In Marketplaces › Settlements ogni riga mostra il periodo, il pagamento totale, le righe riconciliate e quelle non riconciliate, e il metodo di importazione. Ripassa le righe non riconciliate di ogni liquidazione. E prima che passino i giorni che hai fissato in Log Retention (days), controlla i log dei processi di sincronizzazione che ti interessano, perché quelli più vecchi vengono eliminati.

Lista Settlements con tre liquidazioni di Bol.com NL, Kaufland DE e Allegro PL
Marketplaces › Settlements: periodo, pagamento totale in EUR, righe riconciliate e non riconciliate e metodo di importazione.

Quanto costa e come ti aiuta FlexigoTech

EU Marketplace Connector è pubblicato su Odoo Apps per Odoo 17, 18, 19 e 20, a 9 € IVA esclusa per versione di Odoo, pagamento unico, secondo la scheda di Odoo Apps. Quel pagamento non è tutto il costo: in tutte e quattro le versioni il modulo richiede l'abbonamento a FlexigoTech Cloud, piano Connettore, da 49 €/mese o 490 €/anno IVA esclusa, con fino a 3 account della piattaforma (il piano Pro, 98 €/mese o 980 €/anno IVA esclusa, ne ammette fino a 10). La connessione passa da FlexigoTech Cloud, che conserva cifrate le credenziali, monitora la sincronizzazione e avvisa via e-mail se fallisce.

Se preferisci non fare la messa in funzione da solo, in FlexigoTech implementiamo Odoo 17, 18, 19 e 20 e sviluppiamo connettori e integrazioni su misura, per esempio per un marketplace o un flusso specifico della tua azienda.

Continua a leggere

Come funziona EU Marketplace Connector in Odoo: menu, azioni e glossarioMenu, stati a schermo e azioni pianificate di EU Marketplace Connector per Odoo, spiegati come glossario per chi lavora già con Odoo.Errori di EU Marketplace Connector in Odoo: cosa significa ogni messaggio e cosa fareI messaggi di errore di EU Marketplace Connector in Odoo, con il testo letterale: credenziali su FlexigoTech Cloud, Allegro, Octopia, ordini e resi.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti