Setup (Customers API)
The API setup of the BlueStar connector lives as the BlueStar API Setup section on the Hub's Supplier Card — together with the three import definitions. For the guided initial setup there is the Setup Wizard (action on the Supplier Card or via the Assisted Setup).
Opening the Page
- Hub Supplier List → supplier BLUESTAR → section BlueStar API Setup
- Assisted Setup: AD merchantCENTRAL - Setup → BlueStar
Order: Hub first
When opened, the Setup Wizard checks whether the merchantCENTRAL Hub is configured and otherwise leads there first.
Setup Wizard
The wizard guides you through the complete setup in seven steps:
- Welcome
- File sources — source type and the three blob URLs (catalog, prices, stock)
- Authentication of the file source (central OAuth2 blob configuration or Function Key)
- Connection test of the file imports
- API credentials — customer number, OAuth Scope, test endpoint, Client ID, Client Secret, API Key. This step can be skipped while the credentials from BlueStar are still pending — the wizard blocks half-entered data.
- API connection test
- Finish — optionally activates the import definitions
Fields of the API Setup
Connection
| Field | Description |
|---|---|
| Customer No. | Your BlueStar customer number. It is sent with every API call as customerNo and sellToCustomerNo. |
| Use Test Endpoint | Switches to the BlueStar staging API (recommended for initial commissioning). |
| Base URL Live / Test | The API endpoints (pre-filled, usually not to be changed). |
| OAuth Scope | The OAuth2 scope provided by BlueStar. |
| Token URL | The Microsoft Entra token endpoint (pre-filled). |
Authentication
Client ID, Client Secret, and API Key are entered via the secured secret input dialog (click the respective status field) and stored encrypted in the central merchantCENTRAL Credential Store — never in table fields. The fields only show whether a value is stored.
| Field | Description |
|---|---|
| Client ID / Client Secret | OAuth2 credentials for the token request. |
| API Key | The customer-specific API key (GUID) that BlueStar requires in every call in addition to the token. |
| Token Status / Token Expires At | State of the cached access token (managed by the connector itself). |
Order Defaults
| Field | Description |
|---|---|
| Order Contact E-Mail / Phone No. | Mandatory API data — transmitted with every order. |
| Default VAS Order | Default for the vasOrder flag (Value Added Services). |
Automation
| Field | Description |
|---|---|
| Enable Auto Sync | Turns on the regular synchronization (status, invoices, PE codes) via the Job Queue. |
| Sync Interval (Minutes) | Time between two runs (default 60). |
| Last Sync / Job Queue Status | Diagnostic displays. |
Purchase Order
These four switches control what the sync automatically writes into your documents from the reported BlueStar data — details under Automatic Processing:
| Field | Effect |
|---|---|
| Auto Update Purchase Order | Writes the BlueStar order number and invoice number into the vendor fields of the Purchase Order, and the reported delivery dates as Promised Receipt Date onto the open lines. |
| Auto Assign Serial Numbers | Takes over serial numbers from the Despatch Advice as Item Tracking (incl. drop shipment mirror). |
| Auto Post Receipt | Posts the Receipt as soon as the order is reported as fully shipped. |
| Auto Update Sales Shipment Date | Mirrors the reported delivery dates as Planned Shipment Date onto the sales lines (drop shipment). |
Simulation
| Field | Description |
|---|---|
| Simulation Mode | Enabled by default: orders are not transmitted to BlueStar but sent as an email (incl. the JSON request) to the notification address. Only disable it after a successful test on staging. |
| Notification Email | Recipient of simulation and process emails (multiple addresses possible). |
| Send Process Notification | Summary email after every auto-sync run, listing synchronizations and errors. |
Advanced
| Field | Description |
|---|---|
| Item Price Batch Size | How many item numbers are sent per customeritemprice request (default 100). Only lower this if the API rejects large requests. |
Actions
| Action | Description |
|---|---|
| Get Access Token | Manually fetches a fresh OAuth2 token (diagnostics). |
| Test Connection | Retrieves the price exceptions and reports the count — the fastest end-to-end test. |
| Create/Update Job Queue | Creates the auto-sync job or updates its interval and status. |
| Disconnect & Delete Credentials | Removes all stored secrets (Client ID, Secret, API Key, token) from the Credential Store. |
No cancellation via the API
The BlueStar Customers API offers no cancellation or change endpoint. A transmitted order can only be changed by phone or email with BlueStar — the connector therefore prevents sending the same order twice.