Mit dem Telekom-Adapter ist es möglich, Vertragsdaten und SIM-Karten vom Portal der Telekom nach i-doit zu importieren.
Zur Nutzung des Adapters benötigen Sie eine entsprechende Lizenz, welche Sie über den Marketplace von synetics oder direkt von SHD erhalten können.
Installation
Zur Nutzung des Telekom-Adapters ist ein Internetzugriff vom i-doit Host auf das Portal der Telekom nötig.
Die Nutzung des Telekom-Portals muss beim Anbieter mit Hilfe der B2B-Abteilung beantragt werden. Im nächsten Schritt ist es nötig ein TLS-Zertifikat zu erstellen und der Telekom mitzuteilen. Dieses wird dann für den vereinbarten Rahmenvertrag freigeschaltet. Nach erfolgreicher Beantragung muss das Zertifikat dann nach i-doit importiert werden.
Sie können das Zertifikat und den privaten Schlüssel unter dem Menüpunkt “Client Zertifikat Upload” hochladen.
Im unteren Bereich der Seite befindet sich die Zertifikatsübersicht:
Hier besteht auch die Möglichkeit, hochgeladene Zertifikate zu löschen.
Basiseinstellungen
Neben den allgemeinen Basiseinstellungen können Sie für den Telekom-Adapter folgende Einstellungen vornehmen:
Api Basis URL: Die Basis-URL zum Telekom-Portal, ohne abschließenden “/”.
API Benutzername: Ein gültiger Nutzername mit Zugriff auf das Telekom-Portal.
Api Passwort: Das entsprechende Passwort des Nutzers.
Zertifikat Passphrase: Die von der Telekom übermittelte Passphrase zum Zertifikat.
Telekom Kundennummer: Ihre Telekom Kundennummer.
Telekom Vertrags ID: Ihre Telekom Vertrags-ID.
Standard Ziel-Kategorien nicht befüllen: Wenn aktiviert, wird das hinterlegte Standard-Mapping ignoriert und nur die im folgenden Abschnitt zugewiesenen Werte befüllt.
Import Limit: Maximale Anzahl der Objekte, welche importiert werden.
Konfiguration des Mappings
Zum Bearbeiten der Konfiguration wechseln Sie bitte mit einem Klick auf den Knopf “Editieren” in den Bearbeitungsmodus.
Die Konfiguration des Objekttyp-Mappers und des Objekt-Matchings sind unter folgendem Link beschrieben: https://smdocu.atlassian.net/wiki/x/AQDli
Wert Mapping
Für den Telekom-Adapter ist es möglich, verfügbare Einträge für Telefontarif und Provider auf bereits bestehende Einträge in i-doit abzubilden. Dies hat den Vorteil, dass beispielsweise mehrere Einträge zu einem Provider - “D1” oder “Telekom” auf einen einzigen Provider-Namen in i-doit gemappt werden können.
Import
Neben dem automatischen, zeitgesteuerten Import haben Sie zusätzlich die Möglichkeit, einen Import manuell zu starten.
Mit einem Klick auf den Knopf “Import starten” werden die jeweiligen Daten nach i-doit importiert.
Welche Daten werden importiert?
Folgende Daten können grundsätzlich importiert werden:
Verträge
mit Laufzeiten
mit Tarifoptionen
SIM-Karten
mit Rufnummern
mit PIN / PUK
mit eSIM / klassische SIM / Multi-SIM
Verwendung von Vertragsdaten
Mit der Installation des Adapters wird ein neuer Objekktyp “Rahmenvertrag“ und eine neue Kategorie “Telekom Rahmenvertrag Metadaten” angelegt. Hier werden die entsprechenden Daten des ausgewählten Vertrages angezeigt.
Ebenfalls wird mit der Installation des Adapters eine neue Kategorie “Telekom Vertrag Metadaten” angelegt. Hier werden die entsprechenden Daten des ausgewählten Vertrages angezeigt.
Verwendung von SIM-Karten Daten
Mit der Installation des Adapters wird dem Objekttyp “Rahmenvertrag” die Kategorie “Karten” zugewiesen. In dieser Kategorie werden alle mit dem Vertrag verknüpften Karten aufgelistet.
Diese können dann einem Mobiltelefon zugewiesen werden.
In der Kategorie “SIM” finden Sie nach dem Import alle relevanten Laufzeitdaten des Vertrages.
