Was sich ändert

Der Endpunkt Get Costed BOM ist veraltet (deprecated):

GET /rfqs/{id}/costed-bom
GET /projects/{id}/costed-bom

(Beide liefern dieselben Daten – in Luminovo sind ein Projekt und eine RfQ dasselbe.)

Der Costed-BOM-Endpunkt wurde ursprünglich entwickelt, um den Excel-Export der bepreisten BOM von Luminovo in einem einzigen API-Aufruf eins zu eins abzubilden. Dadurch wurde die Antwort sehr groß, ihre Erzeugung bei größeren BOMs langsam und die zuverlässige Integration schwieriger.

Wir haben diesen alten Endpunkt durch eine Reihe kleinerer, fokussierter Endpunkte ersetzt. Jeder liefert einen einzelnen, klar definierten Teil des Gesamtbilds – Projekte, Sourcing-Szenarien, Einkaufsoptionen, Angebote und Komponentendaten – sodass Ihre Integration schneller, vorhersehbarer und einfacher zu warten ist.

Heute funktioniert noch alles wie gehabt. Der Costed-BOM-Endpunkt funktioniert weiterhin, und wir kündigen seine Entfernung rechtzeitig im Voraus an. Er erhält jedoch keine weiteren Verbesserungen. Wir empfehlen daher, Ihre Migration jetzt zu planen und jede neue Integration von Anfang an auf den neuen Endpunkten aufzubauen.

Die neuen Endpunkte

Alles, was der Costed-BOM-Endpunkt zusammengefasst hat, ist jetzt über die folgenden Endpunkte verfügbar.

Ab sofort verfügbar (Q2 2026)

Endpunkt	Methode & Pfad	`Accept`-Header
Get all projects	`GET /projects`	`application/api.luminovo.project-overview-v1+json`
Get a project	`GET /projects/{id}`	`application/api.luminovo.project-v1+json`
Get BOM tree	`GET /projects/{id}/tree`	`application/api.luminovo.assembly-ids-v1+json`
Get a sourcing scenario	`GET /sourcing-scenarios/{id}`	`application/api.luminovo.sourcing-scenario-v2+json`
Get purchase options	`GET /sourcing-scenarios/{id}/purchase-options`	`application/api.luminovo.sourcing-scenario-v1+json`
Get offers by part	`POST /offers/find`	`application/api.luminovo.offer-v1+json`
Get an offer	`GET /offers/{id}`	`application/api.luminovo.offer-v1+json`
Get component by IPN	`GET /components/ipn/{ipn}`	`application/api.luminovo.component-v1+json`
List components	`GET /components`	`application/api.luminovo.component-v1+json`
Get calculated assembly cost	`GET /calculations/assembly-costs`	`application/api.luminovo.assembly-cost-v1+json`

Verfügbar ab Anfang Q3 2026

Endpunkt	Was er Ihnen liefert
Get part	Vollständige Bauteilstammdaten für ein einzelnes Bauteil – Hersteller, MPN, Beschreibung, Spezifikationen, Compliance und Lebenszyklus.
Assembly cost breakdown	Eine zeilenweise Kostenaufschlüsselung einer Baugruppe.

💡 Die Kostensummen auf Baugruppenebene (Materialkosten, Fertigungskosten und zusätzliche Kosten sowie die Information, ob die Kalkulation eingefroren ist) sind bereits heute über Get calculated assembly cost verfügbar. Die detailliertere, zeilenweise Aufschlüsselung folgt Anfang Q3.

So werden die alten Daten den neuen Endpunkten zugeordnet

Der Costed-BOM-Endpunkt kombinierte vier Arten von Informationen. Hier sehen Sie, wo sich diese jetzt befinden:

In der Bepreisten BOM	Jetzt verfügbar über
BOM-Struktur – Projekte, Baugruppen, Designatoren, Mengen	Get all projects · Get a project · Get BOM tree
Bauteil- & Komponentendaten – IPN, MPN, Hersteller, Beschreibung, Compliance, Lebenszyklus	Get component by IPN · List components (+ Get part, Anfang Q3)
Sourcing & Preisgestaltung – Angebote, ausgewählte Einkaufsoptionen, Lieferant, Stückpreis, MOQ/MPQ, Verfügbarkeit	Get purchase options · Get offers by part · Get an offer
Kostenübersichten – Stück-/Gesamtkosten pro Baugruppe	Get calculated assembly cost (+ zeilenweise Aufschlüsselung, Anfang Q3)

Migration nach Anwendungsfall

