Odoo-Integrationsleitfaden für die Feinplanung mit SkyPlanner APS

Planen Sie die Entfernung schon jetzt ein. Odoo hat die Entfernung von XML-RPC und JSON-RPC angekündigt: in Odoo 22 (Herbst 2028) und Odoo Online 21.1 (Winter 2027). Setzen Sie für 19.0 auf JSON-2 und kapseln Sie den RPC-Zugriff für ältere Datenbanken in einem einzigen Adapter. So ist beim Upgrade nur eine Änderung nötig. Eigene Controller mit @route(type='jsonrpc') sind von der Entfernung nicht betroffen.

Authentifizierung

Legen Sie einen eigenen Integrationsbenutzer mit Lesezugriff auf Manufacturing und Inventory sowie Schreibzugriff auf Fertigungsaufträge an. Erstellen Sie seinen Schlüssel unter Preferences > Account Security > New API Key. In 19.0 sind Schlüssel höchstens drei Monate gültig. Die Middleware muss deshalb Schlüssel rotieren und bei Authentifizierungsfehlern einen Alarm auslösen können. Ohne diese Funktionen stoppt ein abgelaufener Schlüssel die Synchronisierung unbemerkt. Die REST API von SkyPlanner verwendet JWT; die Middleware verwaltet daher beide Zugangsdaten.

Jeder JSON-2-Aufruf läuft in einer eigenen SQL-Transaktion. Ein Schreibvorgang über mehrere Aufrufe ist daher nicht atomar. Schreiben Sie die Daten je Fertigungsauftrag und protokollieren Sie jedes Ergebnis.

Ereignisse

Odoo übermittelt Änderungen über Automatisierungsregeln. Eine Regel für mrp.production oder mrp.workorder mit dem Auslöser „On create and edit“ (Beim Erstellen und Bearbeiten) und der Aktion „Send Webhook Notification“ (Webhook-Benachrichtigung senden) schickt die ausgewählten Felder per POST an eine URL. Legen Sie die Regel in Studio oder im Entwicklermodus über das Formular „Automation Rules“ an. Ergänzen Sie eine regelmäßige search_read-Abfrage anhand von write_date, um Importe und alle von der Regel nicht erfassten Änderungen abzudecken. In der Gegenrichtung übertragen SkyPlanner-Webhooks Plan- und Statusänderungen, sobald sie auftreten.

Die Feldnamen unterscheiden sich je nach Version. In 19.0 listet jede Datenbank ihre Modelle, Felder und Methoden unter /doc auf; in älteren Versionen rufen Sie fields_get auf. Erstellen Sie die Zuordnung auf dieser Grundlage, nicht aus dem Gedächtnis.

„ 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 übernimmt alle Methodenargumente mit ihrem Namen sowie ids und context. Aus write(vals) wird also der Schlüssel vals. Unter 16.0 bis 18.0 erfolgt derselbe Aufruf als execute_kw(db, uid, key, 'mrp.workorder', 'write', [[4711], vals]) über XML-RPC oder JSON-RPC. Unter 16.0 heißen die Schlüssel date_planned_start und date_planned_finished. Datums- und Zeitangaben werden in UTC übergeben. Für saubere Schreibvorgänge gelten einige Regeln:

• Übertragen Sie beide Termine im selben Aufruf.
• Fügen Sie workcenter_id nur hinzu, wenn die Planungsengine eine alternative Maschine gewählt hat.
• Schreiben Sie nur in die Felder für die Feinplanung. Ändern Sie niemals Mengen oder Stücklisten.

Beim Schreiben der Termine wird auch Odoos eigene Belegung der Arbeitsstation verschoben. So zeigen die Planungsansichten in Odoo den Plan von SkyPlanner.

Rückmeldungen vom Shopfloor an Odoo. Bediener erfassen ihre Arbeit in SkyPlanner Mobile Confirmations. Für jede Rückmeldung ruft die Integration create auf mrp.workcenter.productivity auf (JSON-2: POST /json/2/mrp.workcenter.productivity/create mit vals_list). Sie befüllt workorder_id, workcenter_id, date_start, date_end sowie eine loss_id vom Typ Productive. Arbeitszeit und Kosten werden damit in Odoo verbucht.

Ist ein Arbeitsgang abgeschlossen, setzt die Integration die gefertigte Menge und ruft button_finish am Fertigungsauftrag auf. Nach dem letzten Fertigungsauftrag ist der Produktionsauftrag bereit für button_mark_done. Jede Rückmeldung wird genau einmal gebucht. Die ID ihres Odoo-Datensatzes wird bei der SkyPlanner-Zeitbuchung gespeichert, sodass ein erneut zugestellter Webhook niemals einen zweiten Time Log erzeugt.

In Betrieben, die die Enterprise Shop Floor-App nutzen, läuft es umgekehrt: SkyPlanner liest den Status des Fertigungsauftrags und qty_produced aus. Autopilot plant automatisch neu, sobald sich in der Produktion etwas ändert.

Datenhoheit. Halten Sie die Regeln vor dem Go-live schriftlich fest:

Bei Produktionsaufträgen, die SkyPlanner plant, dürfen Planer in Odoo die Schaltflächen Plan und Unplan nicht mehr verwenden. Andernfalls bucht Odoo eigene Zeitfenster und überschreibt damit die Termine von SkyPlanner.

