Guide till integration av Sylob ERP för produktionsplanering med SkyPlanner APS

Sylob dokumenterar två publika 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 exponerar två typer av publika REST API, även kallade webbtjänster, för läsning och skrivning av data.) (Forterros kunskapsbas)

1. API REST Système d’information (läsning). Det kör en sparad fråga (requête) som skapats i aktiviteten ”Interroger le système d’information”. Frågans anrops-URL hämtas via ”Autres actions” > ”Afficher le web service” och har formen /rest/query/{identifiantQuery}/resultat. Parametrar styr resultatgräns, talformat, frågevariabler och resultatstruktur. Resultaten returneras som XML som standard, eller som JSON med headern Accept: application/json. Detta API ingår i ERP-systemet.
2. API REST Action (läsning och skrivning). Det kör en åtgärd som definierats i aktiviteten ”Gérer les actions web service”, Sylobs åtgärdskatalog. Det exponerar två operationer: GET /rest/v2/action/{code}/describe returnerar dataschemat för en åtgärd och POST /rest/v2/action/{code}/execute kör den med en JSON-kropp. Åtgärdstyperna omfattar:

– Modification de données: ändrar ett eller flera fält i en post via Sylobs funktion för snabbredigering. Describe listar de redigerbara fälten. – Message EDI: skapar, ändrar eller tar bort poster via ett EDI-meddelande. – Scénario de saisie: kör ett inmatningsscenario, fråga för fråga. Sylobs eget exempel är ”Déclarer un début ou une fin”, som rapporterar start eller avslut för en operation (Sylob_Action_006). – Publicering, uppladdning och nedladdning av dokument.

1. EDI-meddelanden. Sylobs EDI-motor hanterar export och import. Standardmeddelandet Sylob_Recup_Decl_Pro hämtar produktionsrapportering. (Forterro)
2. Filer och ETL. Sylob ERP Cloud erbjuder ”Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Filintegration via SFTP för enkel migrering av befintliga integrationer.) (Sylob) Frågeresultat kan också exporteras till Excel, vilket är en snabb väg att prova SkyPlanner.

Sylobs publika kunskapsbas dokumenterar ingen möjlighet att prenumerera på utgående webhooks. Ändringar når SkyPlanner genom pollning av sparade frågor som filtrerar på öppna OF och senaste ändringar. Ni bestämmer intervallet.

Sylob skyddar ERP-systemet mot hög frågebelastning. Sedan version 2025.Q2 kan företagsparametern ”Protection des API” aktivera anropsbegränsning per användare och sidindelning av stora resultat. Sylob anger att detta tillämpas generellt från version 2026.Q2. Svaren innehåller RateLimit-headers. Ett anrop som överskrider kvoten returnerar HTTP 429 Too Many Requests med ett Retry-After-värde. (Forterro) Utforma synkroniseringen för detta: använd inkrementella frågor, sidindelning och ökande väntetid vid 429.

I den andra riktningen skickar SkyPlanner webhooks när status eller planeringen ändras. Återskrivningen till Sylob är alltså händelsestyrd.

1. Första inläsning av grunddata. Skapa en sparad fråga per objekt (artiklar, produktstrukturer, beredningar, produktionsgrupper, anställda) och läs in dem via Système d’information API, eller gör en engångsinläsning från en Excel-export. Mappa produktionsgrupperna med omsorg. Ett centre de charge i Sylob är en grupp resurser. En grupp med tre maskiner blir därför vanligtvis en grupp med tre produktionsgrupper i SkyPlanner.

2. Ordersynkronisering. Läs in fastställda OF med tillhörande operationer samt lagersaldon och öppna inköpsorder. SkyPlanner betraktar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagersaldot när inköpsordern markeras som Delivered. Planeringen kontrollerar alltså både befintligt lager och kommande inköp.

Planera fastställda OF, inte CBN-förslag. Förslagen ändras vid nästa nettobehovsberäkning.

3. Återskrivning av planeringen. För varje operation som planeringsmotorn har lagt in eller flyttat anropar integrationen en Modification de données-åtgärd på OF-operationen (Opération d’ordre de fabrication) med planerad start, planerad sluttid och produktionsgrupp. Åtgärden använder Sylobs egen snabbredigeringslogik, precis som när en planerare redigerar operationen. Describe returnerar de redigerbara fälten, så integrationen validerar sina anropsdata före det första anropet. Om en användare redigerar posten returneras ett förväntat fel. Försök igen vid nästa ändring.

4. Rapportering från produktionen. Operatörerna registrerar arbete med SkyPlanner Mobile Confirmations eller Production Timer. Start och avslut skickas tillbaka via scenariot ”Déclarer un début ou une fin”. Tidregistreringar och kvantiteter blir produktionsrapportering på samma OF-operation: ställtid, körtid, tillverkad kvantitet, kassation och avslutad operation. Om fabriken redan rapporterar via Sylob Apps eller produktionsterminaler ska ni behålla en enda rapporteringskanal för att undvika dubbelregistrering.

5. Regler för dataägarskap och konflikter. Dokumentera reglerna före driftstart:

SkyPlanner behöver varken CADPLAN eller Sylobs aktiviteter för finplanering. Låt SkyPlanner styra operationsdatumen, eftersom två planeringssystem som skriver samma datum skriver över varandras uppgifter. När SkyPlanner styr datumen planerar Autopilot automatiskt om vid varje betydande förändring, och de nya datumen skickas tillbaka till Sylob.

• Licens för Action API. Läsning via sparade frågor ingår. För att skriva via åtgärdskatalogen krävs Sylob-modulen ”Webservice” eller en API-licens på MyForterro. Planera detta med er Sylob-kontakt innan återföringen ska införas.
• Frågorna utgör ert gränssnittskontrakt. Läsningen bygger på sparade frågor. Ge dem tydliga namn, skicka filter som variabla attribut vid körning och versionshantera frågorna tillsammans med integrationen.
• Gruppering av maskiner. En produktionsgrupp i Sylob kan innehålla flera maskiner. Bestäm för varje produktionsgrupp om den ska visas som en samlad grupp eller som enskilda maskiner i SkyPlanner.
• Bakåtplanering och beläggningsberäkningar. Sylob planerar bakåt från behovsdatumen, och en schemalagd beläggningsberäkning kan planera om försenade OF. Kom överens om vilken aktivitet, om någon, som fortfarande ska skriva operationsdatum när SkyPlanner har tagit över ansvaret för dem.
• Enheter för ställtid och körtid. Kontrollera enheterna och om ställtiden anges per OF eller per styck före importen. Fel enheter gör alla tidsåtgångar felaktiga.
• Kalendrar. Produktionsgruppernas veckoscheman och undantag måste täcka hela planeringshorisonten, annars försvinner kapacitet ur planen.
• Anropsbegränsning. Sylob begränsar antalet anrop per användare och delar upp stora resultat i sidor. Inkrementell pollning håller sig väl inom kvoten.
• CORS och webbläsare. Anrop mellan servrar berörs inte av CORS. För webbläsarklienter måste tillåtna ursprung konfigureras i Sylob.