Vodnik za povezavo Sylob ERP s SkyPlanner APS za terminiranje proizvodnje

Sylob dokumentira dva javna REST API: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (Sylob ERP ponuja dve vrsti javnih REST API, imenovanih tudi spletne storitve, ki omogočajo branje in zapisovanje podatkov.) (Baza znanja Forterro)

1. API REST Système d’information (branje). Izvede shranjeno poizvedbo (requête), pripravljeno v aktivnosti “Interroger le système d’information”. URL za klic posamezne poizvedbe dobite prek “Autres actions” > “Afficher le web service” in ima obliko /rest/query/{identifiantQuery}/resultat. Parametri določajo omejitev števila rezultatov, oblikovanje števil, spremenljivke poizvedbe in strukturo rezultatov. Rezultati so privzeto v obliki XML, z glavo Accept: application/json pa v obliki JSON. Ta API je vključen v ERP.
2. API REST Action (branje in zapisovanje). Izvede dejanje, opredeljeno v aktivnosti “Gérer les actions web service”, ki je katalog dejanj v sistemu Sylob. Ponuja dve operaciji: GET /rest/v2/action/{code}/describe vrne podatkovno shemo dejanja, POST /rest/v2/action/{code}/execute pa ga izvede s telesom zahteve v obliki JSON. Vrste dejanj vključujejo:

– Modification de données: spremeni eno ali več polj zapisa prek mehanizma za hitro urejanje v sistemu Sylob. Describe navede polja, ki jih je mogoče urejati. – Message EDI: ustvari, spremeni ali izbriše zapise prek sporočila EDI. – Scénario de saisie: izvede scenarij vnosa, vprašanje za vprašanjem. Sylob kot primer navaja “Déclarer un début ou une fin”, s katerim se prijavi začetek ali konec operacije (Sylob_Action_006). – Objava, nalaganje in prenos dokumentov.

1. Sporočila EDI. Mehanizem EDI v sistemu Sylob skrbi za izvoz in uvoz. Standardno sporočilo Sylob_Recup_Decl_Pro pridobi prijave proizvodnje. (Forterro)
2. Datoteke in ETL. Sylob ERP Cloud ponuja “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Povezovanje z datotekami prek SFTP za preprosto selitev obstoječih integracij.) (Sylob) Rezultate poizvedb lahko izvozite tudi v Excel, kar je hitra pot do preizkusa sistema SkyPlanner.

Javna baza znanja Sylob ne dokumentira možnosti naročanja na odhodna obvestila webhook. Spremembe se v SkyPlanner prenašajo s periodičnim izvajanjem shranjenih poizvedb, ki filtrirajo odprte OF in nedavne spremembe. Urnik izvajanja določite sami.

Sylob ščiti ERP pred preobremenitvijo zaradi poizvedb. Od različice 2025.Q2 parameter podjetja “Protection des API” vklopi omejevanje klicev na uporabnika in razdelitev obsežnih rezultatov na strani. Sylob napoveduje, da bo ta zaščita od različice 2026.Q2 standardno vključena. Odgovori vsebujejo glave RateLimit, klic, ki preseže kvoto, pa vrne HTTP 429 Too Many Requests z vrednostjo Retry-After. (Forterro) Sinhronizacijo zasnujte temu primerno: z inkrementalnimi poizvedbami, razdelitvijo rezultatov na strani in odlogom ponovnega klica ob odgovoru 429.

SkyPlanner pa ob spremembah stanja ali terminskega plana pošilja obvestila webhook, zato povratno zapisovanje v Sylob sprožajo dogodki.

1. Začetni prenos matičnih podatkov. Za vsak objekt (artikle, kosovnice, tehnološke postopke, delovne centre, zaposlene) pripravite eno shranjeno poizvedbo in podatke preberite prek API Système d’information ali pa jih enkratno naložite iz izvoza Excel. Preslikavo delovnih centrov skrbno določite. Sylob centre de charge je skupina virov, zato center s tremi stroji v SkyPlanner običajno postane skupina delovnih centrov s tremi delovnimi centri.

