BlueStar Orders
The order list (BlueStar Orders) shows all orders that were transmitted to BlueStar, simulated, or subsequently imported through the connector. The order card shows the status lines of each order, with tracking, invoice numbers, and license data.
Opening the Page
- Via search: BlueStar Orders
- Via the Dashboard → Orders
Creating Orders
From the Purchase Order
If the vendor of the order matches the configured BlueStar vendor, the Purchase Order shows the BlueStar group in the ribbon:
| Action | Description |
|---|---|
| Check BlueStar Availability | Checks stock, incoming quantities, and price at BlueStar per line and shows an overview report — purely informational. |
| Create BlueStar Order | Transmits the order to BlueStar (or simulates it in simulation mode). With a safety prompt, since the API offers no cancellation endpoint. |
| View BlueStar Order | Opens the linked BlueStar order. |
| Refresh BlueStar Status | Refreshes status and tracking of the linked order. |
| Link Existing BlueStar Order | Searches BlueStar for an order with this document number (e.g. ordered by email in the past) and imports it, including invoices. |
In addition, the BlueStar Tracking FactBox on the Purchase Order shows the tracking numbers per line — one line per parcel for split shipments.
Preflight before submission
Before transmission, the connector checks every line against the current BlueStar data:
- Minimum and multiple quantities — violations block the transmission (the API would reject them anyway).
- Price deviations above 1 % — collected and shown as a prompt.
- PE codes — assigned price exceptions are hard-validated (see Price Exceptions).
Prerequisites: Vendor = BlueStar vendor, at least one item line with quantity > 0, and each item has a BlueStar item number (from the supplier data, the item vendor catalog, or the line).
Automatically (Drop Shipment)
When the merchantCENTRAL Hub transmits a Purchase Order to the supplier (e.g. out of a Sales Order), the connector creates the BlueStar order automatically — the ship-to address then comes from the Sales Order.
Resend lock: no cancellation via the API
The Customers API offers no cancellation or change endpoint. A transmitted order can only be changed by phone or email with BlueStar. The connector therefore refuses to transmit the same Purchase Order a second time — the historical import and the link action activate this lock as well.
Status Model
The status is reported by BlueStar per line and aggregated into the header status (the least advanced line status determines the header):
| Status | Meaning |
|---|---|
| Pending | Transmitted, no status response yet. |
| Open | Created at BlueStar, not yet shipped. |
| Partially Shipped | At least one line shipped, at least one still open. |
| Shipped | All lines shipped. |
| Invoiced | All lines invoiced. |
| Canceled | Canceled by BlueStar. |
| Unknown | BlueStar reports a status the connector does not know — the original text remains visible on the line, nothing is lost. |
Fields of the List
| Field | Description |
|---|---|
| Purchase Order No. | Linked BC Purchase Order. |
| BlueStar Order No. | The order number assigned by BlueStar. |
| Status | Aggregated order status. |
| Simulation | Marks orders that were only simulated and never transmitted. |
| Order Date/Time | Time of the transmission or simulation. |
| Last Status Sync / Last Sync Error | Diagnostics of the automatic synchronization; errors appear in red. |
On the order card, the lines show per position: item number (SKU), quantity, price, line status with original text, the posted BlueStar invoice number (a click opens the invoice), planned delivery date, shipment date, carrier, tracking number and link, and — for license products — end user and license period.
Actions
Processing
| Action | Description |
|---|---|
| Refresh Status | Refreshes the selected order from the API. |
| Process All Orders | Refreshes all open orders incl. invoice import and document automation — with progress display. |
| Import Historical Orders | Imports legacy orders from existing purchase documents — see below. |
Navigation
| Action | Description |
|---|---|
| Purchase Order | Opens the linked Purchase Order. |
| Sales Order | Opens the Sales Order (drop shipment). |
| Posted Purchase Invoices | Shows all posted invoices for this order. |
| Posted Purchase Receipts | Shows all posted receipts for this order. |
How the link works technically and why actions can be dimmed is described under Document Navigation.
Importing Historical Orders
Orders placed by email or phone before the connector was introduced can be taken over retroactively. The run checks all open purchase documents and all posted purchase invoices of the BlueStar vendor against the API — using two keys in descending reliability:
- the document number of the Purchase Order (BlueStar stores it as the external document number),
- the Vendor Invoice No. of the posted invoice (resolved to the order through the invoice query).
Found orders are imported including lines, tracking, and invoices with their PDFs. The result shows separate counters (imported / already existing / without reference / not found / errors) and, on request, a detailed log per document.
Catching up a single order
For a single document, the Link Existing BlueStar Order action directly on the Purchase Order is the quicker way.