KSeF API do wystawiania faktur z Twojego systemu

KSeF API to publiczny interfejs Ministerstwa Finansów do wysyłania i pobierania faktur. Zamiast budować własną integrację z KSeF, wysyłasz dane faktury do REST API Fakturujemy w prostym formacie JSON, a my obsługujemy sesje, FA(3), numer KSeF i UPO.

Dlaczego nie warto pisać integracji samemu

Integracja z KSeF wymaga obsługi sesji, szyfrowania, schematu FA(3), kodów błędów i trybu offline. Zespół programistów traci na to tygodnie, a zmiany schematu wymuszają kolejne poprawki. Interfejs Fakturujemy ukrywa tę złożoność.

Przykład zapytania

Poniżej minimalne zapytanie tworzące fakturę. Odpowiedź zawiera identyfikator faktury i jej status, a numer KSeF oraz UPO pojawiają się po przyjęciu faktury przez system.

curl -X POST https://api.fakturujemy.pl/api/v1/invoices \
  -H "Authorization: Bearer <klucz>" \
  -H "Content-Type: application/json" \
  -d '{
    "buyer": {"nip": "1234563218"},
    "lines": [{"name": "Abonament", "qty": 1, "net": 1200.00, "vat": "23"}],
    "due_days": 14
  }'

Co obejmuje API

Tworzenie i korekta faktur, pobieranie statusu i PDF, lista faktur kosztowych z KSeF oraz webhooki o zmianie statusu.

Autoryzacja kluczem API, osobnym dla każdej firmy
Limity wywołań zależne od planu
Webhook o zmianie statusu faktury

Dostępność w planach

API REST jest dostępne od planu Zespół (10 tys. wywołań w okresie) i Biznes (100 tys. wywołań). Enterprise ma limity ustalane w umowie.

Pytania i odpowiedzi

Dostęp jest częścią planu Zespół, Biznes i Enterprise, bez dodatkowej opłaty za wywołania w ramach limitu.

Numer KSeF i UPO są dostępne po przyjęciu faktury, przez zapytanie o status albo webhook.

Tak, możesz wystawić faktury testowe przed pierwszą wysyłką do KSeF.