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.

La coda webhook di Storecove, i documenti grezzi e il registro
| Cosa | Dove | Quando agisce |
|---|---|---|
Storecove: invia le fatture elettroniche in coda | Azione pianificata, attiva all'installazione | Ogni 5 minuti |
Storecove: interroga la coda webhook (modalità pull) | Azione pianificata, attiva all'installazione | Ogni 5 minuti |
Invia fattura di prova | Menu Storecove › Strumenti | Quando lo apri |
Invia Documento Grezzo (UBL/CII/IDOC) | Menu Storecove › Strumenti | Quando lo apri |
Registro di sincronizzazione | Menu Storecove › Configurazione | Quando lo apri |
Con il menu del documento grezzo invii a Storecove un documento UBL, CII o IDOC.

Errori della Storecove API e cosa fare
| Messaggio | Quando compare | Cosa fare |
|---|---|---|
Save the API key of … in FlexigoTech Cloud first: nothing was sent. | La chiave di quell'account non è ancora stata salvata in FlexigoTech Cloud | Salva 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'account | Digita 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 Odoo | Salva 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
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
