Sanctions Management – Complete Handbook
Welcome to the official handbook for the Sanctions Screening (Compliance Suite) module of the Siedelmann Business Suite. This guide covers the compliance architecture, official and custom lists, REST API (upload, status, and ERP blocked-partner return channel), ERP SQL templates, four-eyes review workflows, GDPR data minimization, and audit evidence.
1. Overview & Compliance Architecture
Companies operating in the EU and international trade must ensure that no funds or economic resources are made available to sanctioned individuals or entities. The Sanctions Screening module automates screening and creates tamper-evident audit trails:
- 9 official sanctions & export-control lists built in (automatically refreshed every 6 hours).
- Unlimited custom lists via CSV, JSON/NDJSON, XML, or external HTTPS URL sync.
- Ad-hoc single checks and asynchronous REST API batch uploads up to 50,000 records per upload (16 MiB).
- ERP return channel (
GET /treffer) returningblocked_partner_idsfor automated delivery blocks. - Case worklist with structured identity comparison, bulk review, and strict four-eyes approval.
- Audit-grade exports: Branded PDF audit reports (with your company logo & SHA-256 checksums), ZIP evidence packages, single-partner proofs, and annual reports.
- GDPR by design: Local matching (no third-party APIs), AES-256 encryption at rest, automatic daily raw-data pruning, cryptographic
HMAC-SHA256partner proofs, Art. 15 subject access export, and pre-filled electronic DPA + TOM PDF (Art. 28(9) GDPR).
2. Official & Custom Sanctions Lists
9 Integrated Official Lists (6-Hour Sync)
| Key | Official List | Scope |
|---|---|---|
eu |
EU Financial Sanctions (CFSP) | Mandatory EU baseline, includes direct EUR-Lex legal act links |
un |
UN Consolidated List (UNSC) | Global UN Security Council sanctions |
ofac_sdn |
US OFAC SDN | US Treasury primary sanctions list |
ofac_non_sdn |
US OFAC Non-SDN (Consolidated) | Secondary US financial sanctions |
us_bis |
US BIS Export Control | Entity List (EL), Denied Persons (DPL), Unverified List (UVL) |
uk |
UK Sanctions List | UK FCDO/OFSI consolidated designations |
ch |
Switzerland – SECO | Swiss sanctions list (automatically excludes de-listed targets) |
ca |
Canada – SEMA | Canadian autonomous sanctions list |
au |
Australia – DFAT Consolidated List | Australian sanctions list (merges primary names & aliases) |
Custom Lists (CSV, JSON/NDJSON, XML & HTTPS URL)
Managers can upload custom blocklists (up to 10 MB) as CSV, JSON/NDJSON (including OpenSanctions), or XML, or link an external https:// URL for automatic 6-hour synchronization. Common field names (id/reference, name/caption, aliases/aka, countries, birth_dates/dob) are detected automatically or can be mapped manually. Private/internal IPs and XML DOCTYPE declarations are blocked (SSRF protection).
3. REST API Reference
Authenticate every request with Authorization: Bearer <64-hex-token>.
Upload CSV (POST)
POST https://siedelmann.com/api/v1/sanktionspruefung/quellen/{source_uuid}/importe
Authorization: Bearer <TOKEN>
Content-Type: text/csv
Idempotency-Key: erp-export-2026-11-21
Returns 202 Accepted with import_id, status_url, and findings_url. Supports up to 16 MiB / 50,000 records per upload.
Poll Run Status (GET)
GET https://siedelmann.com/api/v1/sanktionspruefung/quellen/{source_uuid}/importe/{import_uuid}
Authorization: Bearer <TOKEN>
ERP Return Channel – Blocked Partner IDs (GET)
GET https://siedelmann.com/api/v1/sanktionspruefung/quellen/{source_uuid}/treffer?decision=open,requested,confirmed
Authorization: Bearer <TOKEN>
Returns blocked_partner_ids and structured findings[] so your ERP can automatically block deliveries until a case is cleared via four-eyes review.
4. Token Setup, Automation & ERP Integration
- Windows: Download the source
.regfile (HKEY_CURRENT_USER\Environment→SANCTIONS_SOURCE_TOKEN_<UUID>), import viareg import, delete the.regfile, and schedulesanktions-upload.ps1daily via Windows Task Scheduler. - Linux: Run the source
.shsetup script (writes$HOME/.config/siedelmann/sanktionspruefung/<uuid>.tokenwithchmod 700/umask 077), delete the.shfile, and schedulesanktions-upload.shvia Cron (0 2 * * *). - Ready-to-use SQL & Export Templates: Available directly inside the module under ERP-Anleitungen for SAP Business One, Sage 100, Microsoft Dynamics 365 Business Central, JTL-Wawi, DATEV / Lexware / SevDesk, and Odoo.
5. Four-Eyes Review, Notifications, Audit Reports & GDPR
- Four-Eyes Principle: Exclusions (
excluded) strictly require confirmation by a second authorized manager (including in bulk reviews). - Alerts: Email and/or Telegram alerts for new/changed findings, failed runs, or overdue uploads – without exposing personal data in notifications.
- Audit Evidence: Branded PDF audit reports, ZIP evidence archives, single-partner proofs, and annual reports.
- GDPR Data Minimization: Daily pruning (
sanctions:prune, 03:15 UTC) deletes raw personal data of non-hit historical runs after the configured retention period (default 30 days, down to 0 days per source), while keeping cryptographicHMAC-SHA256partner proofs intact for up to 10 years. Art. 15 subject access search/export and a pre-filled electronic DPA + TOM PDF (Art. 28(9) GDPR) are built directly into the module.
