Sylob ERP integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS

Sylob dokumentacijoje aprašytos dvi viešosios 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 teikia dviejų tipų viešąsias REST API, dar vadinamas žiniatinklio paslaugomis, kurios leidžia skaityti ir įrašyti duomenis.) (Forterro žinių bazė)

1. API REST Système d’information (skaitymas). Ji vykdo išsaugotą užklausą (requête), sukurtą veikloje „Interroger le système d’information“. Konkrečios užklausos iškvietimo URL gaunamas pasirinkus „Autres actions“ > „Afficher le web service“. Jo formatas – /rest/query/{identifiantQuery}/resultat. Parametrais nustatoma rezultatų skaičiaus riba, skaičių formatas, užklausos kintamieji ir rezultatų struktūra. Pagal numatytąją nuostatą rezultatai pateikiami XML formatu, o su antrašte Accept: application/json – JSON formatu. Ši API įtraukta į ERP.
2. API REST Action (skaitymas ir įrašymas). Ji vykdo veiksmą, apibrėžtą veikloje „Gérer les actions web service“ – Sylob veiksmų kataloge. Galimos dvi operacijos: GET /rest/v2/action/{code}/describe grąžina veiksmo duomenų schemą, o POST /rest/v2/action/{code}/execute jį vykdo su JSON užklausos turiniu. Veiksmų tipai:

– Modification de données: pakeičia vieną ar kelis įrašo laukus per Sylob greitojo redagavimo mechanizmą. Describe pateikia redaguojamų laukų sąrašą. – Message EDI: sukuria, pakeičia arba pašalina įrašus per EDI pranešimą. – Scénario de saisie: vykdo duomenų įvedimo scenarijų, nuosekliai pereidamas per klausimus. Sylob pateikiamas pavyzdys – „Déclarer un début ou une fin“, kuriuo deklaruojama operacijos pradžia arba pabaiga (Sylob_Action_006). – Dokumentų publikavimas, įkėlimas ir atsisiuntimas.

1. EDI pranešimai. Sylob EDI modulis apdoroja eksportą ir importą. Standartinis pranešimas Sylob_Recup_Decl_Pro nuskaito gamybos deklaracijas. (Forterro)
2. Failai ir ETL. Sylob ERP Cloud siūlo „Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.“ (Failų integravimą per SFTP, kad būtų lengva perkelti esamas integracijas.) (Sylob) Užklausų rezultatus taip pat galima eksportuoti į Excel – tai greitas būdas pradėti išbandyti SkyPlanner.

Viešojoje Sylob žinių bazėje neaprašyta galimybė prenumeruoti siunčiamus webhook pranešimus. Pakeitimai perduodami į SkyPlanner jūsų nustatytu periodiškumu vykdant išsaugotas užklausas, kurios atrenka atvirus OF ir naujausius pakeitimus.

Sylob saugo ERP nuo pernelyg intensyvių užklausų. Nuo versijos 2025.Q2 įmonės parametras „Protection des API“ įjungia užklausų dažnio ribojimą kiekvienam naudotojui ir didelių rezultatų rinkinių skaidymą į puslapius. Sylob skelbia, kad nuo versijos 2026.Q2 tai bus taikoma sistemingai. Atsakymuose pateikiamos RateLimit antraštės, o viršijus kvotą grąžinamas HTTP 429 Too Many Requests atsakymas su Retry-After reikšme. (Forterro) Projektuodami sinchronizavimą į tai atsižvelkite: užklausomis nuskaitykite tik pokyčius, naudokite puslapiavimą, o gavę 429 atsakymą ilginkite laukimo laiką iki kito bandymo.

Kita kryptimi SkyPlanner siunčia webhook pranešimus pasikeitus būsenai arba tvarkaraščiui, todėl duomenų įrašymą atgal į Sylob sužadina įvykiai.

1. Pradinis pagrindinių duomenų įkėlimas. Kiekvienam objektui (articles, nomenclatures, gammes, darbo centrams, darbuotojams) sukurkite po išsaugotą užklausą ir nuskaitykite duomenis per Système d’information API arba vieną kartą įkelkite juos iš Excel eksporto. Atidžiai nustatykite darbo centrų atitikmenis. Sylob centre de charge yra išteklių grupė, todėl centras su trimis staklėmis SkyPlanner sistemoje paprastai tampa darbo centrų grupe su trimis darbo centrais.

