Otwarte API
do zamówień i magazynu.
Panel Flovern sam korzysta z tego API, więc wszystko, co w nim klikasz, poza kontami, hasłami i kluczami, zrobisz też programem: własnym skryptem, systemem ERP albo modelem AI, który dostanie dokładnie takie uprawnienia, jakie mu dasz.
Model AI obsłuży panel za Ciebie
Model AI z dostępem do narzędzi, np. Claude albo dowolny inny, dostaje od Ciebie dokumentację i klucz. Polecenia piszesz zwykłymi zdaniami, a model wykonuje je w Twojej instancji tymi samymi operacjami, których używa panel.
Ustawia stanowisko pakowania
„Dodaj stanowisko Pakowanie 2 z drukarką etykiet i sprawdź, czy drukuje.” Model pobiera z PrintNode listę drukarek, zaznacza, że drukarka etykiet przyjmuje ZPL, zakłada stanowisko i wysyła stronę testową, a potem sprawdza, czy zlecenie się wydrukowało.
Obszary API: Druk, Ustawienia
Sprawdza, czego brakuje
Model wyszukuje zamówienia wysłane bez faktury i produkty sprzedane bez kosztu zakupu, a listę z numerami pokazuje Ci w rozmowie. Gdy klucz pozwala na zapis faktur, wystawia brakujące zbiorczo, najpierw na próbę, żeby było widać, co się stanie.
Obszary API: Zamówienia, Statystyki, Faktury
Układa automaty
„Po wpłacie ustaw status Do wysłania, nadaj paczkę i wydrukuj etykietę.” Model czyta słownik zdarzeń, warunków i akcji, zakłada regułę, a po pierwszych zamówieniach sprawdza w logu uruchomień, czy wszystko zadziałało.
Obszary API: Automaty, Zamówienia, Przesyłki, Druk
Porządkuje katalog
Model znajduje produkty bez EAN albo bez zdjęcia, a setkom produktów naraz zmienia kategorię, cenę albo tagi jedną operacją masową. Postęp i pominięte produkty widzi w przebiegu tej operacji.
Obszar API: Produkty
Twoje programy podpięte do Flovern
System ERP, program magazynowy, skrypt na serwerze albo arkusz księgowej. Każdy z nich rozmawia z Flovern przez to samo API co panel, z własnym kluczem.
Program magazynowy pilnuje stanów
Twój ERP albo program magazynowy ustawia stany produktów w magazynach Flovern, a my przekazujemy je dalej do ofert na Allegro, gdy synchronizacja jest włączona. W drugą stronę program pobiera nowe zamówienia, zmienia im status i dopisuje numer przesyłki nadanej poza Flovern.
Obszary API: Produkty, Zamówienia, Przesyłki
Komplet dokumentów dla księgowej
Na początku miesiąca skrypt pobiera faktury i korekty w PDF i XML, potwierdzenia UPO z KSeF oraz rejestr sprzedaży w XLSX i plik JPK z ewidencją sprzedaży. Klucz ma tylko odczyt faktur, więc niczego nie zmieni.
Obszar API: Faktury (odczyt)
Produkty z hurtowni
Hurtownia udostępnia plik CSV albo XML pod stałym adresem? Profil importu pobiera go nawet co godzinę i aktualizuje katalog. Nietypowy format tłumaczy krótki skrypt, który zakłada produkty z kluczem idempotencji, więc ponowione żądanie nie zrobi duplikatu.
Obszar API: Produkty
Raport na dzień dobry
Rano skrypt pobiera wczorajszą sprzedaż, średni koszyk i zysk, kolejki pracy (nowe, nieopłacone, do wysłania) i produkty, którym stan skończy się w ciągu dwóch tygodni. Wynik wysyła mailem albo na czat zespołu.
Obszar API: Statystyki (odczyt)
Klucze API pod Twoją kontrolą
Klucz wydaje właściciel konta w ustawieniach panelu. Konta, hasła i same klucze zostają poza API, więc żaden klucz nie założy konta ani nie wyda kolejnego klucza.
Dostęp osobno dla każdego obszaru
Przy zamówieniach, produktach, fakturach, druku i pozostałych obszarach wybierasz Brak, Odczyt albo Zapis. Do tego termin ważności i limit wywołań na minutę. Zmiana działa od następnego żądania.
Log każdego wywołania
Operacja, status, czas trwania i adres IP przy każdym wywołaniu kluczem, widoczne w panelu przez 90 dni. Wiesz, co zrobił skrypt albo model AI.
Rotacja bez przestoju
Nowy klucz dostaje te same uprawnienia, a stary działa jeszcze przez okres przejściowy, domyślnie 24 godziny. Klucz, który wyciekł, unieważniasz, a od razu przestaje działać.
Sekret widzisz raz
Pełny klucz pokazujemy tylko przy wydaniu, a w bazie trzymamy sam jego skrót, więc później nie da się go odczytać.
Szczegóły techniczne: OpenAPI i stałe konwencje
Każda instancja ma dokumentację pod /api/docs, z opisem każdej operacji i przykładem curl. Generujemy ją z tego samego kodu, który obsługuje żądania, więc nowa operacja trafia do niej od razu.
# Wysłane, a bez fakturycurl 'https://<instancja>/api/v1/orders?shipped=true&invoiced=false&limit=1' \ -H 'Authorization: Bearer osk_...'{ "items": [ { "number": "1008417", "status": { "id": "wyslane", "name": "Wysłane" }, "flags": { "shipped": true, "invoiced": false }, "total": { "amount": 8228, "currency": "PLN" } } ], "nextCursor": "b3JkZXI6MTAwODQxNw", "total": 3}Kontrakt OpenAPI
Z pliku OpenAPI wygenerujesz klienta w swoim języku. Z tego samego pliku korzysta nasz panel. Opisy operacji są po angielsku.
Paginacja kursorem
Listy zwracają stronę wyników i kursor do następnej. Filtry podajesz w adresie, tymi samymi polami, których używa panel.
Błędy w problem+json
Błędy w formacie RFC 9457. Błędy domenowe mają stały kod, np. insufficient_scope albo rate_limited, a błędy walidacji listę pól. Program reaguje na kod, a nie na treść komunikatu.
Klucze idempotencji
Nagłówek Idempotency-Key przy zakładaniu zamówień, produktów, przesyłek i faktur. Ponowione żądanie po zerwanym połączeniu dostaje tę samą odpowiedź zamiast drugiej faktury.
Limity w nagłówkach
Każda odpowiedź mówi, ile wywołań zostało w tej minucie. Po przekroczeniu limitu dostajesz 429 z informacją, kiedy spróbować ponownie.
Zmiany bez webhooków
Nowe zamówienia i zmiany statusu wykryjesz, odpytując listy posortowane po dacie zmiany, albo automatem z akcją Wywołaj adres URL, który przy zdarzeniu wyśle dane zamówienia na Twój serwer.
W planach
- Webhooki: Flovern sam powiadomi Twój program o nowym zamówieniu, wpłacie albo zmianie statusu, bez odpytywania list.
- Strumień zdarzeń: wszystkie zmiany w instancji w jednej liście do odpytywania, zamiast kilku osobnych list.
Porozmawiajmy o Twojej sprzedaży
Opowiedz nam o swoim sklepie: gdzie sprzedajesz, ile masz zamówień w miesiącu i co dziś najbardziej uwiera. Odpiszemy i pokażemy, jak Flovern to poukłada.