prohibis
Diese Dokumentation beschreibt die Einrichtung und Nutzung der Profi-App in prohibis.
Zugriffsberechtigung Profi-App
Damit die Profi-App mit dem prohibis System kommunizieren kann, ist im Vorfeld eine Zugriffsberechtigung zu erteilen. Diese erfolgt durch die Anlage eines API-Keys zur Authentifizierung. Dem API-Key wird im Anschluss ein Service zur Autorisierung hinterlegt.
Authentifizierung (API-Key)
Über die Zugangsverwaltung in prohibis ist die API-Key Verwaltung aufzurufen.
Dort ist über die Neuanlage ein neuer API-Key zu erzeugen. Für diesen APi-Key sind folgende Informationen zu füllen:
Freigegeben Das Toggle ist zu setzen, sodass der API-Key direkt ohne Freigabeprozess genutzt werden kann.
Beschreibung Ein sprechender Name für den API-Key, welcher den Zweck der Nutzung eindeutig widerspiegelt.
Gesellschafter Die Gesellschafternummer des Standortes, für welchen der API-Key verwendet werden soll.
Standort Der Standort, für welchen der API-Key verwendet werden soll.
Aktiv Das Toggle ist zu setzen, sodass der API-Key gültig ist und genutzt werden kann.
Im Anschluss ist der Datensatz zu speichern und ein neuer API-Key wurde angelegt.
Ein angelegter API-Key hat zunächst keinerlei Rechte. Jeder Client, der mit dem API-Key versucht zu kommunizieren, erhält eine HTTP-Response mit dem Status 401 (unauthorized). Für die Rechtevergabe ist in der API-Key Verwaltung unter dem Menüpunkt Funktion das Menü "Services zum API Key" aufzurufen.
Je nachdem, welcher Zweck der API-Key erfüllen soll, ist der entsprechende Service über die F12 Funktion auszusuchen.
Für Funktionen rund um Artikel wie z.B. Bestandsabfragen, Preisabfragen, Statistikdaten und Artikellisten ist der Service MDE-Artikel auszuwählen. Das Toggle aktiv ist zu setzen, sodass der Service für den API-Key freigegeben ist. Für die Profi-App ist der Service MDE-Artikel zwingend auszuwählen!
Mit dieser Einstellung kann der API-Key für die Abfrage und Anlage von artikelbezogenen Daten verwendet werden. Der erzeugte API-Key ist dem Client bzw. dem anfragenden System (in diesem Fall die Profi-App) mitzuteilen.
GLN zur Kommunikation identifizieren
Neben dem API-Key benötigt die Profi-App eine GLN zur Kommunikation mit dem prohibis System. Die GLN kann in prohibis folgendermaßen identifiziert werden:
In den DFÜ-Verbindungen ist die "GLN zu wem" mit der Nummer 4333990000009 zu identifizieren. Die dort hinterlegte "eigene GLN" wird zur Kommunikation zwischen Profi-App und prohibis verwendet. Diese GLN ist neben dem API-Key mitzuteilen.
Profi-App Bestellungen sichten und verarbeiten
Erzeugte Profi-App Bestellungen können in prohibis unter folgenden Pfad eingesehen werden:
In dem Feld Fremdbeleg ist die Bestellnummer aus der Profi-App einsehbar. Über die Toolbar kann eine Verarbeitung der Artikelliste angestoßen werden. Es erfolgt die Anlage eines Beleges vom Typ Vorgang.
Sollten Sie Probleme bei der Einrichtung haben, wenden Sie sich bitte an den zentralen IT Service Desk. Diesen erreichen Sie Montag bis Freitag von 6 bis 19 Uhr und Samstag von 8 bis 14 Uhr unter der folgenden Telefonummer: +49 5191 802-222
Last updated