2. Sinhronizacija nalogov. Preberite potrjene OF z njihovimi operacijami ter zaloge in odprta nabavna naročila. SkyPlanner obravnava naročeni material kot razpoložljiv na datum dobave nabavnega naročila in posodobi zalogo, ko je naročilo označeno kot Delivered. Pri terminiranju tako preverja zalogo in prihajajoče nabave.

Terminirajte potrjene OF, ne predlogov CBN. Predlogi se spremenijo ob naslednjem izračunu neto potreb.

3. Povratno zapisovanje terminskega plana. Za vsako operacijo, ki jo je mehanizem razporedil ali premaknil, povezava pokliče dejanje Modification de données za operacijo OF (Opération d’ordre de fabrication) z načrtovanim začetkom, načrtovanim koncem in delovnim centrom. Dejanje se izvede prek lastne logike hitrega urejanja v sistemu Sylob, enako kot kadar operacijo ureja planer. Describe vrne polja, ki jih je mogoče urejati, zato povezava pred prvim klicem preveri podatke zahteve. Če zapis trenutno ureja uporabnik, se vrne predvidena napaka; klic ponovite ob naslednji spremembi.

4. Prijave iz proizvodnje. Operaterji beležijo delo s SkyPlanner Mobile Confirmations ali Production Timer. Začetek in konec se vračata prek scenarija “Déclarer un début ou une fin”. Evidence časa in količine se pretvorijo v prijave proizvodnje za isto operacijo OF: pripravljalni čas, obdelovalni čas, izdelana količina, izmet in zaključek operacije. Če v vaši tovarni prijave že potekajo prek Sylob Apps ali terminalov v proizvodnji, ohranite en kanal za prijave, da preprečite podvojene vnose.

5. Pravila o lastništvu podatkov in reševanju konfliktov. Zapišite jih pred prehodom v produkcijo:

SkyPlanner ne potrebuje CADPLAN ali Sylobovih postopkov planiranja z omejenimi zmogljivostmi. Datume operacij naj določa SkyPlanner, saj si dva sistema za planiranje, ki zapisujeta iste datume, medsebojno prepisujeta podatke. Ko datume upravlja SkyPlanner, Autopilot ob vsaki pomembni spremembi samodejno ponovno terminira proizvodnjo, novi datumi pa se prenesejo nazaj v Sylob.

• Licenca za Action API. Branje prek shranjenih poizvedb je vključeno. Za zapisovanje prek kataloga dejanj potrebujete modul Sylob »Webservice« ali licenco API v MyForterro. O tem se dogovorite s svojim kontaktom za Sylob še pred fazo povratnega zapisovanja.
• Poizvedbe so dogovor o izmenjavi podatkov. Branje podatkov temelji na shranjenih poizvedbah. Jasno jih poimenujte, filtre ob izvajanju podajte kot spremenljive atribute in različice poizvedb upravljajte skupaj z različicami integracije.
• Skupine delovnih centrov. En delovni center v Sylob lahko zajema več strojev. Za vsak center se odločite, ali bo v SkyPlanner predstavljen kot ena skupina delovnih centrov ali kot posamezni stroji.
• Terminiranje nazaj in izračuni obremenitev. Sylob terminira nazaj od datumov potreb, načrtovani izračun obremenitev pa lahko ponovno terminira OF, ki zamujajo. Dogovorite se, kateri postopek, če sploh kateri, bo še zapisoval datume operacij, ko jih bo upravljal SkyPlanner.
• Enote pripravljalnega in izvajalnega časa. Pred uvozom preverite enote in ali je pripravljalni čas določen na OF ali na kos. Napačne enote popačijo vsa trajanja.
• Koledarji. Tedenski urniki delovnih centrov in izjeme morajo pokrivati celotno obdobje terminiranja, sicer zmogljivosti izginejo iz plana.
• Omejevanje klicev. Sylob omejuje število klicev na uporabnika in obsežne rezultate razdeli na strani. Inkrementalno preverjanje sprememb ostaja precej pod dovoljeno kvoto.
• CORS in brskalniki. Za klice med strežniki omejitve CORS ne veljajo. Za odjemalce v brskalniku je treba na strani Sylob nastaviti dovoljene izvore.