Die Preise und die Verfügbarkeit in Ihrem ERP von Hand zu aktualisieren, ist langsam

Wenn ein Projekt in Luminovo kalkuliert und anschließend bestätigt wird, muss jemand die Zahlen in der Regel von Hand ins ERP übertragen – jedes Sourcing-Szenario öffnen, das ausgewählte Angebot pro Position ablesen und Stückpreis, Preisstaffeln, Lieferzeit, Bestand und Lieferantendaten in den Materialstamm und die Einkaufsdatensätze abtippen. Das ist langsam, fehleranfällig, und bis es erledigt ist, können die Preise bereits veraltet sein.

Während dieses gesamten Ablaufs bleibt das ERP das führende System: Die Bestellung wird im ERP erstellt und ausgeführt, nicht in Luminovo. Die Aufgabe von Luminovo ist es, die bepreisten Sourcing-Daten bereitzuhalten und sie auf Anfrage zurückzugeben, damit das ERP seine Preise und Verfügbarkeit aktualisieren und die Bestellung selbst auslösen kann.

Dieser Leitfaden behandelt das folgende Szenario:

Preise, Verfügbarkeit und Lieferantendaten ins ERP synchronisieren, wenn ein Projekt bestätigt wird.

In diesem Dokument geht es darum, diese Synchronisation zu automatisieren. Alles Folgende lässt sich bereits manuell in der Luminovo-Oberfläche erledigen – Nutzer*innen können das Sourcing-Szenario öffnen, die ausgewählten Angebote ablesen und die Preise, Lieferzeiten und Lieferantendaten Position für Position ins ERP eintippen. Der Punkt hier ist der automatisierte Weg: dieser Datenaustausch direkt zwischen dem ERP und Luminovo über die API, sodass ein bestätigtes Projekt das ERP ohne erneutes Abtippen aktualisiert.

Erforderliches API-Paket: Full API. Dieser Anwendungsfall ruft Endpunkte auf (purchase options, offers), die nicht Teil des Standard-Pakets sind. Falls Sie nicht sicher sind, welches API-Paket Ihr Account hat, stimmen Sie sich mit Ihrem CSM ab.

So funktioniert der Datenaustausch

Der gesamte Austausch läuft über die öffentliche API von Luminovo und erfolgt ausschließlich auf Anfrage. Es gibt immer einen Initiator – Ihr ERP oder eine davor geschaltete Middleware –, der den Aufruf ausführt.

Luminovo schiebt niemals aktiv Daten in Ihr ERP. Es hält die bepreisten Sourcing-Daten bereit und gibt sie zurück, wann immer das ERP danach fragt.

Wenn ein Projekt also bestätigt wird, sendet das ERP eine Anfrage – ein GET für die purchase options, dann ein POST, um die Angebote per ID nachzuschlagen – und Luminovo antwortet mit den ausgewählten Angeboten, ihren Preisen, ihrer Verfügbarkeit und den Lieferantendetails. Das ERP entscheidet, was geschrieben wird, wann es geschrieben wird und ob daraufhin eine Bestellung ausgelöst wird.

Szenario – Preise und Verfügbarkeit synchronisieren, wenn ein Projekt bestätigt wird

Workflow

Eine BOM wird in ein Projekt (eine RfQ) in Luminovo importiert – typischerweise, wenn ein Kunde ein Kundenangebot anfragt.
Die Nutzer*innen bearbeiten die BOM, führen das Sourcing durch und erstellen das Kundenangebot. Die Sourcing-Engine von Luminovo wählt für jede Position im Sourcing-Szenario ein Angebot aus.
Das Projekt wird bestätigt. Das ist der Auslöser: Das ERP (oder die Middleware) ruft Luminovo auf, um die aktuellen Preise und die Verfügbarkeit für das bestätigte Sourcing-Szenario abzurufen.
Das ERP liest die ausgewählten purchase options für das Szenario und schlägt dann für jede zurückgegebene offer_id das vollständige Angebotsdetail nach.
Das ERP schreibt die Preise, die Verfügbarkeit, die Lieferzeiten und die Lieferantendaten zurück in seine eigenen Datensätze – aktualisiert den Materialstamm und die Infosätze und erstellt bei Bedarf Bestellungen.

Aktualität. Purchase options spiegeln den Zeitpunkt wider, zu dem das Sourcing zuletzt ausgeführt wurde. Wenn seit dem Kundenangebot Zeit vergangen ist, führen Sie die Angebotsaktualisierung mit POST /offers/refresh und die Auswahl mit POST /sourcing-scenarios/run-selection vor dem Lesen erneut aus, damit die ausgewählten Angebote aktuell sind.

Endpunkte

In dieser Reihenfolge aufgerufen. Der optionale Aktualitäts-Aufruf kommt zuerst, danach die beiden Leseaufrufe.

(Optional)

