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
/register14 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):
- CSV-Upload (Semikolon-getrennt, UTF-8, Pflichtspalten
ReferenzundName, 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
- JSON / NDJSON-Upload (Standard-JSON-Array, Wrapper-Objekte wie
results/entries/itemssowie zeilenweises NDJSON wie OpenSanctionsentities.ftm.json):
[
{
"reference": "SP-001",
"name": "Beispiel Sperrfirma GmbH",
"aliases": ["BSF GmbH", "Beispiel Holding"],
"countries": ["DE", "AT"]
}
]
- 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>
- 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.
- Automatische Felderkennung & eigene Feldzuordnung: Gängige Feldnamen (
3. Abgleichverfahren, Schwellwerte & Identitätsvergleich
Der Namensabgleich arbeitet vollständig lokal und deterministisch (Verfahren v1):
- Normalisierung: Kleinschreibung, Transliteration von Umlauten und Sonderzeichen (z. B.
ä→ae, kyrillische/arabische Umschriften), Entfernung von Satzzeichen. - 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“). - Kombiniertes Scoring (0–100 %): Kombination aus zeichenbasierter Editierdistanz (Levenshtein) und Wort-Übereinstimmung (Token-Overlap).
- 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).
- Öffnen Sie Datenquellen & API → Neue Datenquelle anlegen.
- Laden Sie optional eine CSV-Beispieldatei hoch – das System erkennt gängige Spaltennamen automatisch.
- Ordnen Sie die Spalten zu:
- Pflichtfelder:
Partner-ID(eindeutige Kunden-/Debitoren-/Kreditorennummer) undName(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.
- Pflichtfelder:
- Wählen Sie Schwellwert und Referenzlisten.
- Konfigurieren Sie unter Quellenstatus & Überwachung optional:
- Upload-Frist (Stunden): z. B.
26Stunden bei täglichem Nacht-Upload – bleibt eine Datei aus, wird automatisch der Alarmsanctions_upload_overdueausgelö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
30Tage;0bedeutet sofortige Minimierung unauffälliger Alt-Rohdaten nach Ablösung durch den nächsten Upload.
- Upload-Frist (Stunden): z. B.
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 liefert200 OKmit der bestehendenimport_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 ausopen,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)
- Melden Sie sich mit genau dem Windows-Benutzerkonto an, unter dem später der Upload (z. B. Windows-Aufgabenplanung) läuft.
- Laden Sie unter API & Automatisierung → Schritt 2 die Windows-Datei (
.reg) herunter. - Importieren Sie die Datei per Doppelklick oder in PowerShell:
reg import ".\sanktions-einrichtung-<QUELLEN-UUID>.reg"
- Die
.reg-Datei legt das Token als Benutzer-Umgebungsvariable unterHKEY_CURRENT_USER\Environmentab:- Variablenname:
SANCTIONS_SOURCE_TOKEN_<UUID_IN_GROSSBUCHSTABEN_MIT_UNTERSTRICHEN>
- Variablenname:
- 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)
- Melden Sie sich als der Linux-Benutzer an, der den Cronjob / systemd-Timer ausführt.
- 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
- 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."alsPartner-ID) undVendor("K-" + "No.") per Aufgabenwarteschlange (Job Queue), OData oder Power Automate als Semikolon-CSV. - Über den Rückkanal
GET /treffersetzen Sie für jede ID inblocked_partner_idsautomatischCustomer.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)
- Exportieren Sie Debitoren/Kreditoren als CSV (Semikolon, UTF-8 oder Windows-1252) in einen festen Ordner (z. B.
C:\Sanktionspruefung\export.csv). - Ordnen Sie die Spalten einmalig in der Datenquelle zu.
- Lassen Sie
sanktions-upload.ps1tä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:
Offen– Neuer oder geänderter möglicher Treffer.Ausschluss beantragt– Erste Person hat nach Merkmalsvergleich (Land, Ort, Adresse, Geburtsdatum, offizielle Rechtsakte) eine dokumentierte Fehlalarm-Begründung hinterlegt.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.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ällesanctions_failure: Prüflauf technisch fehlgeschlagensanctions_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.csvsowie 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 alsSHA-256-Hash. - Automatisches 3-Stufen-Löschkonzept (
sanctions:prune, täglich 03:15 UTC):- CSV-Rohdatei (
input): Nach Abschluss der Prüfung sofort geleert. - 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.
- 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.
- CSV-Rohdatei (
- 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).
