Ghid de integrare Sylob ERP pentru programarea producției cu SkyPlanner APS

Sylob documentează două API-uri REST publice: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (ERP-ul Sylob pune la dispoziție două tipuri de API-uri REST publice, numite și „servicii web”, care permit citirea și scrierea datelor.) (Baza de cunoștințe Forterro)

1. API REST Système d’information (citire). Execută o interogare salvată (requête), creată în activitatea “Interroger le système d’information”. URL-ul de apel al interogării se obține din “Autres actions” > “Afficher le web service” și are forma /rest/query/{identifiantQuery}/resultat. Parametrii stabilesc limita de rezultate, formatarea numerelor, variabilele interogării și structura rezultatelor. Rezultatele sunt returnate implicit în format XML sau în format JSON dacă se folosește antetul Accept: application/json. Acest API este inclus în ERP.
2. API REST Action (citire și scriere). Execută o acțiune definită în activitatea “Gérer les actions web service”, catalogul de acțiuni Sylob. Pune la dispoziție două operații: GET /rest/v2/action/{code}/describe returnează schema de date a unei acțiuni, iar POST /rest/v2/action/{code}/execute o execută folosind un corp de cerere JSON. Tipurile de acțiuni includ:

– Modification de données: modifică unul sau mai multe câmpuri ale unei înregistrări prin mecanismul de editare rapidă din Sylob. Describe listează câmpurile care pot fi editate. – Message EDI: creează, modifică sau șterge înregistrări printr-un mesaj EDI. – Scénario de saisie: execută un scenariu de introducere a datelor, întrebare cu întrebare. Exemplul oferit de Sylob este “Déclarer un début ou une fin”, pentru declararea începutului sau sfârșitului unei operații (Sylob_Action_006). – Publicarea, încărcarea și descărcarea documentelor.

1. Mesaje EDI. Motorul EDI din Sylob gestionează exporturile și importurile. Un mesaj standard, Sylob_Recup_Decl_Pro, preia declarațiile de producție. (Forterro)
2. Fișiere și ETL. Sylob ERP Cloud oferă “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Integrarea fișierelor prin SFTP pentru migrarea ușoară a integrărilor existente.) (Sylob) Rezultatele interogărilor pot fi exportate și în Excel, o modalitate rapidă de a începe testarea SkyPlanner.

Baza publică de cunoștințe Sylob nu documentează niciun mecanism de abonare la webhook-uri de ieșire. Modificările ajung în SkyPlanner prin executarea periodică a unor interogări salvate care filtrează OF-urile deschise și modificările recente, la intervale stabilite de dumneavoastră.

Sylob protejează ERP-ul împotriva interogărilor excesive. Începând cu versiunea 2025.Q2, parametrul de companie “Protection des API” activează limitarea apelurilor pe utilizator și paginarea rezultatelor voluminoase. Sylob anunță aplicarea sistematică a acestei protecții începând cu versiunea 2026.Q2. Răspunsurile includ antete RateLimit, iar un apel care depășește cota returnează HTTP 429 Too Many Requests cu o valoare Retry-After. (Forterro) Proiectați sincronizarea în consecință: interogări incrementale, paginare și temporizarea reîncercărilor la răspunsul 429.

În sens invers, SkyPlanner trimite webhook-uri când se schimbă starea sau programul de producție, astfel încât scrierea datelor înapoi în Sylob este declanșată de evenimente.

1. Încărcarea inițială a nomenclatoarelor. Creați câte o interogare salvată pentru fiecare obiect (articole, liste de materiale, fișe tehnologice, centre de lucru, angajați) și citiți datele prin API-ul Système d’information sau încărcați-le o singură dată dintr-un export Excel. Stabiliți cu atenție corespondența dintre centrele de lucru. În Sylob, un centre de charge este un grup de resurse, așa că un centru cu trei utilaje devine de obicei un grup cu trei centre de lucru în SkyPlanner.

