Integraties / ERP / Acumatica Cloud ERP
Acumatica-integratiegids voor productieschema’s met SkyPlanner APS
Deze Acumatica-integratiegids laat partners en IT-teams zien hoe ze Acumatica Cloud ERP (Manufacturing Edition) aan SkyPlanner APS koppelen. SkyPlanner wisselt in beide richtingen gegevens uit met Acumatica:
- Productieorders met hun bewerkingen, werkcentra, machines, gereedschappen, diensten, voorraadartikelen en inkooporders worden ingelezen.
- De geplande begin- en einddatums worden naar de bewerkingen van de productieorder geschreven en de order wordt vastgezet.
- Tijdregistraties van operators worden teruggestuurd als arbeids- en verplaatsingsboekingen.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Het SkyPlanner-team stemt de integratie tijdens de onboarding af op uw Acumatica-inrichting en blijft deze na de ingebruikname ondersteunen. Deze gids is bedoeld voor partners en ontwikkelaars die daaraan willen meewerken of zelf verder willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-referentie).
Integratie-interfaces van Acumatica
De integratie gebruikt interfaces die Acumatica standaard levert. Er wordt niets in de instantie geïnstalleerd.
- Contractgebaseerde REST API. Endpoints hebben versienummers die de releases volgen. Het endpoint Manufacturing (bijvoorbeeld 26.200.001 voor 2026 R2) biedt toegang tot
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryenMaterialEntry. Het endpoint Default biedt toegang totStockItem,PurchaseOrderenSalesOrder. URL’s hebben de vorm{instance}/entity/{Endpoint}/{version}/{Entity}. - Acties op hetzelfde endpoint.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryenReleaseMaterialEntryvoeren dezelfde logica uit als de knoppen op de schermen. - OData. Elke Generic Inquiry (SM208000) kan via OData beschikbaar worden gesteld. Een Generic Inquiry met openstaande productiebewerkingen en hun datums is de snelste manier om gegevens in bulk uit te lezen.
- Pushmeldingen (SM302000). Deze zijn gebaseerd op een Generic Inquiry of een ingebouwde query en sturen toegevoegde en verwijderde rijen naar een door u ingestelde URL.
- Import- en exportscenario’s met CSV- en Excel-providers om gegevens in bulk te laden.
De entiteiten en acties staan op Web Service Endpoints (SM207000) en in de repository van de REST-client van Acumatica.
Authenticatie en limieten
Acumatica gebruikt OAuth 2.0 en OpenID Connect via clientapplicaties die zijn geregistreerd op Connected Applications (SM303010). De gedocumenteerde flows zijn Authorization Code, Implicit, Resource Owner Password Credentials en Hybrid. Registreer voor een serverintegratie een aparte integratiegebruiker met rollen die alleen de noodzakelijke rechten verlenen. Gebruik Authorization Code met een refresh token of Resource Owner Password Credentials.
Uw licentie bepaalt de limieten: de License Monitoring Console (SM604000) toont het toegestane aantal API-verzoeken per minuut en API-gebruikers.
Aan de kant van SkyPlanner gebruikt de REST API een API-token voor authenticatie (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding helpt u bij de eerste aanroepen.
Gegevensmapping
| Acumatica-object (endpoint / formulier) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Producten en materialen | Acumatica → SkyPlanner | Eerst volledig, daarna alleen wijzigingen |
BillOfMaterial (AM208000): materialen, bewerkingen | Productstructuur, deelproducten, materialen per product | Acumatica → SkyPlanner | Eerst volledig, daarna bij wijzigingen |
| BOM-bewerkingen: Setup, Run, Machine, Queue, Finish, Move Time | Processtappen met tijdsduur, instel- en afbouwtijden | Acumatica → SkyPlanner | Eerst volledig, daarna bij wijzigingen |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Werkcentra, groepen werkcentra, efficiëntiefactoren, alternatieve werkcentra | Acumatica → SkyPlanner | Eerst volledig, daarna zelden |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Diensten en personeelscapaciteit | Acumatica → SkyPlanner | Dagelijks, of diensten beheren in SkyPlanner |
Tool (AM205500) | Gereedschappen als productiemiddelen met beperkte beschikbaarheid | Acumatica → SkyPlanner | Eerste volledige gegevensimport |
ProductionOrder met OrderOperationDetail (Planned, Released, In Process) | Orders en taken met leverdatums, uitvoeringsprioriteit en materiaalbehoeften | Acumatica → SkyPlanner | Pushmelding of om de paar minuten pollen |
PurchaseOrder-regels (Default) | Inkooporders met verwachte leverdatum | Acumatica → SkyPlanner | Pollen, elk uur of bij het berekenen van het productieschema |
| Artikelhoeveelheden per magazijn | Voorraadstanden | Acumatica → SkyPlanner | Pollen, elk uur of bij het berekenen van het productieschema |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Gepland begin, einde en werkcentrum per bewerking | SkyPlanner → Acumatica | Bij wijzigingen in het productieschema, via een SkyPlanner-webhook |
Actie FirmProductionOrder | Voorkomt dat Acumatica APS de weggeschreven datums wijzigt | SkyPlanner → Acumatica | Na elke terugschrijving |
LaborEntry, MoveEntry met vrijgaveacties | Tijdregistraties, gereedgemelde aantallen, terugmeldingen van operators | SkyPlanner → Acumatica | Per terugmelding of per dienst |
| Niet in Acumatica | Omsteltijdenmatrix, operators op naam, taken met meerdere operators | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Integratiepatronen
1. Stamgegevens voor het eerst inlezen. Lees eerst werkcentra, machines, gereedschappen, diensten en kalenders in. Lees daarna voorraadartikelen en stuklijsten in. Bepaal hoe een werkcentrum met meerdere machines wordt gekoppeld: als één groep werkcentra met de machines als afzonderlijke werkcentra, of als één werkcentrum. Basis for Capacity in Acumatica geeft aan welke benadering de fabriek hanteert.
2. Orders synchroniseren. Lees productieorders en hun bewerkingen uit de order, niet uit de BOM. Bewerkingen worden naar de order gekopieerd en planners passen ze daar aan. Stel een pushmelding in op een Generic Inquiry met openstaande orders en bewerkingen, of lees deze via polling uit. Lees ook openstaande inkooporderregels in. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt.
3. Het productieschema terugschrijven. Voor elke bewerking die de planningsengine heeft ingepland of verplaatst, schrijft SkyPlanner StartDate en EndDate naar OrderOperationDetail. Als het werk naar een alternatief werkcentrum is verplaatst, wordt ook het werkcentrum weggeschreven. Daarna roept SkyPlanner FirmProductionOrder aan. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Bij capaciteitsplanning van productieorders plant het systeem vastgezette productieorders niet opnieuw in.) (bron)
4. Terugmeldingen vanaf de productievloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Tijdregistraties worden omgezet in LaborEntry-documenten (tijd en gereedgemeld aantal per bewerking) of MoveEntry-documenten (alleen aantallen). Deze worden met de bijbehorende actie vrijgegeven. Als uw productiemedewerkers al in Acumatica rapporteren, via Labor (AM301000) of de Shop Floor Kiosk, stroomt de voortgangsinformatie de andere kant op. Kies één kanaal, nooit beide.
5. Afspraken over gegevensbeheer en conflicten. Leg deze vóór de ingebruikname vast:
| Gegevens | Leidend systeem |
|---|---|
| Voorraadartikelen, BOM’s, aantallen, orderstatus, kostprijsberekening | Acumatica |
| Bewerkingsvolgorde, begin- en eindtijden, toewijzing aan werkcentra | SkyPlanner |
| Omsteltijdenmatrix, gereedschappen, vereisten voor operators, alternatieven | SkyPlanner |
| Diensten en afwezigheden | Eén systeem, gekozen tijdens de scopebepaling |
| Arbeids- en verplaatsingsboekingen | Acumatica, geboekt vanuit SkyPlanner-tijdregistraties of ingevoerd op de productievloer |
De belangrijkste bron van conflicten is Acumatica’s eigen APS. Rough Cut Planning of het APS Maintenance Process kan datums opnieuw berekenen voor orders die SkyPlanner heeft ingepland. Door elke teruggeschreven order vast te zetten, voorkomt u dat. Sluit ingeplande orders ook uit van APS-runs.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Daaraan voorafgaand gebruikt u tijdens de gratis proefperiode van 30 dagen uw eigen gegevens. Exporteer werkcentra en openstaande productieorders met hun bewerkingen vanuit een Generic Inquiry naar Excel, importeer ze en controleer het productieschema.
- Mapping. Leg de mappingtabel, regels voor gegevenseigenaarschap, synchronisatiefrequenties en het kanaal voor het boeken van arbeidsuren vast.
- Toegang. Registreer de gekoppelde applicatie, maak de integratiegebruiker en rollen aan en controleer de endpointversie in Web Service Endpoints. Begin in een sandbox.
- Eerste gegevensimport. Werkcentra, machines, gereedschappen, ploegendiensten, voorraadartikelen en stuklijsten.
- Ordersynchronisatie. Productieorders, bewerkingen en inkooporders via pushmeldingen of polling.
- Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, individuele operators, opdrachten met meerdere operators en alternatieven.
- Terugschrijven. Bewerkingsdatums, het vastzetten van orders en boekingen van arbeidsuren of verplaatsingen.
- Parallel draaien. Vergelijk de datums van SkyPlanner met het huidige plan en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten bij een Acumatica-integratie
- Controleer welke APS-engine actief is. Classic en Optimized slaan hun instellingen afzonderlijk op en er kan er maar één ingeschakeld zijn. Controleer Enable/Disable Features (CS100000) voordat u voor het eerst gegevens terugschrijft.
- Zet de endpointversie vast. De versie maakt deel uit van de URL. Een release-upgrade voegt een nieuwe versie toe, dus test opnieuw bij elke upgrade.
- Bewerkingen bijwerken. Sommige bewerkingsvelden zijn via REST alleen-lezen. Ook de orderstatus is van belang. Test de volgorde van het terugschrijven voor orders met de status Released en In Process in een sandbox.
- Eenheden en tijdvelden. De bewerkingstijd geldt per Run Units, de machinetijd per Machine Units. Wachttijd en verplaatsingstijd “affect the calculated schedule but do not occupy work center capacity.” (beïnvloeden het berekende productieschema, maar leggen geen beslag op de capaciteit van het werkcentrum). Converteer deze waarden zorgvuldig bij het importeren.
- Materiaalbeschikbaarheid. Classic APS vereist dat al het materiaal volledig beschikbaar is. SkyPlanner plant op basis van de voorraad en de ontvangstdatums van inkooporders. Spreek af op welke uitkomst planners zich baseren.
- API-limieten. Het toegestane aantal verzoeken per minuut hangt af van de licentie. Lees alleen wijzigingen uit en gebruik pushmeldingen in plaats van alle gegevens steeds opnieuw te laden.
Wie configureert en ondersteunt de Acumatica-integratie?
- Het SkyPlanner-team configureert de integratie tijdens de onboarding en biedt ondersteuning na ingebruikname. Elke fabriek gebruikt Acumatica anders. Die praktijkkennis komt hier van pas.
- Uw Acumatica-partner kan meewerken. De partner kent uw maatwerk, Generic Inquiries en rollen. SkyPlanner stelt de REST API, Swagger/OpenAPI-documentatie en webhooks beschikbaar.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen via dezelfde REST API met een API-token. Een API-token is voldoende om te beginnen en het SkyPlanner-team helpt waar nodig. Laboratory & Allied koos deze aanpak voor SAP Business One: het eigen IT-team bouwde de integratie grotendeels zelf, met hulp van SkyPlanner.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra en met maandelijkse facturatie. U ontvangt vooraf een offerte voor uw abonnement en de integratie. De offerte voor de integratie is afgestemd op uw proces en behoeften. Zo kent u de totale kosten voordat u begint. Lees hoe Acumatica’s eigen APS zich verhoudt tot SkyPlanner in Capaciteitsplanning in Acumatica, bekijk het overzicht op de Acumatica-pagina en ontdek andere systemen in het overzicht van ERP-integraties.
Ervaringen van fabrikanten met SkyPlanner
2 hbespaard per week
“Dankzij SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime optimalisatie van de productie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd en een nieuwe werklijst bereikt de productielijn binnen enkele seconden.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerd plan voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.
1.000’enwerkorders automatisch ingepland
“We hebben de productie op een andere manier onder controle en ons inzicht in de capaciteit ligt op een compleet ander niveau.”
Hannu Ryynänen, algemeen directeur
Mamec · Industriële mengers, pompen en hightechproductie in opdracht
Duizenden werkorders worden automatisch ingepland en de hele organisatie heeft realtime inzicht in de productie.
99,2%leverbetrouwbaarheid
“SkyPlanner heeft knelpunten zichtbaar gemaakt en de aansturing van de productie overzichtelijker gemaakt.”
Toni Tuori, productiemanager
Piristeel · Dakveiligheid en regenwatersystemen
De leverbetrouwbaarheid bereikte dit jaar 99,2% en het inplannen bespaart tot vier uur werktijd per dag.
Veelgestelde vragen
Biedt de Acumatica API toegang tot productieorders?
Ja. Het Manufacturing-endpoint van de contractgebaseerde REST API biedt toegang tot ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool en boekingen van arbeidsuren en verplaatsingen, plus acties zoals FirmProductionOrder.
Wie bouwt de Acumatica-integratie?
Het SkyPlanner-team configureert de tweerichtingsintegratie tijdens de onboarding voor uw Acumatica-inrichting en biedt ondersteuning na ingebruikname. Uw Acumatica-partner of uw eigen ontwikkelaars kunnen ook bouwen op de gedocumenteerde REST API van SkyPlanner. Een API-token is voldoende om te beginnen.
Hebben we Acumatica APS nodig voor deze integratie?
Nee. Acumatica voert zijn eigen capaciteitsplanning uit via het formulier Rough Cut Planning. Classic APS plant orders die na 120 dagen eindigen met onbeperkte capaciteit (bron). SkyPlanner maakt zelf het gedetailleerde productieschema op basis van productieorders, bewerkingen, werkcentra, machines en gereedschappen, rekening houdend met de beschikbare capaciteit. De integratie werkt dus ongeacht of APS is ingeschakeld. Acumatica vermeldt over APS: “is subject to licensing” (er is een licentie voor vereist). Autopilot houdt het productieschema actueel en operators registreren hun werk met Mobile Confirmations.
Hoe voorkomen we dat Acumatica APS de datums van SkyPlanner overschrijft?
SkyPlanner zet elke productieorder vast nadat de bewerkingsdatums zijn teruggeschreven. De capaciteitsplanning van Acumatica plant vastgezette orders niet opnieuw in.
Kan Acumatica wijzigingen realtime doorsturen?
Ja. Push notifications (SM302000) op een Generic Inquiry sturen gewijzigde regels direct naar een URL. De eigen webhooks van SkyPlanner sturen wijzigingen in het productieschema in de andere richting.
Welke authenticatie moet de integratie gebruiken?
OAuth 2.0 via een client die is geregistreerd in Connected Applications (SM303010), met een aparte integratiegebruiker en rollen met alleen de minimaal benodigde rechten. Tijdens de scopebepaling wordt de authenticatiestroom voor uw omgeving bevestigd.
Kunnen we SkyPlanner testen voordat we de integratie bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en Excel- of CSV-bestanden importeren vanuit een Acumatica Generic Inquiry. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales om de scope van de integratie te bepalen.
