Klucz dostępu do API można wygenerować po zalogowaniu do aplikacji WWW, korzystając z ustawień konta. Klucz przekazuje się w nagłówku HTTP X-inFakt-ApiKey:
X-inFakt-ApiKey: <klucz-api>Zakresy uprawnień wybiera się przy tworzeniu klucza. Żądanie wykonane kluczem bez zakresu wymaganego przez operację kończy się kodem 401. Zakres wymagany przez daną operację podaje jej opis w referencji API.
| Zakres | Daje dostęp do |
|---|---|
api:invoices:read |
odczytu dokumentów sprzedaży, klientów, produktów, słowników, statusów KSeF i zadań asynchronicznych |
api:invoices:write |
tworzenia, edycji i usuwania dokumentów sprzedaży, klientów i produktów; wysyłki faktur e-mailem i do KSeF; płatności i linków do faktur |
api:costs:read |
odczytu dokumentów kosztowych |
api:costs:write |
dodawania, opisywania, oznaczania płatności i usuwania dokumentów kosztowych |
api:accounting:read |
odczytu zaliczek na podatek dochodowy, deklaracji VAT, plików JPK_V7, składek ZUS i KPiR |
api:accounting:write |
oznaczania podatków, składek i plików JPK_V7 jako opłaconych lub wysłanych |
api:account:read |
odczytu danych konta (GET /account/details.json) |
api:sensitive:bank_accounts:read |
odczytu rachunków bankowych |
api:sensitive:bank_accounts:write |
dodawania, edycji i usuwania rachunków bankowych |
api:ksef:integration:write |
dawnej integracji z KSeF 1.0; żadna operacja API v3 nie wymaga tego zakresu |