ZELYRA
SOFTWARE-HANDBUCH · COMPLIANCE-MODUL

Sanktions-
management.

Vollständige Technik- & Compliance-Dokumentation: 9 offizielle Listen + eigene Listen, asynchrone REST-API (bis 50.000 Datensätze), ERP-Anbindung (SAP, Sage, JTL, Business Central, DATEV, Odoo), 4-Augen-Prinzip, PDF-Nachweise & DSGVO.

Sanktionsmanagement – Vollständiges Handbuch

Willkommen im offiziellen Handbuch des Moduls Sanktionsprüfung (Compliance Suite) der Siedelmann Business Suite. Dieses Handbuch beschreibt vollständig die Funktionsweise, Konfiguration, REST-API, ERP-Anbindung (inkl. SQL-Vorlagen), das 4-Augen-Prinzip, die Revisionssicherheit sowie das DSGVO-Lösch- und Nachweiskonzept.


1. Überblick & Compliance-Architektur

Unternehmen in der EU sind aufgrund unmittelbar geltender EU-Sanktionsverordnungen (u. a. VO (EG) Nr. 2580/2001, VO (EG) Nr. 881/2002, VO (EU) Nr. 269/2014) sowie des Außenwirtschaftsgesetzes (AWG/AWV) verpflichtet, keine Gelder oder wirtschaftlichen Ressourcen an sanktionierte Personen, Unternehmen oder Organisationen bereitzustellen (Bereitstellungsverbot).

Das Modul Sanktionsprüfung automatisiert diesen Abgleich vollständig und dokumentiert jeden Prüfschritt revisionssicher:

  • 9 amtliche Sanktions- und Exportkontrolllisten direkt integriert (automatische Aktualisierung alle 6 Stunden).
  • Beliebig viele eigene Mandantenlisten (CSV, JSON/NDJSON, XML oder direkter HTTPS-Link mit automatischem 6h-Sync).
  • Einzelprüfungen im Browser sowie asynchrone Stapelprüfungen per REST-API bis 50.000 Datensätze pro Upload (16 MiB).
  • ERP-Rückkanal (GET /treffer) für automatische Liefersperren im ERP-System.
  • Fallakten-Arbeitsliste mit Merkmalsvergleich, Sammelbewertung und striktem 4-Augen-Prinzip.
  • Revisionssichere Nachweise: PDF-Prüfberichte mit eigenem Firmenlogo und SHA-256-Prüfsummen, ZIP-Nachweispakete, Partnernachweise und Jahresberichte.
  • DSGVO-Datenminimierung ab Werk: AES-256-Verschlüsselung, automatische Rohdaten-Löschung (ab 0 Tagen konfigurierbar), kryptografische HMAC-SHA256-Partnernachweise, Art.-15-Auskunft sowie elektronischer AVV inkl. TOM (PDF).

Rollenmodell & Mandantenisolation

Jeder Mandant arbeitet in einer strikt isolierten Datenumgebung. Zugriffsrechte richten sich nach der Benutzerrolle im Mandanten:

Rolle Übersicht & Treffer ansehen Einzelprüfung & Ausschluss beantragen 4-Augen-Bestätigung, Quellen, API, Listen & Art.-15-Auskunft
Inhaber / Admin Ja Ja Ja
Mitarbeiter / Buchhaltung Ja Ja Nein
Betrachter (Viewer) Ja Nein Nein

Hinweis zum 14-tägigen Testzugang: Interessierte Unternehmen können das Modul über /register 14 Tage lang vollständig kostenfrei und ohne automatische Verlängerung testen. Neu registrierte Testkonten erhalten ausschließlich Zugriff auf die aktuell freigegebenen Testmodule.


2. Offizielle & eigene Sanktionslisten

Die 9 integrierten amtlichen Listen

Das System bezieht alle amtlichen Listen direkt von den jeweiligen Behörden, speichert sie lokal zwischen und prüft alle 6 Stunden (00:13, 06:13, 12:13, 18:13 UTC) auf Änderungen. Eine neue unveränderliche Listenversion wird nur angelegt, wenn sich die SHA-256-Prüfsumme geändert hat.

