JSONJavaScript Object Notation

Co to jest JSON

JSON to sposób zapisania danych tak, żeby mógł je łatwo odczytać zarówno program, jak i człowiek. Dane zapisuje się jako pary: nazwa pola i jego wartość. Pola można grupować w obiekty, a obiekty w listy. Mimo że nazwa pochodzi od języka JavaScript, z JSON korzystają praktycznie wszystkie współczesne systemy.

Tak może wyglądać zamówienie zapisane w JSON:

{
  "numer": "ZAM/2026/10/123",
  "klient": { "nazwa": "Przykładowa sp. z o.o.", "nip": "0000000000" },
  "pozycje": [
    { "produkt": "Uszczelka A", "ilosc": 50 },
    { "produkt": "Uszczelka B", "ilosc": 20 }
  ],
  "zaplacone": false
}

To przykład ilustracyjny. Widać tu obiekt klienta, listę pozycji i pole z wartością logiczną. Program wie, że „ilosc” to liczba, a „zaplacone” to tak albo nie.

Gdzie spotkasz JSON

• API: odpowiedzi z API większości systemów przychodzą w JSON.
• Webhooki: webhook przesyła dane o zdarzeniu najczęściej w tym formacie.
• Narzędzia do automatyzacji: w n8n i Make dane przepływające między krokami są pokazywane właśnie jako JSON.
• AI: modele językowe mogą zwracać dane wyodrębnione z dokumentu w JSON, a automatyzacja od razu zapisze je w systemie.

JSON a CSV i Excel

JSON i AI

Przy odczycie dokumentów przez AI JSON jest bardzo przydatny. Zamiast prosić model o opis faktury, prosi się go o zwrócenie konkretnych pól: numer, data, NIP sprzedawcy, kwoty. Taki wynik łatwo sprawdzić i zapisać w systemie. Na tym opiera się inteligentne przetwarzanie dokumentów, które wdrażamy w usłudze AI w obsłudze dokumentów.

Najczęstsze kłopoty z JSON w integracjach

Błędy w integracjach często wynikają z różnic w danych, a nie z samego formatu. Jeden system zapisuje datę jako tekst, drugi jako liczbę. Pole, które zwykle jest wypełnione, czasem przychodzi puste. Lista pozycji ma jedną pozycję i system traktuje ją inaczej niż listę. Dobra integracja sprawdza takie przypadki i zamiast się zatrzymać, zgłasza czytelny błąd z informacją, czego brakuje.

Czy trzeba znać JSON, żeby automatyzować

Nie trzeba go pisać, ale warto umieć go przeczytać. Kto rozumie, gdzie w JSON jest numer zamówienia, a gdzie lista pozycji, szybciej znajdzie błąd w przepływie i łatwiej dogada się z osobą budującą integrację. Podstawy pracy z danymi w narzędziach automatyzacji omawiamy podczas szkoleń z n8n.