Przejdź do głównej treści
Storecove

Storecove API w Odoo: klucz w FlexigoTech Cloud, sandbox, kolejka webhooków i błędy

Storecove Odoo Connector korzysta z Storecove API v2 (https://api.storecove.com/api/v2), a jego wywołania przechodzą przez FlexigoTech Cloud. Klucz API nigdy nie jest przechowywany w Odoo: jest wysyłany jednorazowo, zaszyfrowany, do FlexigoTech Cloud. Zaplanowana akcja odpytuje kolejkę webhooków Storecove co 5 minut w trybie pull. Specjalne menu pozwala też wysyłać surowe dokumenty UBL, CII lub IDOC.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 12 listopada 2026

Najważniejsze

Moduł
Storecove
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0
Czas czytania
4 min

Z którego Storecove API korzysta konektor i czego potrzebujesz

Konektor działa z https://api.storecove.com/api/v2. Według jego opisu wysyła faktury i noty kredytowe w sieciach Peppol, SDI, KSeF, FACeB2B oraz ponad 30 innych. Pobiera też do Odoo faktury zakupu i zamówienia.

Potrzebujesz:

  • Konta Storecove. Opis mówi, że dostępny jest bezpłatny 30-dniowy sandbox.
  • Subskrypcji FlexigoTech Cloud (plan Konektor). Konto, które tworzysz, trzyma tam swój klucz, nigdy w Odoo.

Podmioty prawne, identyfikator każdego kontaktu i wysyłanie faktur omawiamy w Storecove Peppol z Odoo.

Klucz Storecove API i zgoda

Konto Storecove tworzysz w Odoo, a klucz wpisujesz w pole API key (FlexigoTech Cloud). Jego podpowiedź mówi: Sent once, encrypted, to FlexigoTech Cloud. It is never stored in Odoo.

Zanim zapiszesz klucz, administrator musi zaakceptować, że klucz i wywołania do Storecove przechodzą przez FlexigoTech Cloud. Jeśli tego nie zrobił, konektor zatrzymuje się z takim komunikatem:

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.

Usunięcie klucza z FlexigoTech Cloud również należy do administratora. Inny użytkownik zobaczy Only an administrator can delete the Storecove API key from FlexigoTech Cloud.

Sandbox i produkcja w Storecove API

Konto Storecove w Odoo ma stan Nie połączono, Połączono lub Błąd połączenia. Szybki start konektora zaczyna się od utworzenia konta z jego kluczem i użycia Testuj połączenie.

Konektor zawiera katalog schematów identyfikatorów obejmujący ponad 50 krajów, z testowymi identyfikatorami do sandboxa. Aby wysłać testową fakturę, użyj Storecove › Narzędzia › Wyślij testową fakturę.

Lista schematów identyfikatorów konektora z krajem, kodem, nazwą, zastosowaniem B2B lub B2G, typem identyfikatora i testowym identyfikatorem w niektórych krajach
Schematy identyfikatorów konektora; w niektórych krajach z testowym identyfikatorem

Kolejka webhooków Storecove, surowe dokumenty i dziennik

CoGdzieKiedy działa
Storecove: wysyłanie e-faktur z kolejkiZaplanowana akcja, aktywna po instalacjiCo 5 minut
Storecove: odpytywanie kolejki webhooków (tryb pull)Zaplanowana akcja, aktywna po instalacjiCo 5 minut
Wyślij testową fakturęMenu Storecove › NarzędziaGdy je otworzysz
Wyślij dokument surowy (UBL/CII/IDOC)Menu Storecove › NarzędziaGdy je otworzysz
Dziennik synchronizacjiMenu Storecove › KonfiguracjaGdy je otworzysz

W menu dokumentu surowego wysyłasz do Storecove dokument UBL, CII lub IDOC.

Formularz przesyłki faktury Storecove w kolejce, z paskiem statusu, kontem sandbox, GUID przesyłki oraz zakładkami Evidence i Request Payload
Przesyłka faktury w kolejce, z symulowanym API i danymi demonstracyjnymi

Błędy Storecove API i co zrobić

KomunikatKiedy się pojawiaCo zrobić
Save the API key of … in FlexigoTech Cloud first: nothing was sent.Klucz tego konta nie został jeszcze zapisany w FlexigoTech CloudZapisz klucz w sekcji FlexigoTech Cloud konta
The API key of … is not saved in FlexigoTech Cloud: type it again.FlexigoTech Cloud nie ma zapisanego klucza dla tego kontaWpisz klucz ponownie
This Storecove account goes through FlexigoTech Cloud: its API key is kept there, never in Odoo. Save it in the FlexigoTech Cloud section.Przy próbie zapisania klucza w OdooZapisz klucz w sekcji FlexigoTech Cloud

Jeden podatek na pozycję

Według ostrzeżenia konektora każda pozycja e-faktury wymaga dokładnie jednego podatku procentowego VAT/GST. Ostrzeżenie pojawia się, gdy pozycja nie ma dokładnie jednego podatku albo gdy ten podatek nie jest procentowy. Wskazuje pozycję, liczbę jej podatków i ich typ. Opłaty stałe, takie jak ekopodatki czy DEEE, trafiają jako osobne pozycje albo jako rabat lub upust.

Przekierowania

Jeśli Storecove odpowie na wywołanie wykonane przez FlexigoTech Cloud kodem statusu HTTP równym co najmniej 300, ale niższym niż 400, konektor zgłasza Storecove answered … … with an unexpected HTTP redirect (…) through FlexigoTech Cloud. Ostrzeżenie podaje metodę, ścieżkę i kod statusu HTTP.

Nieprawidłowe powiadomienia

Konektor sprawdza, czy każde powiadomienie Storecove jest obiektem JSON oraz czy te typu document_submission zawierają guid. Jeśli nie, zgłasza Treść webhooka nie jest obiektem JSON. lub Webhook document_submission bez guid.

Pytania o Storecove API z Odoo

Czy Odoo przechowuje klucz Storecove API?

Nie. Jest wysyłany jednorazowo, zaszyfrowany, do FlexigoTech Cloud i nigdy nie jest przechowywany w Odoo. Tylko administrator może go stamtąd usunąć.

Jak często Odoo sprawdza kolejkę webhooków Storecove?

Co 5 minut, za pomocą zaplanowanej akcji Storecove: odpytywanie kolejki webhooków (tryb pull), aktywnej po zainstalowaniu konektora.

Czy mogę sam wysłać dokument UBL, CII lub IDOC?

Tak, z Storecove › Narzędzia › Wyślij dokument surowy (UBL/CII/IDOC).

Czy do korzystania ze Storecove API potrzebuję subskrypcji FlexigoTech Cloud?

Tak. Konektor wymaga subskrypcji FlexigoTech Cloud (plan Konektor), ponieważ klucz i wywołania do Storecove przechodzą przez nią. Znajdziesz go w Odoo Apps oraz na stronie konektora na flexigotech.com.

Czytaj dalej

Storecove Peppol z Odoo: podmiot prawny, identyfikator i fakturyJak wysyłać i odbierać faktury Peppol przez Storecove z Odoo: podmiot prawny, identyfikator Peppol, dostępność klienta i faktury przychodzące.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0)

Źródła

  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): __manifest__.py
  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_api_client.py
  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): models/fgt_cloud.py
  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): data/storecove_cron_data.xml
  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): views/menu.xml
  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_account.py
  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): README.md
  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_document_submission.py
  • Kod modułu: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_invoice_builder.py