Schlüssel Offizielle Liste Schwerpunkt / Einsatzbereich Besonderheiten
eu EU – Finanzsanktionsliste (CFSP) Gesetzliche Pflichtbasis in DE & EU Direkte Links zu EUR-Lex-Rechtsakten (Amtsblatt)
un UN – Konsolidierte Liste (UNSC) Internationale Basis (Terrorismus, Embargos) Weltweite Personen- & Organisationsliste
ofac_sdn USA – OFAC SDN US-Finanzsanktionen, USD-Geschäft Direkte Links zum OFAC-Eintrag
ofac_non_sdn USA – OFAC Non-SDN (Consolidated) Ergänzende US-Sanktionsprogramme (SSI, CMIC u. a.) Direkte Links zum OFAC-Eintrag
us_bis USA – BIS Exportkontrolle Entity List (EL), Denied Persons (DPL), Unverified (UVL) Essenziell bei US-Komponenten / US-Re-Exportrecht (EAR)
uk Vereinigtes Königreich – UK Sanctions List Handel & Dienstleistungen mit UK FCDO/OFSI-Gesamtliste
ch Schweiz – SECO DACH-Geschäft & Schweizer Exportkontrolle Inkl. Bereinigung abgelisteter Einträge (de-listed)
ca Kanada – Autonome Sanktionsliste (SEMA) Nordamerika-Geschäft Kanadische Gesamtliste
au Australien – DFAT Consolidated List Asien-Pazifik-Geschäft Zusammenführung von Haupt- & Aliasnamen je Referenz

Sollte ein behördlicher Server länger als 72 Stunden nicht erreichbar sein, markiert das System den Listenstand automatisch als veraltet und warnt im Dashboard und Quellenstatus.

Eigene mandantenspezifische Listen (CSV, JSON, XML & HTTPS-URL)

Unter Prüflisten → Eigene Listen können Inhaber und Admins beliebig viele interne Sperr- oder Konzernlisten anlegen. Jede neue Version wird mit Zeitstempel und SHA-256-Prüfsumme archiviert, sodass historische Prüfläufe jederzeit nachvollziehbar bleiben.

Unterstützte Eingabewege (bis 10 MB pro Datei):

  1. CSV-Upload (Semikolon-getrennt, UTF-8, Pflichtspalten Referenz und Name, mehrere Werte je Feld mit | getrennt):
Referenz;Name;Aliasnamen;Laender;Geburtsdaten
SP-001;Beispiel Sperrfirma GmbH;BSF GmbH|Beispiel Holding;DE|AT;
SP-002;Max Mustermann;M. Mustermann;CH;1975-04-12
  1. JSON / NDJSON-Upload (Standard-JSON-Array, Wrapper-Objekte wie results / entries / items sowie zeilenweises NDJSON wie OpenSanctions entities.ftm.json):
[
  {
    "reference": "SP-001",
    "name": "Beispiel Sperrfirma GmbH",
    "aliases": ["BSF GmbH", "Beispiel Holding"],
    "countries": ["DE", "AT"]
  }
]
  1. XML-Upload (wiederkehrende Listen-Tags, z. B. <list><entry id="SP-001"><name>…</name></entry></list>):
<list>
  <entry id="SP-001">
    <name>Beispiel Sperrfirma GmbH</name>
    <alias>BSF GmbH</alias>
    <country>DE</country>
  </entry>
</list>
  1. Direkte externe HTTPS-URL: Hinterlegen Sie in den Listeneinstellungen eine direkte https://…-Adresse zu einer CSV-, JSON- oder XML-Datei. Per Klick auf „Jetzt von URL abrufen“ wird sie sofort importiert; aktive Listen mit URL werden zusätzlich alle 6 Stunden automatisch synchronisiert.
    • Automatische Felderkennung & eigene Feldzuordnung: Gängige Feldnamen (id, reference, uid, name, caption, full_name, aliases, aka, country, dob) werden automatisch erkannt. Bei abweichenden Feld-/Tag-Namen hinterlegen Sie diese direkt in der optionalen Feldzuordnung der Liste.
    • SSRF-Schutz: Es sind ausschließlich direkte https://-Adressen ohne Zugangsdaten oder Sonderports zulässig; Weiterleitungen, DOCTYPE-Deklarationen sowie private, interne oder Loopback-IP-Bereiche werden blockiert.

3. Abgleichverfahren, Schwellwerte & Identitätsvergleich

