Zum Inhalt

BlueStar Supplier Connector

Der merchantCENTRAL Supplier BlueStar integriert den AutoID-/POS-Distributor BlueStar (EMEA) vollständig in Ihre merchantCENTRAL-Plattform. Der Connector verbindet Business Central über zwei Kanäle mit BlueStar:

  • BlueStar Customers API (OAuth2 gegen Microsoft Entra) für Bestellungen, Status/Tracking, Rechnungen inkl. PDF, Seriennummern und Preis-Sonderkonditionen (PE-Codes).
  • Datei-Import (Artikelkatalog, Netto-Preise, Lagerbestand — drei CSV-Dateien) über die zentrale merchantCENTRAL-Importpipeline.

Die API bietet keinen Katalog-Endpunkt — der Dateiimport bleibt die Sortimentsquelle, die API übernimmt die Bestellseite. Der Connector ist ein Add-on des merchantCENTRAL Hub: Importierte Stammdaten fließen in die zentrale Tabelle ALN MC Supplier Data, Sendungs-Tracking wird über den Hub an die ursprünglichen Verkaufsaufträge zurückgemeldet (Dropshipment-Brücke).

Funktionsübersicht

Feature Beschreibung
Katalog-, Preis- & Bestandsimport Drei getrennte CSV-Importe (BLUESTAR-CATALOG / -PRICE / -STOCK) in die Hub-Lieferantendaten
Bestellmanagement Kompletter Workflow: EK-Bestellung → API → Statusverfolgung → Wareneingang; Sende-Sperre, da die API keinen Storno-Endpunkt bietet
Verfügbarkeitsprüfung Bestand, Zulauf und Preisvergleich je Bestellzeile vor dem Absenden
Preis-Preflight Automatische Prüfung von Mindest-/Vielfachmengen (blockierend) und Preisabweichungen über 1 % (Rückfrage)
Preisausnahmen (PE-Codes) Täglicher Spiegel der Sonderkonditionen, PE-Code je Bestellzeile mit harter Validierung vor dem Senden
Rechnungsmanagement Automatischer Import inkl. PDF (als Beleganhang an der EK-Bestellung), Fälligkeit, MwSt und Brutto aus dem Versandavis
Seriennummern Automatische Zuweisung aus dem Versandavis (inkl. Dropshipment-Reservierungen auf dem Verkaufsauftrag)
Tracking-Brücke Rückmeldung aller Sendungsnummern an den Hub und den ursprünglichen Verkaufsauftrag
Belegnavigation Ein Klick zwischen gebuchten BC-Belegen und BlueStar-Vorgängen — in beide Richtungen, inkl. Original-PDFs
Historischer Import Nachträglicher Import bestehender BlueStar-Bestellungen aus offenen und gebuchten Einkaufsbelegen
Auto-Verarbeitung Job-Queue-Pipeline: Status-, Rechnungs- und PE-Sync plus optionale Belegautomatik (Termine, Wareneingang)
Simulationsmodus Testmodus ohne echte API-Bestellungen (Versand per E-Mail, Standard bei Neuinstallation)
Lizenz & Demo Tenant-/modulgebundene Lizenz mit kostenloser Demo (Modulcode BLUESTAR)

Erste Schritte

  1. Stellen Sie sicher, dass der merchantCENTRAL Hub installiert, eingerichtet und lizenziert ist.
  2. Installieren Sie den Supplier BlueStar Connector über AppSource.
  3. Fordern Sie Ihre API-Zugangsdaten bei BlueStar an: Client ID, Client Secret, OAuth Scope, API Key und Ihre Kundennummer.
  4. Richten Sie die Verbindung über den Setup-Wizard ein (siehe Einrichtung) — der API-Schritt ist überspringbar, solange die Zugangsdaten noch ausstehen.
  5. Testen Sie die Verbindung über Verbindung testen.
  6. Richten Sie den Datei-Import (Katalog, Preise, Bestand) ein.
  7. Konfigurieren Sie die automatische Verarbeitung nach Ihren Anforderungen.

Bestehende Bestellungen übernehmen

Wenn Sie bereits per E-Mail bei BlueStar bestellt haben, holt der historische Import diese Bestellungen samt Rechnungen und PDFs nachträglich in den Connector.

Seitenübersicht

Seite Beschreibung
Dashboard Zentraler Einstiegspunkt mit Kennzahlen, Monitor und Aktionen
Einrichtung (API) API-Verbindung, Bestellstandards, Automatisierung, Simulation
Import-Einrichtung Konfiguration der drei CSV-Importe
Bestellungen Bestellanlage, Statusverfolgung, historischer Import
Rechnungen Rechnungsimport mit PDF, Versandavis und Seriennummern
Preisausnahmen PE-Codes: Spiegel, Zeilenzuordnung und Validierung
Belegnavigation Sprünge zwischen BC-Belegen und BlueStar-Vorgängen
Automatische Verarbeitung Job Queue, Sync-Ablauf und Belegautomatik

Architektur

┌─────────────────────────────────────────────────────────┐
│                     BlueStar (EMEA)                      │
│                                                          │
│  Customers API (OAuth2)        Datei-Quelle (CSV)        │
│  ├── Bestellungen              ├── Katalog (CATALOG)     │
│  ├── Status / Tracking         ├── Preise  (PRICE)       │
│  ├── Rechnungen (PDF)          └── Bestand (STOCK)       │
│  ├── Versandavis (Seriennr.)                             │
│  └── Preisausnahmen (PE)                                 │
└────────────┬──────────────────────────┬─────────────────┘
             │ Bearer-Token + API-Key   │ OAuth2-Blob / SAS
┌────────────┴──────────────────────────┴─────────────────┐
│           merchantCENTRAL Supplier BlueStar               │
└────────────────────────┬─────────────────────────────────┘
                         │ Events
┌────────────────────────┴─────────────────────────────────┐
│                  merchantCENTRAL Hub                      │
│   (Supplier Data, Preis-Engine, Bestand, Tracking)        │
└───────────────────────────────────────────────────────────┘

Voraussetzungen

  • Microsoft Dynamics 365 Business Central (Cloud, Version 28.x oder neuer)
  • merchantCENTRAL Hub installiert, eingerichtet und lizenziert
  • BlueStar-Kundenvertrag mit API-Zugang (Client ID, Client Secret, OAuth Scope, API Key) und Kundennummer — die Freischaltung erfolgt über Ihren BlueStar-Ansprechpartner
  • Für den Datei-Import: eine Bezugsquelle (Azure Blob Storage o. Ä.) — siehe Import-Einrichtung

Hilfe & Support