CLG
Compliance PlatformEnergy
PrihlásenieZačať

Dokumentácia

iCalendar feed

Posledná aktualizácia: 15. januára 2026

Každá company má personalizovaný .ics feed s povinnosťami z watchlistu. Outlook / Google Calendar / Apple Calendar to pretiahnu automaticky a aktualizujú raz denne.

1. URL formát

https://compliance.capitol-legal.com/api/ics/<COMPANY_ID>?token=<ICS_TOKEN>

Token je dlhodobý read-only secret unikátny pre každú company. Vygenerujete ho v /account/ics-token; pri kompromitácii ho jednoducho zrotujete.

2. Outlook setup

  1. Outlook → Súbor → Pridať kalendár → Z internetu
  2. Vložte URL feed-u zhora
  3. Pomenujte „CLG Compliance“ a uložte
  4. Outlook synchronizuje raz denne (manuálne F9)

3. Google Calendar setup

  1. Google Calendar → Settings → Add calendar → From URL
  2. Vložte URL feed-u
  3. Synchronizácia ~12 hodín (Google neumožňuje rýchlejší interval)

4. Štruktúra VEVENT

BEGIN:VEVENT
UID:obl-247-1758888000000@compliance.clg.sk
DTSTAMP:20260115T103000Z
DTSTART:20260415T070000Z
SUMMARY:Štvrťročný report o flexibilnej kapacite
DESCRIPTION:Inštitúcia: ÚRSO\nLehota: do 15. dňa po skončení Q\n...
URL:https://compliance.clg.sk/obligations/247
RRULE:FREQ=MONTHLY;INTERVAL=3
CATEGORIES:electricity
END:VEVENT
  • UID — stabilné ID, deduplikácia naprieč synchroniyáciami
  • DTSTART/DTEND — UTC timestamp YYYYMMDDTHHMMSSZ
  • RRULE — opakovanie podľa RFC 5545 (FREQ + INTERVAL)
  • URL — link späť na detail povinnosti
  • CATEGORIES — komodity pre filter v calendar app-e

5. Privacy & bezpečnosť

  • Feed je read-only (HTTP GET, žiadne mutations).
  • Token je hashovaný pred uložením do DB; pri každom requeste sa overuje SHA-256.
  • Feed neobsahuje PII tretích strán — iba povinnosti z verejného katalógu.
  • HTTPS only; Cache-Control: max-age=600 (10 min CDN cache).
  • Token rotation: /account/ics-token → „Zrotovať“ → nový token, staré URL prestane fungovať okamžite.