TracePass
Referenz

Regulatorischer Assistent

Regulatorische Daten-Endpoints für den DPP-Assistenten — Pflichtfelder nach Kategorie, regulatorische Änderungen, Registrierungshinweise und Compliance-Profil.

GET/api/v1/regulatory/required-fields

Pflichtfelder abrufen

Gibt die erforderlichen und voraussichtlichen Felder für einen Pass der angegebenen Kategorie zurück, mit dem EU-Regulierungsartikel, auf dem jedes Feld beruht, seiner Zugangsstufe (public / restricted / authority) und — für Batterien — ob die Daten üblicherweise vom Hersteller, einem Lieferanten oder dem Betreiber gehalten werden. Ohne `group` gibt der Endpoint eine Zusammenfassung zurück: Gesamtzahlen nach Gruppe und Zugangsstufe, plus `requiredByHolder` (nur Batterien). Mit `group` — die vollständige Feldliste für diese Gruppe.

GET/api/v1/regulatory/changes

Regulatorische Änderungen abrufen

Gibt kuratierte regulatorische Änderungseinträge für die angeforderten Kategorien zurück, gefiltert auf solche mit Datum ab `since`. Jeder Eintrag enthält eine `kind` (`adopted`, `amended`, `date_moved`, `standard_published`, `standard_cited`, `applies_from`, …), das betroffene Instrument oder den betroffenen Standard, die betroffenen Kategorien, eine verständliche Zusammenfassung (in der Antwortsprache) und eine primäre Quell-URL. Das `data.upcoming`-Array listet Daten und geplante Akte der nächsten 90 Tage.

GET/api/v1/regulatory/registry-guidance

Registrierungshinweise abrufen

Gibt kuratierte Hinweispunkte für das angeforderte Thema zurück. Jeder Punkt enthält einen `point` (eine verständliche Aussage), ein `detail` (ausführlichere Erklärung), eine `source` mit URL und Art (`commission` / `standard` / `law` / `our_finding`) und ein `sourceDate`. Punkte aus Kommissionsleitlinien werden mit 'Kommissionsleitlinie, kein Gesetz' gekennzeichnet; TracePass-Forschungspunkte mit 'TracePass research, not law'. `stillMoving` ist true, solange die Kommission die Registrierungsverfahren noch nicht abgeschlossen hat.

GET/api/v1/company/compliance-profile

Compliance-Profil abrufen

Gibt das gespeicherte Compliance-Profil des Unternehmens und seinen `updatedAt`-Zeitstempel zurück. Das Profil enthält Unternehmens­fakten, die die DPP-Assistenten-Tools als Standardwerte nutzen — `role`, `ownBrand`, `categories`, `markets`, `products`, `sizeBand`, `salesChannels` und `dataSystems`. Wenn das Profil nicht gesetzt wurde, lautet die Antwort `{ "complianceProfile": {} }`. Das Profil enthält nur Unternehmensfakten, niemals personenbezogene Daten.

PATCH/api/v1/company/compliance-profile

Compliance-Profil aktualisieren

Führt die bereitgestellten Felder in das gespeicherte Compliance-Profil zusammen und gibt das aktualisierte Profil mit `updatedAt` zurück. Nicht enthaltene Felder bleiben unverändert. Setzen Sie ein Feld auf `null`, um es zu entfernen. Validierte Felder: `role`, `ownBrand`, `categories`, `markets`, `products` (Array, max. 50), `sizeBand`, `salesChannels`, `dataSystems` (String, max. 200 Zeichen). Ein ungültiger Wert liefert 400 `invalid_input`.

DELETE/api/v1/company/compliance-profile

Compliance-Profil löschen

Entfernt das gesamte `complianceProfile`-Teildokument aus dem Unternehmensdatensatz, einschließlich aller gespeicherten Fakten (Rolle, Kategorien, Märkte, Produkte und alle gelernten Werte). Gibt bei Erfolg `{ "deleted": true }` zurück. Nach dem Löschen gibt `GET /api/v1/company/compliance-profile` ein leeres Profil zurück. Die DPP-Assistenten-Tools haben dann keine gespeicherten Standardwerte mehr.