---
title: "Uprawnienia"
description: "Jakie zakresy uprawnień może mieć klucz API inFakt i do których operacji dają dostęp."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.niebieskiorzel.pl/llms.txt
> Use this file to discover all available pages before exploring further.

# Uprawnienia

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`:

```http
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](/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 |

> **Nadawaj tylko niezbędne uprawnienia**
>
> Integracja, która tylko wystawia faktury, potrzebuje zakresów `api:invoices:read` i `api:invoices:write`. Osobny klucz z wąskim zakresem uprawnień ogranicza skutki ewentualnego wycieku.

Source: https://docs.niebieskiorzel.pl/referencje/uprawnienia/index.mdx