Handleiding voor de Sylob ERP-koppeling voor productieplanning met SkyPlanner APS

Sylob documenteert twee openbare REST API’s: “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 biedt twee soorten openbare REST API’s, ook wel webservices genoemd, waarmee gegevens kunnen worden gelezen en geschreven.) (Forterro-kennisbank)

1. API REST Système d’information (lezen). Deze voert een opgeslagen query (requête) uit die is aangemaakt in de activiteit “Interroger le système d’information”. De aanroep-URL van de query vindt u via “Autres actions” > “Afficher le web service” en heeft de vorm /rest/query/{identifiantQuery}/resultat. Parameters bepalen de resultaatlimiet, getalnotatie, queryvariabelen en resultaatstructuur. Resultaten worden standaard als XML geleverd, of als JSON met de header Accept: application/json. Deze API is inbegrepen bij het ERP.
2. API REST Action (lezen en schrijven). Deze voert een actie uit die is gedefinieerd in de activiteit “Gérer les actions web service”, de actiecatalogus van Sylob. De API biedt twee bewerkingen: GET /rest/v2/action/{code}/describe geeft het gegevensschema van een actie terug en POST /rest/v2/action/{code}/execute voert de actie uit met een JSON-body. Ondersteunde actietypen zijn onder meer:

– Modification de données: wijzigt één of meer velden van een record via de snelbewerkingsfunctie van Sylob. Describe geeft een overzicht van de bewerkbare velden. – Message EDI: maakt records aan, wijzigt ze of verwijdert ze via een EDI-bericht. – Scénario de saisie: voert een invoerscenario uit, vraag voor vraag. Sylob gebruikt zelf het voorbeeld “Déclarer un début ou une fin”, waarmee de start of het einde van een bewerking wordt gemeld (Sylob_Action_006). – Documenten publiceren, uploaden en downloaden.

1. EDI-berichten. De EDI-engine van Sylob verzorgt de export en import. Het standaardbericht Sylob_Recup_Decl_Pro haalt productiemeldingen op. (Forterro)
2. Bestanden en ETL. Sylob ERP Cloud biedt “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Bestandsintegratie via SFTP om bestaande koppelingen eenvoudig te migreren.) (Sylob) Queryresultaten kunnen ook naar Excel worden geëxporteerd. Dat is een snelle manier om met de proefversie van SkyPlanner aan de slag te gaan.

De openbare kennisbank van Sylob documenteert geen mogelijkheid om u op uitgaande webhooks te abonneren. Wijzigingen bereiken SkyPlanner via polling van opgeslagen query’s die filteren op openstaande OF’s en recente wijzigingen. U bepaalt zelf hoe vaak dit gebeurt.

Sylob beschermt het ERP tegen zware querybelasting. Sinds release 2025.Q2 schakelt de bedrijfsparameter “Protection des API” throttling per gebruiker en paginering van grote resultaatsets in. Sylob kondigt aan dit vanaf release 2026.Q2 standaard toe te passen. Responses bevatten RateLimit-headers. Bij overschrijding van het quotum retourneert een aanroep HTTP 429 Too Many Requests met een Retry-After-waarde. (Forterro) Houd hier rekening mee bij het inrichten van de synchronisatie: gebruik incrementele query’s, paginering en backoff bij 429.

Omgekeerd verstuurt SkyPlanner webhooks zodra de status of planning verandert. Het terugschrijven naar Sylob is daardoor eventgestuurd.

1. Eerste import van stamgegevens. Maak per object één opgeslagen query aan (artikelen, stuklijsten, bewerkingsroutes, werkcentra, medewerkers) en lees deze uit via de Système d’information API. U kunt de gegevens ook eenmalig uit een Excel-export laden. Bepaal zorgvuldig hoe u werkcentra koppelt. Een centre de charge in Sylob is een groep resources. Een centrum met drie machines wordt in SkyPlanner daarom meestal een werkcentrumgroep met drie werkcentra.