2. Sincronizarea comenzilor. Citiți OF-urile ferme împreună cu operațiile lor, precum și stocurile și comenzile de achiziție deschise. SkyPlanner consideră materialul comandat disponibil la data de livrare a comenzii de achiziție și actualizează stocul când comanda este marcată Delivered. Astfel, programarea ține cont atât de stoc, cât și de achizițiile care urmează să fie recepționate.

Programați OF-urile ferme, nu propunerile CBN. Propunerile se schimbă la următoarea rulare a calculului necesarului net.

3. Scrierea programului de producție înapoi în Sylob. Pentru fiecare operație programată sau mutată de motor, integrarea apelează o acțiune Modification de données asupra operației OF (Opération d’ordre de fabrication), cu începutul planificat, sfârșitul planificat și centrul de lucru. Acțiunea folosește logica de editare rapidă din Sylob, la fel ca atunci când un planificator editează operația. Describe returnează câmpurile care pot fi editate, astfel încât integrarea validează conținutul cererii înainte de primul apel. Dacă un utilizator editează înregistrarea, este returnată o eroare prevăzută; reîncercați la următoarea modificare.

4. Declarații de producție din atelier. Operatorii își înregistrează activitatea folosind SkyPlanner Mobile Confirmations sau Production Timer. Începutul și sfârșitul sunt transmise înapoi prin scenariul “Déclarer un début ou une fin”. Pontajele și cantitățile devin declarații de producție pentru aceeași operație OF: timp de reglaj, timp de execuție, cantitate produsă, rebuturi și operație finalizată. Dacă fabrica dumneavoastră face deja declarații prin Sylob Apps sau prin terminalele din atelier, păstrați un singur canal de declarare pentru a evita înregistrările duble.

5. Responsabilitatea asupra datelor și regulile pentru conflicte. Documentați-le înainte de punerea în funcțiune:

SkyPlanner nu are nevoie de CADPLAN sau de activitățile de programare cu capacitate finită din Sylob. Lăsați SkyPlanner să gestioneze datele operațiilor: dacă două sisteme de programare scriu aceleași date, se suprascriu reciproc. Odată ce SkyPlanner preia această responsabilitate, Autopilot reprogramează automat la fiecare schimbare semnificativă, iar noile date sunt trimise înapoi în Sylob.

• Licența Action API. Citirea prin interogări salvate este inclusă. Scrierea prin catalogul de acțiuni necesită modulul Sylob “Webservice” sau o licență API pe MyForterro. Stabiliți acest aspect cu persoana de contact Sylob înainte de etapa de transmitere a datelor către Sylob.
• Interogările definesc contractul de integrare. Citirea datelor depinde de interogările salvate. Dați-le nume clare, transmiteți filtrele ca atribute variabile la execuție și gestionați versiunile interogărilor împreună cu cele ale integrării.
• Grupuri de centre de lucru. Un centru de lucru Sylob poate cuprinde mai multe utilaje. Decideți pentru fiecare centru dacă în SkyPlanner va apărea un grup de centre de lucru sau utilajele individuale.
• Programarea înapoi și calculele de încărcare. Sylob programează înapoi pornind de la datele de necesar, iar un calcul de încărcare programat poate reprograma OF-urile întârziate. Stabiliți dacă vreo activitate va mai scrie datele operațiilor după ce SkyPlanner preia gestionarea lor și, dacă da, care.
• Unitățile pentru timpii de reglaj și de execuție. Înainte de import, verificați unitățile și dacă reglajul se aplică per OF sau per piesă. Unitățile greșite denaturează toate duratele.
• Calendare. Programele săptămânale ale centrelor de lucru și excepțiile trebuie să acopere orizontul de programare; altfel, capacitatea dispare din plan.
• Limitarea apelurilor. Sylob limitează apelurile per utilizator și paginează rezultatele mari. Interogarea periodică incrementală menține consumul mult sub limita alocată.
• CORS și browsere. Apelurile între servere evită restricțiile CORS. Pentru clienții din browser, originile permise trebuie configurate în Sylob.