API i integracje

Fakturnia udostępnia REST API oraz webhooki, dzięki którym połączysz aplikację z własnym sklepem, systemem księgowym lub innym oprogramowaniem. Możesz na przykład automatycznie wystawiać faktury po złożeniu zamówienia w sklepie internetowym. Jeśli chcesz podłączyć asystenta AI (ChatGPT, Claude, Gemini, Mistral Vibe, Perplexity, GitHub Copilot i inne), zobacz osobny artykuł Asystent AI: ChatGPT, Claude, Gemini i inne. REST API, webhooki i asystent AI (MCP) są dostępne od pakietu MAX.

Gdzie znajdziesz integracje

Przejdź pod adres https://app.fakturnia.pl/konto/integracje lub wybierz "Integracje" w menu. Sekcja pokazuje dwa kafelki: "Asystent AI (MCP)" (dostępny także dla pracownika, z jego uprawnieniami) i "REST API" (wyłącznie dla właściciela konta: pracownik zobaczy kafelek zablokowany). Moduł REST API ma trzy zakładki: "Konta API" (klucze dostępu), "Webhooki" oraz "Logi API" (podgląd zapytań wysłanych do API).

Moduł integracji dostępny jest wyłącznie w wersji przeglądarkowej.

Co umożliwia API

  • wystawianie i pobieranie dokumentów, zobacz Tworzenie dokumentów,
  • wysyłkę faktur do KSeF i odczyt wyniku, zobacz Wysyłka faktur do KSeF,
  • zarządzanie kontrahentami i produktami,
  • powiadomienia o zdarzeniach przez webhooki (na przykład o wystawieniu dokumentu).

Webhooki

Webhook to adres w Twoim systemie, na który Fakturnia wysyła powiadomienie o wybranych zdarzeniach. Adres jest sprawdzany przy każdym zapisie webhooka: musi zaczynać się od http lub https i prowadzić do publicznie dostępnego serwera. Adresy lokalne (na przykład localhost) oraz prywatne lub zarezerwowane adresy IP są odrzucane, podobnie jak nazwy domen, których nie da się rozwiązać w DNS.

Listę zdarzeń, format powiadomienia i sprawdzanie podpisu opisuje przewodnik Webhooki w dokumentacji dla programistów.

Dokumentacja dla programistów

Pełna dokumentacja techniczna API, wraz z opisem endpointów, przykładami zapytań i instrukcją autoryzacji, znajduje się na portalu deweloperskim: developers.fakturnia.pl. Na początek przydadzą się przewodniki Szybki start (pierwsza faktura w kilka minut) i Uwierzytelnianie (klucze API i tokeny).

Klucz API daje dostęp do danych Twojego konta. Traktuj go jak hasło: nie publikuj go i nie udostępniaj osobom trzecim.

Zobacz też

Zapytaj AI o ten artykuł

Wybierz asystenta. Otworzy się z gotowym pytaniem, przeczyta ten artykuł i odpowie na Twoje pytania.