Przewodnik po integracji Odoo ze SkyPlanner APS do harmonogramowania produkcji

Już teraz przygotuj się na wycofanie tych interfejsów. Odoo zaplanowało wycofanie XML-RPC i JSON-RPC w Odoo 22 (jesień 2028) i Odoo Online 21.1 (zima 2027). Dla wersji 19.0 buduj integrację na JSON-2, a obsługę RPC dla starszych baz wydziel do jednego adaptera. Dzięki temu aktualizacja będzie wymagała zmiany tylko w jednym miejscu. Wycofanie nie obejmuje własnych kontrolerów z @route(type='jsonrpc').

Uwierzytelnianie

Utwórz osobne konto użytkownika do integracji z prawem odczytu w modułach Manufacturing i Inventory oraz prawem zapisu zleceń produkcyjnych. Wygeneruj dla niego klucz w Preferences > Account Security > New API Key. W wersji 19.0 klucze są ważne najwyżej trzy miesiące, więc warstwa pośrednia musi obsługiwać rotację kluczy i alerty o błędach uwierzytelniania. Bez tego wygaśnięcie klucza niezauważenie zatrzyma synchronizację. Po stronie SkyPlanner REST API korzysta z JWT, dlatego warstwa pośrednia przechowuje dane uwierzytelniające obu systemów.

Każde wywołanie JSON-2 odbywa się w osobnej transakcji SQL, więc zapis rozłożony na kilka wywołań nie jest atomowy. Zapisuj każde zlecenie produkcyjne osobno i rejestruj wynik każdej operacji.

Zdarzenia

Odoo wysyła zmiany za pomocą reguł automatyzacji. Reguła dla mrp.production lub mrp.workorder z wyzwalaczem On create and edit oraz akcją „Send Webhook Notification” (wyślij powiadomienie webhook) wysyła żądanie POST z wybranymi polami pod wskazany adres URL. Utwórz regułę w Studio lub w trybie deweloperskim, w formularzu Automation Rules. Uzupełnij ją o cykliczne odpytywanie przez search_read na podstawie write_date, aby wychwycić importy i wszystko, co pominęła reguła. W przeciwnym kierunku webhooki SkyPlanner wysyłają zmiany harmonogramu i statusów na bieżąco.

Nazwy pól różnią się między wersjami. W wersji 19.0 każda baza udostępnia listę swoich modeli, pól i metod pod /doc; w starszych wersjach wywołaj fields_get. Na tej podstawie przygotuj mapowanie — nie z pamięci.

„ 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 przyjmuje każdy argument metody po nazwie, a dodatkowo ids i context, więc argument z write(vals) trafia pod klucz vals. W wersjach od 16.0 do 18.0 to samo wywołanie ma postać execute_kw(db, uid, key, 'mrp.workorder', 'write', [[4711], vals]) przez XML-RPC lub JSON-RPC, a w wersji 16.0 klucze to date_planned_start i date_planned_finished. Daty i godziny przesyłaj w UTC. Kilka zasad pozwala uniknąć błędów przy zapisie:

• Przesyłaj obie daty w jednym wywołaniu.
• Dodawaj workcenter_id tylko wtedy, gdy silnik wybrał alternatywną maszynę.
• Zapisuj tylko pola związane z harmonogramowaniem — nigdy ilości ani BoM.

Zapis dat przesuwa rezerwację gniazda produkcyjnego w Odoo, dzięki czemu widoki planowania w Odoo pokazują plan ze SkyPlanner.

Dane z hali produkcyjnej z powrotem w Odoo. Operatorzy rejestrują pracę w SkyPlanner Mobile Confirmations. Dla każdego potwierdzenia integracja wywołuje create na mrp.workcenter.productivity (JSON-2: POST /json/2/mrp.workcenter.productivity/create z vals_list). Wypełnia pola workorder_id, workcenter_id, date_start, date_end oraz loss_id typu Productive, a czas pracy i koszty są rejestrowane w Odoo.

Po zakończeniu operacji integracja ustawia wyprodukowaną ilość i wywołuje button_finish na zleceniu produkcyjnym. Zakończenie ostatniego zlecenia produkcyjnego przygotowuje MO do wywołania button_mark_done. Każde potwierdzenie jest zapisywane raz, a identyfikator jego rekordu w Odoo jest przechowywany przy wpisie czasu pracy w SkyPlanner. Dzięki temu ponowienie webhooka nigdy nie tworzy drugiego wpisu Time Logs.

W zakładach korzystających z aplikacji Enterprise Shop Floor kierunek jest odwrotny: SkyPlanner odczytuje status zlecenia produkcyjnego i qty_produced, a Autopilot automatycznie aktualizuje harmonogram po zmianach w produkcji.

Odpowiedzialność za dane. Spisz zasady przed uruchomieniem produkcyjnym:

Planiści przestają używać przycisków Plan i Unplan w Odoo dla MO harmonogramowanych przez SkyPlanner. W przeciwnym razie Odoo rezerwuje własne przedziały czasowe, nadpisując terminy ze SkyPlanner.

