Integracja ERP i MES

Ta strona jest dla inżyniera integracji łączącego Scalarcut z ERP, MES lub sterownikiem stołu cięcia.

Dokument Factory MBOM dociera do Twoich systemów na dwa sposoby:

• Eksport z planera — użytkownik Enterprise planuje w planerze i klika przycisk Factory MBOM, aby pobrać JSON i CSV.
• HTTP API — Twoje middleware pobiera ten sam dokument przez punkt końcowy z kluczem.

Oba tworzą ten sam schemat scalarcut.factory_bom.v1.1; poniższe mapowanie dotyczy obu.

Wybierz JSON lub CSV

• JSON to pełny dokument: nagłówek, elementy, przepisy, materiały eksploatacyjne, sumy i opcjonalna geometry. Użyj go, gdy Twoje middleware potrafi przyjmować ustrukturyzowany JSON.
• CSV to tylko lista elementów — płaskie kolumny, które możesz wrzucić prosto do stołu cięcia lub importu arkusza. Pakowanie, identyfikatory, stawki i sumy nie są w CSV.

Oba opisują tę samą listę cięć; CSV to stratna projekcja elementów JSON.

Mapowanie pól

Pole Factory MBOM	Typowy cel ERP / MES
schema	Blokada wersji kontraktu (przypnij do scalarcut.factory_bom.v1.1)
scene_id / project_id	Klucz zlecenia produkcyjnego / zlecenia roboczego
surface_id	Strefa lub linia (wall-a…wall-d, floor)
group_id	Stabilny klucz trasowania grupy cięć
letter	Czytelna legenda listy cięć dla hali
sku	Indeks materiałowy / numer artykułu
w_mm / h_mm	Wymiary cięcia dla stołu cięcia
cut_type	Strategia cięcia / stanowisko robocze
qty	Ilość zamówienia dla grupy
fragile	Blokada jakości / flaga obsługi ręcznej
cre_recycled / cre_parent	Śledzenie recyklingu do płytki źródłowej
is_l_cut	Trasowanie cięcia w L
rates	Stałe formuł materiałów eksploatacyjnych
totals.cut_qty	Weryfikacja z nagłówkiem listy cięć planu
totals.boxes_to_order	Kartony do zakupu

Idempotentne pobieranie

Punkt końcowy to GET z ETag. Odpytuj z If-None-Match, aby ponowne żądanie bez zmian zwracało 304 zamiast ponownego przetwarzania dokumentu. Traktuj kombinację scene_id/project_id + ETag jako klucz idempotencji przy wczytywaniu do kolejki.

Pobieranie, nie wysyłanie

Są dwie ścieżki dostarczania. Użytkownik może wyeksportować dokument przyciskiem w nagłówku planera (pobiera JSON + CSV). Do automatyzacji Twoje middleware może pobrać dokument przez HTTP API na żądanie — w tym wydaniu nie ma wysyłania webhookiem. Ustaw odpytywanie w swoim tempie i opieraj się na ETag.

Kruche cięcia

Cięcie poniżej progu kruchości 50 mm jest oznaczone fragile: true. Kieruj je do obsługi ręcznej, zamiast wysyłać na maszynę, która je złamie. Sliver Guard już próbuje ponownie zakotwiczać układy, aby ich unikać; flaga to ostateczna siatka bezpieczeństwa.

Materiały eksploatacyjne

Klej, fuga i grunt są zawsze obecne w rates i totals Factory MBOM — odwrotnie niż w koszyku Online Store Widget, gdzie materiały eksploatacyjne są opcjonalną pozycją koszyka. Zmapuj rates raz na stałe swoich formuł; dokument niesie obliczone kg/L, więc nie musisz ich przeliczać.

Weryfikacja

totals.cut_qty musi równać się sumie qty elementów. Przy wczytywaniu dokumentu uzgodnij totals.cut_qty z nagłówkiem listy cięć planu dla tej samej sceny. Każde odchylenie oznacza, że układ zmienił się między eksportem a wczytaniem — pobierz ponownie przed wydaniem do produkcji.

Pobieranie projektu po id

Twoje middleware pobiera projekt po jego scene_id (lub project_id) wraz z Twoim Enterprise Key. Żądanie jest ograniczone do Twojego przedsiębiorstwa, więc pobierasz tylko własne projekty. Fixture garażu to publiczna próbka dla testów integratorów i panelu Try MBOM API, a nie jedyny dokument serwowany przez punkt końcowy.