Rozwijaj swoje narzędzia z pomocą fakturnia.pl

Połącz swoją aplikację z naszym systemem i zbuduj dokładnie takie rozwiązanie, jakiego potrzebujesz. Wystawiaj faktury, zarządzaj kontrahentami i wysyłaj do KSeF przez przejrzyste API REST, a Fakturnia zadba o poprawność każdej kwoty co do grosza.

Oficjalna dokumentacja deweloperska zewnętrznego API REST Fakturnia: uwierzytelnianie, fakturowanie, KSeF, webhooki, MCP i maszynowo czytelna dokumentacja OpenAPI.

• Łatwy interfejs
• Komunikacja z KSeF
• Postman i CLI w zestawie
• LLM / Agent friendly

Wszystko, czego potrzebujesz, by wystartować

Od pierwszego tokenu po webhooki na produkcji. Wszystkie klocki, w pełni udokumentowane.

Szybki start

Token, faktura i PDF w pięć minut, z gotowym do wklejenia cURL.

Uwierzytelnianie

OAuth 2.0 client credentials, tokeny bearer i precyzyjne zakresy uprawnień.

Dokumenty i kwoty

Każdy typ dokumentu i dokładne reguły obliczeń, co do grosza.

Webhooki

Reaguj na zdarzenia w czasie rzeczywistym i weryfikuj podpisy HMAC.

Narzędzia

Kolekcja Postman, CLI na curl i klient generowany z OpenAPI w dowolnym języku.

Dla agentów i botów

OpenAPI, llms.txt i Markdown, maszynowo czytelne z założenia.

Serwer MCP

Wystaw fakturę przez ChatGPT, Claude, Gemini, Mistral Vibe, Perplexity albo GitHub Copilot: OAuth 2.1, prowadzona ścieżka, uprawnienia użytkownika.

Jak działa integracja

Cztery kroki od pustego konta do faktury przyjętej przez KSeF. Każdy z nich najpierw sprawdzisz w środowisku testowym.

1. Utwórz aplikację API

   W Fakturni otwórz Inne → Integracje → REST API i utwórz aplikację. Dostaniesz client_id i client_secret oraz wybierzesz zakresy uprawnień, z których integracja może korzystać.

2. Pobierz token

   Wymień dane aplikacji na token bearer w przepływie OAuth 2.0 client credentials. Token jest ważny godzinę: przechowuj go w pamięci i pobierz nowy tuż przed wygaśnięciem.

3. Wystaw dokument

   Jedno wywołanie POST /documents tworzy fakturę razem z nabywcą. Fakturnia nadaje numer według ustawień konta, liczy netto, VAT i brutto co do grosza i zwraca dokument, który pobierzesz jako PDF.

4. Wyślij do KSeF i odbierz wynik

   Wysyłka to osobne wywołanie, więc możesz najpierw sprawdzić dokument. Wynik z KSeF przychodzi webhookiem document.sentToKSeF albo document.ksefRejected, możesz też odpytywać endpoint statusu.

Buduj swój produkt na Fakturni

Integracja działa na tych samych danych co aplikacja webowa i mobilna, więc Twój system i zespół w Fakturni widzą te same dokumenty.

Sklep internetowy

Faktura powstaje zaraz po opłaceniu zamówienia, trafia do KSeF i wraca do sklepu jako PDF dla klienta. Klucz idempotentności chroni przed duplikatem, gdy powiadomienie o płatności przyjdzie dwa razy.

CRM i narzędzia sprzedażowe

Synchronizuj kontrahentów i produkty, a dane firmy pobieraj z rejestru GUS po samym NIP. Handlowcy wystawiają faktury we własnym narzędziu, a księgowość widzi je w Fakturni.

Abonamenty i usługi cykliczne

Reguły cykliczne same wystawiają faktury według harmonogramu. Przez API sprawdzisz najbliższą generację i wstrzymasz regułę, gdy klient zrezygnuje z usługi.

Magazyn i logistyka

Prowadź stany w kilku magazynach, rejestruj przyjęcia i wydania (PZ, WZ, MM) i wystawiaj WZ do faktur sprzedaży.

Faktury kosztowe z KSeF

Faktury od dostawców pobrane z KSeF trafiają do Twojego systemu webhookiem document.ksefImported, razem z identyfikatorami potrzebnymi do odczytu szczegółów.

Asystent AI

Podłącz Fakturnię do ChatGPT, Claude albo Gemini przez serwer MCP i wystawiaj faktury w rozmowie, z podglądem i potwierdzeniem przed zapisem.

Najczęstsze pytania

Krótkie odpowiedzi, każda z linkiem do przewodnika ze szczegółami.

Czy API Fakturni obsługuje KSeF?

Tak. Dokument utworzony przez API wysyłasz do KSeF osobnym wywołaniem, a wynik odbierasz webhookiem albo z endpointu statusu. Przez API sprawdzisz i przetestujesz też połączenie konta z KSeF. Wysyłka do KSeF

Czy mogę testować bez skutków prawnych?

Tak. Środowisko testowe (sandbox) to osobna kopia Fakturni z własnymi kontami i danymi API. Faktury wysłane z niego trafiają do testowego KSeF Ministerstwa Finansów. Szybki start

Jaki plan jest potrzebny?

REST API, webhooki i serwer MCP są częścią planu MAX. Nowe konto zaczyna od 14-dniowego okresu próbnego MAX, więc integrację zaczniesz od razu. Uwierzytelnianie

Jak uwierzytelnia się integracja?

Przepływem OAuth 2.0 client credentials. Aplikacja API dostaje tylko wybrane przez Ciebie zakresy uprawnień, a dostęp możesz dodatkowo ograniczyć do listy adresów IP. Uwierzytelnianie

Ile zapytań mogę wysłać?

Limity są liczone dla aplikacji API, a nie dla adresu IP. Na tworzenie dokumentów przypada 30 zapytań na minutę, a każda odpowiedź podaje w nagłówkach, ile zostało. Limity zapytań

Co, jeśli połączenie zerwie się w trakcie wystawiania faktury?

Wyślij żądanie z nagłówkiem Idempotency-Key i ponów je z tym samym kluczem. Fakturnia zwróci wynik pierwszego wywołania zamiast tworzyć drugi dokument. Idempotentność

Czy jest specyfikacja OpenAPI?

Tak. Pełną specyfikację OpenAPI 3 pobierzesz po polsku i po angielsku, a na jej podstawie wygenerujesz klienta w dowolnym języku. W zestawie są też kolekcja Postman i CLI oparte na curl. Narzędzia