2. Užsakymų sinchronizavimas. Nuskaitykite patvirtintus OF su jų operacijomis, taip pat atsargas ir atvirus pirkimo užsakymus. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakyme nurodytą pristatymo dieną, o atsargas atnaujina, kai pirkimo užsakymas pažymimas būsena Delivered. Taigi sudarant tvarkaraštį tikrinamos ir turimos atsargos, ir laukiami pirkimai.

Į tvarkaraštį įtraukite patvirtintus OF, o ne CBN pasiūlymus. Pasiūlymai pasikeičia kitą kartą perskaičiavus grynuosius poreikius.

3. Tvarkaraščio įrašymas atgal. Kiekvienai operacijai, kurią planavimo variklis įtraukė į tvarkaraštį arba perkėlė, integracija iškviečia OF operacijos (Opération d’ordre de fabrication) veiksmą Modification de données, perduodama suplanuotą pradžią, pabaigą ir darbo centrą. Veiksmas vykdomas pagal pačios Sylob greitojo redagavimo logiką – taip pat, kaip operaciją redaguotų planuotojas. Describe grąžina redaguojamus laukus, todėl integracija patikrina siunčiamus duomenis prieš pirmąjį iškvietimą. Jei įrašą tuo metu redaguoja naudotojas, grąžinama numatyta klaida; pakartokite bandymą įvykus kitam pakeitimui.

4. Gamybos deklaracijos ceche. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer. Pradžia ir pabaiga perduodamos atgal per scenarijų „Déclarer un début ou une fin“. Darbo laiko įrašai ir kiekiai tampa tos pačios OF operacijos gamybos deklaracijomis: paruošimo laikas, vykdymo trukmė, pagamintas kiekis, brokas ir operacijos užbaigimas. Jei jūsų gamykla jau teikia deklaracijas per Sylob Apps arba cecho terminalus, palikite vieną deklaravimo kanalą, kad įrašai nesidubliuotų.

5. Duomenų valdymo ir konfliktų sprendimo taisyklės. Užfiksuokite jas prieš pradėdami eksploataciją:

SkyPlanner nereikia nei CADPLAN, nei Sylob planavimo pagal ribotus pajėgumus funkcijų. Operacijų datas patikėkite valdyti SkyPlanner: jei jas įrašo dvi planavimo sistemos, jos perrašo viena kitos duomenis. Kai datas valdo SkyPlanner, Autopilot automatiškai perskaičiuoja tvarkaraštį po kiekvieno reikšmingo pokyčio, o naujos datos perduodamos atgal į Sylob.

• Action API licencija. Duomenų skaitymas per išsaugotas užklausas įtrauktas. Norint įrašyti duomenis per veiksmų katalogą, reikia Sylob „Webservice“ modulio arba MyForterro API licencijos. Suderinkite tai su savo Sylob kontaktiniu asmeniu dar prieš įrašymo atgal etapą.
• Užklausos – jūsų integracijos sutartis. Duomenų skaitymas priklauso nuo išsaugotų užklausų. Suteikite joms aiškius pavadinimus, vykdymo metu perduokite filtrus kaip kintamuosius atributus ir valdykite užklausų versijas kartu su integracijos versijomis.
• Darbo centrų grupės. Vienas Sylob darbo centras gali apimti kelias stakles. Kiekvienam centrui nuspręskite, ar SkyPlanner jį matys kaip vieną darbo centrų grupę, ar kaip atskiras stakles.
• Planavimas atgal ir apkrovos skaičiavimas. Sylob sudaro tvarkaraštį atgal nuo poreikio datų, o suplanuotas apkrovos skaičiavimas gali perplanuoti vėluojančius OF. Susitarkite, kuri funkcija, jei tokia liks, dar galės įrašyti operacijų datas, kai jas valdys SkyPlanner.
• Paruošimo ir vykdymo laiko vienetai. Prieš importuodami patikrinkite vienetus ir tai, ar paruošimo laikas nurodytas vienam OF, ar vienam gaminiui. Netinkami vienetai iškraipo visas trukmes.
• Kalendoriai. Darbo centrų savaitiniai darbo grafikai ir išimtys turi apimti visą planavimo laikotarpį, kitaip plane neliks pajėgumų.
• Užklausų dažnio ribojimas. Sylob riboja vienam naudotojui tenkančių iškvietimų skaičių ir didelius rezultatų rinkinius skaido į puslapius. Periodiškai tikrinant tik pasikeitusius duomenis, iki kvotos ribos lieka didelė atsarga.
• CORS ir naršyklės. Tiesioginiams iškvietimams tarp serverių CORS apribojimai netaikomi. Naršyklėje veikiantiems klientams Sylob pusėje reikia sukonfigūruoti leidžiamus šaltinius.