Jak używać Monitoringu firm?

Monitoring firm pozwala monitorować firmy które są dla Ciebie ważne. Dodaj je raz – system sprawdza zmiany każdego dnia i dostarcza typowane zdarzenia dla każdej wykrytej różnicy. Ten przewodnik pokazuje jak skonfigurować monitoring i efektywnie konsumować liste zdarzeń.

Dodawanie firm

Dodaj firmy po ich identyfikatorze – NIP, REGON9 lub KRS. Możesz przesłać do 100 identyfikatorów w jednym żądaniu. Żądanie jest asynchroniczne – otrzymujesz natychmiastowe potwierdzenie i powiadomienie e-mail gdy wszystkie podmioty są gotowe do monitorowania.

POST /api/v1/companies/add

curl -X POST https://api.entiway.com/api/v1/companies/add \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier_type":  "NIP",
    "identifier_value": ["5270103391", "7221234567", "9876543210"]
  }'

{
  "success": true,
  "message": "Accepted for processing."
}

Jeśli firma jest już w bazie rejestru, jest dodawana natychmiast. Jeśli nie, przechodzi przez pełny pipeline importu. W każdym przypadku otrzymujesz e-mail gdy wszystko jest gotowe.

Przeglądanie listy obserwowanych

W każdej chwili możesz zobaczyć wszystkie firmy na swojej watchliście. Każdy wpis pokazuje nazwę firmy, główny identyfikator, datę dodania, datę ostatniego wykrytego eventu i łączną liczbę eventów. Ten endpoint jest bezpłatny – kredyty nie są pobierane.

GET /api/v1/companies/watched

curl "https://api.entiway.com/api/v1/companies/watched?page=1" \
  -H "Authorization: Bearer sk_api_xxxx"

Pobieranie zdarzeń

Są dwa sposoby konsumowania eventów z Twojej listy obserwowanych podmiotów.

GET /api/v1/watchlist/events

curl "https://api.entiway.com/api/v1/watchlist/events?from_date=2026-03-01&to_date=2026-03-24" \
  -H "Authorization: Bearer sk_api_xxxx"

Struktura zdarzenia

Każde zdarzenie ma tę samą strukturę – typ, stara wartość, nowa wartość, data i poziom ważności. Gdy old_value wynosi null, pole zostało nowo dodane. Gdy new_value wynosi null, zostało usunięte.

{
  "primary_identifier": "543701794",
  "name":               "CAR-PRO MAX DETAILING",
  "event_type":         "COMPANY_NAME_CHANGED",
  "old_value":          "CAR-PRO DETAILING",
  "new_value":          "CAR-PRO MAX DETAILING",
  "event_date":         "2026-03-02",
  "severity":           "warning"
}

Usuwanie firm

Usuń firmy z listy obserwowanych używając tego samego formatu identyfikatorów co przy dodawaniu. Codzienny monitoring zatrzymuje się natychmiast. Odpowiedź mówi dokładnie które identyfikatory zostały usunięte, których nie znaleziono i których nie było na Twojej watchliście.

DELETE /api/v1/companies/watched

curl -X DELETE https://api.entiway.com/api/v1/companies/watched \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name":  "NIP",
    "value": ["5270103391"]
  }'

Wskazówka – codzienna rutyna
Typowa integracja odpytuje /watchlist/events raz dziennie z wczorajszą datą jako from_date. Daje to czysty dzienny feed wszystkich zmian we wszystkich monitorowanych firmach.