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.

De Storecove-webhookwachtrij, ruwe documenten en het logboek
| Wat | Waar | Wanneer het werkt |
|---|---|---|
Storecove: e-facturen in wachtrij verzenden | Geplande actie, actief bij installatie | Elke 5 minuten |
Storecove: webhookwachtrij pollen (pull-modus) | Geplande actie, actief bij installatie | Elke 5 minuten |
Testfactuur verzenden | Menu Storecove › Hulpmiddelen | Wanneer je het opent |
Ruw document verzenden (UBL/CII/IDOC) | Menu Storecove › Hulpmiddelen | Wanneer je het opent |
Synchronisatielogboek | Menu Storecove › Configuratie | Wanneer je het opent |
Met het menu voor ruwe documenten stuur je Storecove een UBL-, CII- of IDOC-document.

Fouten van de Storecove API en wat je eraan doet
| Melding | Wanneer ze verschijnt | Wat 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 Cloud | Sla 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 account | Typ 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 slaan | Sla 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
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
