Aller au contenu principal
Storecove

API Storecove dans Odoo : clé dans FlexigoTech Cloud, sandbox, file de webhooks et erreurs

Storecove Odoo Connector utilise l'API Storecove v2 (https://api.storecove.com/api/v2), et ses appels passent par FlexigoTech Cloud. La clé d'API n'est jamais stockée dans Odoo : elle est envoyée une seule fois, chiffrée, à FlexigoTech Cloud. Une action planifiée interroge la file des webhooks Storecove toutes les 5 minutes en mode pull. Un menu permet aussi d'envoyer des documents UBL, CII ou IDOC bruts.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 12 novembre 2026

L'essentiel

Module
Storecove
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0
Lecture
4 min

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.

Liste des schémas d'identifiant du connecteur avec pays, code, nom, usage B2B ou B2G, type d'identifiant et identifiant de test dans certains pays
Les schémas d'identifiant du connecteur ; dans certains pays, avec un identifiant de test

La file de webhooks Storecove, les documents bruts et le journal

QuoiOùQuand cela agit
Storecove : envoyer les factures électroniques en file d'attenteAction planifiée, active à l'installationToutes les 5 minutes
Storecove : interroger la file des webhooks (mode pull)Action planifiée, active à l'installationToutes les 5 minutes
Envoyer une facture de testMenu Storecove › OutilsQuand vous l'ouvrez
Envoyer un document brut (UBL/CII/IDOC)Menu Storecove › OutilsQuand vous l'ouvrez
Journal de synchronisationMenu Storecove › ConfigurationQuand vous l'ouvrez

Avec le menu des documents bruts, vous envoyez à Storecove un document UBL, CII ou IDOC.

Formulaire d'un envoi de facture Storecove dans la file, avec la barre d'état, le compte sandbox, le GUID de l'envoi et les onglets Evidence et Request Payload
Un envoi de facture en file d'attente, avec une API simulée et des données de démonstration

Erreurs de l'API Storecove et que faire

MessageQuand il apparaîtQue 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 CloudEnregistrez 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 compteSaisissez 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 OdooEnregistrez 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

Storecove Peppol depuis Odoo : entité légale, identifiant et facturesEnvoyer et recevoir des factures Peppol avec Storecove depuis Odoo : entité légale, identifiant Peppol, accessibilité du client et factures reçues.
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