ZELYRA
SOFTWARE HANDBOOK · COMPLIANCE MODULE

Sanctions
Management.

Complete technical & compliance documentation: 9 official lists + custom lists, async REST API (up to 50,000 records), ERP integration (SAP, Sage, JTL, Business Central, DATEV, Odoo), four-eyes review, audit PDFs, and GDPR.

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) returning blocked_partner_ids for 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-SHA256 partner 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 .reg file (HKEY_CURRENT_USER\Environment → SANCTIONS_SOURCE_TOKEN_<UUID>), import via reg import, delete the .reg file, and schedule sanktions-upload.ps1 daily via Windows Task Scheduler.
  • Linux: Run the source .sh setup script (writes $HOME/.config/siedelmann/sanktionspruefung/<uuid>.token with chmod 700/umask 077), delete the .sh file, and schedule sanktions-upload.sh via 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 cryptographic HMAC-SHA256 partner 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.
PRODUCT OVERVIEWSanctions Management Module →