Einrichtung (Customers API)
Die API-Einrichtung des BlueStar-Connectors lebt als Abschnitt BlueStar API Setup auf der Lieferant-Karte des Hubs — zusammen mit den drei Import-Definitionen. Für die geführte Ersteinrichtung gibt es den Setup-Wizard (Aktion auf der Lieferant-Karte oder über die Unterstützte Einrichtung).
Seite öffnen
- Hub-Lieferantenübersicht → Lieferant BLUESTAR → Abschnitt BlueStar API Setup
- Unterstützte Einrichtung: AD merchantCENTRAL - Einrichtung → BlueStar
Reihenfolge: Hub zuerst
Der Setup-Wizard prüft beim Öffnen, ob der merchantCENTRAL Hub eingerichtet ist, und führt andernfalls zuerst dorthin.
Setup-Wizard
Der Wizard führt in sieben Schritten durch die komplette Einrichtung:
- Willkommen
- Datei-Quellen — Quelltyp und die drei Blob-URLs (Katalog, Preise, Bestand)
- Authentifizierung der Datei-Quelle (zentrale OAuth2-Blob-Konfiguration oder Function Key)
- Verbindungstest der Datei-Importe
- API-Zugangsdaten — Kundennummer, OAuth Scope, Test-Endpunkt, Client ID, Client Secret, API Key. Dieser Schritt ist überspringbar, solange die Zugangsdaten von BlueStar noch ausstehen — halbe Eingaben blockt der Wizard.
- API-Verbindungstest
- Abschluss — aktiviert auf Wunsch die Import-Definitionen
Felder des API-Setups
Verbindung
| Feld | Beschreibung |
|---|---|
| Kundennr. | Ihre BlueStar-Kundennummer. Sie wird mit jedem API-Aufruf als customerNo und sellToCustomerNo gesendet. |
| Test-Endpunkt verwenden | Schaltet auf die BlueStar-Staging-API um (empfohlen für die Erstinbetriebnahme). |
| Basis-URL Live / Test | Die API-Endpunkte (vorbelegt, i. d. R. nicht zu ändern). |
| OAuth Scope | Der von BlueStar mitgeteilte OAuth2-Scope. |
| Token-URL | Der Microsoft-Entra-Token-Endpunkt (vorbelegt). |
Authentifizierung
Client ID, Client Secret und API Key werden über den abgesicherten Secret-Eingabedialog hinterlegt (Klick auf das jeweilige Statusfeld) und im zentralen merchantCENTRAL-Credential-Store verschlüsselt gespeichert — nie in Tabellenfeldern. Die Felder zeigen nur, ob ein Wert hinterlegt ist.
| Feld | Beschreibung |
|---|---|
| Client ID / Client Secret | OAuth2-Zugangsdaten für den Token-Abruf. |
| API Key | Der kundenbezogene API-Schlüssel (GUID), den BlueStar zusätzlich zum Token in jedem Aufruf verlangt. |
| Token-Status / Token gültig bis | Zustand des zwischengespeicherten Zugriffstokens (verwaltet der Connector selbst). |
Bestellstandards
| Feld | Beschreibung |
|---|---|
| Bestell-Kontakt-E-Mail / Telefonnr. | Pflichtangaben der API — sie werden mit jeder Bestellung übertragen. |
| Standard VAS-Bestellung | Vorgabe für das vasOrder-Kennzeichen (Value Added Services). |
Automatisierung
| Feld | Beschreibung |
|---|---|
| Auto-Sync aktivieren | Schaltet die regelmäßige Synchronisierung (Status, Rechnungen, PE-Codes) über die Job Queue ein. |
| Sync-Intervall (Minuten) | Abstand zwischen zwei Läufen (Standard 60). |
| Letzter Sync / Job-Queue-Status | Diagnose-Anzeigen. |
Einkaufsbestellung
Diese vier Schalter steuern, was der Sync aus den gemeldeten BlueStar-Daten automatisch in Ihre Belege schreibt — Details unter Automatische Verarbeitung:
| Feld | Wirkung |
|---|---|
| EK-Bestellung autom. aktualisieren | Schreibt BlueStar-Bestellnummer und -Rechnungsnummer in die Kreditorenfelder der Bestellung sowie die gemeldeten Liefertermine als Zugesagtes Wareneingangsdatum auf die offenen Zeilen. |
| Seriennummern autom. zuweisen | Übernimmt Seriennummern aus dem Versandavis als Artikelverfolgung (inkl. Dropshipment-Spiegel). |
| Wareneingang autom. buchen | Bucht den Wareneingang, sobald die Bestellung vollständig als geliefert gemeldet ist. |
| VK-Warenausg.-Datum autom. akt. | Spiegelt die gemeldeten Liefertermine als Geplantes Warenausgangsdatum auf die Verkaufszeilen (Streckengeschäft). |
Simulation
| Feld | Beschreibung |
|---|---|
| Simulationsmodus | Standardmäßig aktiv: Bestellungen werden nicht an BlueStar übertragen, sondern als E-Mail (inkl. des JSON-Requests) an die Benachrichtigungsadresse gesendet. Erst nach erfolgreichem Test im Staging deaktivieren. |
| Benachrichtigungs-E-Mail | Empfänger für Simulations- und Prozess-E-Mails (mehrere Adressen möglich). |
| Prozessbenachrichtigung senden | Sammel-E-Mail nach jedem Auto-Sync-Lauf mit Synchronisierungen und Fehlern. |
Erweitert
| Feld | Beschreibung |
|---|---|
| Artikelpreis-Batchgröße | Wie viele Artikelnummern je customeritemprice-Anfrage gesendet werden (Standard 100). Nur senken, wenn die API große Anfragen ablehnt. |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Zugriffstoken abrufen | Holt manuell ein frisches OAuth2-Token (Diagnose). |
| Verbindung testen | Ruft die Preisausnahmen ab und meldet die Anzahl — der schnellste Ende-zu-Ende-Test. |
| Job-Queue-Eintrag erstellen | Legt den Auto-Sync-Job an bzw. aktualisiert Intervall und Status. |
| Trennen & Zugangsdaten löschen | Entfernt alle gespeicherten Secrets (Client ID, Secret, API Key, Token) aus dem Credential Store. |
Kein Storno über die API
Die BlueStar Customers API bietet keinen Storno- oder Änderungs-Endpunkt. Eine übertragene Bestellung kann nur telefonisch oder per E-Mail bei BlueStar geändert werden — der Connector verhindert deshalb doppeltes Senden derselben Bestellung.