Der Namensabgleich arbeitet vollständig lokal und deterministisch (Verfahren v1):

  1. Normalisierung: Kleinschreibung, Transliteration von Umlauten und Sonderzeichen (z. B. ä → ae, kyrillische/arabische Umschriften), Entfernung von Satzzeichen.
  2. Rechtsform-Bereinigung & Wortreihenfolge: Gängige Rechtsformen (GmbH, AG, KG, Ltd, LLC, Inc, Corp, Limited) werden zusätzlich als normalisierte Variante ohne Rechtsform und mit sortierten Wörtern abgeglichen (z. B. findet „Handels Mirador GmbH“ auch „Mirador Handels“).
  3. Kombiniertes Scoring (0–100 %): Kombination aus zeichenbasierter Editierdistanz (Levenshtein) und Wort-Übereinstimmung (Token-Overlap).
  4. Speichereffizienter Bigramm-Index: Jede Referenzliste wird einzeln über einen binär gepackten Index abgeglichen – dadurch laufen selbst Prüfungen gegen alle 9 offiziellen Listen (>56.000 Einträge) stabil und schnell im Hintergrund.

Empfohlene Schwellwerte

Schwellwert Verhalten Empfohlener Einsatz
85 % (Standard) Sehr gute Balance aus Tippfehler-/Schreibweisenerkennung und geringer Fehlalarmquote Standard für fast alle ERP- und Kundenstämme
80 % Sensibler – erkennt stärkere Abweichungen, erzeugt mehr Prüffälle Hochrisiko-Branchen / Dual-Use / Exportkontrolle
90–95 % Sehr streng – nur sehr nahe Treffer Große B2C-Stämme mit kurzen Namen

4. Datenquellen einrichten & überwachen

Eine Datenquelle beschreibt ein externes System (z. B. SAP Debitoren, Sage Kreditoren, JTL Kunden).

  1. Öffnen Sie Datenquellen & API → Neue Datenquelle anlegen.
  2. Laden Sie optional eine CSV-Beispieldatei hoch – das System erkennt gängige Spaltennamen automatisch.
  3. Ordnen Sie die Spalten zu:
    • Pflichtfelder: Partner-ID (eindeutige Kunden-/Debitoren-/Kreditorennummer) und Name (Firmen- oder Personenname).
    • Optionale Felder: Land, Ort, Postleitzahl, Adresse, Geburtsdatum, Geburtsort (ermöglichen den schnellen Identitätsvergleich bei Treffern).
    • Alle übrigen Spalten Ihrer CSV werden beim Einlesen verworfen und niemals gespeichert.
  4. Wählen Sie Schwellwert und Referenzlisten.
  5. Konfigurieren Sie unter Quellenstatus & Überwachung optional:
    • Upload-Frist (Stunden): z. B. 26 Stunden bei täglichem Nacht-Upload – bleibt eine Datei aus, wird automatisch der Alarm sanctions_upload_overdue ausgelöst.
    • Automatisches Prüfintervall (Stunden): Optionales festes Re-Screening des aktiven Bestands (zusätzlich zu automatischen Nachprüfungen bei jeder neuen Sanktionslistenversion).
    • Rohdaten-Aufbewahrung (Tage, DSGVO): Standard 30 Tage; 0 bedeutet sofortige Minimierung unauffälliger Alt-Rohdaten nach Ablösung durch den nächsten Upload.

5. REST-API im Detail (Upload, Status & ERP-Rückkanal)

Die REST-API ermöglicht vollautomatische 24h-Prüfungen direkt aus jedem ERP-, CRM- oder Warenwirtschaftssystem.

Authentifizierung

Jede Datenquelle besitzt ein eigenes 64-stelliges Hex-Token (Authorization: Bearer <TOKEN>). Das Token wird ausschließlich als SHA-256-Hash gespeichert und bei Erzeugung einmalig angezeigt. Über API & Automatisierung können Tokens jederzeit rotiert oder widerrufen werden.

5.1 CSV-Upload starten (POST)

