Sprievodca integráciou Odoo so SkyPlanner APS na rozvrhovanie výroby

Pripravte sa na odstránenie už teraz. Odoo plánuje odstrániť XML-RPC a JSON-RPC vo verziách Odoo 22 (jeseň 2028) a Odoo Online 21.1 (zima 2027). Pre verziu 19.0 postavte integráciu na JSON-2 a prístup cez RPC pre staršie databázy oddeľte do jedného adaptéra, aby pri aktualizácii stačila jediná zmena. Odstránenie sa netýka vlastných kontrolérov s @route(type='jsonrpc').

Autentifikácia

Vytvorte samostatného používateľa pre integráciu s právom na čítanie v moduloch Manufacturing a Inventory a právom na zápis do výrobných príkazov. Kľúč mu vygenerujte cez Preferences > Account Security > New API Key. Vo verzii 19.0 platia kľúče najviac tri mesiace, preto musí middleware zabezpečovať ich rotáciu a upozorňovať na zlyhania autentifikácie. Bez toho synchronizáciu nepozorovane zastaví kľúč, ktorému uplynula platnosť. Na strane SkyPlanner používa REST API autentifikáciu JWT, takže middleware uchováva oba prihlasovacie údaje.

Každé volanie JSON-2 prebieha vo vlastnej SQL transakcii, takže zápis rozdelený do viacerých volaní nie je atómový. Zapisujte po jednotlivých výrobných príkazoch a zaznamenajte každý výsledok.

Udalosti

Odoo odosiela zmeny prostredníctvom automatizačných pravidiel. Pravidlo pre mrp.production alebo mrp.workorder so spúšťačom On create and edit a akciou „Send Webhook Notification“ (Odoslať oznámenie cez webhook) odošle požiadavku POST s vybranými poľami na URL. Pravidlo vytvorte v Studio alebo vo vývojárskom režime cez formulár Automation Rules. Doplňte ho pravidelným čítaním cez search_read podľa write_date, aby ste zachytili importy aj všetko, čo pravidlo vynechalo. V opačnom smere webhooky SkyPlanner odosielajú zmeny rozvrhu a stavu hneď, ako nastanú.

Názvy polí sa medzi verziami líšia. Vo verzii 19.0 má každá databáza zoznam svojich modelov, polí a metód na /doc; v starších verziách zavolajte fields_get. Pri mapovaní vychádzajte z týchto údajov, nie z pamäti.

„ 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 prijíma všetky argumenty metódy podľa názvu spolu s ids a context, takže argument z volania write(vals) sa odovzdáva pod kľúčom vals. Vo verziách 16.0 až 18.0 sa rovnaké volanie vykonáva ako execute_kw(db, uid, key, 'mrp.workorder', 'write', [[4711], vals]) cez XML-RPC alebo JSON-RPC a vo verzii 16.0 sa používajú kľúče date_planned_start a date_planned_finished. Dátumy a časy sa odosielajú v UTC. Pri zápise dodržujte tieto pravidlá:

• Oba dátumy odošlite v tom istom volaní.
• workcenter_id pridajte iba vtedy, keď plánovací algoritmus vybral alternatívny stroj.
• Zapisujte len do polí rozvrhovania, nikdy nemeňte množstvá ani kusovníky.

Zápis dátumov posunie aj rezerváciu pracoviska v Odoo, takže plánovacie zobrazenia Odoo ukazujú plán zo SkyPlanner.

Údaje z dielne späť do Odoo. Operátori zaznamenávajú prácu v SkyPlanner Mobile Confirmations. Pri každom potvrdení integrácia zavolá create na mrp.workcenter.productivity (JSON-2: POST /json/2/mrp.workcenter.productivity/create s vals_list). Vyplní workorder_id, workcenter_id, date_start, date_end a loss_id typu Productive a v Odoo sa zaeviduje pracovný čas a náklady.

Po dokončení operácie integrácia nastaví vyrobené množstvo a zavolá button_finish na výrobnom príkaze. Dokončením posledného výrobného príkazu je výrobná zákazka pripravená na button_mark_done. Každé potvrdenie sa zapíše iba raz a ID jeho záznamu v Odoo sa uloží k časovému záznamu v SkyPlanner, takže opakovaný webhook nikdy nevytvorí druhý záznam Time Log.

V závodoch, ktoré používajú aplikáciu Enterprise Shop Floor, je tok opačný: SkyPlanner číta stav výrobného príkazu a qty_produced a Autopilot pri zmenách vo výrobe automaticky prepočíta rozvrh.

Zodpovednosť za údaje. Pred spustením ostrej prevádzky si pravidlá písomne stanovte:

Plánovači prestanú v Odoo používať tlačidlá Plan a Unplan pri výrobných zákazkách, ktoré rozvrhuje SkyPlanner. Inak Odoo vytvorí vlastné časové rezervácie a prepíše termíny zo SkyPlanner.

