Spezifikationen

Spezifikationen der Clearing-Schnittstelle und Kopplung von Clearing Plattformen

Allgemeine Information zur Clearingschnittstelle und der Kopplung von Clearing Plattformen

Die erste Version 1.0 Spezifikation der Schnittstelle für die Clearing-Plattformen wurde vom Arbeitskreis Schnittstellen & Prozesse seit Sommer 2021 mit einer Reihe von Dienstleistern erarbeitet. Sie basiert auf zeitgemäßen technischen Standards auf Basis von REST-Schnittstellen und den Leitlinien des Tele Management-Forums (TMF).

Nach Veröffentlichung der Versionen 1.0 und 1.1 haben einige Telekommunikationsunternehmen die praktische Anwendung der Schnittstelle verprobt und die daraus gesammelten Erfahrungen aus den Piloten sind nun in die Version 1.2.1 eingeflossen. Das grundlegende technischen Konzept für das Clearing wurde hierbei nicht verändert. Die Änderungen wirken insbesondere auf die fachliche Nutzung der von den Dienstleistern betriebenen Clearing Plattformen. Die Anpassungen umfassen hierbei beispielsweise die Erweiterung der Metadaten um fachlich relevante Attribute, Review von Pflichtfeldern und Erweiterung der nutzbaren Clearingszenarien.

DEZEMBER 2025

Der Arbeitskreis Schnittstellen und Prozesse unterstützt ausdrücklich den Einsatz verschiedener Clearing Plattformen, da diese Diversifizierung den unterschiedlichen Anforderungen der Telekommunikationsunternehmen entgegenkommt und einer Marktdurchdringung weiteren Vorschub verleiht.

Damit Unternehmen, die auf unterschiedlichen Clearingplattformen untereinander Tickets empfangen und versenden können, war es erforderlich eine Schnittstellenspezifikation zur Kopplung von Clearingplattformen zu entwickeln. Die im Dezember 2025 verabschiedete Schnittstellenspezifikation wurde bereits zwischen zwei Betreibern von Clearing Plattformen erfolgreich etabliert und befindet sich im praktischen Einsatz.
Durch die Veröffentlichung haben nun auch anderen Dienstleister die Möglichkeit, eine entsprechende Clearing Plattform zu entwickeln und sich mit anderen Betreiber zu koppeln.

Hinweis: Anbieter von Clearing Plattformen werden vom Arbeitskreis Schnittstellen und Prozesse veröffentlicht, wenn die Kopplung zwischen sämtlichen Plattformbetreiber erfolgreich abgeschlossen ist.

Die aktuellen Betreiber von Clearing Plattformen können hier eingesehen werden. Zur Einrichtung und Inbetriebnahme eine Kopplung finden sich dort auch die entsprechenden Kontaktdaten.

Clearing Schnittstellenspezifikation 1.2.1 (Juni 2025)

Main 1 – Clearing Platform REST API Specification (Version 1.2.1 vom August 2025)

Es handelt sich um das Kerndokument, welches die Funktionalität der Schnittstelle definiert (angelehnt an die Trouble Ticket REST API Specification TMF621)

REF-1 – Clearing Platform non functional requirements (V1.0 unverändert vom September 2022)

Die Spezifikation der nicht funktionalen Anforderungen an die Plattformen (Sicherheit, Datenschutz u.a.)

REF-2 – Clearing Platform Open API_ Specification (Version 1.1. vom September 2023)

Diese maschinenlesbare YAML-Datei (auch wandelbar in ein JSON-Format) spezifiziert die Schnittstelle in technischer Hinsicht.

REF-3 (XLSX) – Clearing Platform Metadata (Version 1.2.1 vom Juni 2025)
REF-4 – (YAML) – Clearing Platform Metadata (Version 1.2.1 vom Juni 2025)

Es handelt sich um das technische Validierungs-Schema, das die zahlreichen fachlich abgeleiteten Felder beschreibt (z.B. Clearingszenarien, Verwendung von Feldern in Abhängigkeit vom Szenario, Pflichtfelder und anderes). Es handelt sich um ein Dokumentenpaar: es ist im YAML-Format maschinenlesbar, während die XLS-Datei (REF-3) eine inhaltsgleiche, aber besser menschenlesbare Version davon bereitstellt. Weiterhin beschreibt und dokumentiert die Datei (REF-5) dieses Schema.

REF-5 – Clearing Platform Metadata Schema (Version 1.2. vom Oktober 2024)
REF-6 – Testfälle zur vor Inbetriebnahme der Schnittstelle zwischen Telekommunikationsunternehmen und einer Clearingplattform
REF-7 – Handling von Non-Clearing-Organisation (Version 1.0 vom August 2025)
Clearing Platform REST API – Änderungen der Spezifikation zwischen der Version 1.2.1 und Version 1.2

Die YAML Dateien werden als ZIP File zur Verfügung gestellt.

Schnittstellen Spezifikation zu Kopplung von Clearingplattformen 1.0 (Dezember 2025)

Main 1 – Clearing Inter-Platform API Specification (Version 1.0 vom Dezember 2025)

Es handelt sich um das Kerndokument, welches die Funktionalität der Schnittstelle zwischen den Plattformen definiert.

REF-1 – Clearing Platform Open API_ Specification (Version 1 vom Dezmeber 2025)

Diese maschinenlesbare YAML-Datei (auch wandelbar in ein JSON-Format) spezifiziert die Schnittstelle in technischer Hinsicht.

REF-2 – Testfall Liste zur Kopplung zweier Clearing-Plattformen
REF-6 – Testfälle zur vor Inbetriebnahme der Schnittstelle zwischen Telekommunikationsunternehmen und einer Clearingplattform
REF-7 – Handling von Non-Clearing-Organisation (Version 1.0 vom August 2025)

Die YAML Datei wir als ZIP File zur Verfügung gestellt.