Quelle API Storecove utilise le connecteur et ce dont vous avez besoin
Le connecteur travaille avec https://api.storecove.com/api/v2. Selon sa fiche, il envoie des factures et des avoirs sur Peppol, SDI, KSeF, FACeB2B et plus de 30 réseaux. Il fait aussi entrer dans Odoo des factures fournisseurs et des commandes.
Vous avez besoin de :
- Un compte Storecove. La fiche indique qu'une sandbox gratuite de 30 jours est disponible.
- L'abonnement FlexigoTech Cloud (plan Connecteur). Le compte que vous créez y conserve sa clé, jamais dans Odoo.
Les entités légales, l'identifiant de chaque contact et l'envoi des factures sont traités dans Storecove Peppol depuis Odoo.
La clé d'API Storecove et le consentement
Vous créez le compte Storecove dans Odoo, et la clé se saisit dans le champ API key (FlexigoTech Cloud). Son aide dit : Sent once, encrypted, to FlexigoTech Cloud. It is never stored in Odoo.
Avant de l'enregistrer, un administrateur doit accepter que la clé et les appels à Storecove passent par FlexigoTech Cloud. S'il ne l'a pas fait, le connecteur s'arrête avec ce message :
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.
Supprimer la clé de FlexigoTech Cloud relève aussi d'un administrateur. Un autre utilisateur voit Only an administrator can delete the Storecove API key from FlexigoTech Cloud.
Sandbox et production sur l'API Storecove
Un compte Storecove dans Odoo est Non connecté, Connecté ou Erreur de connexion. Le démarrage rapide du connecteur commence par créer le compte avec sa clé et utiliser Tester la connexion.
Le connecteur fournit un catalogue de schémas d'identifiant couvrant plus de 50 pays, avec des identifiants de test pour la sandbox. Pour envoyer une facture de test, vous avez Storecove › Outils › Envoyer une facture de test.

La file de webhooks Storecove, les documents bruts et le journal
| Quoi | Où | Quand cela agit |
|---|---|---|
Storecove : envoyer les factures électroniques en file d'attente | Action planifiée, active à l'installation | Toutes les 5 minutes |
Storecove : interroger la file des webhooks (mode pull) | Action planifiée, active à l'installation | Toutes les 5 minutes |
Envoyer une facture de test | Menu Storecove › Outils | Quand vous l'ouvrez |
Envoyer un document brut (UBL/CII/IDOC) | Menu Storecove › Outils | Quand vous l'ouvrez |
Journal de synchronisation | Menu Storecove › Configuration | Quand vous l'ouvrez |
Avec le menu des documents bruts, vous envoyez à Storecove un document UBL, CII ou IDOC.

Erreurs de l'API Storecove et que faire
| Message | Quand il apparaît | Que faire |
|---|---|---|
Save the API key of … in FlexigoTech Cloud first: nothing was sent. | La clé de ce compte n'a pas encore été enregistrée dans FlexigoTech Cloud | Enregistrez la clé dans la section FlexigoTech Cloud du compte |
The API key of … is not saved in FlexigoTech Cloud: type it again. | FlexigoTech Cloud n'a aucune clé stockée pour ce compte | Saisissez de nouveau la clé |
This Storecove account goes through FlexigoTech Cloud: its API key is kept there, never in Odoo. Save it in the FlexigoTech Cloud section. | En essayant d'enregistrer la clé dans Odoo | Enregistrez la clé dans la section FlexigoTech Cloud |
Une taxe par ligne
Selon l'avertissement du connecteur, chaque ligne de la facture électronique nécessite exactement une taxe VAT/GST en pourcentage. L'avertissement apparaît quand une ligne n'a pas exactement une taxe ou quand cette taxe n'est pas en pourcentage. Il nomme la ligne, combien de taxes elle comporte et de quel type. Les frais fixes, comme les éco-taxes ou la DEEE, vont en lignes séparées ou en remise ou rabais.
Redirections
Si Storecove répond à un appel passé par FlexigoTech Cloud avec un code d'état HTTP supérieur ou égal à 300 et inférieur à 400, le connecteur renvoie Storecove answered … … with an unexpected HTTP redirect (…) through FlexigoTech Cloud. L'avertissement indique la méthode, le chemin et le code d'état HTTP.
Notifications mal formées
Le connecteur vérifie que chaque notification Storecove est un objet JSON et que celles de type document_submission portent un guid. Sinon, il renvoie Le corps du webhook n'est pas un objet JSON. ou Webhook document_submission sans guid.
Questions sur l'API Storecove avec Odoo
Odoo stocke-t-il la clé d'API Storecove ?
Non. Elle est envoyée une seule fois, chiffrée, à FlexigoTech Cloud, et n'est jamais stockée dans Odoo. Seul un administrateur peut la supprimer de là-bas.
À quelle fréquence Odoo vérifie-t-il la file des webhooks Storecove ?
Toutes les 5 minutes, grâce à l'action planifiée Storecove : interroger la file des webhooks (mode pull), active dès que le connecteur est installé.
Puis-je envoyer moi-même un document UBL, CII ou IDOC ?
Oui, depuis Storecove › Outils › Envoyer un document brut (UBL/CII/IDOC).
Ai-je besoin de l'abonnement FlexigoTech Cloud pour utiliser l'API Storecove ?
Oui. Le connecteur a besoin de l'abonnement FlexigoTech Cloud (plan Connecteur), car la clé et les appels à Storecove passent par lui. Vous le trouverez sur Odoo Apps et sur la page du connecteur sur flexigotech.com.
À lire aussi
Vérifié dans le code du connecteur (version 20.0)
Sources
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): __manifest__.py
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_api_client.py
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): models/fgt_cloud.py
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): data/storecove_cron_data.xml
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): views/menu.xml
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_account.py
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): README.md
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_document_submission.py
- Code du module : flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_invoice_builder.py
