Guide til integration af Sylob ERP til produktionsplanlægning med SkyPlanner APS

Sylob dokumenterer to offentlige REST API’er: “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 stiller to typer offentlige REST API’er, også kaldet webservices, til rådighed til læsning og skrivning af data.) (Forterros vidensbase)

1. API REST Système d’information (læsning). Kører en gemt forespørgsel (requête), som er oprettet i aktiviteten “Interroger le système d’information”. Forespørgslens egen URL til kald findes under “Autres actions” > “Afficher le web service” og har formen /rest/query/{identifiantQuery}/resultat. Parametre styrer antallet af resultater, talformatering, forespørgselsvariabler og resultatets struktur. Resultater returneres som standard i XML eller i JSON med headeren Accept: application/json. Denne API er inkluderet i ERP-systemet.
2. API REST Action (læsning og skrivning). Kører en handling, der er defineret i aktiviteten “Gérer les actions web service”, Sylobs handlingskatalog. Den stiller to operationer til rådighed: GET /rest/v2/action/{code}/describe returnerer en handlings dataskema, og POST /rest/v2/action/{code}/execute kører handlingen med en JSON-body. Handlingstyperne omfatter:

– Modification de données: ændrer et eller flere felter i en post via Sylobs funktion til hurtig redigering. Describe viser de felter, der kan redigeres. – Message EDI: opretter, ændrer eller sletter poster via en EDI-meddelelse. – Scénario de saisie: kører et indtastningsforløb, spørgsmål for spørgsmål. Sylobs eget eksempel er “Déclarer un début ou une fin”, som registrerer start eller afslutning af en operation (Sylob_Action_006). – Publicering, upload og download af dokumenter.

1. EDI-meddelelser. Sylobs EDI-motor håndterer eksport og import. Standardmeddelelsen Sylob_Recup_Decl_Pro henter produktionstilbagemeldinger. (Forterro)
2. Filer og ETL. Sylob ERP Cloud tilbyder “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Filintegration via SFTP gør det nemt at migrere eksisterende integrationer.) (Sylob) Forespørgselsresultater kan også eksporteres til Excel, hvilket er den hurtige vej til at prøve SkyPlanner.

Sylobs offentlige vidensbase dokumenterer ingen mulighed for at abonnere på udgående webhooks. Ændringer overføres til SkyPlanner ved at polle gemte forespørgsler, der filtrerer på åbne OF’er og seneste ændringer. I fastlægger selv intervallet.

Sylob beskytter ERP-systemet mod tung forespørgselsbelastning. Siden version 2025.Q2 har virksomhedsparameteren “Protection des API” kunnet aktivere begrænsning af kald pr. bruger og sideopdeling af store resultatsæt. Sylob oplyser, at dette bliver standard fra version 2026.Q2. Svar indeholder RateLimit-headere, og et kald, der overskrider kvoten, returnerer HTTP 429 Too Many Requests med en Retry-After-værdi. (Forterro) Tag højde for det i synkroniseringen med inkrementelle forespørgsler, sideopdeling og ventetid før nye forsøg ved 429.

I den modsatte retning sender SkyPlanner webhooks, når status eller planen ændres. Tilbageskrivningen til Sylob er dermed hændelsesstyret.

1. Første indlæsning af stamdata. Opret én gemt forespørgsel pr. objekt (articles, nomenclatures, gammes, arbejdscentre, medarbejdere), og læs dem via Système d’information API. Alternativt kan de indlæses én gang fra en Excel-eksport. Vær omhyggelig med mappingen af arbejdscentre. Et centre de charge i Sylob er en gruppe af ressourcer, så et center med tre maskiner bliver normalt til en arbejdsstationsgruppe med tre arbejdsstationer i SkyPlanner.

2. Ordresynkronisering. Hent fastlagte OF’er med tilhørende operationer samt lagerbeholdninger og åbne indkøbsordrer. SkyPlanner betragter bestilte materialer som tilgængelige på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered. Planlægningen kontrollerer dermed både lagerbeholdning og kommende indkøbsleverancer.

Planlæg fastlagte OF’er, ikke CBN-forslag. Forslagene ændres ved næste nettobehovsberegning.

3. Tilbageskrivning af planen. For hver operation, som planlægningsmotoren har placeret eller flyttet, kalder integrationen en Modification de données-handling på OF-operationen (Opération d’ordre de fabrication) med planlagt start, planlagt slut og arbejdscenter. Handlingen bruger Sylobs egen logik til hurtig redigering, ligesom når en planlægger redigerer operationen. Describe returnerer de felter, der kan redigeres, så integrationen validerer de data, der skal sendes, før det første kald. Hvis en bruger er ved at redigere en post, returneres en forventet fejl. Prøv igen ved næste ændring.

4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer. Start og afslutning sendes tilbage via scenariet “Déclarer un début ou une fin”. Tidsregistreringer og mængder bliver til produktionstilbagemeldinger på den samme OF-operation: omstillingstid, køretid, produceret antal, kassation og afsluttet operation. Hvis fabrikken allerede melder tilbage via Sylob Apps eller terminaler i produktionen, skal I holde jer til én kanal til tilbagemeldinger for at undgå dobbeltregistreringer.

5. Regler for dataejerskab og konflikter. Skriv dem ned inden idriftsættelsen:

SkyPlanner behøver hverken CADPLAN eller Sylobs funktioner til planlægning med begrænset kapacitet. Lad SkyPlanner styre operationsdatoerne, da to planlægningssystemer, der skriver til de samme datoer, overskriver hinandens ændringer. Når SkyPlanner styrer datoerne, omplanlægger Autopilot automatisk ved hver væsentlig ændring, og de nye datoer sendes tilbage til Sylob.

• Licens til Action API. Læsning via gemte forespørgsler er inkluderet. Skrivning via handlingskataloget kræver Sylob-modulet “Webservice” eller en API-licens på MyForterro. Aftal det med jeres Sylob-kontakt, før fasen med tilbageskrivning begynder.
• Forespørgslerne er jeres kontrakt. Læsning af data afhænger af gemte forespørgsler. Giv dem tydelige navne, overfør filtre som variable attributter ved kørsel, og versionsstyr forespørgslerne sammen med integrationen.
• Grupper af arbejdscentre. Ét arbejdscenter i Sylob kan rumme flere maskiner. Beslut for hvert center, om SkyPlanner skal se én gruppe af arbejdsstationer eller de enkelte maskiner.
• Baglæns planlægning og belastningsberegninger. Sylob planlægger baglæns fra behovsdatoer, og en tidsstyret belastningsberegning kan omplanlægge forsinkede OF’er. Aftal, om nogen funktion fortsat skal skrive operationsdatoer, når SkyPlanner har overtaget ansvaret, og i så fald hvilken.
• Enheder for omstillings- og køretid. Kontrollér enhederne, og om omstillingen gælder pr. OF eller pr. emne, før importen. Forkerte enheder giver fejl i alle varigheder.
• Kalendere. Arbejdscentrenes ugemønstre og undtagelser skal dække hele planlægningshorisonten, ellers forsvinder kapacitet fra planen.
• Begrænsning af kald. Sylob begrænser antallet af kald pr. bruger og opdeler store resultater i sider. Inkrementel polling holder sig et godt stykke under kvoten.
• CORS og browsere. Kald mellem servere er ikke omfattet af CORS. For browserklienter skal tilladte origins konfigureres i Sylob.