Warunki API

KSeF Canvas — warunki API

Ten suplement uzupełnia pakiet public-v5-2026-10-20 oraz warunki planów organizations-seats-2026-10-20 w zakresie dostępu do KSeF Canvas przez API. Integralną częścią suplementu są informacje o prywatności API i uzupełnienie umowy powierzenia. Właściciel firmy przyjmuje suplement przed utworzeniem pierwszego klucza API; w opisanym zakresie ma on pierwszeństwo przed pakietem bazowym. Pełny suplement jest udostępniany przed przyjęciem i utrwalany w potwierdzeniu klienta.

1. Dostęp. API jest dostępne w planach Studio i Firma dla firm, którym je udostępnimy. Pozwala systemowi klienta tworzyć, zmieniać i sprawdzać szkice faktur, wystawiać je w KSeF, sprawdzać stan wystawienia, pobierać XML, UPO i PDF oraz odczytywać zapisanych kontrahentów i produkty. Klucze API tworzy i unieważnia wyłącznie właściciel firmy. Klucz działa tylko w jednej firmie i tylko w zakresach wybranych przy jego utworzeniu. Dostęp przez API nie rozszerza uprawnień, które klient ma w aplikacji: klucz przestaje działać, gdy dostęp do wystawiania wygasł, firma jest zamykana, konto jest zablokowane albo właściciel musi zaakceptować nową wersję warunków.

2. Klucze i odpowiedzialność za ich użycie. Klient przechowuje klucze w poufności, z użyciem zabezpieczeń odpowiednich dla danych uwierzytelniających, i przekazuje je tylko systemom i osobom, które ich potrzebują. Działania wykonane przy użyciu ważnego klucza traktujemy jako działania klienta. Klient niezwłocznie unieważnia klucz, który mógł zostać ujawniony, i powiadamia nas na support@ksefcanvas.pl, jeśli ujawnienie mogło dotyczyć danych innych osób. Pokazujemy sekret klucza tylko raz i przechowujemy wyłącznie jego skrót, dlatego nie możemy go odtworzyć. Możemy unieważnić klucz lub wstrzymać API dla firmy, jeśli wymaga tego bezpieczeństwo usługi lub danych, informując o tym klienta bez zbędnej zwłoki.

3. Wystawianie w imieniu klienta. Klucz z zakresem „wystawianie faktur w KSeF” pozwala systemowi klienta wysłać fakturę do KSeF bez kliknięcia w aplikacji. Każde takie żądanie jest poleceniem klienta wystawienia faktury z użyciem poświadczeń KSeF klienta, w jego imieniu i na jego odpowiedzialność, tak jak kliknięcie „Wystaw”. Zakres ten nie jest nadawany domyślnie; klient wybiera go świadomie dla systemu, któremu ufa. Za treść wystawionej faktury odpowiada wystawca; sprawdzenie i podgląd szkicu przez API nie są poradą podatkową. Faktury przyjętej w KSeF nie można wycofać, a jedynie skorygować. Ponowienie żądania z tym samym kluczem idempotencji zwraca pierwsze wystawienie; klient odpowiada za używanie różnych kluczy idempotencji dla różnych faktur. Szkiców ze sprzedaży Stripe nie wystawia się przez API.

4. Agenci AI (MCP). Klucz pozwala też połączyć z KSeF Canvas asystenta AI (agenta) przez serwer MCP. Agent korzysta z tych samych zakresów, limitów i sprawdzeń co klucz: może wyszukiwać kontrahentów i produkty, tworzyć i sprawdzać szkice, odczytywać stan i dokumenty faktur, a z zakresem „wystawianie faktur w KSeF” także wystawiać faktury. Agent nie wysyła e-maili, nie usuwa danych i nie zmienia kluczy, webhooków, poświadczeń KSeF, płatności, członków ani ustawień. Klient sam wybiera aplikację AI i jej dostawcę i odpowiada za to, co agent robi z kluczem, tak jak za działania własnego systemu (punkt 2); polecenie agenta wykonane z użyciem ważnego klucza jest poleceniem klienta. Przed wystawieniem faktury serwer wymaga, aby agent sprawdził szkic, i przyjmuje wystawienie tylko z krótko ważnym potwierdzeniem dotyczącym tej wersji szkicu; prosi agenta o pokazanie użytkownikowi nabywcy, NIP, kwot i daty wystawienia i uzyskanie jego zgody, a gdy aplikacja AI to umożliwia, pyta użytkownika bezpośrednio. Te zabezpieczenia nie zastępują nadzoru klienta: agent AI może się pomylić, dlatego klient sprawdza dane przed potwierdzeniem i nie nadaje zakresu wystawiania, jeśli agent nie ma wystawiać faktur. Dane faktur, kontrahentów i produktów, które agent odczyta, trafiają do aplikacji AI i do dostawcy AI wybranych przez klienta i są tam przetwarzane na podstawie umowy klienta z tym dostawcą. Aplikacja i dostawca AI nie są naszymi dalszymi podmiotami przetwarzającymi i nie odpowiadamy za przetwarzanie danych przez nich. Klient sprawdza przed połączeniem, czy warunki dostawcy AI, w tym miejsce przetwarzania danych, odpowiadają jego obowiązkom.

5. Webhooki. Klient może wskazać do trzech adresów https, na które wysyłamy podpisane powiadomienia o fakturach przyjętych i odrzuconych przez KSeF. Klient odpowiada za swój serwer, weryfikację podpisu i ochronę sekretu podpisu. Powiadomienia ponawiamy przez ograniczony czas; ich brak lub opóźnienie nie zmienia stanu faktury, który klient sprawdza przez API lub w aplikacji. Nie łączymy się z adresami w sieciach prywatnych.

6. Limity i rzetelne korzystanie. API ma limity liczby żądań na klucz, na firmę i na wystawienia; opisujemy je w dokumentacji i możemy je zmieniać, jeśli wymaga tego stabilność usługi, z wyprzedzeniem, gdy to możliwe. Klient nie obchodzi limitów, nie testuje bezpieczeństwa usługi bez naszej zgody i nie używa API do wysyłania danych, które nie służą fakturowaniu jego firmy.

7. Dostępność i zmiany API. Do API stosujemy punkt 8 regulaminu o awariach, konserwacji i odpowiedzialności; API nie ma odrębnego SLA. Wersja API jest częścią adresu (np. /v1). W ramach wersji dodajemy tylko zgodne wstecz elementy. To samo dotyczy narzędzi serwera MCP: ich nazwy i argumenty tylko przybywają. Zmianę niezgodną wstecz udostępniamy jako nową wersję, a poprzednią utrzymujemy co najmniej 12 miesięcy od ogłoszenia, chyba że jej wcześniejsze wyłączenie jest konieczne z przyczyn prawnych lub bezpieczeństwa.

8. Zakończenie. Klient może w każdej chwili unieważnić klucze i usunąć adresy webhooków. Wyłączenie API dla firmy, zamknięcie firmy lub rozwiązanie umowy zatrzymuje klucze i webhooki; dokumenty wystawione wcześniej pozostają w firmie zgodnie z polityką retencji.