Integraties / ERP / Odoo
Odoo-integratiegids voor productieschema’s met SkyPlanner APS
Deze gids laat Odoo-partners, ontwikkelaars en IT-verantwoordelijken zien hoe ze Odoo Manufacturing aan SkyPlanner APS koppelen. Meer over de businesscase en wat de knop Plan in Odoo al doet, leest u op de pagina over productieschema’s in Odoo en in Ondersteunt Odoo capaciteitsplanning?.
Odoo blijft het bronsysteem voor producten, stuklijsten, bewerkingen, fabricageorders, voorraad en kostencalculatie. SkyPlanner stelt met zijn Arcturus-engine op basis van die gegevens het productieschema op. De integratie met Odoo werkt in beide richtingen:
- Fabricageorders, productieorders, BoM-bewerkingen, werkcentra en inkooporders worden ingelezen.
- De geplande start- en eindtijd en de werkcentra worden teruggeschreven naar
mrp.workorder. - Voortgang en geregistreerde tijd worden als Odoo Time Logs teruggestuurd.
- SkyPlanner-webhooks sturen wijzigingen in het productieschema direct door.
Het SkyPlanner-team configureert de integratie tijdens de onboarding via de standaard externe API van Odoo. Het team stemt deze af op uw versie, hosting en maatwerk en biedt ook na de ingebruikname ondersteuning. Deze gids is bedoeld voor partners en ontwikkelaars die willen meewerken of zelf op de gedocumenteerde REST API van SkyPlanner willen voortbouwen (API-referentie). De verwerking van producten, materialen en inkooporders staat beschreven in de openbare SkyPlanner-documentatie.
Stap nul: controleer het Odoo-abonnement en de hosting
Ga eerst na welke Odoo-omgeving de klant gebruikt. Die bepaalt de aanpak.
| Omgeving | Externe API | Maatwerkmodules | Praktische aanpak |
|---|---|---|---|
| Odoo Online, One App Free of Standard | Nee | Nee | CSV/XLSX, of overstappen op het Custom-abonnement |
| Odoo Online, Custom-abonnement | Ja | Nee | Externe API |
| Odoo.sh (Custom-abonnement) | Ja | Ja | Externe API, optionele module |
| On-premise, Community of Enterprise | Ja | Ja | Externe API, optionele module |
Volgens de API-documentatie van Odoo is toegang tot de externe API “only available on Custom Odoo pricing plans” (alleen beschikbaar bij Custom-abonnementen van Odoo), niet bij One App Free of Standard. Op de prijzenpagina staat dat Standard op Odoo Online wordt gehost “without custom modules” (zonder maatwerkmodules). Vraag dit tijdens de inventarisatie na, niet halverwege de bouw.
Integratiemogelijkheden van Odoo
| Optie | Versies | Authenticatie | Rol bij een planningsintegratie |
|---|---|---|---|
External JSON-2 API: POST /json/2/<model>/<method> | Nieuw in 19.0 | API-sleutel in Authorization: bearer <key>, optionele header X-Odoo-Database | Standaard voor nieuwe integraties: search_read voor uitlezen, write voor het terugschrijven van datums |
Externe XML-RPC / JSON-RPC: /xmlrpc/2, /jsonrpc, services common, object | Tot en met 19.0; verwijdering gepland | common.authenticate met inlognaam en wachtwoord of API-sleutel, daarna execute_kw | Vereist voor klanten op 16.0 tot en met 18.0 |
| Maatwerkcontrollers in een module | Alle | Per route, bijvoorbeeld auth='bearer' | Gecombineerde payloads: een MO met de bijbehorende productieorders in één aanroep |
| Automatiseringsregels: “Send Webhook Notification” (webhookmelding verzenden) | Gedocumenteerd vanaf 17.0 | Uitgaand POST-verzoek naar een URL | Push bij het aanmaken of wijzigen van MO’s en productieorders |
| Records importeren (CSV, XLSX) en exporteren | Alle | Gebruikerssessie | Proefgegevens en eenmalige import van stamgegevens |
Houd nu al rekening met de verwijdering. Odoo heeft de verwijdering van XML-RPC en JSON-RPC gepland voor Odoo 22 (najaar 2028) en Odoo Online 21.1 (winter 2027). Bouw voor 19.0 op JSON-2 en scherm het RPC-pad voor oudere databases af achter één adapter. Zo volstaat bij een upgrade één wijziging. Maatwerkcontrollers met @route(type='jsonrpc') vallen niet onder deze verwijdering.
Authenticatie
Maak een aparte integratiegebruiker aan met leesrechten voor Manufacturing en Inventory en schrijfrechten voor productieorders. Genereer de sleutel via Preferences > Account Security > New API Key. In 19.0 zijn sleutels maximaal drie maanden geldig. De middleware moet daarom sleutels kunnen roteren en een melding geven bij authenticatiefouten. Zonder die voorzieningen stopt de synchronisatie ongemerkt zodra een sleutel verloopt. Aan de kant van SkyPlanner gebruikt de REST API JWT, dus de middleware beheert beide inloggegevens.
Elke JSON-2-aanroep draait in een eigen SQL-transactie. Een schrijfactie die over meerdere aanroepen is verdeeld, is dus niet atomair. Schrijf per productieorder en leg elk resultaat vast.
Gebeurtenissen
Odoo pusht wijzigingen via automatiseringsregels. Een regel op mrp.production of mrp.workorder met de trigger On create and edit en de actie “Send Webhook Notification” (webhookmelding verzenden) verstuurt een POST-verzoek met de geselecteerde velden naar een URL. Maak de regel in Studio of, in ontwikkelaarsmodus, via het formulier Automation Rules. Combineer dit met een periodieke search_read-poll op write_date om imports en wijzigingen die de regel heeft gemist alsnog op te halen. In de andere richting pushen SkyPlanner-webhooks wijzigingen in planning en status zodra ze plaatsvinden.
Veldnamen verschillen per versie. In 19.0 vermeldt elke database zijn modellen, velden en methoden op /doc; roep bij oudere versies fields_get aan. Baseer de mapping daarop, niet op uw geheugen.
Gegevensmapping: van Odoo naar SkyPlanner
| Odoo-model | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
product.product / product.template (default_code, uom_id, qty_available) | Product of materiaal | Odoo → SkyPlanner | Eerste import, daarna dagelijks of bij wijziging |
mrp.bom (product_tmpl_id, product_qty, produce_delay), mrp.bom.line (product_id, product_qty, operation_id), mrp.bom.byproduct | Product met meerdere niveaus, materiaalbehoefte per stap | Odoo → SkyPlanner | Bij wijziging |
mrp.routing.workcenter (tabblad Operations: workcenter_id, sequence, time_mode, time_cycle_manual, blocked_by_operation_ids) | Processtappen met volgorde en bewerkingstijd | Odoo → SkyPlanner | Bij wijziging |
mrp.workcenter (resource_calendar_id, time_efficiency, time_start, time_stop, alternative_workcenter_ids) | Werkcentrum, efficiëntie, instellen en opruimen, alternatieve werkcentra | Odoo → SkyPlanner, daarna beheerd in SkyPlanner | Eerste import |
mrp.workcenter.capacity (capacity) | Stuks per cyclus, productspecifieke instel- en opruimtijden | Odoo → SkyPlanner | Eerste import |
resource.calendar, resource.calendar.attendance, resource.calendar.leaves | Diensten en verlof | Odoo → SkyPlanner | Eerste import, verlof bij wijziging |
mrp.production (product_id, product_qty, date_deadline, priority, state, workorder_ids) | Order met uiterste einddatum en prioriteit | Odoo → SkyPlanner | Webhook bij bevestiging, aangevuld met polling |
mrp.workorder (operation_id, workcenter_id, duration_expected, state) | Taak op een werkcentrum | Odoo → SkyPlanner | Webhook, aangevuld met polling |
stock.quant, stock.move (componentmutaties) | Aanwezige voorraad en materiaalbehoefte voor materiaalgestuurd plannen | Odoo → SkyPlanner | Periodiek, bijvoorbeeld elke 15 tot 60 minuten |
purchase.order (partner_id, state), purchase.order.line (product_id, product_qty, date_planned, qty_received) | Inkooporders en binnenkomend materiaal, beschikbaar op de verwachte leverdatum | Odoo → SkyPlanner | Webhook bij bevestiging of wijziging van de inkooporder, aangevuld met dezelfde periodieke polling |
| Geplande start- en eindtijd en werkcentrum | mrp.workorder.date_start, date_finished, workcenter_id | SkyPlanner → Odoo | Bij een planningswijziging, via een SkyPlanner-webhook |
| Mobile Confirmations, tijdregistraties | mrp.workcenter.productivity (Time Logs: workcenter_id, workorder_id, date_start, date_end, loss_id) | SkyPlanner → Odoo | Per terugmelding |
| Geproduceerd aantal, voltooide bewerking | qty_producing op de productieorder, daarna button_finish; button_mark_done op de MO | SkyPlanner → Odoo, of uitgevoerd in Odoo Shop Floor | Per terugmelding |
Integratiepatronen
Eerst de stamgegevens.
Laad eerst de werkcentra en kalenders en daarna de producten, BoMs en bewerkingen die naar werkcentra verwijzen. Tijdens de proefperiode van 30 dagen worden dezelfde lijsten als CSV-exports ingelezen. De import- en exportfunctie van Odoo werkt in elke lijstweergave.
Ordersynchronisatie.
Haal MO’s met de status confirmed en progress op, inclusief de bijbehorende productieorders. Laat concept-MO’s buiten beschouwing of behandel ze als voorlopige vraag. Subassemblages met een eigen stuklijst kunnen als afzonderlijke onderliggende MO’s binnenkomen. Odoo plant elke MO afzonderlijk. Koppel ze aan subproducten in SkyPlanner, zodat subassemblages klaar zijn voordat het bovenliggende product start.
Het productieschema terugschrijven.
Wanneer de planning verandert, activeert een SkyPlanner-webhook de integratie. Die roept de ORM-methode write aan voor elke betrokken mrp.workorder. In Odoo 19.0 is dat één JSON-2-verzoek per productieorder:
“ POST /json/2/mrp.workorder/write Authorization: bearer <api-key> {"ids": [4711], "vals": {"date_start": "2026-11-03 06:00:00", "date_finished": "2026-11-03 09:30:00", "workcenter_id": 7}} “
JSON-2 accepteert elk methodeargument op naam, plus ids en context. Zo wordt write(vals) de sleutel vals. In 16.0 tot en met 18.0 verloopt dezelfde aanroep als execute_kw(db, uid, key, 'mrp.workorder', 'write', [[4711], vals]) via XML-RPC of JSON-RPC. In 16.0 heten de sleutels date_planned_start en date_planned_finished. Verstuur datums en tijden in UTC. Met een paar regels houdt u het terugschrijven correct:
- Verstuur beide datums in dezelfde aanroep.
- Voeg
workcenter_idalleen toe als de engine een alternatieve machine heeft gekozen. - Schrijf alleen planningsvelden, nooit hoeveelheden of BoMs.
Door de datums terug te schrijven, verschuift de reservering van het werkcentrum in Odoo. Daardoor tonen de planningsweergaven in Odoo het schema van SkyPlanner.
Van de productievloer terug naar Odoo. Operators registreren hun werk in SkyPlanner Mobile Confirmations. Voor elke terugmelding roept de integratie create aan op mrp.workcenter.productivity (JSON-2: POST /json/2/mrp.workcenter.productivity/create met vals_list). Daarbij worden workorder_id, workcenter_id, date_start, date_end en een loss_id van het type Productive ingevuld. De arbeidsuren en kosten worden in Odoo geboekt.
Zodra een bewerking klaar is, stelt de integratie het geproduceerde aantal in en roept ze button_finish aan op de productieorder. Na de laatste productieorder is de MO klaar voor button_mark_done. Elke terugmelding wordt één keer geboekt. De bijbehorende Odoo-record-ID wordt bij de SkyPlanner-tijdregistratie bewaard, zodat een opnieuw verstuurde webhook nooit een tweede Time Log aanmaakt.
Bij fabrieken die de Enterprise Shop Floor-app gebruiken, werkt dit andersom: SkyPlanner leest de status van de productieorder en qty_produced uit. Autopilot past de planning automatisch aan wanneer de productie verandert.
Gegevenseigenaarschap. Leg de regels vóór de ingebruikname vast:
| Gegevens | Eigenaar |
|---|---|
| Producten, BoMs, bewerkingen, hoeveelheden, MO-status | Odoo |
| Volgorde van productieorders, start- en eindtijden, keuze van werkcentrum | SkyPlanner |
| Omsteltijdenmatrix, eisen aan gereedschap en operators, alternatieve resources | SkyPlanner |
| Werkcentrumkalenders en Time Off | Eén systeem, te kiezen tijdens de scopebepaling |
| Time Logs, voorraad en kostencalculatie | Odoo, gevoed met terugmeldingen uit SkyPlanner |
Planners gebruiken de knoppen Plan en Unplan in Odoo niet meer voor MOs die SkyPlanner inplant. Anders reserveert Odoo zelf tijdvakken die de datums van SkyPlanner overschrijven.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Daarvóór gebruikt u de gratis proefperiode van 30 dagen met CSV-exports van uw eigen Odoo-gegevens. Het project zelf omvat:
- Mapping van stamgegevens: Odoo-modellen en -velden per versie (controleer
/docoffields_get), maateenheden en welk systeem de kalenders en Time Off beheert. - Opschonen: werkcentrumkalenders, Setup Time en Cleanup Time, en voor de duur van BoM-bewerkingen Fixed in plaats van Computed instellen.
- Eerste gegevensimport: producten, werkcentra met kalenders, BoMs en de bijbehorende bewerkingen.
- Synchronisatie van orders en inkooporders: bevestigde en lopende MO’s met de bijbehorende productieorders, plus
purchase.order-regels met hun verwachte aankomstdatums. - Planning terugschrijven: datums en werkcentra op
mrp.workorder, met rotatie van de API-sleutel aan de Odoo-kant. - Terugmeldingen van de productievloer: Time Logs en gereedmeldingen van productieorders terugsturen naar Odoo.
- Testen naast de huidige planning, daarna ingebruikname.
Valkuilen in Odoo
- Hernoemde datumvelden. Tot en met 16.0 bevatten
date_planned_startendate_planned_finishedde geplande datums endate_start/date_finishedde werkelijke datums. Vanaf 17.0 zijndate_startendate_finishedde geplande datums. Een mapping die uit een 16.0-project is overgenomen, leest op 17+ ongemerkt werkelijke datums als geplande datums. - Datums van productieorders zijn reserveringen. In 19.0 worden
date_startendate_finishedopmrp.workorderberekend op basis van eenresource.calendar.leaves-record (leave_id) in de werkcentrumkalender. Als u de datums op de productieorder schrijft, wordt die reservering bijgewerkt. Schrijf nooit rechtstreeks naar de verloftabel. - Gestarte productieorders blokkeren Unplan. Odoo weigert een MO uit de planning te halen wanneer “Some work orders have already started” (sommige productieorders zijn al gestart). Sla bij het terugschrijven productieorders met de status
progressofdoneover en verplaats alleen wat nog niet is gestart. - Bewerkingstijden veranderen. Bewerkingen met de instelling Computed ontlenen hun duur aan de laatste productieorders (standaard 10), bijgesteld op basis van Time Efficiency. Stel ze voor de proefperiode in op Fixed, of accepteer dat de invoerwaarden veranderen. Bewerkingen worden per BoM vastgelegd, zonder gedeelde stamgegevens voor de bewerkingsvolgorde. Elke BoM moet dus afzonderlijk worden opgeschoond.
- Onjuiste kalenders. Elk werkcentrum heeft een werktijdenkalender nodig. De eigen planner van Odoo zoekt tot 700 dagen vooruit en stopt dan met de melding “Impossible to plan the workorder” (de productieorder kan niet worden ingepland). Corrigeer de kalenders vóór de eerste gegevensimport.
- Maateenheden.
mrp.bom.lineheeft een eigenproduct_uom_id, die kan afwijken van de voorraadeenheid van het product. Reken de eenheden om voordat u de materiaalbeschikbaarheid controleert.
Wie configureert de Odoo-integratie?
Elke fabriek gebruikt Odoo anders: met eigen BoM-bewerkingen, werkcentrumkalenders, alternatieve werkcentra en maatwerkmodules. Het SkyPlanner-team heeft de expertise om de gegevensmapping op die inrichting af te stemmen.
- Het SkyPlanner-team configureert de integratie tijdens de onboarding voor uw Odoo-omgeving en biedt na de ingebruikname ondersteuning. De integratie gebruikt de REST API en webhooks van SkyPlanner en de JSON-2- of RPC-API van Odoo. Dit is de standaardaanpak.
- Uw Odoo-partner kan meewerken. De partner kent uw inrichting en maatwerkmodules en kan voortbouwen op dezelfde gedocumenteerde REST API. Daarmee kunnen orders, producten, materialen, processtappen en tijdregistraties worden gelezen en geschreven, met JWT-authenticatie en Swagger/OpenAPI-documentatie.
- Uw eigen ontwikkelaars kunnen hetzelfde doen, meestal met een kleine middlewaretoepassing naast Odoo of met een module op Odoo.sh of on-premise. Een API-sleutel is genoeg om te beginnen (integratiehandleiding). Het SkyPlanner-team helpt waar nodig.
Dezelfde aanpak wordt al in de praktijk gebruikt met andere ERP-systemen. Bij Laboratory & Allied bouwde het interne IT-team de integratie met SAP Business One grotendeels zelf, met hulp van SkyPlanner. UTU gebruikt SkyPlanner naast zijn ERP-systeem NetSuite.
Waarom de integratie loont
Juist het terugschrijven van gegevens maakt de integratie dagelijks waardevol. Zodra dit werkt:
- Odoo-productieorders krijgen concrete datums. De Arcturus AI-engine bepaalt in seconden de volgorde van alle openstaande MO’s. De berekende datums en gekozen werkcentra worden vastgelegd op
mrp.workorderen zijn zichtbaar in de planningsweergaven van Odoo. - Niemand hoeft handmatig te herplannen. Autopilot past het productieschema automatisch aan bij wijzigingen in de productie. De webhook stuurt de nieuwe datums naar Odoo.
- Terugmeldingen vanaf de productievloer maken de cirkel rond. Operators registreren hun werk op een telefoon of tablet met Mobile Confirmations, Production Timer en Quick Log Mode. Time Logs worden naar Odoo gestuurd voor voorraad en kostencalculatie. Planning en uitvoering komen samen in één tool, zowel op Community als op Enterprise.
- De planning houdt rekening met beperkingen die Odoo niet meeneemt. Een omsteltijdenmatrix legt per productpaar de volgordeafhankelijke omsteltijd vast. Gereedschappen hebben een beperkte capaciteit en worden door meerdere machines gedeeld. Een taak kan meerdere operators tegelijk vereisen. Als de primaire machine of medewerker niet beschikbaar is, wijkt de engine uit naar alternatieven. De datums die naar
mrp.workorderworden teruggeschreven, houden met al deze beperkingen rekening. - Materiaalaanvoer stuurt de planning. De aanwezige voorraad en openstaande inkooporders in Odoo vormen de basis voor materiaalgestuurd plannen. Bestelde componenten gelden als beschikbaar op de leverdatum van de PO. De voorraad wordt bijgewerkt zodra de PO als Delivered is gemarkeerd. Voor elke taak wordt gecontroleerd wat er in het magazijn ligt en wat er onderweg is.
U kunt het productieschema beoordelen voordat er integratiewerk nodig is. Start de gratis proefperiode van 30 dagen met CSV-exports en bekijk uw eigen Odoo-productieorders in het Gantt-diagram, met maximaal 20 werkstations en zonder creditcard. De prijs begint bij 199 € per maand, inclusief 5 werkstations, met maandelijkse facturering en opzegging op elk moment. U ontvangt vooraf een offerte voor de integratie, afgestemd op uw proces en behoeften, samen met uw abonnement. Zo kent u de volledige kosten voordat u begint. Bekijk de functies en klanten, of boek een demo.
Ervaringen van productiebedrijven met SkyPlanner
2 hbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
Bij UTU bespaart de productieplanning elke week 2 uur werktijd en bereikt een nieuwe werklijst de productielijn binnen enkele seconden.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, IT-manager
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkstations is in minder dan 30 minuten klaar.
1.000’enproductieorders automatisch ingepland
“We hebben de productie op een andere manier onder controle, en ons inzicht in de capaciteit ligt op een heel ander niveau.”
Hannu Ryynänen, CEO
Mamec · Industriële mengers, pompen en hightechproductie in opdracht
Duizenden productieorders worden automatisch ingepland en de hele organisatie heeft realtime inzicht in de productie.
99,2%leverbetrouwbaarheid
“Dankzij SkyPlanner zien we waar de knelpunten zitten en is de aansturing van de productie overzichtelijker geworden.”
Toni Tuori, productiemanager
Piristeel · Dakveiligheid en hemelwaterafvoersystemen
De leverbetrouwbaarheid bereikte dit jaar 99,2% en het inplannen bespaart tot vier uur werktijd per dag.
Veelgestelde vragen
Werkt de integratie op Odoo Online?
Ja, met het Custom-abonnement, via de externe API. One App Free en Standard bieden geen toegang tot de externe API en Standard werkt zonder maatwerkmodules. Met die abonnementen bent u dus beperkt tot import en export via CSV/XLSX.
Moeten we JSON-2 of XML-RPC gebruiken?
Gebruik JSON-2 voor Odoo 19.0 en hoger. Voor 16.0 tot en met 18.0 zijn XML-RPC en JSON-RPC nog nodig, maar volgens planning worden ze in Odoo 22 verwijderd.
Hoe komt het productieschema terug in Odoo?
Via de ORM-methode write op elke mrp.workorder: in 19.0 met POST /json/2/mrp.workorder/write en ids en vals, of in 16.0 tot en met 18.0 met execute_kw en write via XML-RPC of JSON-RPC. Het gaat om de waarden date_start, date_finished (date_planned_start en date_planned_finished in 16.0) en, indien gewijzigd, workcenter_id. Odoo verplaatst de reservering van het werkcentrum mee, zodat de planningsweergaven van Odoo de datums uit SkyPlanner tonen.
Hoe komen de terugmeldingen van operators in Odoo terecht?
Als Time Logs: de integratie maakt mrp.workcenter.productivity-records aan bij de productieorder, met een starttijd, eindtijd en een verliesreden van het type Productive. Zodra de bewerking klaar is, roept ze button_finish aan. Elke terugmelding wordt één keer geboekt, zodat herhaalde pogingen geen dubbele tijdregistraties opleveren.
Wie onderhoudt de integratie na de ingebruikname?
Het SkyPlanner-team configureert de integratie tijdens de onboarding en biedt na de ingebruikname ondersteuning, ook als uw Odoo-inrichting verandert en er aanpassingen nodig zijn. Als uw partner of uw ontwikkelaars de integratie bouwen, gebruiken zij de gedocumenteerde REST API en de SkyPlanner-documentatie. Het team helpt waar nodig.
Wat gebeurt er met productieorders die al zijn gestart?
Laat die bij het terugschrijven ongemoeid. Odoo blokkeert het uit de planning halen van een MO zodra een productieorder in uitvoering of afgerond is. SkyPlanner leest de status en voortgang en plant het resterende werk eromheen.
Hoelang duurt de Odoo-integratie?
De implementatie is normaal gesproken binnen enkele weken na de start van de onboarding afgerond. Begin met de proefperiode van 30 dagen op basis van CSV-exports. Zo heeft het productieschema zich al bewezen met uw eigen Odoo-gegevens voordat het werk aan de API begint.
