Ghid de integrare Sage 200 pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Sage 200 le arată partenerilor de afaceri și echipelor IT cum să conecteze Sage 200 Professional și extensia sa pentru producție la SkyPlanner APS. SkyPlanner se integrează cu Sage 200 în ambele sensuri:
- Produsele, stocurile din depozite, comenzile de achiziție și comenzile de vânzare sunt preluate prin Sage 200 REST API.
- Comenzile de producție, operațiile, personalul și utilajele sunt preluate din extensia pentru producție.
- Datele planificate ale operațiilor sunt retransmise către comenzile de producție.
- Pontajele operatorilor sunt retransmise pentru înregistrarea timpului aferent fiecărei operații.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră Sage 200 în etapa de implementare și asigură asistență după punerea în funcțiune. Acest ghid se adresează partenerilor și dezvoltatorilor care vor să participe sau să dezvolte singuri soluții folosind REST API documentată a SkyPlanner (documentația API).
Două surse într-un singur sistem Sage 200
O instalare Sage 200 utilizată în producție are două niveluri, iar integrarea citește date din ambele.
1. Sage 200 REST API pentru date comerciale și stocuri. Sage precizează că API-ul „lets your application read and modify data in a Sage 200 site” (permite aplicației dumneavoastră să citească și să modifice date în instalarea respectivă). Sunt incluse datele despre clienți, furnizori, produse, comenzi de vânzare și de achiziție, precum și conturi contabile. Documentația Sage 200 Professional (2025.02) grupează resursele în Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP și Stock. Resursele relevante pentru programare sunt:
| Resursă | Conținut |
|---|---|
products | Cod, denumire, unitate de măsură pentru stoc, tip de articol BOM, cost standard |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Comenzi de achiziție deschise, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Cererea clienților, requested_delivery_date, promised_delivery_date |
warehouses, units | Locații și unități de măsură |
2. Extensia de producție pentru gestionarea comenzilor de producție. API-ul Sage 200 nu are endpointuri pentru comenzi de producție, operații sau resurse. Comenzile de producție se află în Sicon Works Order Processing, Cim200 sau în vechiul modul Sage 200 Manufacturing. Integrarea citește comenzile de producție, operațiile și resursele prin metoda acceptată de extensie, stabilită împreună cu dumneavoastră și cu partenerul Sage 200 în etapa de definire a domeniului proiectului.
Autentificare și acces
API-ul Sage 200 „uses OAuth 2.0 with OpenID Connect” (utilizează protocolul OAuth împreună cu OpenID Connect), prin fluxul de autorizare cu cod. Autentificarea se face prin Sage ID.
- Înscrieți-vă în Sage 200 API Developer Programme și solicitați datele de acces.
- Asociați un Sage ID cu un utilizator Sage 200 care are acces la compania și funcționalitățile necesare pentru endpointurile utilizate.
- Solicitați permisiunea
offline_access; în caz contrar, nu se emite niciun token de reîmprospătare. - Trimiteți
Authorization: Bearer <access_token>,X-SiteșiX-Companyla fiecare cerere către baza de date. Ambele ID-uri se obțin din/sites.
URL de bază pentru Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Cererile folosesc GET, POST, PUT și DELETE, precum și opțiunile de interogare OData $filter, $select, $top, $skip, $orderby și $expand.
Pentru Sage 200 Professional, furnizorul de asistență al clientului activează API-ul. În lista de verificare Sage, acesta confirmă că „the API is enabled” (API-ul este activat) și că „each required user has a Sage ID assigned.” (fiecare utilizator care are nevoie de acces are un Sage ID atribuit). În Sage 200 Standard, API-ul este activat implicit.
Durata de valabilitate a tokenurilor influențează proiectarea integrării. Tokenurile de acces sunt valabile 8 ore. Tokenurile de reîmprospătare sunt valabile între 1 și 90 de zile, iar „The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (Perioada de reîmprospătare se calculează de la autentificarea inițială a utilizatorului, nu de la cea mai recentă reîmprospătare.) Sage precizează că reautentificarea „is unavoidable” (este inevitabilă). Prevedeți o alertă pentru reînnoirea consimțământului înainte de expirarea perioadei.
În SkyPlanner, autentificarea la REST API se face cu un token API (SkyPlanner Settings > API), iar documentația este disponibilă în Swagger/OpenAPI. Tutorialul de integrare vă ghidează prin primele apeluri.
Detectarea modificărilor
Documentația API Sage 200 nu include nicio resursă pentru webhookuri sau abonamente. Modificările sunt detectate prin interogări periodice. Înregistrările conțin date_time_created și date_time_updated, astfel încât fiecare interogare filtrează cu $filter după date_time_updated și paginează rezultatele cu $top și $skip.
Interogați comenzile de producție la fiecare câteva minute, iar stocurile și liniile comenzilor de achiziție, la fiecare oră. SkyPlanner trimite webhookuri când programul se modifică, astfel încât retransmiterea datelor este declanșată de evenimente.
Maparea datelor
| Obiect Sage 200 (sursă) | Obiect SkyPlanner | Sens | Frecvență |
|---|---|---|---|
products, units (API) | Produse și materiale | Sage 200 → SkyPlanner | Încărcare, apoi interogări periodice |
| Componente BOM (extensie sau modul BOM) | Structura produsului, subproduse, materiale pentru fiecare produs | Sage 200 → SkyPlanner | La modificare |
| Personal și utilaje, grupuri de resurse (extensie) | Centre de lucru, grupuri de centre de lucru, personal | Sage 200 → SkyPlanner | Încărcare inițială |
| Disponibilitatea resurselor: opriri, mentenanță, concedii (extensie) | Schimburi, absențe | Sage 200 → SkyPlanner | Zilnic |
| Comenzi de producție și operațiile lor, timpi pentru fiecare operație (extensie) | Comenzi și operații cu etape, durate și termene | Sage 200 → SkyPlanner | La fiecare câteva minute |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Termene de livrare către clienți | Sage 200 → SkyPlanner | Interogări periodice |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Solduri de stoc | Sage 200 → SkyPlanner | La fiecare oră |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Comenzi de achiziție cu data estimată a livrării | Sage 200 → SkyPlanner | La fiecare oră |
| Începutul și sfârșitul planificate ale operației din comanda de producție, resursa | Începutul și sfârșitul planificate și centrul de lucru pentru fiecare operație | SkyPlanner → Sage 200 | La modificare, prin webhook |
| Pontaj pe operație (extensie) | Pontaje și confirmări ale operatorilor | SkyPlanner → Sage 200 | La fiecare confirmare sau schimb |
| Date privind constrângerile din SkyPlanner | Matricea timpilor de pregătire, scule ca resurse cu capacitate finită, utilaje și personal alternativ | Gestionate în SkyPlanner | În etapa de implementare |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Preluați produsele și unitățile de măsură din API, apoi resursele, grupurile de resurse și operațiile BOM din extensie. Un grup de resurse format din trei utilaje identice poate fi reprezentat printr-un grup de centre de lucru sau prin trei centre de lucru.
2. Sincronizarea comenzilor. Citiți comenzile de producție deschise împreună cu operațiile lor din extensie, precum și liniile deschise pop_order_lines și datele warehouse_holdings din API. La programare se verifică atât stocurile, cât și achizițiile care urmează să sosească. MRP continuă să propună comenzi de producție în Sage 200, iar SkyPlanner le programează pe cele pe care le creați.
3. Retransmiterea programului. Pentru fiecare operație programată sau mutată de motor, SkyPlanner retransmite către comanda de producție începutul și sfârșitul planificate, precum și resursa. Extensia își păstrează propriile cantități, alocări și calcule de cost.
4. Confirmări din secția de producție. Operatorii își înregistrează activitatea cu SkyPlanner Mobile Confirmations sau Production Timer, iar pontajele mențin programul la zi. Timpul înregistrat este retransmis ca pontaj aferent operației din comanda de producție, astfel încât calculul costurilor în Sage 200 să țină cont de orele efectiv lucrate.
Dacă fabrica dumneavoastră înregistrează deja pontaje în Sicon Shop Floor Data Capture sau Cim200 Shop Floor Data Capture, alegeți un singur canal de pontaj.
5. Responsabilitatea asupra datelor și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Produse, BOM-uri, cantități din ordinele de producție, alocări, costuri | Sage 200 și modulul suplimentar |
| Succesiunea operațiilor, orele de început și de sfârșit, alocarea la centrele de lucru | SkyPlanner |
| Matricea timpilor de pregătire, cerințe privind sculele și operatorii, resurse alternative | SkyPlanner |
| Pontarea timpului de lucru | Sage 200, pe baza înregistrărilor de timp din SkyPlanner |
Graficul capacității este principala sursă de conflicte. Dacă planificatorii continuă să mute prin glisare ordinele de producție sau operațiile în Sicon Rough Cut Capacity Planning ori în Cim200 Graphical Scheduler, datele ajung să fie gestionate de două sisteme. Lăsați SkyPlanner să gestioneze datele operațiilor. Cu Autopilot, SkyPlanner reface automat programarea atunci când apar schimbări în producție.
Etapele obișnuite ale proiectului
Implementarea se încheie, de regulă, în câteva săptămâni de la începerea procesului de configurare inițială. Înainte de această etapă, validați programul de producție în perioada de testare gratuită de 30 de zile, folosind un export CSV sau Excel al ordinelor de producție deschise. Proiectul continuă apoi astfel:
- Definirea domeniului. Confirmați modulul suplimentar și versiunea acestuia, metoda de citire a ordinelor de producție, metoda de retransmitere a datelor, frecvențele de sincronizare și canalul de pontare a timpului de lucru.
- Acces la API. Furnizorul de suport activează API-ul Sage 200, asociază un Sage ID cu un utilizator Sage 200 și configurează accesul la companii și funcționalități.
- Încărcarea inițială. Produse, unități de măsură, resurse, grupuri de resurse, operații din BOM și disponibilitate.
- Sincronizarea comenzilor. Ordine de producție, linii de comandă de achiziție și stocuri, prin interogare periodică, cu alertă pentru reînnoirea consimțământului.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire, scule, numărul de operatori pentru fiecare operație și utilaje sau personal alternativ.
- Retransmiterea programului. Datele planificate ale operațiilor sunt înscrise în ordinele de producție; în această etapă se adaugă și pontarea timpului de lucru.
- Testarea în paralel și punerea în producție. Comparați datele cu planul actual, corectați nomenclatoarele, apoi activați retransmiterea datelor.
Ce trebuie să aveți în vedere la integrarea cu Sage 200
- Modul retras în noua versiune. Vechiul modul Sage 200 Manufacturing nu mai poate fi utilizat începând cu Sage 200 Professional 2025 R2. Înainte de a începe maparea, confirmați ce soluție de producție va fi utilizată la punerea în producție.
- Duratele operațiilor estimate din datele de cost. Sicon MRP estimează timpii de manoperă și de funcționare a utilajelor pe baza elementelor de cost din BOM-urile Sage 200. Verificați mai întâi aceste estimări în raport cu duratele reale de execuție.
- Neconcordanțe între categoriile de cost. Sage avertizează că valorile Nominal, Overhead Nominal și Overhead Recovery % trebuie să coincidă între operațiile din BOM și categoriile de cost; în caz contrar, “there will be cost discrepancies.” (vor apărea diferențe de cost).
- Intervalul de reînnoire. Perioada maximă de 90 de zile se calculează de la prima autentificare. O integrare pentru care consimțământul nu este niciodată reînnoit se oprește în aceeași zi a fiecărui trimestru.
- Instanțe cu mai multe companii. O instanță poate conține mai multe companii, așa că trimiteți valoarea corectă pentru
X-Companyla fiecare cerere.
Integrarea cu Sage 200: cine o configurează și asigură suportul
- Echipa SkyPlanner configurează integrarea în etapa inițială și asigură suportul după punerea în producție.
- Partenerul dumneavoastră Sage 200 poate participa. Acesta cunoaște modulul suplimentar pe care îl folosiți și activează API-ul în Sage 200 Professional.
- Propriii dezvoltatori pot extinde integrarea folosind același REST API documentat și un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner vă ajută când este nevoie.
După conectare, motorul Arcturus programează producția pe baza ordinelor de producție actualizate din Sage 200, iar datele planificate sunt înscrise în operațiile acestor ordine. SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Oferta pentru integrare este stabilită de la început, în funcție de procesele și nevoile dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe. Consultați prețurile, funcționalitățile și comparația cu planificarea oferită de Sage 200 în pagina Programare cu capacitate finită pentru Sage 200. Prezentarea generală se află pe pagina Sage 200, iar celelalte sisteme ERP sunt prezentate în secțiunea de integrări ERP.
Ce spun producătorii 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.
Mii (1.000) de ordine de producție programate automat
„Avem un alt nivel de control asupra producției, iar înțelegerea capacității noastre a ajuns la un nivel complet diferit.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție la comandă de înaltă tehnologie
Mii de ordine de producție sunt programate automat, iar întreaga organizație are o imagine în timp real asupra producției.
Întrebări frecvente
API-ul Sage 200 include ordine de producție?
Nu. API-ul Sage 200 Professional acoperă produsele, stocurile, comenzile de vânzare și de achiziție, datele financiare și altele, dar nu oferă resurse API pentru ordine de producție sau operații. Ordinele de producție sunt preluate din modulul suplimentar de producție, precum Sicon Works Order Processing sau Cim200, prin metoda convenită la definirea domeniului.
Cine realizează integrarea cu Sage 200?
Echipa SkyPlanner configurează integrarea bidirecțională în funcție de configurația dumneavoastră Sage 200 în etapa inițială și asigură suportul după punerea în producție. Partenerul dumneavoastră Sage 200 activează API-ul și poate participa la proiect. Propriii dezvoltatori pot, de asemenea, să creeze soluții folosind interfața REST API documentată a SkyPlanner, iar un token API este suficient pentru a începe.
Poate Sage 200 să transmită automat modificările în timp real?
API-ul Sage 200 nu oferă webhook-uri. Stocurile și comenzile de achiziție sunt interogate periodic pe baza câmpului date_time_updated, iar ordinele de producție sunt citite din modulul suplimentar la intervale de câteva minute. În sens invers, webhook-urile proprii SkyPlanner transmit modificările programului imediat ce apar.
Putem testa SkyPlanner înainte de realizarea integrării?
Da. Perioada de testare gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu importul ordinelor de producție din CSV sau Excel, fără card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
