Integrări / ERP / Acumatica Cloud ERP
Ghid de integrare Acumatica pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Acumatica le arată partenerilor și echipelor IT cum să conecteze Acumatica Cloud ERP (Manufacturing Edition) la SkyPlanner APS. Integrarea dintre SkyPlanner și Acumatica funcționează în ambele sensuri:
- În SkyPlanner sunt preluate comenzile de producție cu operațiile aferente, centrele de lucru, utilajele, sculele, schimburile, articolele de stoc și comenzile de achiziție.
- Datele planificate de început și de sfârșit sunt înscrise în operațiile comenzii de producție, iar comanda este marcată ca fermă.
- Pontajele operatorilor sunt trimise înapoi ca înregistrări de manoperă și de transfer.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră Acumatica în etapa de implementare și asigură suport după punerea în producție. Acest ghid se adresează partenerilor și dezvoltatorilor care doresc să participe sau să dezvolte singuri soluții folosind REST API documentat al SkyPlanner (documentația de referință API).
Interfețele de integrare Acumatica
Integrarea folosește interfețele deja incluse în Acumatica. Nu se instalează nimic în instanță.
- REST API bazat pe contract. Endpointurile au versiuni corelate cu versiunile produsului. Endpointul Manufacturing (de exemplu 26.200.001 pentru 2026 R2) expune
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryșiMaterialEntry. Endpointul Default acoperăStockItem,PurchaseOrderșiSalesOrder. URL-urile respectă structura{instance}/entity/{Endpoint}/{version}/{Entity}. - Acțiuni pe același endpoint.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryșiReleaseMaterialEntryexecută aceeași logică precum butoanele din ecranele aplicației. - OData. Orice Generic Inquiry (SM208000) poate fi expusă prin OData. O Generic Inquiry care include operațiile de producție deschise și datele acestora permite cea mai rapidă citire a unui volum mare de date.
- Notificări push (SM302000). Acestea se bazează pe o Generic Inquiry sau pe o interogare predefinită și trimit rândurile inserate și șterse către un URL pe care îl configurați.
- Scenarii de import și export cu furnizori de date CSV și Excel pentru încărcări în masă.
Entitățile și acțiunile sunt enumerate în Web Service Endpoints (SM207000) și în depozitul de cod al clientului REST Acumatica.
Autentificare și limite
Acumatica folosește OAuth 2.0 și OpenID Connect prin aplicații client înregistrate în Connected Applications (SM303010). Fluxurile documentate sunt Authorization Code, Implicit, Resource Owner Password Credentials și Hybrid. Pentru o integrare pe server, înregistrați un utilizator dedicat integrării, cu roluri care acordă doar drepturile strict necesare, și folosiți Authorization Code cu un token de reîmprospătare sau Resource Owner Password Credentials.
Licența stabilește limitele: License Monitoring Console (SM604000) afișează numărul permis de cereri API pe minut și de utilizatori API.
În SkyPlanner, autentificarea pentru REST API se face cu un token API (SkyPlanner Settings > API), iar documentația este disponibilă în Swagger/OpenAPI. Tutorialul de integrare vă ghidează prin primele apeluri.
Maparea datelor
| Obiect Acumatica (endpoint / formular) | Obiect SkyPlanner | Sens | Frecvență |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produse și materiale | Acumatica → SkyPlanner | Încărcare inițială, apoi doar modificările |
BillOfMaterial (AM208000): materiale, operații | Structura produsului, subproduse, materiale pentru fiecare produs | Acumatica → SkyPlanner | Încărcare inițială, apoi la modificare |
| Operații BOM: Setup, Run, Machine, Queue, Finish, Move Time | Etape de proces cu durate, timpi de pregătire și de demontare | Acumatica → SkyPlanner | Încărcare inițială, apoi la modificare |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Centre de lucru, grupuri de centre de lucru, randamente, centre de lucru alternative | Acumatica → SkyPlanner | Încărcare inițială, apoi rar |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Schimburi și capacitatea personalului | Acumatica → SkyPlanner | Zilnic sau schimburi gestionate în SkyPlanner |
Tool (AM205500) | Scule tratate ca resurse cu capacitate finită | Acumatica → SkyPlanner | Încărcare inițială |
ProductionOrder cu OrderOperationDetail (Planned, Released, In Process) | Comenzi și lucrări cu termene, prioritate de lansare în execuție și necesar de materiale | Acumatica → SkyPlanner | Notificare push sau interogare la fiecare câteva minute |
Linii PurchaseOrder (Default) | Comenzi de achiziție cu data estimată a livrării | Acumatica → SkyPlanner | Interogare la fiecare oră sau la rularea programării |
| Cantități de articole pe depozit | Stocuri curente | Acumatica → SkyPlanner | Interogare la fiecare oră sau la rularea programării |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Începutul și sfârșitul planificate și centrul de lucru pentru fiecare operație | SkyPlanner → Acumatica | La modificarea programului, prin webhook SkyPlanner |
Acțiunea FirmProductionOrder | Împiedică Acumatica APS să modifice datele înscrise | SkyPlanner → Acumatica | După fiecare scriere înapoi |
LaborEntry, MoveEntry cu acțiuni de validare | Pontaje, cantități realizate, confirmări ale operatorilor | SkyPlanner → Acumatica | La fiecare confirmare sau pe schimb |
| Nu există în Acumatica | Matricea timpilor de pregătire, operatori nominalizați, lucrări cu mai mulți operatori | Gestionate în SkyPlanner | Configurate în etapa de implementare |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți mai întâi centrele de lucru, utilajele, sculele, schimburile și calendarele. Citiți apoi articolele de stoc și listele de materiale. Stabiliți cum mapați un centru de lucru cu mai multe utilaje: la un grup de centre de lucru în care fiecare utilaj este un centru de lucru sau la un singur centru de lucru. Câmpul Basis for Capacity din Acumatica indică modul în care fabrica își gestionează capacitatea.
2. Sincronizarea comenzilor. Citiți comenzile de producție împreună cu operațiile din comandă, nu din BOM. Operațiile sunt copiate în comandă, iar planificatorii le modifică acolo. Configurați o notificare push pentru o Generic Inquiry cu comenzile și operațiile deschise sau interogați-o periodic. Citiți și liniile deschise ale comenzilor de achiziție. SkyPlanner consideră materialul comandat disponibil la data de livrare a comenzii de achiziție și actualizează stocul când aceasta este marcată Delivered.
3. Scrierea programului înapoi în Acumatica. Pentru fiecare operație pe care motorul a programat-o sau a mutat-o, SkyPlanner înscrie StartDate și EndDate în OrderOperationDetail, precum și centrul de lucru dacă lucrarea a fost mutată pe un centru de lucru alternativ. Apoi apelează FirmProductionOrder. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Când rulați programarea cu capacitate finită a comenzilor de producție, sistemul nu reprogramează comenzile de producție marcate ca ferme.) (sursă)
4. Confirmări din secția de producție. Operatorii își înregistrează activitatea cu SkyPlanner Mobile Confirmations sau Production Timer. Pontajele devin documente LaborEntry (timp și cantitate realizată pentru fiecare operație) sau documente MoveEntry (doar cantitate), validate prin acțiunea corespunzătoare. Dacă secția de producție raportează deja în Acumatica, prin Labor (AM301000) sau Shop Floor Kiosk, informațiile despre progres circulă în sens invers. Alegeți un singur canal, niciodată ambele.
5. Responsabilitatea pentru date și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în producție:
| Date | Sistem responsabil |
|---|---|
| Articole de stoc, BOM-uri, cantități, starea comenzilor, calculul costurilor | Acumatica |
| Ordinea operațiilor, orele de început și de sfârșit, alocarea centrelor de lucru | SkyPlanner |
| Matricea timpilor de pregătire, scule, cerințe privind operatorii, alternative | SkyPlanner |
| Schimburi și absențe | Un singur sistem, ales la definirea domeniului |
| Tranzacții de manoperă și de transfer | Acumatica, cu înregistrări provenite din pontajele SkyPlanner sau introduse în secția de producție |
Principala sursă de conflicte este sistemul APS din Acumatica. Rough Cut Planning sau APS Maintenance Process pot recalcula datele comenzilor programate de SkyPlanner. Marcarea ca fermă a fiecărei comenzi transmise împiedică acest lucru. Excludeți totodată comenzile deja programate din rulările APS.
Etapele obișnuite ale proiectului
Implementarea se finalizează, de regulă, în câteva săptămâni de la începerea procesului de configurare inițială. Înainte de această etapă, puteți testa gratuit soluția timp de 30 de zile, cu propriile date. Exportați în Excel centrele de lucru și comenzile de producție deschise, împreună cu operațiile lor, dintr-o Generic Inquiry, apoi importați-le și validați programul de producție.
- Corespondența datelor. Stabiliți tabelul de corespondență, regulile care determină sistemul responsabil pentru fiecare categorie de date, frecvențele de sincronizare și canalul de înregistrare a manoperei.
- Acces. Înregistrați aplicația conectată, creați utilizatorul și rolurile pentru integrare și confirmați versiunea endpointului în Web Service Endpoints. Începeți în mediul de testare.
- Încărcarea inițială. Centre de lucru, utilaje, scule, schimburi, articole de stoc și liste de materiale (BOM).
- Sincronizarea comenzilor. Comenzi de producție, operații și comenzi de achiziție, prin notificări push sau interogări periodice.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire, operatori nominalizați, lucrări care necesită mai mulți operatori și alternative.
- Scrierea înapoi în ERP. Datele operațiilor, marcarea comenzilor ca ferme și înregistrările de manoperă sau de transfer.
- Rularea în paralel. Comparați datele calculate de SkyPlanner cu planul actual și corectați nomenclatoarele.
- Trecerea în producție. Activați scrierea înapoi în ERP după ce datele corespund.
Ce trebuie să aveți în vedere la integrarea cu Acumatica
- Verificați ce motor APS este activ. Classic și Optimized păstrează setările separat și numai unul poate fi activat. Verificați Enable/Disable Features (CS100000) înainte de prima scriere înapoi în ERP.
- Fixați versiunea endpointului. Versiunea face parte din URL. Actualizarea aplicației adaugă o versiune nouă, așa că repetați testele la fiecare actualizare.
- Actualizarea operațiilor. Unele câmpuri ale operațiilor pot fi doar citite prin REST, iar starea comenzii contează. Testați în mediul de testare succesiunea de scriere înapoi în ERP pentru comenzile cu stările Released și In Process.
- Unități și câmpuri de timp. Timpul de execuție este raportat la Run Units, iar timpul de funcționare a utilajului, la Machine Units. Timpii de așteptare și de transfer „affect the calculated schedule but do not occupy work center capacity.” (influențează programul calculat, dar nu ocupă capacitatea centrului de lucru). Efectuați conversiile cu atenție la import.
- Disponibilitatea materialelor. Classic APS cere ca toate materialele să fie disponibile în cantitatea integrală. SkyPlanner planifică în funcție de stoc și de comenzile de achiziție așteptate, ținând cont de datele de sosire. Stabiliți de comun acord după care rezultat se vor ghida planificatorii.
- Limitele API. Numărul de cereri pe minut depinde de licență. Citiți doar modificările și folosiți notificări push, nu reîncărcări complete.
Cine configurează integrarea cu Acumatica și asigură asistența
- Echipa SkyPlanner configurează integrarea în etapa inițială și oferă asistență după trecerea în producție. Fiecare fabrică folosește Acumatica în felul său, iar aici punem în practică această experiență.
- Partenerul dumneavoastră Acumatica poate participa. Acesta vă cunoaște personalizările, Generic Inquiries și rolurile. SkyPlanner pune la dispoziție REST API, documentația Swagger/OpenAPI și webhookuri.
- Propriii dezvoltatori pot construi integrarea folosind același REST API și un token API. Pentru început este suficient un token API, iar echipa SkyPlanner oferă ajutor la nevoie. Laboratory & Allied a ales această cale pentru SAP Business One: echipa IT internă a realizat integrarea în mare parte pe cont propriu, cu ajutorul SkyPlanner.
Prețul 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 procesele și nevoile dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe. Vedeți comparația cu propriul APS al Acumatica în articolul despre programarea cu capacitate finită în Acumatica, prezentarea generală de pe pagina Acumatica și celelalte sisteme din secțiunea de integrări ERP.
Ce spun producătorii despre SkyPlanner
2 heconomisite săptămânal
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru pe săptămână, iar o nouă listă de lucrări ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar realizarea unui plan optimizat pe trei luni, pentru toate centrele de lucru, durează mai puțin de 30 de minute.
1.000+comenzi de lucru programate automat
„Acum controlăm producția într-un mod diferit, iar înțelegerea capacității noastre a ajuns la un cu totul alt nivel.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție la comandă cu tehnologie avansată
Mii de comenzi de lucru sunt programate automat, iar întreaga organizație are o imagine în timp real asupra producției.
99,2%respectarea termenelor de livrare
„SkyPlanner ne-a oferit vizibilitatea necesară pentru a identifica blocajele și a adus mai multă claritate în gestionarea producției.”
Toni Tuori, director de producție
Piristeel · Sisteme de siguranță pentru acoperișuri și sisteme pluviale
Rata de respectare a termenelor de livrare a ajuns la 99,2% anul acesta, iar programarea producției economisește până la patru ore de lucru pe zi.
Întrebări frecvente
API-ul Acumatica include comenzile de producție?
Da. Endpointul Manufacturing din REST API bazat pe contracte expune ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool și înregistrările de manoperă și de transfer, precum și acțiuni cum ar fi FirmProductionOrder.
Cine realizează integrarea cu Acumatica?
Echipa SkyPlanner configurează integrarea bidirecțională în funcție de configurația dumneavoastră Acumatica în etapa inițială și oferă asistență după trecerea în producție. Partenerul dumneavoastră Acumatica sau propriii dezvoltatori pot, de asemenea, construi integrarea folosind REST API documentat al SkyPlanner. Pentru început este suficient un token API.
Avem nevoie de Acumatica APS pentru această integrare?
Nu. Acumatica realizează propria programare cu capacitate finită prin formularul Rough Cut Planning, iar Classic APS programează la capacitate infinită comenzile care se încheie după mai mult de 120 de zile (sursă). SkyPlanner construiește singur programul detaliat cu capacitate finită pe baza comenzilor de producție, operațiilor, centrelor de lucru, utilajelor și sculelor. Prin urmare, integrarea funcționează indiferent dacă APS este activat sau nu; potrivit Acumatica, acesta „is subject to licensing” (necesită licență). Autopilot menține programul actualizat, iar operatorii înregistrează lucrările cu Mobile Confirmations.
Cum împiedicăm Acumatica APS să suprascrie datele stabilite de SkyPlanner?
SkyPlanner marchează fiecare comandă de producție ca fermă după ce înregistrează datele operațiilor acesteia. Programarea cu capacitate finită din Acumatica nu reprogramează comenzile ferme.
Poate Acumatica să transmită modificările în timp real?
Da. Notificările push (SM302000) configurate pentru o Generic Inquiry trimit rândurile modificate către un URL imediat ce apar modificările. Webhookurile SkyPlanner transmit modificările programului în sens invers.
Ce metodă de autentificare trebuie să folosească integrarea?
OAuth 2.0, printr-un client înregistrat în Connected Applications (SM303010), cu un utilizator dedicat integrării și roluri cu drepturi minime necesare. Fluxul este confirmat pentru instanța dumneavoastră în etapa de definire a domeniului.
Putem testa SkyPlanner înainte de a realiza integrarea?
Da. Perioada de testare gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu importuri Excel sau CSV dintr-o Generic Inquiry Acumatica, fără card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