• Umbenannte Datumsfelder. Bis 16.0 enthielten date_planned_start und date_planned_finished die Plantermine und date_start/date_finished die Isttermine. Ab 17.0 stehen die Plantermine in date_start und date_finished. Eine aus einem 16.0-Projekt kopierte Zuordnung liest unter 17+ unbemerkt Isttermine als Plantermine ein.
• Fertigungsauftragstermine sind Kalenderbuchungen. Unter 19.0 werden date_start und date_finished auf mrp.workorder aus einem resource.calendar.leaves-Datensatz (leave_id) im Kalender der Arbeitsstation berechnet. Wer die Termine am Fertigungsauftrag schreibt, aktualisiert damit diese Buchung. Schreiben Sie niemals direkt in die Abwesenheitstabelle.
• Gestartete Fertigungsaufträge verhindern das Aufheben der Planung. Odoo lässt die Planung eines Produktionsauftrags nicht aufheben, wenn die Meldung „Some work orders have already started“ (Einige Fertigungsaufträge wurden bereits gestartet) erscheint. Überspringen Sie beim Zurückschreiben Fertigungsaufträge im Status progress oder done und verschieben Sie nur solche, die noch nicht begonnen haben.
• Schwankende Vorgangsdauern. Bei Arbeitsgängen mit der Einstellung Computed wird die Dauer aus den letzten Fertigungsaufträgen ermittelt (standardmäßig 10) und anhand von Time Efficiency skaliert. Stellen Sie sie für die Testphase auf Fixed oder nehmen Sie wechselnde Eingangswerte in Kauf. Die Arbeitsgänge sind in jeder Stückliste einzeln hinterlegt; einen gemeinsamen Arbeitsplanstamm gibt es nicht. Deshalb muss jede Stückliste separat bereinigt werden.
• Fehlerhafte Kalender. Jede Arbeitsstation braucht einen Arbeitszeitkalender. Odoos eigene Planung sucht bis zu 700 Tage im Voraus und bricht dann mit „Impossible to plan the workorder“ (Fertigungsauftrag kann nicht eingeplant werden) ab. Korrigieren Sie die Kalender vor dem Erstimport.
• Maßeinheiten. mrp.bom.line hat eine eigene product_uom_id, die von der Lagereinheit des Produkts abweichen kann. Rechnen Sie die Einheiten um, bevor Sie die Materialverfügbarkeit prüfen.

Erst das Zurückschreiben der Daten macht die Integration im Alltag wertvoll. Sobald es läuft:

• Odoo-Fertigungsaufträge erhalten konkrete Termine. Arcturus AI bringt alle offenen Produktionsaufträge in Sekunden in die richtige Reihenfolge. Die berechneten Termine und gewählten Arbeitsstationen werden in mrp.workorder übernommen und erscheinen dort in den Planungsansichten von Odoo.
• Niemand plant von Hand um. Autopilot plant automatisch neu, wenn sich in der Produktion etwas ändert. Der Webhook überträgt die neuen Termine an Odoo.
• Rückmeldungen vom Shopfloor schließen den Kreis. Bediener erfassen ihre Arbeit per Smartphone oder Tablet mit Mobile Confirmations, Production Timer und Quick Log Mode. Time Logs werden für Lagerbestände und Kalkulation an Odoo übermittelt. Feinplanung und Ausführung laufen in einem Werkzeug – sowohl mit Community als auch mit Enterprise.
• Der Plan berücksichtigt Restriktionen, die Odoo nicht abbildet. Eine Rüstzeitmatrix legt reihenfolgeabhängige Umrüstzeiten für jedes Produktpaar fest. Werkzeuge sind begrenzt verfügbare Ressourcen, die sich mehrere Maschinen teilen. Ein Arbeitsgang kann mehrere Bediener gleichzeitig benötigen. Ist die primäre Maschine oder das vorgesehene Personal nicht verfügbar, weicht die Planungsengine auf Alternativen aus. Die in mrp.workorder zurückgeschriebenen Termine berücksichtigen all diese Restriktionen.
• Der Materialeingang bestimmt den Plan. Lagerbestände und offene Bestellungen aus Odoo fließen in die materialgesteuerte Feinplanung ein. Bestellte Komponenten gelten zum Liefertermin der Bestellung als verfügbar. Wird die Bestellung als Delivered markiert, aktualisiert sich der Bestand. Für jeden Arbeitsgang wird geprüft, was im Lager liegt und was unterwegs ist.

Sie können den Plan beurteilen, bevor die Integrationsarbeit beginnt. Starten Sie die 30-tägige kostenlose Testphase mit CSV-Exporten und sehen Sie Ihre eigenen Odoo-Fertigungsaufträge im Gantt-Diagramm – mit bis zu 20 Arbeitsstationen und ohne Kreditkarte. Die Preise beginnen bei 199 € pro Monat inklusive 5 Arbeitsstationen, bei monatlicher Abrechnung und jederzeitiger Kündigungsmöglichkeit. Für die Integration erhalten Sie vorab ein auf Ihre Abläufe und Anforderungen abgestimmtes Angebot zusammen mit Ihrem Tarif. So kennen Sie die Gesamtkosten, bevor Sie starten. Entdecken Sie die Funktionen und unsere Kunden oder buchen Sie eine Demo.