Ghid de integrare Exact Online pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Exact Online le arată partenerilor Exact și echipelor IT cum să conecteze Exact Online Manufacturing la SkyPlanner APS. Integrarea SkyPlanner cu Exact Online funcționează în ambele sensuri:
- Comenzile de producție, etapele fluxului tehnologic, planurile de materiale, centrele de lucru, operațiile și listele de materiale sunt preluate prin REST API din Exact Online.
- Sunt preluate articolele, situația stocurilor, comenzile de achiziție și comenzile de vânzare, iar modificările sunt transmise prin webhooks din Exact Online.
- Datele planificate de început și de sfârșit sunt trimise înapoi pentru fiecare etapă a fluxului tehnologic și pentru comanda de producție.
- Pontajele operatorilor sunt înregistrate ca tranzacții de timp, iar cantitățile finalizate, ca recepții aferente comenzilor de producție.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră Exact Online în etapa de implementare și asigură suport după punerea în funcțiune. Acest ghid se adresează partenerilor și dezvoltatorilor care doresc să participe sau să dezvolte singuri integrarea folosind REST API documentat al SkyPlanner (documentația API). La final se află o scurtă secțiune despre Exact Globe+.
REST API din Exact Online pentru producție
Exact Online pune datele la dispoziție printr-un singur REST API, cu resurse grupate pe servicii. Calea de bază este /api/v1/{division}/<service>/<resource>, unde division reprezintă compania din Exact Online. Documentația REST API enumeră următoarele resurse ale serviciului manufacturing, utile pentru programarea producției:
| Resursă | Date conținute | Metode |
|---|---|---|
manufacturing/ShopOrders | Numărul comenzii de producție, articolul, PlannedQuantity, PlannedStartDate, PlannedDate, starea, indicatorul de lansare | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Etapa fluxului tehnologic pentru fiecare comandă de producție: operația, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Pozițiile de materiale pentru fiecare comandă de producție | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Cod, tip, zonă de producție, valoarea capacității, tarife | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operațiile și centrul de lucru la care se execută fiecare, timpii de pregătire și de execuție | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Versiunile BOM, componentele și fluxul tehnologic | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Orele înregistrate pentru fiecare comandă de producție și etapă a fluxului tehnologic | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Cantitățile finalizate recepționate dintr-o comandă de producție | GET, POST |
manufacturing/MaterialIssues | Materialele eliberate pentru o comandă de producție | GET, POST |
manufacturing/ShopOrderPriorities | Modul de prioritizare pentru fiecare comandă de producție | GET, PUT |
Din celelalte servicii:
| Resursă | Date conținute |
|---|---|
logistics/Items | Nomenclatorul de articole |
inventory/ItemWarehouses | Stocul pe articol și depozit |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Comenzile de achiziție deschise și datele de recepție |
salesorder/SalesOrders, SalesOrderLines | Cererea clienților și datele de livrare |
Autentificare și acces
Exact Online folosește OAuth 2.0 cu fluxul authorization code și tokenuri de reîmprospătare. Exact precizează: “Before you can start integration with Exact Online, you must first register your app in the App Store.” (Înainte de a începe integrarea cu Exact Online, trebuie să vă înregistrați aplicația în App Store.) (Ajutor Exact Online) Pentru înregistrarea aplicațiilor este necesar un abonament Exact Online Developer (Exact App Store).
- Integrarea este înregistrată ca aplicație, cu un URI de redirecționare.
- Un utilizator Exact Online cu acces la producție, stocuri și achiziții își dă consimțământul o singură dată.
- Fiecare cerere trimite
Authorization: Bearer <access_token>și include divizia în cale. - Tokenurile de acces sunt reînnoite cu ajutorul tokenului de reîmprospătare. Exact limitează frecvența cu care poate fi solicitat un token nou, așa că păstrați tokenul în cache până la expirare.
Exact limitează și numărul de apeluri pe minut și pe zi pentru fiecare aplicație și companie și solicită apeluri secvențiale, nu paralele. Limitele actuale se găsesc în articolul Exact despre limitele API. Integrarea este concepută pentru a le respecta: citiri filtrate cu $filter și $select și Sync API pentru modificări în masă.
În SkyPlanner, autentificarea REST API se face cu un token API în antetul Authorization-Token (SkyPlanner Settings > API), iar documentația este disponibilă în Swagger/OpenAPI. Tutorialul de integrare vă ghidează prin primele apeluri.
Webhooks și interogare periodică
Mecanismele webhook din Exact Online trimit o cerere POST la URL-ul dumneavoastră de callback când se modifică un subiect la care v-ați abonat. Cererea este semnată cu un hash HMAC SHA256 (webhooks). Printre subiecte se numără Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders și SalesOrderLines. Acestea transmit către SkyPlanner modificările stocurilor, achizițiilor și cererii pe măsură ce apar.
Comenzile de producție și etapele fluxului tehnologic sunt citite la intervale programate. Filtrați ShopOrders și ShopOrderRoutingStepPlans după Modified și folosiți Sync API pentru citiri în masă (restricții API).
SkyPlanner trimite propriile notificări webhook când se modifică programul de producție, astfel încât scrierea înapoi în Exact Online este declanșată de evenimente.
Maparea datelor
| Resursă Exact Online | Obiect SkyPlanner | Sens | Frecvență |
|---|---|---|---|
Items | Produse și materiale | Exact Online → SkyPlanner | Încărcare, apoi prin webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Structura produsului, subproduse, materiale pentru fiecare produs | Exact Online → SkyPlanner | La modificare |
Workcenters, OperationResources | Centre de lucru, grupuri de centre de lucru | Exact Online → SkyPlanner | Încărcare inițială |
Operations, BillOfMaterialRoutings | Etape de proces cu timpi de pregătire și de execuție | Exact Online → SkyPlanner | La modificare |
ShopOrders | Comenzi cu cantitate și termen de finalizare | Exact Online → SkyPlanner | O dată la câteva minute |
ShopOrderRoutingStepPlans | Operații cu ordine de execuție, centru de lucru, ore de pregătire și de execuție | Exact Online → SkyPlanner | O dată la câteva minute |
ShopOrderMaterialPlans | Materiale pentru fiecare operație | Exact Online → SkyPlanner | O dată la câteva minute |
ItemWarehouses, StockPosition | Solduri de stoc | Exact Online → SkyPlanner | Prin webhook |
PurchaseOrderLines | Comenzi de achiziție cu data estimată de livrare | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Termenele de livrare către clienți și prioritatea | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Începutul, sfârșitul și centrul de lucru planificate pentru fiecare operație | SkyPlanner → Exact Online | La modificare, prin webhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Începutul și sfârșitul comenzii | SkyPlanner → Exact Online | La modificare, prin webhook |
TimeTransactions (POST) | Pontaje și confirmări ale operatorilor | SkyPlanner → Exact Online | La fiecare confirmare sau la fiecare schimb |
ShopOrderReceipts (POST) | Cantitatea finalizată la ultima operație | SkyPlanner → Exact Online | La fiecare confirmare |
| Nu sunt stocate în Exact Online | Matricea timpilor de pregătire, scule ca resurse cu capacitate finită, operatori pe operație, centre de lucru alternative, schimburi | Gestionate în SkyPlanner | Configurare inițială |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți Workcenters, Operations și OperationResources, apoi articolele și versiunile BOM cu fluxurile lor tehnologice. Un centru de lucru cu trei utilaje devine trei centre de lucru sau un grup de centre de lucru. Schimburile, absențele și orele suplimentare se configurează în SkyPlanner, deoarece centrul de lucru din Exact are o singură valoare a capacității.
2. Sincronizarea comenzilor. Citiți înregistrările ShopOrders deschise, împreună cu ShopOrderRoutingStepPlans și ShopOrderMaterialPlans aferente, precum și stocurile și liniile comenzilor de achiziție. La programare se verifică atât stocurile, cât și achizițiile care urmează să fie recepționate. MRP continuă să ofere recomandări de comenzi în Exact Online, iar SkyPlanner programează comenzile de producție pe care le creați.
3. Scrierea programului înapoi în Exact Online. Pentru fiecare operație din fluxul tehnologic pe care motorul a programat-o sau a mutat-o, SkyPlanner trimite o cerere PUT către ShopOrderRoutingStepPlans, cu PlannedStartDate, PlannedEndDate și Workcenter. Câmpurile PlannedStartDate și PlannedDate ale comenzii de producție reflectă prima și ultima operație. Cantitățile, planurile de materiale și calculul costurilor rămân în Exact Online.
4. Confirmări din secția de producție. Operatorii înregistrează lucrul efectuat cu SkyPlanner Mobile Confirmations sau Production Timer, iar pontajele mențin programul la zi. Orele înregistrate sunt transmise ca TimeTransactions pentru comanda de producție și operația aferentă, ca timp de pregătire sau de execuție. Confirmarea finală transmite o înregistrare ShopOrderReceipts pentru cantitatea finalizată. Dacă fabrica dumneavoastră înregistrează deja timpul în Shop Floor Control, alegeți un singur canal de înregistrare.
5. Reguli de responsabilitate pentru date și de rezolvare a conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Articole, BOM, cantități ale comenzilor de producție, planuri de materiale, costuri | Exact Online |
| Succesiunea operațiilor din fluxul tehnologic, momentele de început și de sfârșit, alocarea la centrele de lucru | SkyPlanner |
| Matricea timpilor de pregătire, scule, operatori pe operație, resurse alternative, schimburi | SkyPlanner |
| Pontaje și recepții de produse finite | Exact Online, cu date primite de la SkyPlanner |
Principala sursă de conflicte este modificarea manuală a datelor calendaristice. Dacă planificatorii continuă să modifice datele comenzilor de producție în Exact Online, acestea ajung să fie gestionate de două sisteme. Lăsați SkyPlanner să gestioneze datele operațiilor din fluxul tehnologic. Cu Autopilot, SkyPlanner reprogramează automat când apar schimbări în producție.
Etapele obișnuite ale proiectului
Implementarea se finalizează de regulă în câteva săptămâni de la începerea configurării inițiale. Înainte de aceasta, validați programul în perioada de probă gratuită de 30 de zile, folosind un export CSV sau Excel al comenzilor de producție deschise și al operațiilor din fluxurile tehnologice. Proiectul continuă apoi astfel:
- Definirea domeniului. Confirmați ediția, diviziile, frecvențele de sincronizare, canalul de pontaj și modul de înregistrare a recepțiilor.
- Aplicația și consimțământul. Înregistrați aplicația, apoi un utilizator Exact Online acordă consimțământul OAuth pentru fiecare divizie.
- Încărcarea inițială. Centre de lucru, operații, articole, versiuni BOM și fluxuri tehnologice.
- Sincronizarea comenzilor. Comenzile de producție, planurile operațiilor din fluxurile tehnologice și planurile de materiale se sincronizează la intervale stabilite, iar stocurile și achizițiile prin webhook.
- Configurarea constrângerilor în SkyPlanner. Schimburi, matricea timpilor de pregătire, scule, numărul de operatori pe operație și utilaje sau personal alternativ.
- Transmiterea programului către Exact Online. Se transmit datele planificate ale operațiilor din fluxurile tehnologice, apoi pontajele și recepțiile.
- Testarea în paralel și punerea în funcțiune. Comparați datele calendaristice cu planul actual, corectați nomenclatoarele, apoi activați transmiterea datelor către Exact Online.
Ce trebuie prevăzut la integrarea cu Exact Online
- Duratele operațiilor din fluxul tehnologic.
PlannedSetupHoursșiPlannedRunHoursprovin din fluxul tehnologic al BOM. Verificați-le mai întâi în raport cu duratele reale de execuție. - Gruparea centrelor de lucru. Exact stochează o singură valoare a capacității pentru fiecare centru de lucru. Decideți pentru fiecare centru de lucru dacă va fi reprezentat printr-un singur centru de lucru, prin mai multe sau printr-un grup.
- Calendare. Schimburile, sărbătorile și absențele sunt gestionate în SkyPlanner. Configurați-le înainte de prima programare.
- Bugetul de apeluri API. Exact limitează numărul de apeluri pe aplicație și companie și cere ca apelurile să fie secvențiale. Folosiți webhook-uri acolo unde există topicuri disponibile,
$filterpeModifiedși Sync API pentru citirea unor volume mari de date. - Mai multe divizii. Fiecare divizie Exact Online este o companie cu propria cale de acces și propriul consimțământ. Asociați fiecare fabrică diviziei sale.
- Comenzi lansate în producție. Stabiliți pentru ce stări poate SkyPlanner să modifice datele calendaristice: comenzi deschise și lansate sau numai comenzi deschise.
- Un singur sistem responsabil pentru datele calendaristice. Opriți modificările manuale ale datelor în Exact Online odată ce SkyPlanner gestionează datele operațiilor din fluxul tehnologic.
Exact Globe+
Exact Globe+ este sistemul ERP al Exact, vândut și implementat prin partenerii Exact Globe+. Exact afirmă că acesta „koppelt eenvoudig en snel met andere systemen” (se conectează ușor și rapid cu alte sisteme) (Exact Globe+). SkyPlanner programează comenzile de producție din Exact Globe+ în același mod: primește comenzi de producție, fluxuri tehnologice, resurse și stocuri și trimite înapoi datele planificate și orele înregistrate. Partenerul dumneavoastră Exact Globe+ și echipa SkyPlanner stabilesc interfața și obiectele în care se vor scrie datele în etapa de definire a domeniului.
Integrarea cu Exact Online: cine o configurează și cine oferă asistență
- Echipa SkyPlanner o configurează în etapa inițială și oferă asistență după punerea în funcțiune.
- Partenerul dumneavoastră Exact poate participa. Acesta cunoaște edițiile, diviziile și configurația sistemului de producție pe care le utilizați.
- Dezvoltatorii dumneavoastră pot extinde integrarea folosind REST API documentat al SkyPlanner. Un token API este suficient pentru a începe, iar echipa SkyPlanner vă ajută atunci când este nevoie.
Odată stabilită conexiunea, motorul Arcturus programează pe baza comenzilor de producție actualizate din Exact Online, iar datele planificate sunt transmise pentru fiecare operație din fluxul tehnologic. SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Oferta pentru integrare este stabilită de la început, în funcție de procesul și nevoile dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe. Consultați prețurile, funcționalitățile și comparația cu planificarea oferită de Exact Online în articolul Programare cu capacitate finită pentru Exact Online. Găsiți prezentarea generală pe pagina Exact Online, iar celelalte sisteme ERP în secțiunea de integrări ERP.
Părerile producătorilor despre SkyPlanner
Mai puține opriri din lipsă de materiale
„Valoarea pe care ne-o aduce SkyPlanner este că funcționează în activitatea de zi cu zi, mai ales la stabilirea termenelor de livrare.”
Tommi Männistö, Manager de planificare a producției
Eskomatic · Prelucrări mecanice la comandă
Programarea automată a încărcării oferă termene de livrare mai precise, iar opririle de producție cauzate de lipsa materialelor s-au redus considerabil.
Mii (1.000) de comenzi de lucru programate automat
„Acum ținem producția sub control într-un alt mod, iar înțelegerea noastră asupra capacității este la un cu totul alt nivel.”
Hannu Ryynänen, Director general
Mamec · Mixere industriale, pompe și producție la comandă de înaltă tehnologie
Mii de comenzi de lucru sunt programate automat, iar întreaga organizație are o imagine în timp real a producției.
Întrebări frecvente
API-ul Exact Online include comenzi de producție și operații din fluxurile tehnologice?
Da. Serviciul de producție include ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations și resurse BOM, toate disponibile atât pentru citire, cât și pentru scriere. Timpul se înregistrează prin TimeTransactions, iar cantitățile finalizate prin ShopOrderReceipts.
Cum sunt transmise înapoi în Exact Online datele planificate?
SkyPlanner trimite o cerere PUT către ShopOrderRoutingStepPlans, cu PlannedStartDate, PlannedEndDate și Workcenter pentru fiecare operație pe care o programează sau o mută. Câmpurile PlannedStartDate și PlannedDate ale comenzii de producție sunt actualizate în consecință.
Cine realizează integrarea cu Exact Online?
Echipa SkyPlanner configurează integrarea bidirecțională în funcție de configurația dumneavoastră Exact Online în etapa de implementare și asigură asistență după punerea în funcțiune. Partenerul dumneavoastră Exact poate participa. Dezvoltatorii proprii pot, de asemenea, să realizeze integrarea folosind REST API documentat al SkyPlanner. Un token API este suficient pentru a începe.
Poate Exact Online să trimită modificările în timp real?
Prin webhook-uri, Exact Online trimite modificările articolelor, ale pozițiilor de stoc, ale comenzilor de achiziție și ale comenzilor de vânzare. Comenzile de producție și operațiile din fluxul tehnologic sunt citite la intervale scurte, prin cereri filtrate. În sens invers, webhook-urile SkyPlanner trimit modificările programului de producție pe măsură ce apar.
Putem testa SkyPlanner înainte de a realiza integrarea?
Da. Versiunea de încercare gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru și importul comenzilor de producție din fișiere CSV sau Excel, fără card de credit. Începeți testarea gratuită sau contactați echipa de vânzări pentru definirea domeniului integrării.