• Premenované polia s termínmi. Do verzie 16.0 vrátane obsahovali polia date_planned_start a date_planned_finished plánované termíny a date_start/date_finished skutočné termíny. Od verzie 17.0 sú date_start a date_finished plánované termíny. Mapovanie skopírované z projektu pre verziu 16.0 vo verziách 17+ bez upozornenia načíta skutočné termíny ako plánované.
• Termíny výrobných príkazov sú rezervácie. Vo verzii 19.0 sa date_start a date_finished v mrp.workorder vypočítavajú zo záznamu resource.calendar.leaves (leave_id) v kalendári pracoviska. Zápis termínov do výrobného príkazu aktualizuje túto rezerváciu. Nikdy nezapisujte priamo do tabuľky neprítomností.
• Začaté výrobné príkazy blokujú funkciu Unplan. Odoo odmietne zrušiť naplánovanie výrobnej zákazky a zobrazí hlásenie „Some work orders have already started“ (Niektoré výrobné príkazy sa už začali). Pri spätnom zápise vynechajte výrobné príkazy v stave progress alebo done a presúvajte iba tie, ktoré sa ešte nezačali.
• Trvanie operácií sa mení. Operácie s nastavením Computed preberajú trvanie z posledných výrobných príkazov (predvolene 10), upravené podľa Time Efficiency. Na skúšobné obdobie ich nastavte na Fixed alebo počítajte s meniacimi sa vstupmi. Operácie sú uložené v jednotlivých kusovníkoch, bez spoločného kmeňového technologického postupu, takže každý kusovník treba upraviť samostatne.
• Nesprávne kalendáre. Každé pracovisko potrebuje kalendár pracovného času. Vlastný plánovač Odoo hľadá voľný termín až 700 dní dopredu a potom sa zastaví s hlásením „Impossible to plan the workorder“ (Výrobný príkaz sa nedá naplánovať). Kalendáre opravte pred prvým načítaním.
• Merné jednotky. mrp.bom.line má vlastné pole product_uom_id, ktoré sa môže líšiť od skladovej jednotky výrobku. Pred kontrolou dostupnosti materiálu jednotky prepočítajte.

Práve vďaka spätnému zápisu údajov je integrácia užitočná každý deň. Keď spätný zápis funguje:

• Výrobné príkazy v Odoo obsahujú reálne termíny. Arcturus AI v priebehu sekúnd určí poradie všetkých otvorených výrobných zákaziek. Výsledné termíny a vybrané pracoviská sa zapíšu do mrp.workorder, kde ich zobrazujú plánovacie pohľady Odoo.
• Nikto nemusí ručne preplánovávať. Autopilot pri zmenách vo výrobe automaticky upraví rozvrh a webhook odošle nové termíny do Odoo.
• Spätná väzba priamo z dielne. Operátori zaznamenávajú prácu na telefóne alebo tablete pomocou funkcií Mobile Confirmations, Production Timer a Quick Log Mode. Time Logs sa prenášajú do Odoo na evidenciu zásob a kalkuláciu nákladov. Rozvrhovanie aj realizácia výroby prebiehajú v jednom nástroji, v edícii Community aj Enterprise.
• Rozvrh rešpektuje aj obmedzenia, ktoré Odoo nezohľadňuje. Matica časov nastavenia určuje časy prestavenia podľa poradia pre každú dvojicu výrobkov. Nástroje sú zdroje s obmedzenou kapacitou zdieľané medzi strojmi a jedna operácia môže vyžadovať viacerých operátorov naraz. Ak primárny stroj alebo pracovník nie je dostupný, plánovací algoritmus využije alternatívy. Termíny zapísané späť do mrp.workorder rešpektujú všetky tieto obmedzenia.
• Plán sa riadi príchodom materiálu. Stav zásob a otvorené nákupné objednávky v Odoo slúžia ako podklady pre rozvrhovanie podľa dostupnosti materiálu. Objednané komponenty sa považujú za dostupné v deň dodania uvedený v nákupnej objednávke a zásoby sa aktualizujú po jej označení ako Delivered. Pri každej operácii sa overuje, čo je na sklade a čo je na ceste.

Rozvrh môžete posúdiť ešte pred začatím prác na integrácii. Spustite si 30-dňovú bezplatnú skúšobnú verziu s exportmi CSV a pozrite si vlastné výrobné príkazy z Odoo v Ganttovom diagrame, až s 20 pracoviskami a bez platobnej karty. Cena začína od 199 € mesačne a zahŕňa 5 pracovísk, s mesačnou fakturáciou a možnosťou kedykoľvek zrušiť predplatné. Cenovú ponuku na integráciu dostanete vopred podľa svojich procesov a potrieb spolu s ponukou programu, takže celkové náklady poznáte ešte pred začiatkom. Pozrite si funkcie a zákazníkov alebo si rezervujte ukážku.