Verwenden Sie POST /offers/refresh, um zunächst die aktuellen Lieferantenangebote neu abzurufen.
POST /sourcing-scenarios/run-selection – führen Sie die Sourcing-Auswahl erneut aus, damit die ausgewählten Angebote aktuell sind, bevor Sie sie lesen.

Senden Sie eine von zwei Anfrageformen. Alle Szenarien müssen zum selben Projekt gehören.

GET /sourcing-scenarios/{id}/purchase-options – die ausgewählten Angebote und Bestellmengen für das Sourcing-Szenario.

Diese Antwort ist darauf ausgelegt, dass ERP-Systeme Bestellungen erstellen. Der Pfadparameter id ist die UUID des Sourcing-Szenarios (aus dem Projekt/der RfQ, auf dem bzw. der das Kundenangebot aufgebaut wurde). Die Antwort ist ein purchase_options-Array mit einem Eintrag pro ausgewähltem Angebot.


Feld	Bedeutung – warum der Aufrufer es benötigt
`purchase_options.offer_id`	Das ausgewählte Angebot. Verwenden Sie es mit `POST /offers/bulk` oder `GET /offers/{id}`, um die vollständigen Lieferanten-, Preis- und Verfügbarkeitsdetails abzurufen.
`purchase_options.quantity`	Anzahl der zu bestellenden Angebotseinheiten.
`purchase_options.unit_of_measurement`	Was eine Angebotseinheit darstellt (z. B. 1 Stück oder 5 Meter Kabel).
`purchase_options.purchase_quantity`	Gesamtbestellmenge in Basiseinheiten – berechnet als `quantity` × `unit_of_measurement.value`.
`purchase_options.minimum_order_quantity`	MOQ aus der ausgewählten Preisstaffel, in Angebotseinheiten.
`purchase_options.minimum_packaging_quantity`	MPQ (Bestellvielfaches) aus der ausgewählten Preisstaffel, in Angebotseinheiten – Bestellungen müssen ein Vielfaches davon sein.
`purchase_options.unit_price`	Preis pro Angebotseinheit – `amount` + `currency`, in der Originalwährung des Angebots (keine Umrechnung angewendet).

POST /offers/bulk – vollständige Details für viele Angebote in einer Anfrage, nachgeschlagen anhand ihrer IDs.

Übergeben Sie die offer_id-Werte aus den purchase options. Für ein einzelnes Angebot verwenden Sie stattdessen GET /offers/{id}. Die Antwort ist ein items-Array (jedes Angebot ist ein StandardPart oder ein CustomPart) plus ein not_found_ids-Array.