POST https://siedelmann.com/api/v1/sanktionspruefung/quellen/{source_uuid}/importe
Authorization: Bearer <64-stelliger-Hex-Token>
Content-Type: text/csv
Idempotency-Key: erp-export-2026-11-21
Accept: application/json
  • Body: Rohe CSV-Datei (UTF-8 oder Windows-1252, Semikolon oder Komma), maximal 16 MiB bzw. 50.000 Datensätze pro Upload.
  • Idempotency-Key (optional, empfohlen): Verhindert doppelte Imports bei Netzwerk-Wiederholungen (erlaubt: A-Za-z0-9._:@-, max. 128 Zeichen). Ein erneuter Request mit demselben Key liefert 200 OK mit der bestehenden import_id.
  • Antwort (202 Accepted):
{
  "import_id": "9f3c7c8e-1a2b-4c5d-8e9f-0123456789ab",
  "status": "queued",
  "message": null,
  "subject_count": null,
  "match_count": null,
  "reference_lists": ["eu", "un", "ofac_sdn", "us_bis"],
  "reference_versions": {},
  "finished_at": null,
  "status_url": "https://siedelmann.com/api/v1/sanktionspruefung/quellen/{source_uuid}/importe/9f3c7c8e-1a2b-4c5d-8e9f-0123456789ab",
  "findings_url": "https://siedelmann.com/api/v1/sanktionspruefung/quellen/{source_uuid}/treffer"
}

5.2 Prüfstatus abfragen (GET)

GET https://siedelmann.com/api/v1/sanktionspruefung/quellen/{source_uuid}/importe/{import_uuid}
Authorization: Bearer <TOKEN>
Accept: application/json

Mögliche status-Werte: queued → processing → completed (oder waiting, failed, superseded). Sobald status == "completed", enthält das JSON subject_count, match_count, reference_versions, finished_at und findings_url.

5.3 ERP-Rückkanal: Gesperrte Partner-IDs abrufen (GET)

Über den ERP-Rückkanal ruft Ihr ERP automatisch alle Geschäftspartner ab, für die offene oder bestätigte Sanktionstreffer vorliegen – ideal für automatische Liefersperren:

GET https://siedelmann.com/api/v1/sanktionspruefung/quellen/{source_uuid}/treffer?decision=open,requested,confirmed
Authorization: Bearer <TOKEN>
Accept: application/json
  • Parameter decision (optional): Kommagetrennte Liste aus open, requested, confirmed, excluded. Standard ohne Parameter: open,requested,confirmed (alle nicht als Fehlalarm ausgeschlossenen Fälle).
  • Antwort (200 OK):
{
  "source_id": "a1b2c3d4-...",
  "decisions": ["open", "requested", "confirmed"],
  "generated_at": "2026-11-21T02:04:12+01:00",
  "count": 1,
  "blocked_partner_ids": ["K-10428"],
  "findings": [
    {
      "case_id": "7d8e9f0a-...",
      "partner_id": "K-10428",
      "partner_name": "Mirador Handels GmbH",
      "decision": "open",
      "classification": "new",
      "score": 96,
      "list_key": "eu",
      "list_name": "EU – Finanzsanktionsliste",
      "reference": "EU.1234.5",
      "matched_name": "Mirador Handels",
      "last_observed_at": "2026-11-21T02:03:58+01:00"
    }
  ]
}

Sobald ein Treffer im 4-Augen-Prinzip als Fehlalarm (excluded) ausgeschlossen wird, verschwindet die partner_id automatisch aus blocked_partner_ids – Ihr ERP kann die Sperre beim nächsten Abgleich wieder aufheben.

HTTP-Statuscodes der API

Code Bedeutung Ursache / Maßnahme
202 Accepted Neuer CSV-Upload angenommen und zur Hintergrundprüfung eingereiht
200 OK Status-/Trefferabfrage erfolgreich oder idempotente Wiederholung
401 Unauthorized Fehlendes, ungültiges oder widerrufenes Bearer-Token
403 Forbidden Datenquelle deaktiviert oder Modullizenz/Testzeitraum abgelaufen
409 Conflict Mindestens eine gewählte Referenzliste der Quelle ist deaktiviert
413 Payload Too Large CSV überschreitet 16 MiB
415 Unsupported Media Type Header Content-Type: text/csv fehlt
422 Unprocessable Entity Leerer Body oder ungültiger Idempotency-Key
429 Too Many Requests Rate-Limit (60 Req/Min) oder mehr als 20 offene Läufe für die Quelle

6. Token-Einrichtung, .reg- / .sh-Dateien & Umgebungsvariablen

Damit geheime API-Tokens niemals im Klartext in Skripten oder Aufgabenplanungen stehen, erzeugt die Seite API & Automatisierung fertige Einrichtungsdateien:

Windows (.reg-Datei & Umgebungsvariable)

  1. Melden Sie sich mit genau dem Windows-Benutzerkonto an, unter dem später der Upload (z. B. Windows-Aufgabenplanung) läuft.
  2. Laden Sie unter API & Automatisierung → Schritt 2 die Windows-Datei (.reg) herunter.
  3. Importieren Sie die Datei per Doppelklick oder in PowerShell:
reg import ".\sanktions-einrichtung-<QUELLEN-UUID>.reg"
  1. Die .reg-Datei legt das Token als Benutzer-Umgebungsvariable unter HKEY_CURRENT_USER\Environment ab:
    • Variablenname: SANCTIONS_SOURCE_TOKEN_<UUID_IN_GROSSBUCHSTABEN_MIT_UNTERSTRICHEN>
  2. Wichtig: PowerShell/Aufgabenplanung neu starten (damit die neue Umgebungsvariable geladen wird) und die heruntergeladene .reg-Datei sofort löschen.

Manuelle Alternative ohne .reg-Datei:

# Dauerhaft im Benutzerkonto:
[Environment]::SetEnvironmentVariable("SANCTIONS_SOURCE_TOKEN_<UUID>", "<TOKEN>", "User")

# Oder temporaer nur fuer den aktuellen Prozess (ueberschreibt die quellenbezogene Variable):
$env:SANCTIONS_SOURCE_TOKEN = "<TOKEN>"

Linux (.sh-Datei & geschützte Token-Datei)

  1. Melden Sie sich als der Linux-Benutzer an, der den Cronjob / systemd-Timer ausführt.
  2. Laden Sie die Linux-Datei (.sh) herunter und führen Sie sie aus:
bash ./sanktions-einrichtung-<QUELLEN-UUID>.sh
rm ./sanktions-einrichtung-<QUELLEN-UUID>.sh
  1. Die Datei schreibt das Token geschützt (chmod 700 / umask 077) nach:
    • $HOME/.config/siedelmann/sanktionspruefung/<QUELLEN-UUID>.token

Manuelle Alternative ohne .sh-Datei:

export SANCTIONS_SOURCE_TOKEN="<TOKEN>"

7. Automatisierte Uploads (PowerShell, Bash, cURL & Zeitplan)

Die fertigen Upload-Skripte (sanktions-upload.ps1 und sanktions-upload.sh) stehen auf API & Automatisierung für jede Datenquelle zum Download bereit. Sie laden das Token automatisch, senden die CSV per POST und fragen die status_url bis zum Abschluss ab.

Windows-Aufgabenplanung (1× täglich, z. B. 02:00 Uhr)

  • Programm/Skript: powershell.exe
  • Argumente: -NoProfile -ExecutionPolicy Bypass -File "C:\Skripte\sanktions-upload.ps1" -CsvPath "C:\Exporte\partner.csv"
  • Benutzerkonto: Dasselbe Konto, in dem die .reg-Datei importiert wurde.

Linux Cronjob (1× täglich um 02:00 Uhr)

0 2 * * * /usr/bin/env bash /opt/sanktionspruefung/sanktions-upload.sh /pfad/zu/partner.csv >> /var/log/sanktions-upload.log 2>&1

Direkter cURL-Test (Upload & ERP-Rückkanal)

# 1. CSV-Upload starten
curl -X POST "https://siedelmann.com/api/v1/sanktionspruefung/quellen/<UUID>/importe" \
  -H "Authorization: Bearer $SANCTIONS_SOURCE_TOKEN" \
  -H "Content-Type: text/csv" \
  -H "Idempotency-Key: export-$(date +%F)" \
  --data-binary @partner.csv

# 2. Gesperrte Partner-IDs abrufen
curl -H "Authorization: Bearer $SANCTIONS_SOURCE_TOKEN" \
  "https://siedelmann.com/api/v1/sanktionspruefung/quellen/<UUID>/treffer?decision=open,requested,confirmed"

Bestände über 50.000 Datensätze

Jede Datenquelle verarbeitet bis zu 50.000 Datensätze (16 MiB) je Upload. Bei größeren Beständen (z. B. 100.000–250.000 Partner) teilen Sie diese einfach auf mehrere Datenquellen auf (z. B. Debitoren + Kreditoren, nach Buchungskreis oder Partner A–M + Partner N–Z).


