Vai al contenuto principale
ManoMano

ManoMano e Odoo: errori frequenti e come risolverli

La maggior parte degli errori del connettore ManoMano in Odoo nasce in quattro punti: la chiave API e il suo ambiente, il contratto del venditore, i dati dell'offerta e lo stato dell'ordine quando provi a spedire o a rimborsare. Ogni messaggio dice cosa non va. Eccoli raggruppati per momento in cui compaiono, con la soluzione.

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

In breve

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

Prima della tabella, un dato che fa risparmiare ore: la sandbox di ManoMano non è sempre accesa. Risponde solo il lunedì dalle 00:00 alle 20:00 e dal martedì al venerdì dalle 07:00 alle 20:00, ora di Parigi. Se fai una prova di sabato e l'API restituisce 404, non è colpa della tua configurazione.

Connessione e account

MessaggioCausa probabileSoluzione
ManoMano API returned 404. Check that: …Chiave inattiva, ambiente sbagliato (Sandbox o Production) o sandbox fuori orario.Controlla chiave e ambiente sull'account e, se è la sandbox, l'orario.
ManoMano authentication failed (…). Please verify the API key on account '…'.ManoMano rifiuta la chiave.Generane una nuova in ManoMano e incollala nell'account di Odoo.
x-thirdparty-name must follow 'Vendor_Version' format (e.g. Flexigobe_1.0).L'identificativo dell'integrazione non segue il formato richiesto da ManoMano.Scrivilo come Vendor_Version.
ManoMano calls of account '…' are paused until … (UTC) after … failed calls in a row.Molte chiamate di fila sono fallite e il connettore si mette in pausa per non martellare l'account.Aspetta: le chiamate ripartono da sole. Oppure premi Test Connection per riprovare subito.
The Seller Contract ID of ManoMano contract '…' is '…': ManoMano's contract IDs are numbers.Hai incollato del testo nel contratto al posto del numero.Copia l'identificativo numerico del contratto.

L'account mostra il suo stato: bozza, connesso, errore di autenticazione o circuito aperto. L'ultimo è la pausa automatica della quarta riga.

Account ManoMano in Odoo con il suo stato di connessione
L'account ManoMano in Odoo, con lo stato della connessione in alto. Schermata di Odoo con dati dimostrativi.

Pubblicare le offerte

  • Select at least one product to publish. La procedura guidata si è aperta senza prodotti selezionati.
  • The following products have no Internal Reference (SKU) and cannot… ManoMano identifica ogni offerta con il suo SKU. Compila il riferimento interno in Odoo.
  • Manual price must be greater than zero. e Product '…' has a price of 0. ManoMano requires a positive price. Un prezzo vuoto o pari a zero non si pubblica. Controlla il listino prezzi o il prezzo manuale della procedura guidata.
Procedura guidata per pubblicare offerte su ManoMano da Odoo
La procedura di pubblicazione: prodotti, prezzo e contratto prima dell'invio. Schermata di Odoo con dati dimostrativi.

Spedizioni e rimborsi

Qui l'errore è quasi sempre una questione di ordine. ManoMano accetta spedizioni solo per ordini accettati, in preparazione o già spediti. Se vedi ManoMano only allows creating shippings for accepted orders…, accetta prima l'ordine. E Tracking number cannot be empty. chiede il numero di tracciamento prima di inviare qualsiasi cosa.

Con i rimborsi è lo stesso: ManoMano only refunds orders it has accepted: in preparation, shipped or refunded in part. Se provi a rimborsare più unità di quelle ordinate, il messaggio ti dice quante ne ha l'ordine. E se non scegli né prodotti né spese di spedizione, ti chiede di scegliere.

Quando un errore sparisce da solo

Le operazioni fallite si ritentano ogni 30 minuti. Se un errore scompare senza che tu faccia nulla, era temporaneo. Se torna a ogni tentativo, apri Tools › API Log: lì trovi la richiesta completa e la risposta di ManoMano.

Registro delle chiamate all'API di ManoMano in Odoo
Il registro delle chiamate: ogni richiesta a ManoMano con la sua risposta. Schermata di Odoo con dati dimostrativi.

Se due record ManoMano puntano a contratti o aziende diversi, Odoo lo blocca con The order, picking or invoice of a ManoMano record must be of its own contract and company. Verifica che ogni contratto appartenga all'azienda giusta.

Continua a leggere

Fatture ManoMano da Odoo: domande e risposteCome si caricano su ManoMano da Odoo 17, 18, 19 e 20 le fatture e le note di credito di ogni ordine: stati, formato PDF, ordine di caricamento ed errori.Ti serve un ERP per vendere su ManoMano? I segnaliUna checklist per capire se la tua attività su ManoMano ha già bisogno di un ERP, e cosa fa Odoo con il connettore: ordini, offerte, giacenze, vettori, traduzioni.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti

  • Codice del modulo: flexigobe_manomano_connector (093b2e34): models/manomano_account.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_account.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_api_client.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_contract.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_fgt_cloud.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): wizard/offer_publish_wizard.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): wizard/refund_create_wizard.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): wizard/shipping_create_wizard.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_binding_mixin.py
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): data/manomano_cron.xml
  • Codice del modulo: flexigobe_manomano_connector 20.0 (093b2e34): views/menu.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_manomano_connector