Liidestused / ERP / Sylob
Sylob ERP liidestamise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See Sylob ERP liidestamise juhend näitab partneritele ja IT-meeskondadele, kuidas ühendada Sylob ERP SkyPlanner APS-iga. SkyPlanneri ja Sylob ERP vaheline andmevahetus on kahesuunaline:
- SkyPlannerisse tuuakse articles, nomenclatures, gammes, töökeskused, töötajad, OF-id, laoseisud ja ostutellimused.
- Iga operatsiooni planeeritud algus, lõpp ja töökeskus kirjutatakse tagasi OF-i operatsioonidesse.
- Operaatorite ajakirjed saadetakse tagasi tootmisaruannetena.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus teie Sylobi keskkonnale vastavaks ja pakub tuge ka pärast käivitamist. See juhend on mõeldud partneritele ja arendajatele, kes soovivad kaasa lüüa või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon).
Sylob ERP liidesed
Sylobi dokumentatsioon kirjeldab kahte avalikku REST API-t: “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 pakub kahte tüüpi avalikke REST API-sid ehk veebiteenuseid, mis võimaldavad andmeid lugeda ja kirjutada.) (Forterro teabebaas)
- API REST Système d’information (lugemine). See käivitab salvestatud päringu (requête), mis on loodud tegevuses “Interroger le système d’information”. Päringu väljakutse URL-i leiab valikust “Autres actions” > “Afficher le web service” ja selle kuju on
/rest/query/{identifiantQuery}/resultat. Parameetritega määratakse tulemuste piirarv, arvuvorming, päringumuutujad ja tulemuste struktuur. Vaikimisi tagastatakse tulemused XML-vormingus, päisegaAccept: application/jsonaga JSON-vormingus. See API kuulub ERP juurde. - API REST Action (lugemine ja kirjutamine). See käivitab Sylobi toimingukataloogi tegevuses “Gérer les actions web service” määratletud toimingu. API pakub kahte operatsiooni:
GET /rest/v2/action/{code}/describetagastab toimingu andmeskeemi ningPOST /rest/v2/action/{code}/executekäivitab selle JSON-päringukehaga. Toimingutüübid on muu hulgas:
– Modification de données: muudab kirje üht või mitut välja Sylobi kiirmuutmise mehhanismi kaudu. Describe loetleb muudetavad väljad. – Message EDI: loob, muudab või kustutab kirjeid EDI-sõnumi kaudu. – Scénario de saisie: käivitab sisestusstsenaariumi küsimus haaval. Sylobi enda näide on “Déclarer un début ou une fin”, millega registreeritakse operatsiooni algus või lõpp (Sylob_Action_006). – Dokumentide avaldamine, üles- ja allalaadimine.
- EDI-sõnumid. Sylobi EDI-mootor haldab eksporti ja importi. Standardsõnum Sylob_Recup_Decl_Pro toob tootmisaruanded. (Forterro)
- Failid ja ETL. Sylob ERP Cloud pakub võimalust “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Failide liidestamine SFTP kaudu olemasolevate liidestuste hõlpsaks üleviimiseks.) (Sylob) Päringutulemusi saab eksportida ka Excelisse, mis on kiire viis SkyPlanneri proovimiseks.
Autentimine
Ligipääs Sylobi API-le sõltub paigaldusviisist. Kõik kutsed kasutavad HTTPS-i ja protokolli TLS 1.2. API pääsuandmed erinevad kasutaja ERP sisselogimisandmetest.
- Sylob ERP Cloud (AWS). Kasutusel on OAuth2 / OpenID Connect,
client_credentialsvoog ja Amazon Cognito väljastatud Bearer-pääsutõend. Kliendi ID, kasutajafondi URL-i ja saladuse leiab jaotisest “Gérer les paramètres des publications”. Pääsutõendi päring sisaldab litsentsi ulatust: Système d’information API puhulClientExterne/rest_readvõi Action API puhulClientExterne/rest_write, lisaks ettevõtte ulatustERP/<unité de persistance>. (Forterro) - Sylob MyForterro platvormil. Kasutusel on OAuth2 ja OpenID Connect. Liidestuse jaoks tuleb MyForterros luua “application” ning määrata sellele vajalikud rollid ja API litsents. (Forterro)
- Kohapealne paigaldus. Kasutusel on HTTP Basic. Sisselogimistunnus koosneb kasutajast, püsivusüksusest ja seansi identifikaatorist, mida eraldavad kahekordsed @-märgid. (Forterro)
Kasutage liidestuse jaoks eraldi kasutajat või rakendust, mille õigused piirduvad vastendustabelis olevate päringute ja toimingutega. Toimingukataloogis kirjutusõigusega kasutaja saab andmeid ka Système d’information API kaudu lugeda, nii et mõlema suuna jaoks piisab ühest liidestuse identiteedist.
SkyPlanneri REST API kasutab autentimiseks API pääsutõendit päises Authorization-Token (SkyPlanner Settings > API). API on dokumenteeritud Swagger/OpenAPI vormingus. Alustamiseks piisab API pääsutõendist. Liidestamise õpetus juhendab esimeste kutsete tegemisel.
Sündmused, perioodilised päringud ja päringusageduse piiramine
Sylobi avalikus teabebaasis ei ole dokumenteeritud väljuvate veebikonksude tellimise võimalust. Muudatused jõuavad SkyPlannerisse salvestatud päringute perioodilise käivitamisega teie määratud ajakava järgi. Need päringud filtreerivad avatud OF-e ja hiljutisi muudatusi.
Sylob kaitseb ERP-d liigse päringukoormuse eest. Alates versioonist 2025.Q2 lülitab ettevõtte parameeter “Protection des API” sisse kasutajapõhise päringusageduse piiramise ja suurte tulemuste lehekülgedeks jaotamise. Sylobi teatel rakendub see alates versioonist 2026.Q2 alati. Vastused sisaldavad RateLimit-päiseid ning piirmäära ületav kutse tagastab vastuse HTTP 429 Too Many Requests koos Retry-After väärtusega. (Forterro) Arvestage sellega sünkroonimise kavandamisel: kasutage muudatuspõhiseid päringuid ja lehekülgjaotust ning pikendage vastuse 429 korral korduskatsete ooteaega.
SkyPlanner saadab omalt poolt oleku või ajakava muutumisel veebikonksuteateid, nii et Sylobisse tagasikirjutamine toimub sündmuspõhiselt.
Andmete vastendamine
| Sylob ERP objekt | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
| Article (ostetav või toodetav) | Tooted ja materjalid | Sylob → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Nomenclature (mitmetasandiline) | Toote struktuur, alamtooted, materjalid toote kohta | Sylob → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Gamme: operatsioonid, seadistus- ja tööajad, töökeskus | Protsessietapid koos kestuste ja seadistusaegadega | Sylob → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
| Centre de charge: ressursside arv, semaine type ja erandid | Töökeskused, töökeskuste rühmad, vahetused, puudumised | Sylob → SkyPlanner | Esmane laadimine; kalendreid uuendatakse iga päev või hallatakse SkyPlanneris |
| Employé | Personal ja vahetused | Sylob → SkyPlanner | Esmane laadimine, seejärel iga päev |
| Ordre de fabrication (OF) koos operatsioonide ja komponentidega | Tellimus ja tööd koos tähtaja ja prioriteediga | Sylob → SkyPlanner | Salvestatud päringute käivitamine iga paari minuti järel |
| Laoseis asukoha kaupa | Materjalide laoseis | Sylob → SkyPlanner | Iga tund või enne iga ajakava koostamist |
| Commande fournisseur koos eeldatava saabumisajaga | Saabuv materjal tarnekuupäeval | Sylob → SkyPlanner | Iga tund või enne iga ajakava koostamist |
| Opération d’ordre de fabrication: planeeritud algus, lõpp ja töökeskus | Iga operatsiooni ajakavakohane algus, lõpp ja töökeskus | SkyPlanner → Sylob | Ajakava muutumisel SkyPlanneri veebikonksu ja Modification de données toimingu kaudu |
| Operatsiooni algus ja lõpp | Töö alustamine ja lõpetamine funktsioonis Mobile Confirmations | SkyPlanner → Sylob | Kohe sündmuse toimumisel stsenaariumi “Déclarer un début ou une fin” kaudu |
| Déclaration de production: seadistusaeg, tööaeg, toodetud kogus, praak, operatsiooni lõpetamine | Ajakirjed ja kogused | SkyPlanner → Sylob | Iga kinnituse või vahetuse kohta Scénario de saisie või Message EDI toimingu kaudu |
| SkyPlanneri piirangute andmed | Ümberseadistusaegade maatriks, tööriistad piiratud ressurssidena, alternatiivsed masinad ja töötajad | Hallatakse SkyPlanneris | Seadistatakse kasutuselevõtu käigus |
Liidestuse töövood
1. Põhiandmete esmane laadimine. Looge iga objekti jaoks (articles, nomenclatures, gammes, töökeskused, töötajad) üks salvestatud päring ja lugege andmed Système d’information API kaudu või laadige need ühekordselt Exceli ekspordist. Mõelge töökeskuste vastendus hoolikalt läbi. Sylobi centre de charge on ressursside rühm, seega vastab kolme masinaga keskusele SkyPlanneris tavaliselt kolmest töökeskusest koosnev rühm.
2. Tellimuste sünkroonimine. Lugege kinnitatud OF-id koos operatsioonidega ning lisaks laoseisud ja avatud ostutellimused. SkyPlanner käsitleb tellitud materjali ostutellimuse tarnekuupäeval saadaval olevana ja uuendab laoseisu, kui ostutellimus märgitakse olekusse Delivered. Seega kontrollitakse ajakava koostamisel nii laoseisu kui ka ostutellimustega saabuvat materjali.
Koostage ajakava kinnitatud OF-ide, mitte CBN-i soovituste põhjal. Soovitused muutuvad järgmisel netovajaduse arvutamisel.
3. Ajakava tagasikirjutamine. Iga operatsiooni puhul, mille planeerimismootor ajakavasse paigutas või ümber tõstis, käivitab liidestus OF-i operatsioonil (Opération d’ordre de fabrication) toimingu Modification de données, edastades planeeritud alguse, lõpu ja töökeskuse. Toiming kasutab Sylobi enda kiirmuutmise loogikat, samamoodi nagu planeerija operatsiooni muutes. Describe tagastab muudetavad väljad, nii et liidestus valideerib saadetavad andmed enne esimest kutset. Kui kasutaja kirjet parajasti muudab, tagastatakse ette nähtud veavastus; proovige järgmisel muudatusel uuesti.
4. Tootmisandmete registreerimine. Operaatorid registreerivad tööd SkyPlanner Mobile Confirmationsi või Production Timeri abil. Algus ja lõpp saadetakse tagasi stsenaariumi “Déclarer un début ou une fin” kaudu. Ajakirjetest ja kogustest saavad sama OF-i operatsiooni tootmisaruanded: seadistusaeg, tööaeg, toodetud kogus, praak ja operatsiooni lõpetamine. Kui teie tehases registreeritakse tootmisandmeid juba Sylob Appsi või tootmisterminalide kaudu, jätke topeltkirjete vältimiseks kasutusele üks registreerimiskanal.
5. Andmete haldamise ja konfliktide lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Articles, nomenclatures, gammes, OF-ide kogused ja olek | Sylob ERP |
| Operatsioonide järjestus, algus- ja lõpuajad ning iga operatsiooni töökeskus | SkyPlanner |
| Ettevalmistus- ja üleminekuaegade maatriks, tööriistad, operaatorite arv, alternatiivsed ressursid | SkyPlanner |
| Vahetused, kalendrid ja puudumised | Üks süsteem, mis valitakse ulatuse määramisel |
| Tootmise registreeringud, laoliikumised, kulud | Sylob ERP, kuhu andmed jõuavad SkyPlanneri ajakirjetest või Sylob Appsist |
SkyPlanner ei vaja CADPLANi ega Sylobi tootmise planeerimise toiminguid, mis arvestavad masinate ja töötajate tegelikku võimsust. Jätke operatsioonide kuupäevade haldamine SkyPlannerile, sest kui kaks planeerimissüsteemi kirjutavad samu kuupäevi, kirjutavad need üksteise andmed üle. Kui kuupäevi haldab SkyPlanner, koostab Autopilot iga olulise muudatuse korral ajakava automaatselt ümber ja uued kuupäevad saadetakse tagasi Sylobi.
Projekti tavapärased etapid
Juurutamine saab tavaliselt valmis mõne nädala jooksul pärast kasutuselevõtu alustamist. Enne seda saate 30-päevase tasuta prooviperioodi jooksul kasutada oma andmeid. Eksportige Sylobi päringutest avatud OF-id, operatsioonid ja töökeskused CSV- või Exceli faili, importige need ning kontrollige ajakava enne integreerimistööde alustamist.
- Andmevastenduse töötuba. Leppige kokku vastendustabel, andmete haldamise reeglid, sünkroonimise sagedused ja tootmise registreerimise kanal.
- Sylobi seadistamine. Looge salvestatud päringud, kirjutamistoimingud jaotises „Gérer les actions web service” ning integratsiooni kasutaja või MyForterro rakendus. Alustage testettevõttest ja jätkake seejärel tootmiskeskkonnas.
- Andmete esmane laadimine. Articles, nomenclatures, gammes, töökeskused ja kalendrid.
- Tellimuste, laoseisu ja ostutellimuste sünkroonimine. Muudatuspäringud, mille tulemused on lehekülgedeks jaotatud ning mille korduskatsetel kasutatakse pikenevat ooteaega.
- Piirangute seadistamine SkyPlanneris. Ettevalmistus- ja üleminekuaegade maatriks, tööriistad, operaatorite arv ning alternatiivsed masinad või töötajad.
- Ajakava tagasikirjutamine. Planeeritud kuupäevad kirjutatakse OF-i operatsioonidele; selles etapis lisatakse ka tootmise registreeringud.
- Paralleelne kasutamine. Võrrelge SkyPlanneri kuupäevi praeguse plaaniga ja parandage tehnilisi andmeid.
- Tootmiskasutuse alustamine. Lülitage tagasikirjutamine sisse, kui andmed klapivad.
Millega Sylob ERP integratsiooni kavandamisel arvestada
- Action API litsents. Salvestatud päringute kaudu lugemine on hinna sees. Toimingukataloogi kaudu kirjutamiseks on vaja Sylobi moodulit „Webservice” või MyForterros hangitavat API litsentsi. Leppige see oma Sylobi kontaktisikuga kokku enne tagasikirjutamise etappi.
- Päringud määravad andmevahetuse kokkuleppe. Andmete lugemine põhineb salvestatud päringutel. Andke neile selged nimed, edastage filtrid käitusajal muutuvate atribuutidena ja hallake päringute versioone koos integratsiooni versioonidega.
- Töökeskuste rühmad. Üks Sylobi töökeskus võib hõlmata mitut masinat. Otsustage iga keskuse puhul, kas SkyPlanner näeb seda ühe töökeskuste rühmana või eraldi masinatena.
- Tagasisuunas ajastamine ja koormuse arvutamine. Sylob koostab ajakava vajaduskuupäevadest tagasisuunas ning ajastatud koormusarvutus võib hilinenud OF-id ümber planeerida. Leppige kokku, kas ja milline toiming võib veel operatsioonide kuupäevi kirjutada pärast seda, kui nende haldamine on antud SkyPlannerile.
- Seadistus- ja tööaja ühikud. Enne importimist kontrollige ühikuid ning seda, kas seadistusaeg on määratud OF-i või tüki kohta. Valed ühikud moonutavad kõiki kestusi.
- Kalendrid. Töökeskuste nädalagraafikud ja erandid peavad katma kogu planeerimisperioodi, muidu kaob tootmisvõimsus plaanist.
- Päringusageduse piirangud. Sylob piirab päringute arvu kasutaja kohta ja jaotab mahukad tulemused lehekülgedeks. Ainult muudatuste perioodiline pärimine jääb lubatud mahust selgelt allapoole.
- CORS ja brauserid. Serveritevaheliste päringute puhul CORS ei rakendu. Brauseriklientide jaoks tuleb Sylobis seadistada lubatud päritolud.
Kes Sylob ERP integratsiooni seadistab ja toetab?
Töö hõlmab teie gammes-andmete, töökeskuste ja OF-ide vastendamist, Sylobi salvestatud päringuid ja kataloogitoiminguid ning SkyPlanneri piiranguid, näiteks ettevalmistus- ja üleminekuaegade maatriksit ning tööriistu.
- SkyPlanneri meeskond seadistab integratsiooni kasutuselevõtu käigus ja pakub tuge pärast tootmiskasutuse algust. Iga tehas korraldab oma Sylobi päringud, gammes-andmed ja töökeskused erinevalt ning seadistamisel rakendatakse just neid teadmisi.
- Teie Sylobi partner või integraator saab osaleda. Ta tunneb teie päringuid, lisaatribuute ja toimingukataloogi ning saab seadistada API juurdepääsu. SkyPlanner pakub REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Teie arendajad saavad lahendust edasi arendada, kasutades sama REST API-t ja API pääsutõendit. SkyPlanneri meeskond aitab vajaduse korral. Toote dokumentatsioon on avalikult kättesaadav lehel SkyPlanneri dokumentatsioon.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub iga kuu. Integratsiooni hinnapakkumine koostatakse teie protsessi ja vajaduste järgi ning esitatakse koos teie paketi hinnaga, et näeksite kogukulu enne alustamist. Sylobi võimsuse planeerimisest lugege artiklist Kas Sylob ERP võimaldab tootmist planeerida tegeliku tootmisvõimsuse piires?. Ülevaate leiate Sylob ERP lehelt ja teised süsteemid ERP integratsioonide lehelt.
Tootmisettevõtete tagasiside SkyPlanneri kohta
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest reaalajas tootmise optimeerimiseni.”
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ja uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise efektiivsus
„Tootmise efektiivsus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise efektiivsus on kasvanud 90% ja kõiki töökeskusi hõlmiva optimeeritud plaani koostamine kolmeks kuuks võtab alla 30 minuti.
100%tarnekindlus alates 2021. aastast
„SkyPlanner annab meile ülevaate tootmisvõimsusest ja muudab planeerimise prognoositavaks.”
Dan Berglund, COO/CFO
Opes Corporation · Keemia- ja toiduainetööstus
Tarnekindlus on olnud 100% kogu SkyPlanneri kasutamise aja, alates 2021. aastast.
98%tarnekindlus varasema ligikaudu 50% asemel
„SkyPlanneril on meie tarnekindluse hoidmisel otsustav roll.”
Hannu Lahtinen, tegevjuht
KJH-Comp · Lehtmetallitööd ja lepinguline tootmine
Tarnekindlus tõusis ligikaudu 50% pealt koguni 98%-ni ning ajakava koostamiseks on nüüd vaja kahe töödejuhataja asemel ühte.
Korduma kippuvad küsimused
Millist Sylobi API-t integratsioon kasutab?
Mõlemat avalikku REST API-t. Système d’information API loeb salvestatud päringute kaudu OF-e, gammes-andmeid, töökeskusi, laoseisu ja ostutellimusi. Action API kirjutab Sylobi toimingukataloogi kaudu tagasi nii OF-i operatsioonide planeeritud kuupäevad kui ka tootmise registreeringud.
Kas Sylob ERP toetab veebihaake?
Sylobi avalikus teadmusbaasis ei ole dokumenteeritud väljaminevate veebihaakide tellimist. Muudatused jõuavad SkyPlannerisse salvestatud päringutega, millega päritakse iga mõne minuti järel ainult muutunud andmeid. SkyPlanneri enda veebihaagid muudavad tagasikirjutamise sündmuspõhiseks.
Kuhu planeeritud kuupäevad Sylobis salvestatakse?
OF-i igale operatsioonile (Opération d’ordre de fabrication): planeeritud algus, planeeritud lõpp ja töökeskus. Koguseid, olekut, komponente ja kulusid haldab endiselt Sylob.
Kuidas operaatorite tööajad Sylobi tagasi jõuavad?
OF-i operatsiooni tootmisregistreeringutena: seadistusaeg, tööaeg, valmistatud kogus, praak ja operatsiooni lõpetamine. Alguse ja lõpu registreerimiseks kasutatakse Action API kaudu stsenaariumi „Déclarer un début ou une fin”.
Kas integratsioon töötab nii Sylob Cloudis kui ka kohapealses paigalduses?
Jah. Samad kaks REST API-t on olemas Sylob ERP Cloudis, MyForterros ja kohapealses paigalduses. Erineb ainult autentimine: pilves kasutatakse OAuth2 autentimist Cognito või MyForterro kaudu, kohapealses paigalduses Basic-autentimist.
Kas Sylobi integraator peaks pakkuma CADPLANi või SkyPlannerit?
SkyPlannerit, kui klient soovib kiiresti kogu tehase jooksvalt uueneva ajakava alusel tööle saada. SkyPlanner loeb olemasolevaid OF-e ja gammes-andmeid Sylobi REST API-de kaudu, planeerib automaatselt ümber ning planeerib ümberseadistusi ning tööriistade, meeskondade ja materjalide kasutamist. Operaatoritele pakub see funktsiooni Mobile Confirmations. Hind algab 199 € kuus. CADPLAN käitab planeerija määratud simulatsioone oma tehnoloogiliste andmete alusel. (Forterro koolitusprogramm)
Kas saame SkyPlannerit enne integratsiooni loomist proovida?
Jah. 30-päevasel tasuta prooviperioodil saate kasutada kuni 20 töökeskust, importides oma OF-id CSV- või Exceli failist. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