2. Ordersynchronisatie. Lees vaste OF’s met hun bewerkingen in, samen met de voorraad en openstaande inkooporders. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt. De planning houdt dus rekening met zowel de voorraad als verwachte inkoopleveringen.

Plan vaste OF’s in, geen CBN-voorstellen. Die voorstellen veranderen bij de volgende nettobehoefteberekening.

3. Planning terugschrijven. Voor elke bewerking die de planningsengine heeft ingepland of verplaatst, roept de koppeling een Modification de données-actie aan op de OF-bewerking (Opération d’ordre de fabrication), met de geplande start, het geplande einde en het werkcentrum. De actie gebruikt de snelbewerkingslogica van Sylob zelf, net als wanneer een planner de bewerking wijzigt. Describe geeft de bewerkbare velden terug, zodat de koppeling de payload vóór de eerste aanroep valideert. Als een gebruiker een record aan het bewerken is, volgt een voorziene foutmelding. Probeer het bij de volgende wijziging opnieuw.

4. Meldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De start en het einde worden teruggestuurd via het scenario “Déclarer un début ou une fin”. Tijdregistraties en hoeveelheden worden productiemeldingen op dezelfde OF-bewerking: insteltijd, bewerkingstijd, geproduceerde hoeveelheid, uitval en bewerking afgerond. Als uw fabriek al meldingen doorgeeft via Sylob Apps of werkvloerterminals, houd het dan bij één meldingskanaal om dubbele registraties te voorkomen.

5. Gegevenseigenaarschap en conflictregels. Leg deze vóór ingebruikname vast:

SkyPlanner heeft CADPLAN of de activiteiten voor capaciteitsplanning van Sylob niet nodig. Laat SkyPlanner de bewerkingsdatums beheren: als twee planningssystemen dezelfde datums schrijven, overschrijven ze elkaar. Zodra SkyPlanner deze datums beheert, plant Autopilot bij elke relevante wijziging automatisch opnieuw en gaan de nieuwe datums terug naar Sylob.

• Licentie voor de Action API. Lezen via opgeslagen query’s is inbegrepen. Voor schrijven via de actiecatalogus is de Sylob-module “Webservice” of een API-licentie op MyForterro nodig. Regel dit met uw Sylob-contactpersoon voordat de fase voor het terugschrijven begint.
• Query’s vormen het contract van de koppeling. Het uitlezen is afhankelijk van opgeslagen query’s. Geef ze duidelijke namen, geef filters tijdens de uitvoering mee als variabele attributen en neem de query’s mee in het versiebeheer van de koppeling.
• Werkcentrumgroepen. Eén Sylob-werkcentrum kan meerdere machines bevatten. Bepaal per centrum of SkyPlanner dit als één werkcentrumgroep of als afzonderlijke machines ziet.
• Achterwaarts plannen en belasting berekenen. Sylob plant achterwaarts vanaf de behoeftedatums. Een ingeplande belastingsberekening kan te late OFs opnieuw inplannen. Spreek af of er nog een activiteit bewerkingsdatums mag schrijven zodra SkyPlanner ze beheert, en zo ja, welke.
• Eenheden voor instel- en bewerkingstijden. Controleer vóór de import de eenheden en of de insteltijd per OF of per stuk geldt. Verkeerde eenheden vertekenen elke tijdsduur.
• Kalenders. De weekpatronen en uitzonderingen van werkcentra moeten de volledige planningshorizon bestrijken. Anders verdwijnt er capaciteit uit de planning.
• Aanroepbeperking. Sylob beperkt het aantal aanroepen per gebruiker en verdeelt grote resultaten over pagina’s. Met incrementele polling blijft u ruim binnen de limiet.
• CORS en browsers. Bij server-naar-serveraanroepen speelt CORS geen rol. Voor browserclients moeten de toegestane origins aan de Sylob-kant worden ingesteld.