API do optymalizacji cięcia rur i profili
Tak — istnieje API do cięcia rur. Docinanie rur, rurek i profili zamkniętych na długość to problem optymalnego rozkroju 1D, a ten sam silnik, który napędza aplikację CutOptim, można wywołać przez HTTP. Twój system ERP, oprogramowanie do wycen albo MES wysyła listę cięć i dostępne długości prętów jako JSON, a w odpowiedzi dostaje zoptymalizowany plan cięcia, liczbę prętów i wykorzystanie materiału — bez przeglądarki i bez klikania.
To działa już dziś — silnik CutOptim od dawna wykonuje optymalizację 1D w produkcji na potrzeby aplikacji, a Engine API udostępnia dokładnie ten sam solver przez HTTP, więc plan zwrócony przez wywołanie API zgadza się z tym, co pokazuje aplikacja.
{
"parts": [
{ "length": 1200, "qty": 8, "meta": { "ref": "RHS-40x40" } },
{ "length": 2450, "qty": 4 }
],
"stock": [{ "length": 6000, "qty": 50, "price": 21.5 }],
"options": { "kerf": 2 }
}- Działa już dziś na
POST /v1/optimize/1d— ten sam silnik co w aplikacji, nie wersja przedpremierowa. - Bezpłatna walidacja:
POST /v1/validate/1dsprawdza zlecenie bez klucza i bez limitu. - Dołącz obiekt meta (numer artykułu, pozycja zamówienia), a wróci przy każdym rozmieszczonym cięciu.
- Zgłaszana resztka to użyteczny odcinek — szerokość rzazu jest już odjęta.
Dlaczego potrzebują tego zakłady obróbki rur
Cięcie zlecenia rur w kolejności z listy zostawia resztkę na prawie każdej sztandze, a wiele z nich jest zbyt krótkich, by je wykorzystać. Optymalizator 1D rozkłada cięcia po sztangach tak, by zlecenie wymagało jak najmniej sztang. Ręcznie nie da się tego zrobić dla setek elementów; we własnym oprogramowaniu, przez API — da się.
Co wysyłasz i co wraca
Wysyłasz długości elementów (z ilościami) oraz dostępne długości prętów i ich ceny jako JSON. Odpowiedź zawiera pełny plan cięcia pręt po pręcie, liczbę prętów, wykorzystanie, łączną długość cięcia i użyteczną resztkę z każdego pręta (szerokość rzazu jest już odjęta). Dodaj include:["csv","dxf"], a lista cięć wróci jako plik w treści odpowiedzi.
Deterministyczny — odtwarzalny dla ofert i audytów
To samo zapytanie zawsze zwraca ten sam plan cięcia: żadnej losowości, żadnego zegara w algorytmie. Ofertę zbudowaną na wywołaniu API można odtworzyć po miesiącach — do audytu albo powtórnego zamówienia — a wyniki da się buforować i porównywać w testach.
Dwustronicowe streszczenie (PDF po angielsku) — problem, co wysyłasz i co dostajesz, przykładowe zapytanie i odpowiedź oraz jak budować na silniku. Gotowe do druku, z kodem QR prowadzącym do tej strony.
Najczęstsze pytania
Czy istnieje API do optymalizacji cięcia rur?
POST /v1/optimize/1d. Wysyłasz listę cięć i długości prętów jako JSON, a w odpowiedzi dostajesz zoptymalizowany plan cięcia, liczbę prętów, wykorzystanie i użyteczne resztki. To ten sam silnik, który napędza aplikację CutOptim, wywoływany przez HTTP.Czy mogę wypróbować to przed podjęciem decyzji?
POST /v1/validate/1d sprawdza zapytanie bez rozwiązywania — za darmo, bez klucza API i bez zużycia limitu — więc programiści mogą potwierdzić poprawność danych podczas budowy integracji. Samo Engine API ma 14-dniowy okres próbny.Czy obsługuje różne długości prętów i ceny?
options.minimizeCost silnik porządkuje plany według łącznej ceny materiału, a nie liczby prętów, i zwraca totalPrice razem z planem — przydatne, gdy dłuższe pręty kosztują nieproporcjonalnie więcej.Jak uwzględniana jest szerokość rzazu i okrawanie końców?
options.kerf na szerokość tarczy piły, a zostanie odjęta przy każdym cięciu; options.trim.start i options.trim.end rezerwują docięcie czoła na każdym końcu pręta. Zgłaszana resztka każdego pręta to użyteczny odcinek po uwzględnieniu tego wszystkiego, więc od razu możesz wpisać ją z powrotem do magazynu. Ustaw options.minOffcut, aby raportować tylko resztki na tyle długie, by je zachować.Czy może planować tylko z prętów, które mam na stanie?
options.respectStock, a ilość każdej pozycji magazynowej staje się twardym limitem: silnik planuje z prętów, które faktycznie masz, a każdy element, który się nie mieści, wraca w unplaced zamiast być cięty z pręta, którego nie posiadasz. Bez tej opcji plan zakłada, że można dokupić kolejne pręty, i podaje, ile zamówić.