Wystawiaj faktury ze swojego sklepu, programu magazynowego albo aplikacji. Zwykłe zapytania HTTP, dane w formacie JSON, dokumentacja z przykładami kodu w panelu.
Wszędzie tam, gdzie faktura ma powstawać automatycznie, a gotowa wtyczka nie wystarcza.
Sklep napisany od podstaw, bez gotowej wtyczki do WooCommerce czy PrestaShop. Zamówienie zamienia się w fakturę od razu po złożeniu.
Dokumenty sprzedaży powstają w Mobilnej Fakturze na podstawie zdarzeń z Twojego systemu, bez przepisywania danych z ręki.
Kontrahenci w jednym miejscu. Nowy klient w CRM trafia do bazy kontrahentów razem z poziomem cenowym.
Wystawianie dokumentów w terenie z własnej aplikacji mobilnej, na danych i cenniku z konta firmowego.
Pobieranie dokumentów do hurtowni danych, arkusza albo panelu BI, po własnych filtrach i okresach.
Skierowanie dokumentu do Krajowego Systemu e-Faktur i sprawdzenie statusu wysyłki bez wchodzenia do panelu.
Pełny opis każdego adresu, z parametrami i przykładowymi odpowiedziami, znajdziesz w dokumentacji w panelu.
Wystawianie faktur z pozycjami, pobieranie listy z filtrami, szczegóły z rozbiciem na stawki VAT, pobranie PDF i wysyłka mailem do kontrahenta.
Baza kontrahentów z wyszukiwaniem i domyślnym poziomem cenowym — ten sam mechanizm co w panelu, więc klient hurtowy dostaje właściwe ceny bez przeliczania po Twojej stronie.
Kartoteka towarów i usług z czterema poziomami cen, edycja cen i opisów oraz zmiana stanu magazynowego przez dokument WZ lub PZ.
Wysyłka dokumentu do KSeF i sprawdzenie statusu, a do tego słowniki: stawki VAT, jednostki miary i pozostałe listy używane przy wystawianiu.
Włącz API w panelu
Ustawienia › Integracje › WebAPI. API jest domyślnie wyłączone.
Przełącz protokół na REST
Domyślnie ustawiony jest SOAP. Bez przełączenia każde zapytanie REST kończy się kodem 403.
Wygeneruj klucz WebApi
Klucz dołączasz do każdego żądania razem z loginem i hasłem. Konto ma jeden klucz — regeneracja unieważnia poprzedni.
Przykłady w PHP, Pythonie i JavaScripcie znajdziesz w artykule pomocy, a opis każdego adresu — po zalogowaniu, w Ustawieniach.
Lepiej poznać granice od razu, niż odkryć je w połowie wdrożenia.
Fakturę można wystawić, pobrać, wysłać i usunąć — ale nie zmienić. Tak samo jak w panelu: wystawiony dokument się koryguje, nie poprawia.
Identyfikatory przekazujesz w polu ids przy żądaniu na kolekcję, a nie pod adresem pojedynczego dokumentu.
Zmiana stanu magazynowego tworzy dokument WZ albo PZ, więc podlega pakietowi Max i ustawieniu aktualizacji stanów wraz z drukami.
Konto pracuje w trybie SOAP albo REST. Starsze integracje na SOAP działają dalej, ale nie równolegle z REST.
Zamiast odpytywać API, możesz dostawać powiadomienia: wystawiona faktura, opłacona należność, nowy kontrahent. Żądania są podpisane, ponawiane przy błędach i zapisywane w dzienniku dostaw.
Wymaga pakietu Max.
Opis webhooków →Do Claude i ChatGPT służy osobne połączenie — serwer MCP z uwierzytelnianiem OAuth 2.1, bez podawania hasła do konta i z uprawnieniami wskazywanymi na ekranie zgody.
Bezpłatnie w każdym pakiecie.
Asystenci AI (MCP) →REST API jest dostępne od pakietu Mini wzwyż. Jeden wyjątek dotyczy zapisu stanów magazynowych — zmiana stanu towaru wymaga pakietu Max, bo powstaje przy niej dokument magazynowy WZ albo PZ. Odczyt towarów działa na każdym pakiecie od Mini.
API jest bezstanowe: do każdego zapytania dołączasz login do panelu, hasło (jawne albo jako skrót MD5) i klucz WebApi wygenerowany w ustawieniach. Nie ma osobnego tokenu dostępu ani procedury logowania — dane idą w każdym żądaniu, więc korzystaj wyłącznie z HTTPS i trzymaj je w zmiennych środowiskowych, nigdy w repozytorium kodu.
Konto ma jeden protokół naraz — SOAP albo REST. Domyślnie ustawiony jest SOAP, więc dopóki nie przełączysz protokołu na REST w Ustawieniach, każde zapytanie kończy się kodem 403. Wyjątkiem jest sprawdzenie konfiguracji pod adresem /auth/check, które odpowiada w obu trybach i jest dobrym pierwszym krokiem przy diagnozie.
Jeden na konto. Wygenerowanie nowego klucza natychmiast unieważnia poprzedni, więc wszystkie integracje korzystające ze starego przestaną działać — zaktualizuj je od razu po regeneracji.
Nie. Dokument można wystawić, pobrać, wysłać i usunąć, ale nie zmienić — tak samo jak w panelu, gdzie wystawionej faktury się nie edytuje, tylko koryguje. Edycja przez API działa dla kartoteki towarów: cen, opisów i poziomów cenowych.
API działa na zasadzie odpytywania — to Twój system pyta, czy coś się zmieniło. Webhooki działają odwrotnie: to Mobilna Faktura powiadamia Twój adres, gdy wystawisz fakturę, klient ją opłaci albo dodasz kontrahenta. Powiadomienia są podpisane i ponawiane przy błędach. Webhooki wymagają pakietu Max.
Tak, i jest to inny mechanizm. Asystenci AI łączą się przez serwer MCP zabezpieczony standardem OAuth 2.1 — tam nie podaje się hasła do konta, a uprawnienia wskazuje się na ekranie zgody. MCP jest bezpłatny w każdym pakiecie. REST API jest przeznaczone dla integracji programistycznych z własnym systemem.
Załóż konto, włącz REST w ustawieniach i wystaw pierwszy dokument z własnego kodu. Dokumentacja z przykładami czeka w panelu.