[INFORMATION] Änderungen API Sendungsverfolgung Geschäftskunden - Changes API shipment tracking for business customers
Liebe Kund:innen und Entwickler:innen,
wir möchten Sie über Neuerungen zur Nutzung der API Sendungsverfolgung Geschäftskunden (GK) informieren, die ab heute, 13.06.2024 gelten.
Wer ist betroffen?
Alle Kund:innen, die die API Sendungsverfolgung GK verwenden (DASS-B Nutzer).
Was ändert sich?
Die Authentifizierung für die Nutzung der API Sendungsverfolgung GK erfolgt nun über das Post & DHL Geschäftskundenportal (GKP). Bisher verwendete Zugangsdaten zur Nutzung der API Sendungsverfolgung GK wurden in einen „Übergangsbenutzer API Sendungsverfolgung“ migriert. Alle bisherigen Berechtigungen sind weiterhin vorhanden.
Was ist der Übergangsbenutzer?
Der Übergangsbenutzer stellt sicher, dass bisher genutzte Zugangsdaten für max. ein Jahr weiter verwendet werden können.
Was müssen Sie veranlassen?
- Es besteht kein akuter Handlungsbedarf auf Ihrer Seite. Für alle zwischen Januar und Juni 2024 aktiven Nutzer der API Sendungsverfolgung GK wurde durch Einrichten des Übergangsbenutzers sichergestellt, dass die API bis auf Weiteres mit den aktuell verwendeten Zugangsdaten genutzt werden kann.
- Bis spätestens Ende Mai 2025 müssen Sie den Übergangsbenutzers (alte zt-Kennung) durch einen GKP Benutzer austauschen. Wir empfehlen hierfür die Einrichtung eines GKP Benutzers mit dem Typ “Systembenutzer” zur Nutzung ausschließlich in technischen Schnittstellen. Der neue GKP Benutzer muss die Berechtigung für die Funktion „Verfolgen Paket & Waren“ erhalten.
Was können Sie tun, wenn der Zugang zur API Sendungsverfolgung nicht funktioniert?
Im Einzelfall kann es z. B. aufgrund veralteter Daten (abgelaufene Nummernkreis o. ä.) vorkommen, dass kein Übergangsbenutzer angelegt werden konnte. In diesem Fall müssen Sie aktiv einen Benutzer im GKP mit den erforderlichen Berechtigungen anlegen und die Zugangsdaten für die Nutzung in allen API-Aufrufen hinterlegen.
Können die Berechtigungen des Übergangsbenutzers verändert werden?
Es kann vorkommen, dass einzelne Berechtigungen nicht aus dem Altsystem migriert wurden und Ihnen dadurch nur noch öffentliche Sendungsdaten (keine datenschutzrelevanten Daten) angezeigt werden.
Für diesen Fall und auch bei allen sonstigen Fällen fehlender Berechtigungen gilt, dass Sie aktiv einen neuen Benutzer im GKP anlegen müssen. Die GKP Zugangsdaten des neuen Benutzers müssen in allen Aufrufen der API Sendungsverfolgung GK mitgegeben werden.
Kann ich das Passwort für den Übergangsbenutzer ändern?
Für den Übergangsbenutzer ist kein Passwort-Rücksetzung möglich. In diesem Fall muss direkt ein neuer GKP Benutzer angelegt werden. Der Übergangsbenutzer kann ab diesem Zeitpunkt nicht weiter verwendet werden.
Bei Fragen zu Berechtigungen wenden Sie sich bitte an Ihre vertriebliche Ansprechperson.
Bei technischen Fragen erstellen Sie bitte ein Ticket im Group API Developer Portal.
Mit freundlichen Grüßen
Ihr Team Group API Developer Portal
-----
Dear customers and developers,
we would like to inform you about changes to the use of the API Shipment Tracking Business Customers (BC), which apply from today, June 13, 2024.
Who is affected?
All customers who use the API Shipment Tracking BC (DASS-B users).
What is changing?
Authentication for the use of the API Shipment Tracking BC is now carried out via the Post & DHL Business Customer Portal (GKP). Previously used access data for using the API Shipment Tracking BC has been migrated to a “Transition user API Shipment Tracking”. All previous authorizations are still available.
What is the transition user?
The transition user ensures that previously used access data still can be used for a maximum of one year.
What do you need to do?
There is no acute need for action on your part. For all users of the API Shipment Tracking BC active between January and June 2024, setting up the transition user ensures that the API can be used with the currently used access data until further notice.
However, you must replace the transitional user (old zt user) with a GKP user by the end of May 2025 at the latest. We recommend setting up a GKP user with the type “system user” for use exclusively in technical interfaces. The new GKP user must have authorization for the “Track Parcels & Goods” function.
What can you do if access to the API Shipment Tracking does not work?
In individual cases, it may not be possible to create a transition user, e.g. due to outdated data (expired number range or similar). In this case, you must actively create a user in the GKP with the required authorizations and store the access data for use in all API calls.
Can the transition user's authorizations be changed?
It is possible that individual authorizations have not been migrated from the old system and therefore only public shipment data (not data relevant to data protection) is displayed.
In this case and in all other cases of missing authorizations, you must actively create a new user in GKP. The GKP access data of the new user must be entered in all calls to the API Shipment Tracking BC.
Can I change the password for the transition user?
It is not possible to reset the password for the transition user. In this case, a new GKP user must be created directly. The transition user can no longer be used from this point onwards.
If you have any questions about authorizations, please get in touch with your sales contact person.
If you have any technical questions, please create a ticket in the Group API Developer Portal.
Yours sincerely
Your team Group API Developer Portal