1. Interne Bauteilnummern (IPNs) für Bauteile anlegen, die noch keine haben

Ziel: Für Bauteile, die in Ihrem ERP noch keine interne Bauteilnummer haben, legen Sie die IPN mithilfe der Bauteildaten von Luminovo an.

Rufen Sie Ihre Komponentenbibliothek aus Luminovo ab:
1. List components (GET /components) liefert eine paginierte Liste aller Komponenten in Ihrem Mandanten – blättern Sie durch, bis Sie alle gelesen haben.
2. Rufen Sie die Liste aller MPNs ab, die mit Ihren IPNs verknüpft sind.
Rufen Sie die Einkaufsoptionen für das Sourcing-Szenario ab (GET /sourcing-scenarios/{id}/purchase-options) und rufen Sie die zugehörigen Angebote ab (GET /offers/{id})
1. Extrahieren Sie die MPN und den Hersteller aus den Angebotsdaten
Vergleichen Sie die Daten aus 2(a) mit den Daten aus 1(b). Wenn die MPN zu keiner IPN gehört, verwenden Sie die MPN-Daten, um ein neues Bauteil in Ihrem ERP-System anzulegen.

2. Preise für Bauteile mit Luminovo-Daten aktualisieren

Ziel: Aktualisieren Sie die Preise in Ihrem ERP mit den aktuellen Angebotsdaten von Luminovo.

Sammeln Sie die Bauteil-IDs, für die Sie Preise abrufen möchten. Sie finden diese an Ihren Komponenten (aus List components oder Get component by IPN – die linked_parts enthalten ihre Bauteil-IDs).
Rufen Sie Get offers by part (POST /offers/find) mit den Bauteil-IDs auf:
```
{   "ids": ["<part-id-1>", "<part-id-2>"] }
```
Bauteil-IDs können IDs von Standardteilen, Zeichnungsteilen oder Komponenten (IPN) sein. Jede ID, die nicht aufgelöst werden kann, wird in not_found_ids zurückgegeben.
Die Antwort gruppiert die Angebote nach Bauteil. Jedes Angebot enthält den Lieferanten, die Verfügbarkeit und eine oder mehrere Preisstaffeln – jede Staffel hat einen unit_price wie { "amount": "0.0520", "currency": "EUR" } und die Menge, ab der er gilt, sowie MOQ/MPQ.
Wählen Sie den relevanten Preis aus und schreiben Sie ihn in Ihr ERP zurück.

💡 Möchten Sie nur die Preise, die Luminovo tatsächlich für ein Sourcing-Szenario ausgewählt hat (statt aller verfügbaren Marktangebote)? Verwenden Sie Get purchase options (nächster Abschnitt) – jedes ausgewählte Angebot enthält seinen Preis.

3. Bestellungen mithilfe von Einkaufsoptionen vorausfüllen

Ziel: Erstellen Sie Bestellungen in Ihrem ERP, vorausgefüllt aus den von Luminovo ausgewählten Einkaufsoptionen.

Get all projects (GET /projects) → das Projekt finden.
Get a project (GET /projects/{id}) → die Antwort listet die Sourcing-Szenarien des Projekts auf; nehmen Sie die gewünschte Sourcing-Szenario-ID. (Optional: Rufen Sie Get a sourcing scenario (GET /sourcing-scenarios/{id}) für dessen Bedarfe, Währung und Einstellungen auf.)
Get purchase options (GET /sourcing-scenarios/{id}/purchase-options) → die Liste der ausgewählten Angebote, bereit für die Erstellung von Bestellungen. Jeder Eintrag enthält:
- quantity – die Anzahl der zu bestellenden Angebotseinheiten
- unit_of_measurement – was eine Angebotseinheit darstellt (z. B. 1 Stück oder 5 m Kabel)
- purchase_quantity – die Gesamtmenge in Basiseinheiten (quantity × unit_of_measurement.value)
- Preisgestaltung
- die Sourcing-Positionen, die das Angebot erfüllt
- offer_id
(Optional) Verwenden Sie die offer_id mit Get an offer (GET /offers/{id}), um das vollständige Angebot abzurufen – Lieferant, alle Preisstaffeln und Verfügbarkeit.
Ordnen Sie jede Einkaufsoption einer Bestellposition in Ihrem ERP zu.

Die Antwort dieses Endpunkts ist speziell darauf ausgelegt, dass ERP-Systeme Bestellungen erstellen können.

Migration von der Costed BOM API zu den neuen Endpunkten von Luminovo