Pełny tekst przyjętych warunków otrzymasz również w potwierdzeniu w aplikacji.
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, adresu webhooka lub połączenia aplikacji AI; w opisanym zakresie ma on pierwszeństwo przed pakietem bazowym. Firma, która przyjęła wcześniejszą wersję warunków API, przyjmuje tę wersję przed utworzeniem kolejnego klucza, adresu webhooka lub połączenia; do tego czasu jej klucze i webhooki działają na warunkach wcześniej przyjętych. 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ę pakietu bazowego.
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 połączenie aplikacji AI albo 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). Asystenta AI (agenta) można połączyć z KSeF Canvas przez serwer MCP kluczem API albo przez logowanie z aplikacji AI, która to umożliwia (np. Claude lub Claude Code). Przy połączeniu przez logowanie właściciel firmy loguje się do KSeF Canvas i na ekranie zgody wybiera jedną firmę i zakresy; zakres „wystawianie faktur w KSeF” nie jest zaznaczony domyślnie. Takie połączenie działa jak klucz o wybranych zakresach: tylko w tej firmie, z tymi samymi limitami i sprawdzeniami, i przestaje działać w tych samych sytuacjach co klucz (punkt 1). Połączenia zatwierdza wyłącznie właściciel firmy. Są widoczne w Ustawienia → Integracje → API, gdzie właściciel może je w każdej chwili odłączyć; odłączenie od razu zatrzymuje dostęp aplikacji. Nazwę aplikacji na ekranie zgody podaje sama aplikacja, dlatego klient zatwierdza tylko połączenie, które sam właśnie rozpoczął w aplikacji AI, i sprawdza adres, do którego wróci zgoda. Klient chroni dostęp do konta w aplikacji AI, w której zapisane jest połączenie, z taką starannością jak klucze (punkt 2), i niezwłocznie odłącza połączenie, którego nie rozpoznaje lub które mogło zostać przejęte. Agent korzysta z zakresów, limitów i sprawdzeń klucza lub połączenia, przez które działa: 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, połączeń, 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 lub połączeniem, tak jak za działania własnego systemu (punkt 2); polecenie agenta wykonane z użyciem ważnego klucza lub ważnego połączenia 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 połączenie, 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, odłączyć połączenia aplikacji AI i usunąć adresy webhooków. Wyłączenie API dla firmy, zamknięcie firmy lub rozwiązanie umowy zatrzymuje klucze, połączenia i webhooki; dokumenty wystawione wcześniej pozostają w firmie zgodnie z polityką retencji.
Prywatność API
Przez API system klienta przekazuje i odbiera te same dane faktur co w aplikacji: dane sprzedawcy i nabywców, pozycje, kwoty, terminy, numery KSeF oraz dokumenty XML, UPO i PDF. Dane te przetwarzamy jako podmiot przetwarzający na rzecz klienta.
Jako administrator przetwarzamy dane dostępu do API: nazwę, prefiks, zakresy i skrót klucza, osobę, która go utworzyła, czas ostatniego użycia, adresy webhooków, zaszyfrowany sekret podpisu, dziennik doręczeń (identyfikator i typ zdarzenia, liczba prób, kod odpowiedzi serwera klienta) oraz zapisy audytowe utworzenia, unieważnienia kluczy i każdego żądania wystawienia. Przy połączeniach aplikacji AI (MCP) zapisujemy też kanał żądania wystawienia oraz nazwę i wersję, którą aplikacja AI sama o sobie podaje. Przy połączeniach przez logowanie zapisujemy ponadto nazwę i identyfikator aplikacji AI, adresy powrotu, które aplikacja podaje, zakresy, osobę, która zatwierdziła połączenie, czas zatwierdzenia, ostatniego użycia i odłączenia, zapisy audytowe zatwierdzenia i odłączenia oraz tokeny połączenia, które przechowujemy zaszyfrowane i odnajdujemy wyłącznie po ich skrócie. Gdy identyfikatorem aplikacji jest adres https, pobieramy spod niego opis aplikacji (nazwę i adresy powrotu), nie przekazując przy tym danych klienta. Podstawą jest umowa z klientem i nasz uzasadniony interes w bezpieczeństwie usługi i rozliczalności, art. 6 ust. 1 lit. b i f RODO. Nie zapisujemy adresów IP w danych kluczy ani połączeń.
Dane dostępu przechowujemy przez czas korzystania z firmy i usuwamy razem z jej danymi zgodnie z polityką retencji; zapisy audytowe konfiguracji API przez 24 miesiące, a zapisy żądań wystawienia razem z dokumentami, których dotyczą. Powiadomienia webhook wysyłamy wyłącznie na adresy wskazane przez klienta. Dane, które agent AI odczyta przez MCP, przekazujemy wyłącznie aplikacji AI połączonej przez klienta; dalej przetwarza je dostawca AI wybrany przez klienta na podstawie umowy z klientem.
Uzupełnienie umowy powierzenia — API
Dla firm, które korzystają z API, polecenia klienta obejmują także żądania wysłane z użyciem kluczy API klienta oraz wysyłkę powiadomień webhook na adresy wskazane przez klienta, a także żądania agentów AI połączonych przez MCP z użyciem kluczy klienta lub połączeń zatwierdzonych przez właściciela firmy i przekazanie tym agentom odczytanych danych. Odbiorcami powiadomień są systemy klienta, a odbiorcami danych odczytanych przez agenta są aplikacja i dostawca AI wybrani przez klienta; nie są one dalszymi podmiotami przetwarzającymi KSeF Canvas. Powiadomienia zawierają identyfikatory, numer faktury, numer KSeF i stan wystawienia, bez pozycji faktury i danych nabywcy poza tymi, które zawiera numer lub komunikat KSeF. Pozostałe postanowienia umowy powierzenia stosuje się bez zmian.