Naar hoofdinhoud
Storecove

Storecove API in Odoo: sleutel in FlexigoTech Cloud, sandbox, webhookwachtrij en fouten

Storecove Odoo Connector gebruikt de Storecove API v2 (https://api.storecove.com/api/v2) en de aanroepen lopen via FlexigoTech Cloud. De API-sleutel wordt nooit in Odoo bewaard: hij wordt één keer versleuteld naar FlexigoTech Cloud gestuurd. Een geplande actie pollt elke 5 minuten de Storecove-webhookwachtrij in pull-modus. Via een menu kun je ook ruwe UBL-, CII- of IDOC-documenten verzenden.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 12 november 2026

In het kort

Module
Storecove
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0
Leestijd
4 min

Welke Storecove API de connector gebruikt en wat je nodig hebt

De connector werkt met https://api.storecove.com/api/v2. Volgens de omschrijving verstuurt hij facturen en creditfacturen via Peppol, SDI, KSeF, FACeB2B en meer dan 30 netwerken. Hij haalt ook leveranciersfacturen en orders binnen in Odoo.

Je hebt nodig:

  • Een Storecove-account. Volgens de omschrijving is er een gratis sandbox van 30 dagen beschikbaar.
  • Het FlexigoTech Cloud-abonnement (plan Connector). Het account dat je aanmaakt bewaart zijn sleutel daar, nooit in Odoo.

Juridische entiteiten, de identificator van elk contact en het verzenden van facturen komen aan bod in Storecove Peppol vanuit Odoo.

De Storecove API-sleutel en toestemming

Je maakt het Storecove-account aan in Odoo en de sleutel komt in het veld API key (FlexigoTech Cloud). De helptekst zegt: Sent once, encrypted, to FlexigoTech Cloud. It is never stored in Odoo.

Voordat je hem opslaat, moet een beheerder accepteren dat de sleutel en de aanroepen naar Storecove via FlexigoTech Cloud lopen. Is dat niet gebeurd, dan stopt de connector met deze melding:

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.

Ook het verwijderen van de sleutel uit FlexigoTech Cloud is aan een beheerder. Een andere gebruiker ziet Only an administrator can delete the Storecove API key from FlexigoTech Cloud.

Sandbox en productie in de Storecove API

Een Storecove-account in Odoo is Niet verbonden, Verbonden of Verbindingsfout. De snelstart van de connector begint met het aanmaken van het account met zijn sleutel en het gebruik van Verbinding testen.

De connector bevat een catalogus met identificatieschema's voor meer dan 50 landen, met testidentificatoren voor de sandbox. Om een testfactuur te versturen heb je Storecove › Hulpmiddelen › Testfactuur verzenden.

Lijst met de identificatieschema's van de connector met land, code, naam, B2B- of B2G-gebruik, type identificator en in sommige landen een testidentificator
De identificatieschema's van de connector; in sommige landen met een testidentificator

De Storecove-webhookwachtrij, ruwe documenten en het logboek

WatWaarWanneer het werkt
Storecove: e-facturen in wachtrij verzendenGeplande actie, actief bij installatieElke 5 minuten
Storecove: webhookwachtrij pollen (pull-modus)Geplande actie, actief bij installatieElke 5 minuten
Testfactuur verzendenMenu Storecove › HulpmiddelenWanneer je het opent
Ruw document verzenden (UBL/CII/IDOC)Menu Storecove › HulpmiddelenWanneer je het opent
SynchronisatielogboekMenu Storecove › ConfiguratieWanneer je het opent

Met het menu voor ruwe documenten stuur je Storecove een UBL-, CII- of IDOC-document.

Formulier van een Storecove-factuurverzending in de wachtrij, met de statusbalk, het sandboxaccount, de GUID van de verzending en de tabbladen Evidence en Request Payload
Een factuurverzending in de wachtrij, met een gesimuleerde API en demogegevens

Fouten van de Storecove API en wat je eraan doet

MeldingWanneer ze verschijntWat te doen
Save the API key of … in FlexigoTech Cloud first: nothing was sent.De sleutel van dat account is nog niet opgeslagen in FlexigoTech CloudSla de sleutel op in de sectie FlexigoTech Cloud van het account
The API key of … is not saved in FlexigoTech Cloud: type it again.FlexigoTech Cloud heeft geen opgeslagen sleutel voor dat accountTyp de sleutel opnieuw in
This Storecove account goes through FlexigoTech Cloud: its API key is kept there, never in Odoo. Save it in the FlexigoTech Cloud section.Bij het proberen de sleutel in Odoo op te slaanSla de sleutel op in de sectie FlexigoTech Cloud

Eén btw per regel

Volgens de waarschuwing van de connector heeft elke regel van de e-factuur precies één percentage-btw/GST nodig. De waarschuwing verschijnt wanneer een regel niet precies één belasting heeft of wanneer die belasting geen percentage is. Ze noemt de regel, hoeveel belastingen die heeft en van welk type. Vaste heffingen, zoals ecotaksen of DEEE, gaan als aparte regels of als korting of toeslag.

Omleidingen

Antwoordt Storecove op een aanroep via FlexigoTech Cloud met een HTTP-statuscode van 300 of hoger en lager dan 400, dan geeft de connector Storecove answered … … with an unexpected HTTP redirect (…) through FlexigoTech Cloud. De waarschuwing vermeldt de methode, het pad en de HTTP-statuscode.

Onjuiste notificaties

De connector controleert of elke Storecove-notificatie een JSON-object is en of die van het type document_submission een guid bevatten. Zo niet, dan geeft hij Webhook-body is geen JSON-object. of document_submission-webhook zonder guid.

Vragen over de Storecove API met Odoo

Bewaart Odoo de Storecove API-sleutel?

Nee. Hij wordt één keer versleuteld naar FlexigoTech Cloud gestuurd en nooit in Odoo bewaard. Alleen een beheerder kan hem daar verwijderen.

Hoe vaak controleert Odoo de Storecove-webhookwachtrij?

Elke 5 minuten, via de geplande actie Storecove: webhookwachtrij pollen (pull-modus), die actief is zodra de connector is geïnstalleerd.

Kan ik zelf een UBL-, CII- of IDOC-document verzenden?

Ja, via Storecove › Hulpmiddelen › Ruw document verzenden (UBL/CII/IDOC).

Heb ik het FlexigoTech Cloud-abonnement nodig om de Storecove API te gebruiken?

Ja. De connector heeft het FlexigoTech Cloud-abonnement (plan Connector) nodig, omdat de sleutel en de aanroepen naar Storecove daarlangs lopen. Je vindt het op Odoo Apps en op de connectorpagina op flexigotech.com.

Lees verder

Storecove Peppol vanuit Odoo: juridische entiteit, ID en facturenZo verstuur en ontvang je Peppol-facturen met Storecove vanuit Odoo: juridische entiteit, Peppol-ID, bereikbaarheid van de klant en inkomende facturen.
Gecontroleerd in de broncode van de connector (versie 20.0)

Bronnen

  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): __manifest__.py
  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_api_client.py
  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): models/fgt_cloud.py
  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): data/storecove_cron_data.xml
  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): views/menu.xml
  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_account.py
  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): README.md
  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_document_submission.py
  • Broncode van de module: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_invoice_builder.py