Vai al contenuto principale
Storecove

Storecove API in Odoo: chiave in FlexigoTech Cloud, sandbox, coda webhook ed errori

Storecove Odoo Connector usa la Storecove API v2 (https://api.storecove.com/api/v2) e le sue chiamate passano da FlexigoTech Cloud. La chiave API non viene mai salvata in Odoo: viene inviata una sola volta, cifrata, a FlexigoTech Cloud. Un'azione pianificata interroga la coda webhook di Storecove ogni 5 minuti in modalità pull. Un menu permette anche di inviare documenti UBL, CII o IDOC grezzi.

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

In breve

Modulo
Storecove
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0
Lettura
4 min

Quale Storecove API usa il connettore e cosa serve

Il connettore lavora su https://api.storecove.com/api/v2. Secondo la sua scheda, invia fatture e note di credito su Peppol, SDI, KSeF, FACeB2B e più di 30 reti. Porta inoltre in Odoo fatture fornitore e ordini.

Servono:

  • Un account Storecove. La scheda indica che è disponibile una sandbox gratuita di 30 giorni.
  • L'abbonamento a FlexigoTech Cloud (piano Connettore). L'account che crei custodisce lì la sua chiave, mai in Odoo.

Le entità legali, l'identificativo di ogni contatto e l'invio delle fatture sono trattati in Storecove Peppol da Odoo.

La chiave della Storecove API e il consenso

L'account Storecove si crea in Odoo e la chiave va nel campo API key (FlexigoTech Cloud). Il suo testo di aiuto dice: Sent once, encrypted, to FlexigoTech Cloud. It is never stored in Odoo.

Prima di salvarla, un amministratore deve accettare che la chiave e le chiamate a Storecove passino da FlexigoTech Cloud. Se non l'ha fatto, il connettore si ferma con questo messaggio:

Before saving the API key, an administrator has to accept that the key and the calls to Storecove go through FlexigoTech Cloud. Nothing was sent.

Anche eliminare la chiave da FlexigoTech Cloud spetta a un amministratore. Un altro utente vede Only an administrator can delete the Storecove API key from FlexigoTech Cloud.

Sandbox e produzione sulla Storecove API

Un account Storecove in Odoo può essere Non connesso, Connesso o Errore di connessione. La guida rapida del connettore inizia creando l'account con la sua chiave e usando Prova connessione.

Il connettore include un catalogo di schemi di identificativo che copre più di 50 paesi, con identificativi di prova per la sandbox. Per inviare una fattura di prova hai Storecove › Strumenti › Invia fattura di prova.

Elenco degli schemi di identificativo del connettore con paese, codice, nome, uso B2B o B2G, tipo di identificativo e un identificativo di prova in alcuni paesi
Gli schemi di identificativo del connettore; in alcuni paesi, con un identificativo di prova

La coda webhook di Storecove, i documenti grezzi e il registro

CosaDoveQuando agisce
Storecove: invia le fatture elettroniche in codaAzione pianificata, attiva all'installazioneOgni 5 minuti
Storecove: interroga la coda webhook (modalità pull)Azione pianificata, attiva all'installazioneOgni 5 minuti
Invia fattura di provaMenu Storecove › StrumentiQuando lo apri
Invia Documento Grezzo (UBL/CII/IDOC)Menu Storecove › StrumentiQuando lo apri
Registro di sincronizzazioneMenu Storecove › ConfigurazioneQuando lo apri

Con il menu del documento grezzo invii a Storecove un documento UBL, CII o IDOC.

Scheda di un invio di fattura Storecove in coda, con la barra di stato, l'account sandbox, il GUID dell'invio e le schede Evidence e Request Payload
Un invio di fattura in coda, con un'API simulata e dati demo

Errori della Storecove API e cosa fare

MessaggioQuando compareCosa fare
Save the API key of … in FlexigoTech Cloud first: nothing was sent.La chiave di quell'account non è ancora stata salvata in FlexigoTech CloudSalva la chiave nella sezione FlexigoTech Cloud dell'account
The API key of … is not saved in FlexigoTech Cloud: type it again.FlexigoTech Cloud non ha nessuna chiave salvata per quell'accountDigita di nuovo la chiave
This Storecove account goes through FlexigoTech Cloud: its API key is kept there, never in Odoo. Save it in the FlexigoTech Cloud section.Quando si prova a salvare la chiave in OdooSalva la chiave nella sezione FlexigoTech Cloud

Un'imposta per riga

Secondo l'avviso del connettore, ogni riga della fattura elettronica richiede esattamente un'imposta percentuale IVA/GST. L'avviso compare quando una riga non ha esattamente un'imposta o quando quell'imposta non è percentuale. Indica la riga, quante imposte ha e di che tipo. I costi fissi, come eco-tasse o DEEE, vanno come righe separate oppure come sconto o maggiorazione.

Reindirizzamenti

Se Storecove risponde a una chiamata fatta tramite FlexigoTech Cloud con un codice di stato HTTP pari o superiore a 300 e inferiore a 400, il connettore restituisce Storecove answered … … with an unexpected HTTP redirect (…) through FlexigoTech Cloud. L'avviso riporta il metodo, il percorso e il codice di stato HTTP.

Notifiche malformate

Il connettore verifica che ogni notifica di Storecove sia un oggetto JSON e che quelle di tipo document_submission portino un guid. In caso contrario restituisce Il corpo del webhook non è un oggetto JSON. oppure Webhook document_submission senza guid.

Domande sulla Storecove API con Odoo

Odoo salva la chiave della Storecove API?

No. Viene inviata una sola volta, cifrata, a FlexigoTech Cloud e non viene mai salvata in Odoo. Solo un amministratore può eliminarla da lì.

Ogni quanto Odoo controlla la coda webhook di Storecove?

Ogni 5 minuti, tramite l'azione pianificata Storecove: interroga la coda webhook (modalità pull), attiva una volta installato il connettore.

Posso inviare io stesso un documento UBL, CII o IDOC?

Sì, da Storecove › Strumenti › Invia Documento Grezzo (UBL/CII/IDOC).

Mi serve l'abbonamento a FlexigoTech Cloud per usare la Storecove API?

Sì. Il connettore richiede l'abbonamento a FlexigoTech Cloud (piano Connettore), perché la chiave e le chiamate a Storecove passano da lì. Lo trovi su Odoo Apps e nella pagina del connettore su flexigotech.com.

Continua a leggere

Storecove Peppol da Odoo: entità legale, identificativo e fattureCome inviare e ricevere fatture Peppol con Storecove da Odoo: entità legale, identificativo Peppol, raggiungibilità del cliente e fatture in arrivo.
Verificato nel codice del connettore (versione 20.0)

Fonti

  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): __manifest__.py
  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_api_client.py
  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/fgt_cloud.py
  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): data/storecove_cron_data.xml
  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): views/menu.xml
  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_account.py
  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): README.md
  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_document_submission.py
  • Codice del modulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_invoice_builder.py