Własne dane - ręcznie i przez API

Chcesz na wykresie w Intum zobaczyć liczby ze swojego sklepu, systemu magazynowego albo arkusza: dzienną sprzedaż, zapisy, zamówienia per region. Trzy kroki: załóż zbiór, dodaj pola, wysyłaj wartości. Potem raport na tych polach zakładasz tak samo jak każdy inny (Raporty i wykresy).

Potrzebny jest dostęp Wszystkie raporty Insight (patrz Ustawienia) - bez niego lista zbiorów nie jest widoczna ani w menu, ani pod tym adresem. Jeśli menu po lewej nie pokazuje w ogóle pozycji „Zbiory Danych”, wejdź przez kafelek na pulpicie Insight albo wpisz adres wprost - patrz Nie widać Zbiorów danych i Alertów w menu.

Krok 1 - zbiór danych

1. Na liście zbiorów kliknij Dodaj.
2. Wpisz Nazwę (np. „Sprzedaż sklepu”) i Kod - małe litery, cyfry i podkreślenia, bez spacji (sprzedaz). Kod potem wpisujesz w raporcie i wysyłasz w API, więc niech będzie krótki.
3. Zapisz. Na stronie zbioru zobaczysz jego ID - liczbę, którą podaje się przy dodawaniu wartości.

Krok 2 - pola

1. Wejdź na Pola zbioru danych i kliknij Dodaj.
2. Wpisz Nazwę („Liczba zamówień”) i Kod (zamowienia). Załóż po jednym polu na każdą mierzoną wielkość: zamowienia, wartosc_brutto, zwroty.
3. Zapisz - i tu również zapamiętaj ID pola.

W raporcie te pola wskazujesz jako sprzedaz.zamowienia, sprzedaz.wartosc_brutto.

Krok 3 - wartości ręcznie

Do sprawdzenia, że wszystko działa, albo gdy liczb jest kilka, wpisz je ręcznie:

1. Wejdź na Wartości zbioru danych i kliknij Dodaj.
2. Wypełnij: Data i czas (dzień, którego dotyczy liczba, z godziną w środku dnia, np. 12:00), ID zbioru danych (zapamiętane w kroku 1), ID pola zbioru danych (zapamiętane w kroku 2), Wartość. Encja zostaw pustą, chyba że liczba dotyczy konkretnej osoby, produktu czy regionu - wtedy wpisz etykietę serii (region_pl).
3. Zapisz. Na tej samej liście możesz wartości filtrować po zbiorze, polu i zakresie dat, poprawiać i usuwać - opis kolumn jest w Zbiory danych.

Krok 3 - wartości przez API

Docelowo liczby wysyła twój system - codziennie po zamknięciu dnia albo od razu, gdy się zmienią. Jedno żądanie to jedna wartość:

POST https://<twoje-konto>.intum.pl/insight/dataset_values.json
Content-Type: application/json
Authorization: Bearer <token API>

{
  "insight_dataset_value": {
    "datetime": "2026-09-15 12:00:00",
    "dataset_id": 123,
    "dataset_field_id": 456,
    "value": 42,
    "entity": "region_pl"
  }
}

• dataset_id i dataset_field_id to ID zbioru i pola ze stron z kroków 1 i 2,
• entity pomiń, gdy zbiór nie jest rozbity na serie,
• ta sama data, pole i encja drugi raz = odpowiedź z błędem duplikatu. Poprawkę wysyłasz jako zmianę istniejącej wartości (żądanie PATCH na jej adres) albo poprawiasz na liście.

Token API dla integracji bierzesz z ustawień konta, tak samo jak dla innych modułów Intum. Pełny opis adresów API Insight (zbiory, pola, wartości, raporty, pobieranie danych wykresu w JSON i CSV) jest w dokumencie „Insight API” pod adresem /noe/prompt/insight_api.md na twoim koncie; ten sam opis widzi agent AI, więc możesz mu po prostu powiedzieć: „dodaj do zbioru sprzedaż wartość 42 za 15 września”.

Co zobaczysz

Po pierwszej wartości zbiór na pulpicie Insight dostaje zieloną kropkę i datę w kolumnie Dane policzone do. Raport założony na sprzedaz.zamowienia pokazuje punkt za ten dzień od razu - własne dane nie czekają na nocne przeliczenie. Jeśli data przy zbiorze przestaje się przesuwać, twój system przestał wysyłać liczby.