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.
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:
GET /treffer) fĂŒr automatische Liefersperren im ERP-System.HMAC-SHA256-Partnernachweise, Art.-15-Auskunft sowie elektronischer AVV inkl. TOM (PDF).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.
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.
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):
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
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"]
}
]
<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>
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.
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.https://-Adressen ohne Zugangsdaten oder Sonderports zulÀssig; Weiterleitungen, DOCTYPE-Deklarationen sowie private, interne oder Loopback-IP-Bereiche werden blockiert.Der Namensabgleich arbeitet vollstÀndig lokal und deterministisch (Verfahren v1):
Ă€ â ae, kyrillische/arabische Umschriften), Entfernung von Satzzeichen.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â).| 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 |
Eine Datenquelle beschreibt ein externes System (z. B. SAP Debitoren, Sage Kreditoren, JTL Kunden).
Partner-ID (eindeutige Kunden-/Debitoren-/Kreditorennummer) und Name (Firmen- oder Personenname).Land, Ort, Postleitzahl, Adresse, Geburtsdatum, Geburtsort (ermöglichen den schnellen IdentitĂ€tsvergleich bei Treffern).26 Stunden bei tĂ€glichem Nacht-Upload â bleibt eine Datei aus, wird automatisch der Alarm sanctions_upload_overdue ausgelöst.30 Tage; 0 bedeutet sofortige Minimierung unauffĂ€lliger Alt-Rohdaten nach Ablösung durch den nĂ€chsten Upload.Die REST-API ermöglicht vollautomatische 24h-PrĂŒfungen direkt aus jedem ERP-, CRM- oder Warenwirtschaftssystem.
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.
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
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.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"
}
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.
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
decision (optional): Kommagetrennte Liste aus open, requested, confirmed, excluded. Standard ohne Parameter: open,requested,confirmed (alle nicht als Fehlalarm ausgeschlossenen FĂ€lle).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.
| 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 |
.reg- / .sh-Dateien & UmgebungsvariablenDamit geheime API-Tokens niemals im Klartext in Skripten oder Aufgabenplanungen stehen, erzeugt die Seite API & Automatisierung fertige Einrichtungsdateien:
.reg-Datei & Umgebungsvariable).reg) herunter.reg import ".\sanktions-einrichtung-<QUELLEN-UUID>.reg"
.reg-Datei legt das Token als Benutzer-Umgebungsvariable unter HKEY_CURRENT_USER\Environment ab:
SANCTIONS_SOURCE_TOKEN_<UUID_IN_GROSSBUCHSTABEN_MIT_UNTERSTRICHEN>.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>"
.sh-Datei & geschĂŒtzte Token-Datei).sh) herunter und fĂŒhren Sie sie aus:bash ./sanktions-einrichtung-<QUELLEN-UUID>.sh
rm ./sanktions-einrichtung-<QUELLEN-UUID>.sh
chmod 700 / umask 077) nach:
$HOME/.config/siedelmann/sanktionspruefung/<QUELLEN-UUID>.tokenManuelle Alternative ohne .sh-Datei:
export SANCTIONS_SOURCE_TOKEN="<TOKEN>"
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.
powershell.exe-NoProfile -ExecutionPolicy Bypass -File "C:\Skripte\sanktions-upload.ps1" -CsvPath "C:\Exporte\partner.csv".reg-Datei importiert wurde.0 2 * * * /usr/bin/env bash /opt/sanktionspruefung/sanktions-upload.sh /pfad/zu/partner.csv >> /var/log/sanktions-upload.log 2>&1
# 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"
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).
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"}).
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;
Customer ("D-" + "No." als Partner-ID) und Vendor ("K-" + "No.") per Aufgabenwarteschlange (Job Queue), OData oder Power Automate als Semikolon-CSV.GET /treffer setzen Sie fĂŒr jede ID in blocked_partner_ids automatisch Customer.Blocked := Customer.Blocked::All.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';
C:\Sanktionspruefung\export.csv).sanktions-upload.ps1 tĂ€glich ĂŒber die Windows-Aufgabenplanung laufen.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
Jeder Treffer aus einer Datenquelle mit Partner-ID wird automatisch einer dauerhaften Fallakte zugeordnet:
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.GeĂ€nderter Fall), damit er neu bewertet wird.Unter API & Automatisierung â Schritt 4 (sowie unter Einstellungen â Benachrichtigungen) legen Sie fest, wie Ihr Team informiert wird:
sanctions_findings: Neue oder geĂ€nderte SanktionsfĂ€llesanctions_failure: PrĂŒflauf technisch fehlgeschlagensanctions_upload_overdue: Erwartete Dateilieferung einer Quelle ĂŒberfĂ€lligDer PrĂŒfverlauf ist absichtlich nicht manuell löschbar, um die Beweiskraft gegenĂŒber Zoll, BAFA und WirtschaftsprĂŒfern (GoBD/AWG/HGB) sicherzustellen.
Pruefbericht.pdf, Datensaetze.csv, Treffer.csv, Bewertungen.csv sowie eine SHA-256-PrĂŒfsummendatei ĂŒber alle enthaltenen Dokumente.Das Modul folgt strikt dem Grundsatz der Datenminimierung (Art. 5 Abs. 1 lit. c & e DSGVO):
encrypted) fĂŒr Rohdaten, PrĂŒfdatensĂ€tze und eigene Listen in der Datenbank; API-Tokens nur als SHA-256-Hash.sanctions:prune, tĂ€glich 03:15 UTC):
input): Nach Abschluss der PrĂŒfung sofort geleert.HMAC-SHA256): Belegen auch nach Löschung der Klartext-Rohdaten bis zu 10 Jahre revisionssicher, dass ein Partner geprĂŒft wurde â ohne Klartext-Vorratsdatenspeicherung.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.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.stefan@siedelmann.com).