Feld	Bedeutung – warum der Aufrufer es benötigt
`ids` (request)	Das Array der nachzuschlagenden Angebots-IDs (die `offer_id`-Werte aus den purchase options).
`id`	Der undurchsichtige Identifier des Angebots – entspricht der angefragten `offer_id`.
`linked_part`	Der Part, für den das Angebot gilt: `mpn` + `manufacturer.name` für Katalogware oder `ipn` (+ `revision`) für eine interne Teilenummer. Nutzen Sie ihn, um das Angebot Ihrem ERP-Material zuzuordnen.
`linked_location`	Wo gekauft wird: ein `Supplier` (`name`, plus `number` = Ihre ERP-Lieferantennummer, falls gepflegt, und `stock_location`) oder ein `InventorySite`.
`supplier_part_number`	Die eigene Teilenummer des Lieferanten (SPN / Lieferantenteilenummer).
`offer_number`	Die Kundenangebots-/Angebotsreferenz des Lieferanten, zum Abgleich mit dessen Datensätzen.
`price_type`	Die Art der Bepreisung, die dieses Angebot darstellt (z. B. Listen-, Vertrags-, Angebots- oder kundenverhandelter Preis).
`price_breaks`	Mengenstaffeln: `minimum_order_quantity` (MOQ), `minimum_packaging_quantity` (MPQ) und `unit_price` (`amount` + `currency`, Originalwährung). Staffeln für Custom Parts tragen zusätzlich pro Staffel eine `lead_time` und eine `description`.
`one_time_costs`	Einmalige Kosten.
`packaging`	Wie der Part geliefert wird (Reel, Tape, Tray, Tube, …).
`availability`	`stock` auf Lager, `factory_lead_time` und `factory_quantity`.
`valid_from` / `valid_until`	Das Gültigkeitsfenster des Angebots – beachten Sie es vor der Bestellung.
`cancellation_policy`	`cancellation_window` und das Flag `is_non_cancellable_non_returnable` (NCNR).
`notes`	Freitextnotizen (z. B. „EOL angekündigt – nur Last-Time-Buy").
`creation_date`	Wann das Angebot in Luminovo erstellt wurde.
`kind`	`StandardPart` oder `CustomPart`.
`not_found_ids` (response)	Angebots-IDs, die nicht aufgelöst werden konnten – explizit zurückgegeben statt verworfen, damit Sie sie abgleichen können.

Zu berücksichtigendes Verhalten:

Preise sind immer in der Originalwährung des Angebots – es wird keine Umrechnung angewendet. Rechnen Sie ERP-seitig um, wenn Sie eine einheitliche Berichtswährung benötigen.
Angebots-IDs sind undurchsichtige, durch Doppelpunkte getrennte Zeichenketten (z. B. PublicOffTheShelf:550e8400-…). Behandeln Sie sie als undurchsichtig; parsen Sie sie nicht.
Die Reihenfolge der price_breaks ist nicht garantiert – sortieren Sie nach minimum_order_quantity, wenn die Reihenfolge wichtig ist.

Was das ERP zurückschreibt – und woher es kommt


Zielfeld im ERP	Quelle in der Luminovo-API	Hinweise
Material / Part	`purchase-options.offer_id` → Angebot `linked_part` (`mpn` + `manufacturer.name`, oder `ipn` + `revision`)	Ordnen Sie es Ihrem ERP-Material über IPN oder MPN zu.
Kreditor / Lieferant	Angebot `linked_location` → `Supplier.name` und `Supplier.number`	`number` ist Ihre eigene ERP-Lieferantennummer, sofern sie in Luminovo gepflegt ist.
Lieferanten- / Kreditorteilenummer	Angebot `supplier_part_number`	Die SPN, die von der MPN abweichen kann.
Bestellmenge	`purchase-options.quantity` (Angebotseinheiten) oder `purchase_quantity` (Basiseinheiten)	Verwenden Sie Basiseinheiten, wenn Ihr ERP in der Basiseinheit arbeitet.
Stückpreis / Einkaufskondition	`purchase-options.unit_price` (`amount` + `currency`), oder Angebot `price_breaks[].unit_price`	Originalwährung; keine Umrechnung – rechnen Sie bei Bedarf ERP-seitig um.
Staffelpreise / Mengenrabatte	Angebot `price_breaks` (`minimum_order_quantity`, `minimum_packaging_quantity`, `unit_price`)	Für gestaffelte Einkaufskonditionen.
MOQ / Bestellvielfaches	`purchase-options.minimum_order_quantity` / `minimum_packaging_quantity`	Auch pro Staffel im Angebot `price_breaks` verfügbar.
Lieferung / Lieferzeit	Angebot `availability.factory_lead_time`; für Custom Parts `price_breaks[].lead_time`
Verfügbarer Bestand	Angebot `availability.stock`, `availability.factory_quantity`
Packaging	Angebot `packaging`
Einmalige Kosten (Werkzeug / NRE)	Angebot `one_time_costs`
Preisgültigkeit	Angebot `valid_from` / `valid_until`	Vor der Bestellung prüfen.
NCNR / Stornobedingungen	Angebot `cancellation_policy` (`is_non_cancellable_non_returnable`, `cancellation_window`)
Kontierung / Kostenstelle	—	Nur ERP-seitig; nicht von Luminovo bereitgestellt.
Bedarf / Liefertermin	—	Nur ERP-seitig; kommt aus dem Bedarf des ERP.
Werk / Standort	—	Nur ERP-seitig.

Explizit zu benennende Einschränkungen

Die Bestellung wird im ERP erstellt und ausgeführt. Wareneingang, Rechnungseingang und Freigaben bleiben dort. Luminovo liefert ausschließlich die bepreisten Angebotsdaten.
Auf diesem Weg wird von Luminovo nichts bei Lieferanten bestellt oder per E-Mail versendet. Diese Endpunkte sind schreibgeschützt; die Kaufentscheidung und die Bestellung liegen immer beim ERP.
Aktualität ist wichtig. Purchase options spiegeln den letzten Sourcing-Lauf wider. Aktualisieren Sie die Angebote, bevor Sie Bestellanforderungen versenden.
Preise sind in der Originalwährung des Angebots – keine Umrechnung. Prüfen Sie is_non_cancellable_non_returnable (NCNR), minimum_order_quantity und minimum_packaging_quantity, bevor Sie sich festlegen.
Behandeln Sie Angebots-IDs als undurchsichtig und gleichen Sie alle in not_found_ids zurückgegebenen IDs ab.

Endpunkt-Kurzreferenz


#	Endpunkt	Methode	Rolle
1	`/offers/refresh`	POST	Optionale Aktualität – Angebote für MPNs aktualisieren.
2	`/sourcing-scenarios/run-selection`	POST	Optionale Aktualität – die Auswahl vor dem Lesen erneut ausführen
3	`/sourcing-scenarios/{id}/purchase-options`	GET	Die ausgewählten Angebote, Mengen und Preise für das Szenario
4	`/offers/bulk`	POST	Vollständige Angebotsdetails (Lieferant, Preisstaffeln, Verfügbarkeit) für viele Angebots-IDs
5	`/offers/{id}`	GET	Vollständige Angebotsdetails für eine einzelne Angebots-ID

Verwandte Artikel

Bestätigte Preise, Verfügbarkeit und Lieferantendaten aus einem kalkulierten Projekt in Ihr ERP synchronisieren