8. Praxis-Anleitungen für gängige ERP-Systeme

8.1 SAP Business One (MS SQL Server & SAP HANA)

Exportiert aktive Kunden (CardType = 'C') und Lieferanten (CardType = 'S') mit Standardadresse:

SELECT
    T0.CardCode                         AS [Partner-ID],
    T0.CardName                         AS [Name],
    COALESCE(T1.Country, T0.Country,'') AS [Land],
    COALESCE(T1.City, T0.City, '')      AS [Ort],
    COALESCE(T1.ZipCode, T0.ZipCode,'') AS [Postleitzahl],
    COALESCE(T1.Street, T0.Address, '') AS [Adresse]
FROM OCRD T0
LEFT JOIN CRD1 T1
    ON T1.CardCode = T0.CardCode
   AND T1.Address  = T0.BillToDef
   AND T1.AdresType = 'B'
WHERE T0.validFor = 'Y'
  AND T0.CardType IN ('C', 'S');

Rückkanal in SAP B1: Lesen Sie blocked_partner_ids aus GET /treffer aus und sperren Sie die betroffenen CardCodes über den SAP Service Layer (PATCH /BusinessPartners('C10001') mit {"Frozen": "tYES"}).

8.2 Sage 100 / Sage Office Line (MS SQL Server)

SELECT
    K.Kto                               AS [Partner-ID],
    LTRIM(RTRIM(COALESCE(A.Name1,'') + ' ' + COALESCE(A.Name2,''))) AS [Name],
    COALESCE(A.Land, '')                AS [Land],
    COALESCE(A.Ort, '')                 AS [Ort],
    COALESCE(A.PLZ, '')                 AS [Postleitzahl],
    COALESCE(A.Strasse, '')             AS [Adresse]
FROM KHKKontokorrent K
INNER JOIN KHKAdressen A
    ON A.Mandant = K.Mandant
   AND A.Adresse = K.Adresse
WHERE K.Mandant = 1
  AND K.KtoArt IN ('D', 'K')
  AND COALESCE(K.Aktiv, -1) <> 0;

8.3 Microsoft Dynamics 365 Business Central / NAV

  • Exportieren Sie Customer ("D-" + "No." als Partner-ID) und Vendor ("K-" + "No.") per Aufgabenwarteschlange (Job Queue), OData oder Power Automate als Semikolon-CSV.
  • Über den Rückkanal GET /treffer setzen Sie für jede ID in blocked_partner_ids automatisch Customer.Blocked := Customer.Blocked::All.

8.4 JTL-Wawi (MS SQL Server)

SELECT
    'K-' + k.cKundenNr                  AS [Partner-ID],
    COALESCE(NULLIF(a.cFirma,''), LTRIM(RTRIM(COALESCE(a.cVorname,'') + ' ' + COALESCE(a.cName,'')))) AS [Name],
    COALESCE(a.cISO, a.cLand, '')       AS [Land],
    COALESCE(a.cOrt, '')                AS [Ort],
    COALESCE(a.cPLZ, '')                AS [Postleitzahl],
    COALESCE(a.cStrasse, '')            AS [Adresse]
FROM dbo.tKunde k
INNER JOIN dbo.tAdresse a
    ON a.kKunde = k.kKunde AND a.nStandard = 1 AND a.nTyp = 1
WHERE k.nAktiv = 1
UNION ALL
SELECT
    'L-' + l.cLiefNr                    AS [Partner-ID],
    l.cFirma                            AS [Name],
    COALESCE(l.cLandISO, '')            AS [Land],
    COALESCE(l.cOrt, '')                AS [Ort],
    COALESCE(l.cPLZ, '')                AS [Postleitzahl],
    COALESCE(l.cStrasse, '')            AS [Adresse]
FROM dbo.tLieferant l
WHERE l.cAktiv = 'Y';

8.5 DATEV, Lexware, SevDesk & WISO (CSV-Export ohne SQL)

  1. Exportieren Sie Debitoren/Kreditoren als CSV (Semikolon, UTF-8 oder Windows-1252) in einen festen Ordner (z. B. C:\Sanktionspruefung\export.csv).
  2. Ordnen Sie die Spalten einmalig in der Datenquelle zu.
  3. Lassen Sie sanktions-upload.ps1 täglich über die Windows-Aufgabenplanung laufen.

