Sylob ERP integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS

Sylob dokumentācijā aprakstītas divas publiskas 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 nodrošina divu veidu publiskas REST API jeb tīmekļa pakalpojumus, kas ļauj lasīt un rakstīt datus.) (Forterro zināšanu bāze)

1. API REST Système d’information (lasīšana). Tā izpilda saglabātu vaicājumu (requête), kas izveidots aktivitātē “Interroger le système d’information”. Vaicājuma izsaukuma URL var iegūt sadaļā “Autres actions” > “Afficher le web service”; tā forma ir /rest/query/{identifiantQuery}/resultat. Ar parametriem nosaka rezultātu skaita ierobežojumu, skaitļu formātu, vaicājuma mainīgos un rezultātu struktūru. Pēc noklusējuma rezultāti tiek atgriezti XML formātā, bet ar galveni Accept: application/json — JSON formātā. Šī API ir iekļauta ERP.
2. API REST Action (lasīšana un rakstīšana). Tā izpilda darbību, kas definēta aktivitātē “Gérer les actions web service” — Sylob darbību katalogā. Pieejamas divas operācijas: GET /rest/v2/action/{code}/describe atgriež darbības datu shēmu, savukārt POST /rest/v2/action/{code}/execute to izpilda ar JSON pieprasījuma saturu. Darbību veidi ietver:

– Modification de données: maina vienu vai vairākus ieraksta laukus, izmantojot Sylob ātrās rediģēšanas mehānismu. Describe uzskaita rediģējamos laukus. – Message EDI: izveido, maina vai dzēš ierakstus, izmantojot EDI ziņojumu. – Scénario de saisie: izpilda ievades scenāriju jautājumu pa jautājumam. Sylob dokumentācijā kā piemērs dots “Déclarer un début ou une fin” — operācijas sākuma vai beigu reģistrēšana (Sylob_Action_006). – Dokumentu publicēšana, augšupielāde un lejupielāde.

1. EDI ziņojumi. Sylob EDI dzinis nodrošina eksportu un importu. Standarta ziņojums Sylob_Recup_Decl_Pro izgūst ražošanas deklarācijas. (Forterro)
2. Faili un ETL. Sylob ERP Cloud piedāvā “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Failu integrācija, izmantojot SFTP, ērtai esošo integrāciju migrācijai.) (Sylob) Vaicājumu rezultātus var arī eksportēt uz Excel — tas ir ātrs veids, kā sākt SkyPlanner izmēģinājumu.

Sylob publiskajā zināšanu bāzē nav dokumentēta izejošo webhook paziņojumu abonēšana. Izmaiņas nonāk SkyPlanner, pēc jūsu noteikta grafika periodiski izpildot saglabātus vaicājumus, kas atlasa atvērtos OF un nesenās izmaiņas.

Sylob aizsargā ERP pret pārmērīgu vaicājumu slodzi. Kopš laidiena 2025.Q2 uzņēmuma parametrs “Protection des API” ieslēdz pieprasījumu biežuma ierobežošanu katram lietotājam un lielu rezultātu kopu dalīšanu lapās. Sylob paziņo, ka no laidiena 2026.Q2 tas tiks piemērots sistemātiski. Atbildēs ir RateLimit galvenes, un izsaukums, kas pārsniedz kvotu, atgriež HTTP 429 Too Many Requests ar Retry-After vērtību. (Forterro) Paredziet to sinhronizācijas risinājumā: izgūstiet tikai izmaiņas, daliet rezultātus lapās un pēc 429 atbildes atkārtojiet pieprasījumus ar pieaugošu aizkavi.

Savukārt SkyPlanner nosūta webhook paziņojumus, kad mainās stāvoklis vai grafiks, tāpēc datu ierakstīšanu atpakaļ Sylob ierosina notikumi.

1. Sākotnējā pamatdatu ielāde. Katram objektam (artikuliem, nomenclatures, gammes, darba centriem, darbiniekiem) izveidojiet vienu saglabātu vaicājumu un nolasiet datus, izmantojot Système d’information API, vai vienreiz ielādējiet tos no Excel eksporta. Rūpīgi nosakiet darba centru atbilstību. Sylob centre de charge ir resursu grupa, tāpēc centrs ar trim iekārtām SkyPlanner parasti kļūst par darba centru grupu ar trim darba centriem.

2. Pasūtījumu sinhronizācija. Nolasiet apstiprinātos OF ar to operācijām, kā arī krājumus un atvērtos iepirkuma pasūtījumus. SkyPlanner uzskata pasūtītos materiālus par pieejamiem iepirkuma pasūtījuma piegādes datumā un atjaunina krājumus, kad pasūtījumam norādīts statuss Delivered. Tādējādi, sastādot grafiku, tiek pārbaudīti gan krājumi, gan gaidāmās iepirkumu piegādes.

