Zum Hauptinhalt springen
Storecove

Storecove API in Odoo: Schlüssel in FlexigoTech Cloud, Sandbox, Webhook-Warteschlange und Fehler

Der Storecove Odoo Connector nutzt die Storecove API v2 (https://api.storecove.com/api/v2), und seine Aufrufe laufen über FlexigoTech Cloud. Der API-Schlüssel wird nie in Odoo gespeichert: Er wird einmal verschlüsselt an FlexigoTech Cloud gesendet. Eine geplante Aktion fragt die Storecove-Webhook-Warteschlange im Pull-Modus alle 5 Minuten ab. Über ein Menü können Sie außerdem Rohdokumente in UBL, CII oder IDOC senden.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 12. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0
Lesezeit
4 Min.

Welche Storecove API der Konnektor nutzt und was Sie brauchen

Der Konnektor arbeitet mit https://api.storecove.com/api/v2. Laut seiner Beschreibung sendet er Rechnungen und Gutschriften über Peppol, SDI, KSeF, FACeB2B und mehr als 30 Netzwerke. Außerdem holt er Lieferantenrechnungen und Bestellungen nach Odoo.

Sie benötigen:

  • Ein Storecove-Konto. Laut der Beschreibung steht eine kostenlose 30-Tage-Sandbox zur Verfügung.
  • Das Abonnement für FlexigoTech Cloud (Plan Konnektor). Der Schlüssel des Kontos, das Sie anlegen, wird dort aufbewahrt, nie in Odoo.

Rechtsträger, die Kennung jedes Kontakts und das Senden von Rechnungen behandelt Storecove Peppol aus Odoo.

Der Storecove-API-Schlüssel und die Zustimmung

Sie legen das Storecove-Konto in Odoo an, und der Schlüssel kommt in das Feld API key (FlexigoTech Cloud). Der Hilfetext dazu lautet: Sent once, encrypted, to FlexigoTech Cloud. It is never stored in Odoo.

Bevor der Schlüssel gespeichert wird, muss ein Administrator zustimmen, dass der Schlüssel und die Aufrufe an Storecove über FlexigoTech Cloud laufen. Ist das nicht geschehen, bricht der Konnektor mit dieser Meldung ab:

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.

Auch das Löschen des Schlüssels aus FlexigoTech Cloud ist Sache eines Administrators. Andere Benutzer sehen Only an administrator can delete the Storecove API key from FlexigoTech Cloud.

Sandbox und Produktion bei der Storecove API

Ein Storecove-Konto in Odoo ist Nicht verbunden, Verbunden oder Verbindungsfehler. Die Schnellstart-Anleitung des Konnektors beginnt damit, das Konto mit seinem Schlüssel anzulegen und Verbindung testen zu verwenden.

Der Konnektor liefert einen Katalog von Kennungsschemata für mehr als 50 Länder mit Test-Kennungen für die Sandbox mit. Um eine Testrechnung zu senden, gibt es Storecove › Werkzeuge › Testrechnung senden.

Liste der Kennungsschemata des Konnektors mit Land, Code, Name, B2B- oder B2G-Verwendung, Kennungstyp und in einigen Ländern einer Test-Kennung
Die Kennungsschemata des Konnektors; in einigen Ländern mit einer Test-Kennung

Die Storecove-Webhook-Warteschlange, Rohdokumente und das Protokoll

WasWoWann es greift
Storecove: Wartende E-Rechnungen sendenGeplante Aktion, bei der Installation aktivAlle 5 Minuten
Storecove: Webhook-Warteschlange abfragen (Pull-Modus)Geplante Aktion, bei der Installation aktivAlle 5 Minuten
Testrechnung sendenMenü Storecove › WerkzeugeWenn Sie es öffnen
Rohdokument senden (UBL/CII/IDOC)Menü Storecove › WerkzeugeWenn Sie es öffnen
Sync-ProtokollMenü Storecove › KonfigurationWenn Sie es öffnen

Über das Menü für Rohdokumente senden Sie Storecove ein Dokument in UBL, CII oder IDOC.

Formular einer Storecove-Rechnungsübermittlung in der Warteschlange mit Statusleiste, Sandbox-Konto, Submission-GUID und den Reitern Evidence und Request Payload
Eine Rechnungsübermittlung in der Warteschlange, mit simulierter API und Demodaten

Fehler der Storecove API und was zu tun ist

MeldungWann sie erscheintWas zu tun ist
Save the API key of … in FlexigoTech Cloud first: nothing was sent.Der Schlüssel dieses Kontos wurde noch nicht in FlexigoTech Cloud gespeichertSpeichern Sie den Schlüssel im Bereich FlexigoTech Cloud des Kontos
The API key of … is not saved in FlexigoTech Cloud: type it again.FlexigoTech Cloud hat für dieses Konto keinen gespeicherten SchlüsselGeben Sie den Schlüssel erneut ein
This Storecove account goes through FlexigoTech Cloud: its API key is kept there, never in Odoo. Save it in the FlexigoTech Cloud section.Beim Versuch, den Schlüssel in Odoo zu speichernSpeichern Sie den Schlüssel im Bereich FlexigoTech Cloud

Eine Steuer pro Position

Laut der Warnung des Konnektors braucht jede Position der E-Rechnung genau eine prozentuale Steuer (USt./GST). Die Warnung erscheint, wenn eine Position nicht genau eine Steuer hat oder wenn diese Steuer nicht prozentual ist. Sie nennt die Position, wie viele Steuern sie hat und von welchem Typ. Festbeträge, etwa Ökosteuern oder DEEE, gehören in separate Positionen oder in einen Rabatt bzw. Nachlass.

Weiterleitungen

Antwortet Storecove auf einen über FlexigoTech Cloud ausgeführten Aufruf mit einem HTTP-Statuscode ab 300 und unter 400, meldet der Konnektor Storecove answered … … with an unexpected HTTP redirect (…) through FlexigoTech Cloud. Die Warnung nennt Methode, Pfad und HTTP-Statuscode.

Fehlerhafte Benachrichtigungen

Der Konnektor prüft, ob jede Storecove-Benachrichtigung ein JSON-Objekt ist und ob die vom Typ document_submission eine guid enthalten. Andernfalls meldet er Webhook-Inhalt ist kein JSON-Objekt. oder document_submission-Webhook ohne GUID.

Fragen zur Storecove API mit Odoo

Speichert Odoo den Storecove-API-Schlüssel?

Nein. Er wird einmal verschlüsselt an FlexigoTech Cloud gesendet und nie in Odoo gespeichert. Nur ein Administrator kann ihn dort löschen.

Wie oft prüft Odoo die Storecove-Webhook-Warteschlange?

Alle 5 Minuten, über die geplante Aktion Storecove: Webhook-Warteschlange abfragen (Pull-Modus), die nach der Installation des Konnektors aktiv ist.

Kann ich ein Dokument in UBL, CII oder IDOC selbst senden?

Ja, über Storecove › Werkzeuge › Rohdokument senden (UBL/CII/IDOC).

Brauche ich das Abonnement für FlexigoTech Cloud, um die Storecove API zu nutzen?

Ja. Der Konnektor setzt das Abonnement für FlexigoTech Cloud (Plan Konnektor) voraus, weil der Schlüssel und die Aufrufe an Storecove darüber laufen. Sie finden es auf Odoo Apps und auf der Konnektor-Seite auf flexigotech.com.

Weiterlesen

Storecove Peppol aus Odoo: Rechtsträger, Kennung und RechnungenSo senden und empfangen Sie Peppol-Rechnungen mit Storecove aus Odoo: Rechtsträger, Peppol-Kennung, Erreichbarkeit des Kunden und eingehende Rechnungen.
Geprüft im Quellcode des Connectors (Version 20.0)

Quellen

  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): __manifest__.py
  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_api_client.py
  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): models/fgt_cloud.py
  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): data/storecove_cron_data.xml
  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): views/menu.xml
  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_account.py
  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): README.md
  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_document_submission.py
  • Quellcode des Moduls: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_invoice_builder.py