Architecture

The SIVI Verzuim Connector is an extension that runs inside Microsoft Dynamics 365 Business Central. It depends on the Dynamics Dossier app and reads data from standard BC objects as well as Dynamics Dossier objects.

High-level Overview

flowchart TD
    subgraph Business Central
        E[Employee record]
        EM[Employment record]
        D[Absence dossier]
        S[SIVI Export Setup]
        L[SIVI Export Log]
    end

    E -->|Employee data| X[XML Builder]
    EM -->|Employment details| X
    D -->|Absence report| X
    X -->|SIVI 2026 XML in JSON envelope| A[Occupational health service API]
    S -->|API URL, credentials, employer details| X
    A -->|Response| L

Components

SIVI Export Setup

A single configuration record that stores the API connection details, authentication method, and employer identifiers required for every SIVI message. See Configuration.

XML Builders

Three XML builders construct SIVI 2026-compliant XML payloads:

Envelope Builder

Wraps the XML payload in the JSON envelope format required by the occupational health service API.

API Client

Sends the JSON envelope to the configured API endpoint and returns the response. Supports API key and bearer token authentication.

SIVI Export Log

Records the result of every export attempt, including the message type, employee, timestamp, status (Success / Warning / Error), and any error description.

Dependency

The SIVI Verzuim Connector requires Dynamics Dossier (Q-Team Solutions B.V., version 26.0 or later). It reads absence dossiers created and managed by that app.