[Intum Pomoc](https://intum.pl/pomoc.md) / [Insight](https://intum.pl/pomoc/insight.md)

# [Własne dane - ręcznie i przez API](https://intum.pl/pomoc/insight/insight-dane-przez-api.md)

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](insight/insight-raporty-i-wykresy)).

> [!PATH]
> [Insight → Zbiory danych](app:/insight/datasets) → **Dodaj**

Potrzebny jest dostęp **Wszystkie raporty Insight** (patrz [Ustawienia](insight/insight-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](app:/insight)
albo wpisz adres wprost - patrz [Nie widać Zbiorów danych i Alertów w
menu](insight/insight-problemy-brak-zbiorow-w-menu).

## Krok 1 - zbiór danych {#krok-1}

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 {#krok-2}

1. Wejdź na [Pola zbioru danych](app:/insight/dataset_fields) 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 {#krok-3-recznie}

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

1. Wejdź na [Wartości zbioru danych](app:/insight/dataset_values) 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](insight/insight-zbiory-danych#wartosci).

## Krok 3 - wartości przez API {#krok-3-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](app:/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.