8.6 Odoo (PostgreSQL) & End-to-End-PowerShell-Ablauf

SELECT
    COALESCE(NULLIF(p.ref, ''), 'P-' || p.id::text) AS "Partner-ID",
    p.name                                          AS "Name",
    COALESCE(c.code, '')                            AS "Land",
    COALESCE(p.city, '')                            AS "Ort",
    COALESCE(p.zip, '')                             AS "Postleitzahl",
    COALESCE(p.street, '')                          AS "Adresse"
FROM res_partner p
LEFT JOIN res_country c ON c.id = p.country_id
WHERE p.active = true AND p.is_company = true;

Komplett-Skript (Upload + ERP-Sperrliste abrufen):

# 1. Aktuelle CSV hochladen
powershell -NoProfile -File ".\sanktions-upload.ps1" -CsvPath "C:\Exporte\partner.csv"

# 2. Gesperrte Partner-IDs abrufen und als ERP-Sperrliste speichern
$headers = @{ Authorization = "Bearer $env:SANCTIONS_SOURCE_TOKEN"; Accept = "application/json" }
$result = Invoke-RestMethod -Uri "https://siedelmann.com/api/v1/sanktionspruefung/quellen/<UUID>/treffer?decision=open,requested,confirmed" -Headers $headers
$result.findings | Select-Object partner_id, partner_name, decision, score, list_name |
    Export-Csv -Path "C:\Exporte\gesperrte-partner.csv" -Delimiter ';' -NoTypeInformation -Encoding UTF8

9. Fallakten, Trefferbewertung & 4-Augen-Prinzip

Jeder Treffer aus einer Datenquelle mit Partner-ID wird automatisch einer dauerhaften Fallakte zugeordnet:

  • Status-Lebenszyklus:
    1. Offen – Neuer oder geänderter möglicher Treffer.
    2. Ausschluss beantragt – Erste Person hat nach Merkmalsvergleich (Land, Ort, Adresse, Geburtsdatum, offizielle Rechtsakte) eine dokumentierte Fehlalarm-Begründung hinterlegt.
    3. Als Fehlalarm ausgeschlossen – Zweite berechtigte Person (Inhaber/Admin) bestätigt den Ausschluss (strenges 4-Augen-Prinzip). Der Treffer wird künftig bei unveränderten Daten automatisch ausgeblendet.
    4. Treffer bestätigt – Echter Sanktionstreffer dokumentiert; Geschäftsbeziehung muss gesperrt/geprüft werden.
  • Automatische Wiederöffnung: Ändern sich Angaben am Geschäftspartner oder am Sanktionslisteneintrag, öffnet das System den Fall automatisch erneut (Geänderter Fall), damit er neu bewertet wird.
  • Sammelbewertung (Bulk-Review): In der Fallakten-Arbeitsliste lassen sich mehrere Fälle gleichzeitig markieren und mit gemeinsamer Begründung bewerten – das 4-Augen-Prinzip wird dabei weiterhin für jeden einzelnen Fall geprüft.
  • Suche & CSV-Export: Sowohl Fallakten als auch Prüftreffer lassen sich durchsuchen, filtern und Excel-kompatibel (UTF-8 BOM, Semikolon, Formelschutz) als CSV exportieren.

10. Benachrichtigungen (E-Mail & Telegram)

Unter API & Automatisierung → Schritt 4 (sowie unter Einstellungen → Benachrichtigungen) legen Sie fest, wie Ihr Team informiert wird:

  • Kanäle: E-Mail (eine oder mehrere Empfängeradressen über Ihren eingerichteten Versanddienst) und/oder Telegram (Bot-Token + Chat-ID).
  • Ereignisse:
    • sanctions_findings: Neue oder geänderte Sanktionsfälle
    • sanctions_failure: Prüflauf technisch fehlgeschlagen
    • sanctions_upload_overdue: Erwartete Dateilieferung einer Quelle überfällig
  • Datenschutz: Nachrichten enthalten niemals Partnernamen, Trefferdetails oder Adressen – nur den Ereignishinweis und den Link zur App.

11. Revisionssichere Nachweise (PDF, ZIP, Partnernachweis, Jahresbericht)

