Veiledning for integrasjon av Sylob ERP med SkyPlanner APS for produksjonsplanlegging

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 tilbyr to typer offentlige REST API-er, også kalt webtjenester, som tillater lesing og skriving av data.) (Forterros kunnskapsbase)

1. API REST Système d’information (lesing). Dette API-et kjører en lagret spørring (requête) som er opprettet i aktiviteten «Interroger le système d’information». Spørringens egen URL for API-kall hentes fra «Autres actions» > «Afficher le web service» og har formen /rest/query/{identifiantQuery}/resultat. Parametere angir resultatgrense, tallformat, spørringsvariabler og resultatstruktur. Resultatene returneres som XML som standard, eller som JSON med headeren Accept: application/json. Dette API-et følger med ERP-systemet.
2. API REST Action (lesing og skriving). Dette API-et kjører en handling som er definert i aktiviteten «Gérer les actions web service», Sylobs handlingskatalog. Det tilbyr to operasjoner: GET /rest/v2/action/{code}/describe returnerer dataskjemaet for en handling, og POST /rest/v2/action/{code}/execute kjører handlingen med en JSON-kropp. Handlingstypene omfatter:

– Modification de données: endrer ett eller flere felt i en post via Sylobs hurtigredigering. Describe viser hvilke felt som kan redigeres. – Message EDI: oppretter, endrer eller sletter poster via en EDI-melding. – Scénario de saisie: kjører et registreringsscenario, spørsmål for spørsmål. Sylobs eget eksempel er «Déclarer un début ou une fin», som rapporterer start eller slutt på en operasjon (Sylob_Action_006). – Publisering, opplasting og nedlasting av dokumenter.

1. EDI-meldinger. Sylobs EDI-motor håndterer eksport og import. Standardmeldingen Sylob_Recup_Decl_Pro henter produksjonsrapportering. (Forterro)
2. Filer og ETL. Sylob ERP Cloud tilbyr «Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.» (Filintegrasjon via SFTP for enkel migrering av eksisterende integrasjoner.) (Sylob) Spørringsresultater kan også eksporteres til Excel. Det er en rask vei til å prøve SkyPlanner.

Sylobs offentlige kunnskapsbase dokumenterer ingen abonnementsløsning for utgående webhooks. Endringer hentes til SkyPlanner ved polling av lagrede spørringer som filtrerer på åpne OF-er og nylige endringer, med intervaller du selv angir.

Sylob beskytter ERP-systemet mot tunge spørringer. Fra versjon 2025.Q2 aktiverer selskapsparameteren «Protection des API» trafikkbegrensning per bruker og sideinndeling av store resultatsett. Sylob opplyser at dette innføres som fast ordning fra versjon 2026.Q2. Svarene inneholder RateLimit-headere, og kall som overskrider kvoten, returnerer HTTP 429 Too Many Requests med en Retry-After-verdi. (Forterro) Ta høyde for dette i synkroniseringen: bruk inkrementelle spørringer, sideinndeling og økt ventetid før nye forsøk ved 429.

I motsatt retning sender SkyPlanner webhooks når tilstanden eller planen endres. Tilbakeskrivingen til Sylob er dermed hendelsesstyrt.

1. Førstegangsinnlasting av grunndata. Opprett én lagret spørring per objekt (artikler, nomenclatures, gammes, arbeidssentre, ansatte), og les dem via Système d’information API. Alternativt kan du laste dem inn én gang fra en Excel-eksport. Vær bevisst på hvordan arbeidssentrene kobles. Et centre de charge i Sylob er en gruppe ressurser. Et senter med tre maskiner blir derfor vanligvis en arbeidsstasjonsgruppe med tre arbeidsstasjoner i SkyPlanner.

2. Ordresynkronisering. Hent bekreftede OF-er med tilhørende operasjoner, samt lagerbeholdning og åpne innkjøpsordrer. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered. Planleggingen kontrollerer dermed både lagerbeholdning og innkommende innkjøp.

Planlegg bekreftede OF-er, ikke CBN-forslag. Forslagene endres ved neste nettobehovsberegning.

3. Tilbakeskriving av planen. For hver operasjon som planleggingsmotoren har plassert eller flyttet, kaller integrasjonen en Modification de données-handling på OF-operasjonen (Opération d’ordre de fabrication) med planlagt start, planlagt slutt og arbeidssenter. Handlingen bruker Sylobs egen logikk for hurtigredigering, akkurat som når en planlegger redigerer operasjonen. Describe returnerer feltene som kan redigeres, slik at integrasjonen validerer dataene som skal sendes før det første kallet. Hvis en bruker redigerer posten, returneres en forventet feil. Prøv igjen ved neste endring.

4. Rapportering fra produksjonen. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer. Start og slutt sendes tilbake via scenarioet «Déclarer un début ou une fin». Tidsregistreringer og antall blir til produksjonsrapportering på samme OF-operasjon: omstillingstid, kjøretid, produsert antall, vrak og fullført operasjon. Hvis fabrikken allerede rapporterer via Sylob Apps eller terminaler i produksjonen, hold dere til én rapporteringskanal for å unngå dobbeltregistreringer.

5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:

SkyPlanner trenger verken CADPLAN eller Sylobs funksjoner for planlegging med begrenset kapasitet. La SkyPlanner styre datoene for operasjonene. Hvis to planleggingssystemer skriver til de samme datofeltene, overskriver de hverandre. Når SkyPlanner styrer datoene, oppdaterer Autopilot planen automatisk ved alle vesentlige endringer, og de nye datoene sendes tilbake til Sylob.

• Lisens for Action API. Lesing via lagrede spørringer er inkludert. Skriving via handlingskatalogen krever Sylob-modulen «Webservice» eller en API-lisens på MyForterro. Avklar dette med Sylob-kontakten din før fasen med tilbakeskriving.
• Spørringene er grensesnittkontrakten. Lesingen er avhengig av lagrede spørringer. Gi dem tydelige navn, send filtre som variable attributter ved kjøring, og versjoner spørringene sammen med integrasjonen.
• Grupper i arbeidssentre. Ett arbeidssenter i Sylob kan inneholde flere maskiner. Avgjør for hvert senter om SkyPlanner skal se én gruppe med arbeidsstasjoner eller enkeltmaskiner.
• Bakoverplanlegging og belastningsberegninger. Sylob planlegger bakover fra behovsdatoene, og en tidsstyrt belastningsberegning kan omplanlegge forsinkede OF-er. Avtal hvilke funksjoner som eventuelt fortsatt skal skrive datoer for operasjonene når SkyPlanner har overtatt styringen.
• Enheter for omstillings- og kjøretid. Kontroller enhetene og om omstillingstiden gjelder per OF eller per stykk før import. Feil enheter gir feil i alle varigheter.
• Kalendere. Arbeidssentrenes ukemønstre og unntak må dekke hele planleggingshorisonten. Ellers forsvinner kapasitet fra planen.
• Begrensning av kall. Sylob begrenser antall kall per bruker og deler store resultatsett inn i sider. Inkrementell polling holder seg godt innenfor kvoten.
• CORS og nettlesere. CORS gjelder ikke for kall mellom servere. For nettleserklienter må tillatte opphav konfigureres på Sylob-siden.