[Intum](https://intum.fr/aide.md) / [CRM](https://intum.fr/aide/crm.md)

# [Interesy](https://intum.fr/aide/crm/interesy.md) | [API](#api)

## Interesy (Deals)

Interes to szansa sprzedażowa lub transakcja powiązana z [klientem](klienci). Interesy pozwalają śledzić pipeline sprzedażowy — od pierwszego kontaktu po zamknięcie.

## Dane interesu

- **Nazwa** — tytuł szansy sprzedażowej
- **Kwota netto i brutto** — wartość transakcji
- **Waluta** — waluta transakcji
- **Podatek** — stawka VAT
- **Data** — główna data interesu
- **Zakres dat** — data od/do (np. okres umowy)
- **Numer** — numer interesu
- **Numer faktury** — powiązana faktura
- **Opis** — szczegóły

## Status interesu

Interes przechodzi przez etapy pipeline'u — od nowego do zamkniętego:

- **Etapy pipeline** — definiowane przez statusy (np. "Kontakt", "Oferta", "Negocjacje")
- **Wygrana (win)** — transakcja zakończona sukcesem
- **Przegrana (lost)** — klient zrezygnował

## Powiązania

- **Klient** — do którego klienta należy interes
- **Kontakt** — osoba kontaktowa po stronie klienta
- **Projekt** — powiązany projekt
- **Zadanie** — powiązane zadanie
- **Odpowiedzialny** — kto prowadzi interes
- **Następny interes** — powiązanie z kolejną transakcją (follow-up)

## Notatki i załączniki

Do interesu można dodawać [notatki](notatki) i pliki — np. oferty, umowy, korespondencję.

## Zewnętrzne ID

Interes może mieć `external_id` do synchronizacji z zewnętrznymi systemami (np. systemem fakturowania).

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

## Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/crm/deals.json` | Lista interesów |
| GET | `/crm/deals/:id.json` | Pojedynczy interes |
| POST | `/crm/deals.json` | Utworzenie interesu |
| PATCH | `/crm/deals/:id.json` | Aktualizacja interesu |
| DELETE | `/crm/deals/:id.json` | Usunięcie interesu |
| GET | `/crm/deals/e/:app_code/:external_id.json` | Pobranie po external_id |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **crm**)

## Pola deal

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | nie | Nazwa interesu |
| `description` | text | nie | Opis |
| `total_amount_net` | decimal | tak | Kwota netto (< 1e12) |
| `total_amount_gross` | decimal | tak | Kwota brutto (>= netto, < 1e12) |
| `tax` | string | tak | Stawka VAT |
| `currency` | string | nie | Waluta |
| `closed` | string | nie | `win`, `lost` lub puste |
| `date` | date | nie | Data interesu |
| `date_from` | date | nie | Data od |
| `date_to` | date | nie | Data do |
| `number` | string | nie | Numer interesu |
| `invoice_no` | string | nie | Numer faktury |
| `url` | string | nie | Powiązany URL |
| `origin` | string | nie | Źródło |
| `external_id` | string | nie | Zewnętrzne ID |
| `client_id` | integer | nie | ID klienta |
| `contact_id` | integer | nie | ID kontaktu |
| `status_id` | integer | nie | ID statusu (etap pipeline) |
| `responsible_id` | integer | nie | ID odpowiedzialnego |
| `department_id` | integer | nie | ID działu |
| `project_id` | integer | nie | ID projektu |
| `task_id` | integer | nie | ID zadania |
| `next_deal_id` | integer | nie | ID następnego interesu |
| `fields` | object | nie | Własne pola (JSONB) |

## Filtrowanie

| Parametr | Opis |
|----------|------|
| `q` | Szukaj w: nazwa, opis, e-mail klienta |
| `client_id` | Filtruj po kliencie |
| `status_id` | Filtruj po statusie |
| `responsible_id` | Filtruj po odpowiedzialnym |
| `department_id` | Filtruj po dziale |
| `project_id` | Filtruj po projekcie |
| `main_date_from`, `main_date_to` | Zakres dat |
| `total_amount_gross_from`, `total_amount_gross_to` | Zakres kwoty |

## Przykład utworzenia

```json
{
  "api_token": "TOKEN",
  "deal": {
    "name": "Wdrożenie systemu CRM",
    "total_amount_net": 10000.00,
    "total_amount_gross": 12300.00,
    "tax": "23",
    "currency": "PLN",
    "client_id": 123,
    "status_id": 1,
    "date": "2026-03-15"
  }
}
```