ERP- & MES-Integration

Diese Seite richtet sich an den Integrationsingenieur, der Scalarcut an ein ERP, MES oder eine Zuschnitttisch-Steuerung anbindet.

Das Factory-MBOM-Dokument erreicht Ihre Systeme auf zwei Wegen:

• Planer-Export — ein Enterprise-Nutzer plant im Planer und klickt auf die Factory MBOM-Schaltfläche, um JSON und CSV herunterzuladen.
• HTTP-API — Ihre Middleware ruft dasselbe Dokument über den schlüsselbasierten Endpunkt ab.

Beide erzeugen dasselbe scalarcut.factory_bom.v1.1-Schema; die untenstehende Zuordnung gilt für beide.

Wählen Sie JSON oder CSV

• JSON ist das vollständige Dokument: Header, Teile, Rezepte, Verbrauchsmaterial, Summen und optionales geometry. Verwenden Sie es, wenn Ihre Middleware strukturiertes JSON verarbeiten kann.
• CSV ist nur die Teileliste — die flachen Spalten, die Sie direkt in einen Zuschnitttisch oder einen Tabellenimport geben können. Packung, IDs, Raten und Summen fehlen in der CSV.

Beide beschreiben dieselbe Zuschnittliste; die CSV ist eine verlustbehaftete Projektion der JSON-Teile.

Zuordnung der Felder

Factory-MBOM-Feld	Typisches ERP-/MES-Ziel
schema	Vertragsversions-Sperre (auf scalarcut.factory_bom.v1.1 pinnen)
scene_id / project_id	Produktionsauftrags-/Arbeitsauftragsschlüssel
surface_id	Zone oder Linie (wall-a…wall-d, floor)
group_id	Stabiler Routingschlüssel für eine Schnittgruppe
letter	Menschliche Zuschnittlisten-Legende für die Werkstatt
sku	Materialstamm / Artikelnummer
w_mm / h_mm	Schnittmaße für den Zuschnitttisch
cut_type	Schnittstrategie / Arbeitsplatz
qty	Bestellmenge für die Gruppe
fragile	Qualitätssperre / Handhabungs-Flag
cre_recycled / cre_parent	Recycling-Rückverfolgbarkeit zum Ausgangsrohling
is_l_cut	L-Schnitt-Routing
rates	Verbrauchsformel-Konstanten
totals.cut_qty	Prüfung gegen den Kopf der Blueprint-Zuschnittliste
totals.boxes_to_order	Zu kaufende Kartons

Idempotente Abrufe

Der Endpunkt ist ein GET mit ETag. Pollen Sie mit If-None-Match, damit eine unveränderte erneute Anfrage 304 statt einer erneuten Verarbeitung liefert. Behandeln Sie die Kombination aus scene_id/project_id + ETag als Idempotenzschlüssel beim Einlesen in eine Queue.

Pull, nicht Push

Es gibt zwei Zustellwege. Ein Nutzer kann das Dokument über die Kopfzeilen-Schaltfläche exportieren (lädt JSON + CSV herunter). Zur Automatisierung kann Ihre Middleware das Dokument über die HTTP-API abrufen — einen Webhook-Push gibt es in diesem Release nicht. Planen Sie Ihr Polling in Ihrem eigenen Takt und verlassen Sie sich auf den ETag.

Bruchgefährdete Schnitte

Ein Schnitt unter der 50-mm-Bruchschwelle ist mit fragile: true markiert. Leiten Sie diese zur manuellen Handhabung, statt sie einer Maschine zuzuführen, die sie zerbricht. Sliver Guard versucht bereits, Layouts neu zu verankern, um sie zu vermeiden; das Flag ist das letzte Sicherheitsnetz.

Verbrauchsmaterial

Kleber, Fuge und Grundierung sind in den Factory-MBOM-rates und totals immer vorhanden — das Gegenteil des Online-Store-Widget-Warenkorbs, wo Verbrauchsmaterial eine optionale Warenkorbzeile ist. Bilden Sie rates einmal auf Ihre Formelkonstanten ab; das Dokument trägt die berechneten kg/L, sodass Sie sie nicht neu berechnen müssen.

Prüfung

totals.cut_qty muss der Summe der Teil-qty entsprechen. Gleichen Sie beim Einlesen eines Dokuments totals.cut_qty mit dem Kopf der Blueprint-Zuschnittliste derselben Szene ab. Jede Abweichung bedeutet, dass sich das Layout zwischen Export und Einlesen geändert hat — rufen Sie erneut ab, bevor Sie in die Produktion gehen.

Ein Projekt per ID abrufen

Ihre Middleware ruft ein Projekt über seine scene_id (oder project_id) zusammen mit Ihrem Enterprise-Key ab. Die Anfrage ist auf Ihr Unternehmen beschränkt, sodass Sie nur Ihre eigenen Projekte erhalten. Die Garage-Fixture ist eine öffentliche Probe für Integrator-Tests und das Try MBOM API-Panel, nicht das einzige Dokument, das der Endpunkt liefert.