Der Prüfverlauf ist absichtlich nicht manuell löschbar, um die Beweiskraft gegenüber Zoll, BAFA und Wirtschaftsprüfern (GoBD/AWG/HGB) sicherzustellen.

  • PDF-Prüfbericht: Enthält automatisch Ihr Firmenlogo (aus den zentralen Mandanteneinstellungen), Status-Siegel, KPI-Übersicht, Zeitstempel, SHA-256-Datei-Prüfsumme, alle verwendeten Listenstände inkl. Prüfsummen sowie Treffer mit Links zu EUR-Lex-Rechtsakten.
  • ZIP-Nachweispaket: Enthält Pruefbericht.pdf, Datensaetze.csv, Treffer.csv, Bewertungen.csv sowie eine SHA-256-Prüfsummendatei über alle enthaltenen Dokumente.
  • Partnernachweis (HTML & PDF): Belegt über einen frei wählbaren Zeitraum minutengenau alle abgeschlossenen Prüfungen eines einzelnen Geschäftspartners – inkl. Live-Suche nach Partner-ID oder Name und vollständigem 4-Augen-Bewertungsverlauf.
  • Jahresbericht (PDF): Kompakte Jahresstatistik aller Prüfläufe, geprüften Datensätze, Treffer und Bewertungen.

12. DSGVO, Datenminimierung, Art.-15-Auskunft & AVV/TOM

Das Modul folgt strikt dem Grundsatz der Datenminimierung (Art. 5 Abs. 1 lit. c & e DSGVO):

  • Lokaler Abgleich: Keine Weitergabe von Partnerdaten an externe Abfrage-APIs.
  • Verschlüsselung: TLS bei Übertragung, AES-256 (encrypted) für Rohdaten, Prüfdatensätze und eigene Listen in der Datenbank; API-Tokens nur als SHA-256-Hash.
  • Automatisches 3-Stufen-Löschkonzept (sanctions:prune, täglich 03:15 UTC):
    1. CSV-Rohdatei (input): Nach Abschluss der Prüfung sofort geleert.
    2. Unauffällige Rohdatensätze historischer Läufe: Standardmäßig nach 30 Tagen automatisch gelöscht (pro Datenquelle bis auf 0 Tage verkürzbar). Der aktive Bestand bleibt für automatische Nachprüfungen geschützt.
    3. Kryptografische Partnernachweise (HMAC-SHA256): Belegen auch nach Löschung der Klartext-Rohdaten bis zu 10 Jahre revisionssicher, dass ein Partner geprüft wurde – ohne Klartext-Vorratsdatenspeicherung.
  • Art.-15-Auskunft: Inhaber/Admins können unter DSGVO-Hinweise alle aktuell noch im Klartext gespeicherten Datensätze durchsuchen, die Bestandsübersicht einsehen und eine Betroffenenauskunft als CSV oder JSON exportieren.
  • Elektronischer AVV & TOM (PDF): Unter AVV & TOM (PDF) im Untermenü steht jederzeit ein mit den Stammdaten des Mandanten vorausgefüllter Auftragsverarbeitungsvertrag nach Art. 28 Abs. 9 DSGVO (rechtswirksam ohne handschriftliche Unterschrift) inkl. Anlage 1 (TOM) zum Download bereit.

13. Fehlerbehebung & Support

  • Upload liefert 401 Unauthorized: Prüfen Sie, ob das Token korrekt in der Umgebungsvariablen des ausführenden Benutzerkontos gesetzt ist und nach dem .reg-Import PowerShell bzw. die Aufgabenplanung neu gestartet wurde.
  • Upload liefert 409 Conflict: Eine der für die Datenquelle ausgewählten Sanktionslisten wurde deaktiviert. Öffnen Sie API & Automatisierung → Schritt 1 und speichern Sie eine gültige Listenauswahl.
  • Ausschluss kann nicht bestätigt werden: Das 4-Augen-Prinzip verhindert, dass dieselbe Person den Ausschluss beantragt und bestätigt. Laden Sie unter Einstellungen → Team eine zweite berechtigte Person (Inhaber/Admin) ein.
  • Direkter Support: Im Modul finden Sie im linken Untermenü den Punkt Support & Feedback für Fehlerhinweise, Verbesserungsvorschläge und direkte Anfragen an SiedelmannIT (stefan@siedelmann.com).
PRODUKTÜBERSICHTSanktionsmanagement im Überblick →