• Zmiany nazw pól dat. Do wersji 16.0 włącznie pola date_planned_start i date_planned_finished przechowywały plan, a date_start/date_finished — rzeczywiste terminy. Od wersji 17.0 pola date_start i date_finished oznaczają terminy planowane. Mapowanie skopiowane z projektu dla wersji 16.0 w wersjach 17+ odczytuje rzeczywiste terminy jako planowane, nie sygnalizując błędu.
• Terminy zleceń produkcyjnych są rezerwacjami. W wersji 19.0 pola date_start i date_finished w mrp.workorder są obliczane na podstawie rekordu resource.calendar.leaves (leave_id) w kalendarzu gniazda produkcyjnego. Zapis terminów na zleceniu produkcyjnym aktualizuje tę rezerwację. Nigdy nie zapisuj danych bezpośrednio w tabeli nieobecności.
• Rozpoczęte zlecenia produkcyjne blokują Unplan. Odoo odmawia wycofania MO z planu, gdy „Some work orders have already started” (niektóre zlecenia produkcyjne zostały już rozpoczęte). Przy zapisie do Odoo pomijaj zlecenia produkcyjne w statusach progress i done. Przesuwaj tylko te, których jeszcze nie rozpoczęto.
• Czasy trwania się zmieniają. Operacje ustawione na Computed pobierają czas trwania z ostatnich zleceń produkcyjnych (domyślnie 10), z uwzględnieniem współczynnika Time Efficiency. Na czas okresu próbnego ustaw Fixed lub zaakceptuj zmienność danych wejściowych. Operacje są definiowane w każdym BoM osobno, bez wspólnej kartoteki marszrut technologicznych, dlatego każdy BoM wymaga oddzielnego uporządkowania.
• Błędne kalendarze. Każde gniazdo produkcyjne potrzebuje kalendarza godzin pracy. Mechanizm planowania Odoo szuka wolnego terminu do 700 dni naprzód, a następnie zatrzymuje się z komunikatem „Impossible to plan the workorder” (Nie można zaplanować zlecenia produkcyjnego). Popraw kalendarze przed pierwszym wczytaniem danych.
• Jednostki miary. mrp.bom.line ma własne pole product_uom_id, które może wskazywać inną jednostkę niż magazynowa jednostka produktu. Przelicz jednostki przed sprawdzeniem dostępności materiałów.

To zapis danych z powrotem do Odoo sprawia, że integracja przynosi korzyści w codziennej pracy. Gdy już działa:

• Zlecenia produkcyjne Odoo mają wykonalne terminy. Silnik Arcturus AI w kilka sekund ustala kolejność wszystkich otwartych MO. Wyznaczone terminy i wybrane stanowiska robocze trafiają do mrp.workorder i są widoczne w widokach planowania Odoo.
• Bez ręcznego przeplanowywania. Autopilot automatycznie zmienia harmonogram, gdy zmienia się sytuacja na produkcji, a webhook przesyła nowe terminy do Odoo.
• Dane z hali wracają do systemu. Operatorzy rejestrują pracę na telefonie lub tablecie za pomocą Mobile Confirmations, Production Timer i Quick Log Mode, a Time Logs trafiają do Odoo na potrzeby aktualizacji stanów magazynowych i kalkulacji kosztów. Harmonogramowanie i realizacja produkcji odbywają się w jednym narzędziu, zarówno w Community, jak i Enterprise.
• Harmonogram uwzględnia ograniczenia, których nie obsługuje Odoo. Macierz czasów przezbrojenia określa czas zmiany dla każdej pary produktów, zależnie od ich kolejności. Narzędzia to zasoby produkcyjne o ograniczonej dostępności, współdzielone przez maszyny, a operacja może wymagać kilku operatorów jednocześnie. Gdy podstawowa maszyna lub pracownik są niedostępni, silnik wybiera alternatywne maszyny lub personel. Terminy zapisywane z powrotem w mrp.workorder uwzględniają wszystkie te ograniczenia.
• Plan uwzględnia dostawy materiałów. Bieżące stany magazynowe i otwarte zamówienia zakupu w Odoo zasilają harmonogramowanie oparte na dostępności materiałów. Zamówione komponenty są uznawane za dostępne w terminie dostawy PO, a stan magazynowy aktualizuje się po oznaczeniu PO jako Delivered. Dla każdej operacji sprawdzane są materiały w magazynie oraz te, które są w drodze.

Możesz ocenić harmonogram jeszcze przed rozpoczęciem prac integracyjnych. Rozpocznij 30-dniowy bezpłatny okres próbny, korzystając z eksportów CSV, i zobacz własne zlecenia produkcyjne z Odoo na wykresie Gantta — do 20 stanowisk, bez karty kredytowej. Ceny zaczynają się od 199 € miesięcznie za 5 stanowisk, z rozliczeniem miesięcznym i możliwością rezygnacji w dowolnym momencie. Integrację wyceniamy z góry, zgodnie z Twoim procesem i potrzebami, razem z wybranym planem. Dzięki temu znasz pełny koszt przed rozpoczęciem. Zobacz funkcje i historie klientów lub umów prezentację.