Grafikā iekļaujiet apstiprinātos OF, nevis CBN ieteikumus. Ieteikumi mainās nākamajā neto vajadzību aprēķinā.

3. Grafika ierakstīšana atpakaļ. Katrai operācijai, kuru plānošanas dzinis ir ievietojis grafikā vai pārvietojis, integrācija izsauc Modification de données darbību attiecīgajai OF operācijai (Opération d’ordre de fabrication), norādot plānoto sākumu, plānotās beigas un darba centru. Darbība izmanto paša Sylob ātrās rediģēšanas loģiku — tāpat kā tad, ja operāciju rediģētu plānotājs. Describe atgriež rediģējamos laukus, tāpēc integrācija pirms pirmā izsaukuma pārbauda nosūtāmos datus. Ja ierakstu tobrīd rediģē lietotājs, tiek atgriezta paredzēta kļūda; atkārtojiet mēģinājumu nākamo izmaiņu laikā.

4. Ražošanas deklarācijas no ceha. Operatori reģistrē darbu, izmantojot SkyPlanner Mobile Confirmations vai Production Timer. Sākuma un beigu dati tiek nosūtīti atpakaļ ar scenāriju “Déclarer un début ou une fin”. Darba laika uzskaites ieraksti un daudzumi kļūst par tās pašas OF operācijas ražošanas deklarācijām: pārregulēšanas laiks, izpildes laiks, saražotais daudzums, brāķis un operācijas pabeigšana. Ja jūsu ražotnē deklarācijas jau reģistrē, izmantojot Sylob Apps vai ceha termināļus, saglabājiet vienu deklarāciju reģistrēšanas kanālu, lai novērstu dubultus ierakstus.

5. Datu pārvaldības un konfliktu risināšanas noteikumi. Dokumentējiet tos pirms palaišanas:

SkyPlanner var darboties bez CADPLAN un bez Sylob plānošanas darbībām, kas ņem vērā pieejamo jaudu. Uzticiet operāciju datumu pārvaldību SkyPlanner, jo divas plānošanas sistēmas, rakstot vienus un tos pašus datumus, pārraksta viena otras datus. Kad datumus pārvalda SkyPlanner, Autopilot automātiski pārplāno grafiku pēc katras būtiskas izmaiņas, un jaunie datumi tiek nosūtīti atpakaļ uz Sylob.

• Action API licence. Datu nolasīšana ar saglabātajiem vaicājumiem ir iekļauta. Rakstīšanai, izmantojot darbību katalogu, nepieciešams Sylob modulis “Webservice” vai API licence MyForterro vidē. Pirms datu ierakstīšanas atpakaļ posma saskaņojiet to ar savu Sylob kontaktpersonu.
• Vaicājumi nosaka datu apmaiņas nosacījumus. Datu nolasīšana balstās uz saglabātajiem vaicājumiem. Piešķiriet tiem skaidrus nosaukumus, izpildes laikā nododiet filtrus kā mainīgus atribūtus un pārvaldiet vaicājumu versijas kopā ar integrācijas versijām.
• Darba centru grupas. Vienā Sylob darba centrā var būt vairākas iekārtas. Katram centram izlemiet, vai SkyPlanner to attēlos kā vienu darba centru grupu vai atsevišķas iekārtas.
• Plānošana atpakaļ no vajadzīgā datuma un noslodzes aprēķini. Sylob sastāda grafiku atpakaļ no datumiem, kuros pasūtījumiem jābūt gataviem, un ieplānots noslodzes aprēķins var pārplānot kavētos OF. Vienojieties, vai kāda darbība joprojām drīkstēs ierakstīt operāciju datumus, kad tos pārvaldīs SkyPlanner, un, ja drīkstēs, kura tā būs.
• Pārregulēšanas un izpildes laika mērvienības. Pirms importēšanas pārbaudiet mērvienības un to, vai pārregulēšanas laiks ir norādīts vienam OF vai vienai vienībai. Nepareizas mērvienības sagroza visu ilgumu aprēķinus.
• Kalendāri. Darba centru nedēļas grafikiem un izņēmumiem jāaptver viss plānošanas periods, citādi jauda plānā nebūs pieejama.
• Pieprasījumu ierobežošana. Sylob ierobežo izsaukumu skaitu katram lietotājam un sadala lielus rezultātu apjomus lapās. Inkrementāla izmaiņu pieprasīšana ļauj droši iekļauties kvotā.
• CORS un pārlūkprogrammas. Izsaukumiem starp serveriem CORS ierobežojumi nav piemērojami. Pārlūkprogrammu klientiem Sylob pusē jākonfigurē atļautie izcelsmes avoti.