Ghid de integrare Odoo pentru programarea producției cu SkyPlanner APS
Acest ghid le arată partenerilor Odoo, dezvoltatorilor și responsabililor IT cum să conecteze Odoo Manufacturing la SkyPlanner APS. Pentru argumentele economice și funcțiile pe care le oferă deja butonul Plan din Odoo, consultați pagina despre programarea producției în Odoo și articolul Oferă Odoo programare cu capacitate finită?.
Odoo rămâne sistemul de referință pentru produse, liste de materiale, operații, ordine de fabricație, stocuri și calculul costurilor. SkyPlanner construiește programul pe baza acestor date, cu ajutorul motorului Arcturus. Integrarea cu Odoo funcționează în ambele sensuri:
- Sunt preluate ordinele de fabricație, comenzile de producție, operațiile din BoM, centrele de lucru și comenzile de achiziție.
- Datele planificate de început și de sfârșit, precum și centrele de lucru sunt actualizate în
mrp.workorder. - Progresul și timpul înregistrat sunt trimise înapoi ca Time Logs în Odoo.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
În etapa de punere în funcțiune, echipa SkyPlanner configurează integrarea prin API-ul extern standard al Odoo, adaptată la versiunea, găzduirea și personalizările dumneavoastră, apoi asigură asistență după lansare. Acest ghid se adresează partenerilor și dezvoltatorilor care vor să participe sau să dezvolte singuri soluții folosind API-ul REST documentat al SkyPlanner (documentația de referință API). Gestionarea produselor, materialelor și comenzilor de achiziție este descrisă în documentația publică SkyPlanner.
Pasul zero: verificați abonamentul și găzduirea Odoo
Aflați mai întâi ce variantă Odoo folosește clientul. Aceasta determină abordarea.
| Configurație | API extern | Module personalizate | Soluție practică |
|---|---|---|---|
| Odoo Online, One App Free sau Standard | Nu | Nu | CSV/XLSX sau trecere la abonamentul Custom |
| Odoo Online, abonament Custom | Da | Nu | API extern |
| Odoo.sh (abonament Custom) | Da | Da | API extern, modul opțional |
| Găzduire locală, Community sau Enterprise | Da | Da | API extern, modul opțional |
Documentația API Odoo precizează că accesul la API-ul extern este “only available on Custom Odoo pricing plans” (disponibil doar cu abonamentele Odoo Custom), nu și cu One App Free sau Standard. Pagina de prețuri descrie Standard ca fiind găzduit pe Odoo Online “without custom modules” (fără module personalizate). Clarificați acest aspect la analiza inițială, nu la jumătatea dezvoltării.
Opțiunile de integrare Odoo
| Opțiune | Versiuni | Autentificare | Rol în integrarea pentru programarea producției |
|---|---|---|---|
API extern JSON-2: POST /json/2/<model>/<method> | Introdus în 19.0 | Cheie API în Authorization: bearer <key>, antet opțional X-Odoo-Database | Opțiunea implicită pentru implementări noi: search_read pentru citire, write pentru scrierea datelor calendaristice înapoi în Odoo |
XML-RPC / JSON-RPC extern: /xmlrpc/2, /jsonrpc, serviciile common, object | Până la 19.0; eliminare programată | common.authenticate cu nume de utilizator și parolă sau cheie API, apoi execute_kw | Necesar pentru clienții care folosesc versiunile 16.0–18.0 |
| Controlere personalizate într-un modul | Toate | În funcție de rută, de exemplu auth='bearer' | Date grupate: un MO împreună cu comenzile sale de producție, într-un singur apel |
| Reguli de automatizare: „Send Webhook Notification” (Trimite notificare webhook) | În documentație începând cu 17.0 | Trimiterea unei cereri POST către un URL | Trimitere la crearea sau modificarea MO-urilor și a comenzilor de producție |
| Import de înregistrări (CSV, XLSX) și export | Toate | Sesiune de utilizator | Date pentru testare și încărcări unice ale nomenclatoarelor |
Pregătiți-vă de acum pentru eliminare. Odoo a programat eliminarea XML-RPC și JSON-RPC în Odoo 22 (toamna 2028) și Odoo Online 21.1 (iarna 2027). Pentru 19.0, construiți integrarea pe JSON-2, iar pentru bazele de date mai vechi, izolați accesul RPC într-un singur adaptor. Astfel, actualizarea va necesita o singură modificare. Controlerele personalizate cu @route(type='jsonrpc') nu sunt afectate de eliminare.
Autentificare
Creați un utilizator dedicat integrării, cu drepturi de citire pentru Manufacturing și Inventory și drepturi de scriere pentru comenzile de producție. Generați cheia acestuia din Preferences > Account Security > New API Key. În versiunea 19.0, cheile sunt valabile cel mult trei luni, așa că aplicația middleware trebuie să asigure rotația cheilor și să emită alerte la erorile de autentificare. Fără acestea, o cheie expirată oprește sincronizarea fără ca cineva să observe. Pe partea SkyPlanner, API-ul REST folosește JWT, deci aplicația middleware păstrează ambele credențiale.
Fiecare apel JSON-2 rulează într-o tranzacție SQL proprie, deci o scriere împărțită între mai multe apeluri nu este atomică. Efectuați scrierea separat pentru fiecare comandă de producție și înregistrați fiecare rezultat în jurnal.
Evenimente
Odoo transmite modificările prin reguli de automatizare. O regulă pe mrp.production sau mrp.workorder, cu declanșatorul On create and edit și acțiunea „Send Webhook Notification” (Trimite notificare webhook), trimite o cerere POST cu câmpurile selectate către un URL. Creați regula în Studio sau, în modul dezvoltator, din formularul Automation Rules. Completați-o cu o interogare periodică search_read pe write_date, pentru a prelua importurile și orice modificare omisă de regulă. În sens invers, webhook-urile SkyPlanner transmit modificările programului de producție și ale stărilor pe măsură ce apar.
Denumirile câmpurilor diferă între versiuni. În 19.0, fiecare bază de date își listează modelele, câmpurile și metodele la /doc; în versiunile mai vechi, apelați fields_get. Stabiliți corespondențele pe baza acestor informații, nu din memorie.
Maparea datelor: din Odoo în SkyPlanner
| Model Odoo | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
product.product / product.template (default_code, uom_id, qty_available) | Produs sau material | Odoo → SkyPlanner | Încărcare inițială, apoi zilnic sau la modificare |
mrp.bom (product_tmpl_id, product_qty, produce_delay), mrp.bom.line (product_id, product_qty, operation_id), mrp.bom.byproduct | Produs cu structură pe mai multe niveluri, necesar de materiale pentru fiecare etapă | Odoo → SkyPlanner | La modificare |
mrp.routing.workcenter (fila Operations: workcenter_id, sequence, time_mode, time_cycle_manual, blocked_by_operation_ids) | Etape de proces, cu ordinea și durata de execuție | Odoo → SkyPlanner | La modificare |
mrp.workcenter (resource_calendar_id, time_efficiency, time_start, time_stop, alternative_workcenter_ids) | Centru de lucru, eficiență, pregătire și încheiere, centre de lucru alternative | Odoo → SkyPlanner, apoi datele sunt întreținute în SkyPlanner | Încărcare inițială |
mrp.workcenter.capacity (capacity) | Piese pe ciclu, timpi de pregătire și de încheiere specifici produsului | Odoo → SkyPlanner | Încărcare inițială |
resource.calendar, resource.calendar.attendance, resource.calendar.leaves | Schimburi și absențe | Odoo → SkyPlanner | Încărcare inițială, absențe la modificare |
mrp.production (product_id, product_qty, date_deadline, priority, state, workorder_ids) | Comandă cu termen de finalizare și prioritate | Odoo → SkyPlanner | Webhook la confirmare, plus interogare periodică |
mrp.workorder (operation_id, workcenter_id, duration_expected, state) | Operație pe un centru de lucru | Odoo → SkyPlanner | Webhook, plus interogare periodică |
stock.quant, stock.move (mișcări de componente) | Stoc existent și necesar de materiale pentru programarea în funcție de disponibilitatea materialelor | Odoo → SkyPlanner | Periodic, de exemplu la intervale de 15 până la 60 de minute |
purchase.order (partner_id, state), purchase.order.line (product_id, product_qty, date_planned, qty_received) | Comenzi de achiziție și materiale în curs de aprovizionare, disponibile la data estimată a livrării | Odoo → SkyPlanner | Webhook la confirmarea sau modificarea comenzii de achiziție, plus aceeași interogare periodică |
| Date planificate de început și de sfârșit, centru de lucru | mrp.workorder.date_start, date_finished, workcenter_id | SkyPlanner → Odoo | La modificarea programului de producție, prin webhook SkyPlanner |
| Mobile Confirmations, înregistrări de timp | mrp.workcenter.productivity (Time Logs: workcenter_id, workorder_id, date_start, date_end, loss_id) | SkyPlanner → Odoo | La fiecare confirmare |
| Cantitate realizată, operație finalizată | qty_producing pe comanda de producție, apoi button_finish; button_mark_done pe MO | SkyPlanner → Odoo sau înregistrare directă în Odoo Shop Floor | La fiecare confirmare |
Modele de integrare
Mai întâi, nomenclatoarele.
Încărcați centrele de lucru și calendarele, apoi produsele, listele de materiale (BoM) și operațiile, care fac referire la centrele de lucru. În perioada de testare de 30 de zile, aceleași liste sunt încărcate din exporturi CSV. Instrumentul Import and Export din Odoo funcționează în orice vizualizare de tip listă.
Sincronizarea comenzilor.
Preluați MO-urile în stările confirmed și progress, împreună cu comenzile lor de producție. Excludeți MO-urile în ciornă sau tratați-le ca cerere provizorie. Subansamblurile cu propriul BoM pot fi preluate ca MO-uri subordonate separate, iar Odoo planifică fiecare MO independent. Asociați-le cu subprodusele din SkyPlanner, astfel încât subansamblurile să fie finalizate înainte de începerea ansamblului părinte.
Scrierea programului înapoi în Odoo.
Când programul de producție se modifică, un webhook SkyPlanner declanșează integrarea, care apelează metoda ORM write pentru fiecare mrp.workorder afectat. În Odoo 19.0, aceasta înseamnă o cerere JSON-2 pentru fiecare comandă de producție:
“ 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 primește fiecare argument al metodei după nume, plus ids și context, astfel că write(vals) devine cheia vals. În versiunile 16.0–18.0, același apel se execută ca execute_kw(db, uid, key, 'mrp.workorder', 'write', [[4711], vals]) prin XML-RPC sau JSON-RPC, iar în 16.0 cheile sunt date_planned_start și date_planned_finished. Datele și orele se trimit în UTC. Câteva reguli asigură scrierea corectă:
- Trimiteți ambele date în același apel.
- Adăugați
workcenter_idnumai când motorul a ales un utilaj alternativ. - Scrieți doar în câmpurile de programare, niciodată în cele pentru cantități sau BoM.
Scrierea datelor mută rezervarea centrului de lucru din Odoo, astfel încât vizualizările de planificare din Odoo afișează planul SkyPlanner.
Din secția de producție înapoi în Odoo. Operatorii își înregistrează activitatea în SkyPlanner Mobile Confirmations. Pentru fiecare confirmare, integrarea apelează create pe mrp.workcenter.productivity (JSON-2: POST /json/2/mrp.workcenter.productivity/create cu vals_list). Completează workorder_id, workcenter_id, date_start, date_end și un loss_id de tip Productive, iar timpul de manoperă și costurile aferente se înregistrează în Odoo.
Când o operație este finalizată, integrarea setează cantitatea produsă și apelează button_finish pe comanda de producție. Finalizarea ultimei comenzi de producție lasă MO-ul pregătit pentru button_mark_done. Fiecare confirmare este înregistrată o singură dată, iar ID-ul înregistrării sale din Odoo este păstrat împreună cu înregistrarea de timp din SkyPlanner. Astfel, reîncercarea unui webhook nu creează niciodată un al doilea Time Log.
În fabricile care folosesc aplicația Enterprise Shop Floor, fluxul este invers: SkyPlanner citește starea comenzii de producție și qty_produced, iar Autopilot reface automat programul când apar modificări în producție.
Responsabilitatea asupra datelor. Stabiliți regulile în scris înainte de lansare:
| Date | Sistem responsabil |
|---|---|
| Produse, BoM, operații, cantități, starea MO | Odoo |
| Succesiunea comenzilor de producție, momentele de început și de sfârșit, alegerea centrului de lucru | SkyPlanner |
| Matricea timpilor de pregătire și schimbare, cerințele privind sculele și operatorii, resursele alternative | SkyPlanner |
| Calendarele centrelor de lucru și Time Off | Un singur sistem, ales la definirea domeniului |
| Time Logs, stocuri și calculul costurilor | Odoo, alimentat cu confirmări din SkyPlanner |
Planificatorii nu mai folosesc butoanele Plan și Unplan din Odoo pentru ordinele de fabricație (MO) programate de SkyPlanner. Altfel, Odoo își rezervă propriile intervale peste cele stabilite de SkyPlanner.
Etapele obișnuite ale proiectului
Implementarea se încheie, de regulă, în câteva săptămâni de la începerea etapei de punere în funcțiune. Înainte de aceasta, testarea gratuită de 30 de zile se bazează pe exporturi CSV ale propriilor date din Odoo. Proiectul propriu-zis cuprinde:
- Stabilirea corespondențelor pentru nomenclatoare: modelele și câmpurile Odoo pentru fiecare versiune (verificați
/docsaufields_get), unitățile de măsură și sistemul în care se întrețin calendarele și Time Off. - Corectarea datelor: calendarele centrelor de lucru, Setup Time și Cleanup Time, precum și folosirea duratelor Fixed în loc de Computed pentru operațiile din BoM.
- Încărcarea inițială: produse, centre de lucru cu calendare, BoM și operațiile aferente.
- Sincronizarea comenzilor și a comenzilor de achiziție: MO-uri confirmate și în curs de execuție, împreună cu comenzile lor de producție, plus liniile
purchase.ordercu datele estimate de sosire. - Scrierea programului înapoi în Odoo: datele calendaristice și centrele de lucru pe
mrp.workorder, cu rotația cheilor API în Odoo. - Confirmări din secția de producție: transmiterea înapoi în Odoo a Time Logs și a finalizării comenzilor de producție.
- Testarea în paralel cu planul actual, apoi lansarea în exploatare.
Capcane specifice Odoo
- Câmpuri de dată redenumite. Până la 16.0 inclusiv,
date_planned_startșidate_planned_finishedconțineau datele planificate, iardate_start/date_finishedconțineau datele efective. Începând cu 17.0,date_startșidate_finishedreprezintă datele planificate. O mapare copiată dintr-un proiect pe 16.0 citește în 17+ datele efective ca date planificate, fără să semnaleze eroarea. - Datele comenzilor de producție reprezintă rezervări. În 19.0,
date_startșidate_finishedde pemrp.workordersunt calculate dintr-o înregistrareresource.calendar.leaves(leave_id) din calendarul centrului de lucru. Scrierea datelor pe comanda de producție actualizează acea rezervare. Nu scrieți niciodată direct în tabelul de absențe. - Comenzile de producție începute blochează acțiunea Unplan. Odoo refuză să anuleze programarea unui MO când „Some work orders have already started” (Unele comenzi de producție au început deja). La scrierea înapoi în Odoo, omiteți comenzile de producție în starea
progresssaudoneși mutați doar ce nu a început. - Duratele variază. Operațiile setate pe Computed își preiau durata din ultimele comenzi de producție (10 în mod implicit), ajustată prin Time Efficiency. Setați-le pe Fixed pentru perioada de testare sau acceptați că datele de intrare se vor schimba. Operațiile sunt definite în fiecare BoM, fără un nomenclator comun de fluxuri tehnologice, așa că fiecare BoM trebuie corectată separat.
- Calendare incorecte. Fiecare centru de lucru are nevoie de un calendar al orelor de lucru. Planificatorul Odoo caută până la 700 de zile în avans, apoi se oprește cu mesajul “Impossible to plan the workorder” (Comanda de producție nu poate fi programată). Corectați calendarele înainte de prima încărcare.
- Unități de măsură.
mrp.bom.lineare propriulproduct_uom_id, care poate diferi de unitatea de stoc a produsului. Faceți conversia înainte de a verifica disponibilitatea materialelor.
Cine configurează integrarea cu Odoo
Fiecare fabrică folosește Odoo diferit: are propriile operații în BoM, calendare ale centrelor de lucru, centre de lucru alternative și module personalizate. Echipa SkyPlanner aduce expertiza necesară pentru a mapa corect datele în această configurație.
- Echipa SkyPlanner configurează integrarea pentru configurația dumneavoastră Odoo în etapa de punere în funcțiune și asigură asistență după lansare. Integrarea folosește API-ul REST și webhook-urile SkyPlanner, precum și API-ul JSON-2 sau RPC al Odoo. Aceasta este abordarea standard.
- Partenerul dumneavoastră Odoo poate participa. Acesta vă cunoaște configurația și modulele personalizate și poate dezvolta soluții folosind același API REST documentat. API-ul permite citirea și scrierea comenzilor, produselor, materialelor, etapelor de proces și înregistrărilor de timp, cu autentificare JWT și documentație Swagger/OpenAPI.
- Dezvoltatorii dumneavoastră pot face același lucru, de obicei printr-o mică aplicație middleware care rulează alături de Odoo sau printr-un modul pe Odoo.sh ori pe infrastructura locală. O cheie API este suficientă pentru a începe (tutorial de integrare), iar echipa SkyPlanner oferă ajutor la nevoie.
Același model funcționează deja în exploatare cu alte sisteme ERP. La Laboratory & Allied, echipa IT internă a construit integrarea cu SAP Business One în mare parte pe cont propriu, cu ajutorul SkyPlanner. UTU folosește SkyPlanner alături de sistemul său ERP NetSuite.
De ce merită integrarea
Transmiterea datelor înapoi în Odoo face integrarea utilă în activitatea de zi cu zi. Odată ce acest mecanism funcționează:
- Comenzile de producție din Odoo au date realiste. Motorul Arcturus AI stabilește în câteva secunde ordinea de execuție pentru toate MO-urile deschise. Datele și centrele de lucru alese sunt scrise în
mrp.workorder, unde apar în vizualizările de planificare Odoo. - Nimeni nu mai reprogramează manual. Autopilot reface automat programul când apar schimbări în producție, iar webhook-ul transmite noile date către Odoo.
- Secția de producție închide circuitul informațiilor. Operatorii își înregistrează activitatea pe telefon sau tabletă cu Mobile Confirmations, Production Timer și Quick Log Mode, iar Time Logs sunt trimise în Odoo pentru stocuri și calculul costurilor. Programarea și execuția se desfășoară într-un singur instrument, atât pe Community, cât și pe Enterprise.
- Programul respectă constrângeri pe care Odoo nu le ia în calcul. O matrice a timpilor de pregătire stabilește timpii de trecere de la un produs la altul pentru fiecare pereche de produse, în funcție de succesiune. Sculele sunt resurse cu capacitate finită, partajate între utilaje, iar o operație poate necesita mai mulți operatori simultan. Motorul apelează la utilaje sau personal alternativ când resursa principală nu este disponibilă. Datele scrise înapoi în
mrp.workorderrespectă toate aceste constrângeri. - Sosirea materialelor dictează planul. Stocul disponibil și comenzile de achiziție deschise din Odoo alimentează programarea în funcție de materiale. Componentele comandate sunt considerate disponibile la data de livrare a comenzii de achiziție (PO), iar stocul se actualizează când aceasta este marcată Delivered. Pentru fiecare operație se verifică ce există în depozit și ce urmează să sosească.
Puteți evalua programul înainte de orice lucrare de integrare. Începeți testarea gratuită de 30 de zile pe baza exporturilor CSV și vedeți propriile comenzi de producție din Odoo pe diagrama Gantt, cu până la 20 de posturi de lucru și fără card de credit. Prețurile pornesc de la 199 € pe lună, cu 5 posturi de lucru incluse, facturare lunară și posibilitatea de a anula oricând. Primiți de la început o ofertă pentru integrare, adaptată procesului și nevoilor dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe. Consultați funcționalitățile și clienții sau programați o demonstrație.
Părerile producătorilor despre SkyPlanner
2 heconomisite în fiecare săptămână
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru în fiecare săptămână, iar o nouă listă de operații ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar realizarea unui plan optimizat pe trei luni, pentru toate posturile de lucru, durează mai puțin de 30 de minute.
1.000scomenzi de producție programate automat
„Avem un alt nivel de control asupra producției și o înțelegere a capacității la un nivel cu totul diferit.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție la comandă cu tehnologie avansată
Mii de comenzi de producție sunt programate automat, iar întreaga organizație are o imagine în timp real asupra producției.
99,2%respectarea termenelor de livrare
„SkyPlanner ne-a ajutat să vedem unde apar blocajele și a făcut gestionarea producției mai clară.”
Toni Tuori, director de producție
Piristeel · Sisteme de siguranță pentru acoperișuri și sisteme pluviale
Rata de respectare a termenelor de livrare a ajuns la 99,2% anul acesta, iar programarea producției economisește până la patru ore de lucru pe zi.
Întrebări frecvente
Integrarea funcționează cu Odoo Online?
Da, cu planul Custom, prin API-ul extern. Planurile One App Free și Standard nu oferă acces la API-ul extern, iar Standard nu permite module personalizate. Prin urmare, aceste planuri sunt limitate la importul și exportul CSV/XLSX.
Să folosim JSON-2 sau XML-RPC?
JSON-2 pentru Odoo 19.0 și versiunile ulterioare. XML-RPC și JSON-RPC sunt încă necesare pentru versiunile de la 16.0 la 18.0, dar eliminarea lor este prevăzută pentru Odoo 22.
Cum este trimis programul de producție înapoi în Odoo?
Prin metoda ORM write pe fiecare mrp.workorder: POST /json/2/mrp.workorder/write cu ids și vals în 19.0 sau execute_kw cu write prin XML-RPC sau JSON-RPC în versiunile 16.0–18.0. Valorile sunt date_start, date_finished (date_planned_start și date_planned_finished în 16.0) și, dacă s-a schimbat, workcenter_id. Odoo mută în același timp rezervarea centrului de lucru, astfel încât vizualizările sale de planificare afișează datele din SkyPlanner.
Cum ajung confirmările operatorilor în Odoo?
Ca Time Logs: integrarea creează înregistrări mrp.workcenter.productivity asociate comenzii de producție, cu început, sfârșit și un motiv de pierdere Productive, apoi apelează button_finish când operația este finalizată. Fiecare confirmare este înregistrată o singură dată, astfel încât reîncercările nu dublează timpul.
Cine asigură mentenanța integrării după punerea în funcțiune?
Echipa SkyPlanner configurează integrarea în etapa de implementare inițială și asigură suportul după punerea în funcțiune, inclusiv adaptările necesare când se schimbă configurația Odoo. Dacă partenerul sau dezvoltatorii dumneavoastră realizează integrarea, aceștia folosesc API-ul REST documentat și documentația SkyPlanner, iar echipa oferă asistență la nevoie.
Ce se întâmplă cu comenzile de producție deja începute?
Nu le modificați când scrieți datele înapoi în Odoo. Odoo blochează anularea programării unui MO dacă o comandă de producție este în curs sau finalizată. SkyPlanner citește starea și progresul acestora și programează lucrările rămase ținând cont de ele.
Cât durează integrarea cu Odoo?
În mod normal, implementarea se finalizează în câteva săptămâni de la începerea etapei de configurare inițială. Folosiți mai întâi perioada de probă de 30 de zile cu exporturi CSV, pentru a valida programul de producție pe propriile date Odoo înainte de a începe lucrul la integrarea prin API.
