Ghid de integrare Senior ERP pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Senior ERP le arată partenerilor și echipelor IT cum să conecteze Senior ERP de la Senior Sistemas (Gestão Empresarial | ERP XT cu Senior X) la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu Senior ERP, prin interfețele proprii ale Senior:
- În SkyPlanner sunt importate ordinele de producție (OP), cu etapele lor, rutele tehnologice (roteiros), resursele și centrele de resurse, codurile SKU, structurile de produs, stocurile și comenzile de achiziție.
- Datele de început și de sfârșit planificate pentru fiecare etapă OP, precum și resursa aleasă pentru aceasta, sunt trimise înapoi în OP.
- Dacă alegeți această opțiune, pontajele operatorilor sunt trimise înapoi ca apontamentos de produção.
- Senior X Events Hub notifică SkyPlanner când o etapă OP își schimbă starea, iar webhookurile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră Senior ERP în etapa de implementare inițială și asigură suportul după intrarea în exploatare. Acest ghid se adresează partenerilor și dezvoltatorilor care doresc să participe sau să dezvolte singuri o integrare folosind REST API documentat al SkyPlanner (documentația API).
Interfețele de integrare Senior ERP
ERP XT este un sistem hibrid. Documentația Senior precizează că Gestão Empresarial XT “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (devine un sistem hibrid: un sistem local, cu soluții cloud integrate) (documentația Senior, în traducere). Un sistem de programare a producției folosește trei interfețe Senior:
- Servicii web G5 (SOAP). Aceste servicii rulează pe serverul dumneavoastră Senior și sunt denumite după modul (com.senior.g5.co.<module>…). Fiecare este publicat în trei variante WSDL: sapiens_Sync, sapiens_Async și sapiens_Scheduled. Serviciile pentru producție includ com.senior.g5.co.mpr.pcp.ordemproducao, care “calls the same production order generation routine” (apelează aceeași rutină de generare a ordinelor de producție) ca ecranul ERP (documentația Senior, în traducere), precum și servicii pentru produse (com.senior.g5.co.ger.cad.produto) și raportarea producției.
- API-uri REST Senior X Platform la api.senior.com.br, pentru domeniile ERP pe care Senior le expune în Senior X, cum ar fi produsele și comenzile de vânzare (documentația Senior).
- Webhookuri Events Hub. Se creează în Senior X, în Tecnologia > Customização > Events Hub > Webhooks. Modulul Manufacturing publică evenimentul erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus când o etapă OP își schimbă starea (documentația Senior).
Autentificare și acces
- Senior X Platform. Integrarea se autentifică prin POST la platform.senior.com.br, pe calea /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, cu utilizatorul în format user@tenant. Răspunsul conține un token de acces Bearer și un token de reîmprospătare. Autentificarea cu chei de aplicație se poate face prin loginWithKey (access key, secret, tenant). Apelurile REST includ antetul authorization și un antet client_id care identifică aplicația conectată, înregistrată în portalul API Senior și asociată unui rol în ERP.
- Servicii web G5. Apelurile includ parametrii user, password și encryption. Dacă se folosește un token Senior X, acesta înlocuiește parola (documentația Senior).
- Permisiuni. Creați un utilizator Senior dedicat integrării, cu acces la datele PCP, de inginerie, stoc și achiziții pe care integrarea le citește și le scrie.
În SkyPlanner, REST API folosește pentru autentificare un token API în antetul Authorization-Token (SkyPlanner Settings > API) și este documentat în Swagger/OpenAPI. Tutorialul de integrare vă ghidează prin primele apeluri.
Evenimente și interogare periodică
Events Hub acoperă activitatea din atelier: când o etapă OP își schimbă starea, webhookul ajunge la SkyPlanner, iar programul se actualizează. Celelalte date sunt preluate prin interogări periodice. Pentru a identifica ordinele noi, interogările selectează OP ferme și lansate și modificările recente. Frecvența se stabilește pentru fiecare fabrică: la câteva minute pentru OP și o dată pe oră pentru stocuri.
SkyPlanner trimite notificări webhook când se modifică starea sau programul de producție, astfel încât transmiterea datelor înapoi este declanșată de evenimente.
Maparea datelor
| Obiect Senior ERP (interfață) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
| SKU: produto și derivação, unități de măsură (servicii web G5 sau entități Senior X) | Produse și materiale | Senior → SkyPlanner | Încărcare inițială, apoi interogare periodică |
| Structură de produs (engenharia do SKU) | Structura produsului, subproduse, materiale pentru fiecare produs | Senior → SkyPlanner | Încărcare inițială, apoi la modificare |
| Roteiro cu estágios: succesiune, dependență de etapa precedentă | Etapele procesului, în ordine | Senior → SkyPlanner | Încărcare inițială, apoi la modificare |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Centre de lucru, durate, timpi de pregătire și de încheiere, eficiențe | Senior → SkyPlanner | Încărcare inițială, apoi rareori |
| Centro de recurso | Grupuri de centre de lucru | Senior → SkyPlanner | Încărcare inițială, apoi rar |
| Calendário: Feriados, calendar de producție pe schimburi | Schimburi și zile nelucrătoare | Senior → SkyPlanner | Zilnic sau schimburi gestionate direct în SkyPlanner |
| Ordens de produção (Firme, Liberada), cu etape și materiale | Comenzi și operații cu termene de finalizare și necesar de materiale | Senior → SkyPlanner | Interogare la câteva minute |
| Starea etapei OP (Events Hub orderProductionStageChangeStatus) | Progresul operației | Senior → SkyPlanner | În timp real, prin webhook |
| Estoque pentru fiecare SKU | Solduri de stoc | Senior → SkyPlanner | Interogare o dată pe oră sau la rularea programării |
| Ordens de compra cu date de livrare | Comenzi de achiziție, materiale așteptate în funcție de data livrării | Senior → SkyPlanner | Interogare periodică, la fiecare oră sau la rularea programării |
| Etapă OP: date de început și de sfârșit planificate, resursă | Date de început și de sfârșit planificate pentru fiecare operație, centrul de lucru alocat | SkyPlanner → Senior | La modificarea programului, prin webhook SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, data și ora de început și de sfârșit | Pontaje și confirmări ale operatorilor | SkyPlanner → Senior | La fiecare confirmare sau pe schimb, dacă se alege această opțiune |
| Nu există în Senior ERP | Matricea timpilor de pregătire, scule ca resurse cu capacitate finită, operații cu mai mulți operatori, utilaje și personal alternativ | Gestionate în SkyPlanner | Configurate în etapa de implementare inițială |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți codurile SKU, structurile, roteiros, recursos, centros de recurso și calendarul de producție. Stabiliți cu atenție corespondența centrelor de resurse: un centro de recurso cu patru utilaje devine un grup de centre de lucru sau patru centre de lucru. Convertiți Fator de carga fie în eficiența centrului de lucru SkyPlanner, fie în schimburi, nu în ambele.
2. Sincronizarea OP. Citiți OP cu stările Firme și Liberada, împreună cu etapele și materialele lor, precum și comenzile de achiziție deschise. OP cu starea Planejada pot fi încă modificate sau șterse de MRP, așa că programați-le doar dacă doriți o perspectivă asupra producției viitoare. SkyPlanner consideră materialul comandat disponibil la data de livrare a comenzii de achiziție și actualizează stocul când comanda este marcată Delivered.
3. Scrierea programului înapoi în ERP. Când motorul plasează sau mută o etapă, un webhook SkyPlanner declanșează scrierea înapoi. Sunt actualizate datele de început și de sfârșit planificate pentru fiecare etapă OP și resursa aleasă pentru aceasta, adică aceleași câmpuri pe care planificatorul le modifică în Programação de produção. Echipa SkyPlanner stabilește serviciul web exact împreună cu dumneavoastră și partenerul Senior în etapa de definire a domeniului.
4. Confirmări din atelier. Operatorii își înregistrează activitatea cu SkyPlanner Mobile Confirmations sau Production Timer, iar pontajele mențin programul actualizat. Dumneavoastră decideți dacă timpii efectivi sunt trimiși înapoi în Senior. Dacă da, fiecare confirmare devine un apontamento de produção pentru etapa OP, cu cantitatea produsă, rebuturile și orele de început și de sfârșit. Senior acceptă raportări de producție doar pentru OP cu starea Liberada sau Andamento. Dacă raportați prin Fábrica ao Vivo, SkyPlanner preia progresul prin Events Hub.
5. Reguli privind responsabilitatea pentru date și soluționarea conflictelor. Documentați-le înainte de punerea în producție:
| Date | Sistem responsabil |
|---|---|
| Coduri SKU, structuri, roteiros, cantități și stare OP | Senior ERP |
| Succesiunea etapelor, ore de început și de sfârșit, alocarea resurselor | SkyPlanner |
| Matricea timpilor de pregătire, necesarul de scule și operatori, resurse alternative | SkyPlanner |
| Calendarul de producție și schimburile | Un singur sistem, ales la definirea domeniului |
| Apontamentos, mișcări de stoc, calculația costurilor | Senior ERP, cu date introduse direct sau transmise din pontajele SkyPlanner |
Alegeți un singur sistem care să scrie datele calendaristice ale etapelor. Dacă planificatorii continuă să stabilească succesiunea acelorași OP în Programação de produção sau în diagrama Gantt, conveniți care OP sunt gestionate de SkyPlanner.
Etapele obișnuite ale proiectului
Implementarea se finalizează de obicei în câteva săptămâni de la începerea etapei de implementare inițială. Înainte de aceasta, validați programul în perioada de testare gratuită de 30 de zile, cu resurse, roteiros și OP deschise exportate din Senior în format CSV sau Excel.
- Mapare. Stabiliți tabelul de corespondențe, regulile privind sistemul responsabil, frecvențele de sincronizare și dacă apontamentos sunt trimise înapoi.
- Acces Senior. Creați utilizatorul pentru integrare, înregistrați aplicația în portalul API Senior și activați serviciile web G5 și webhookul Events Hub. Testați mai întâi într-o bază de date de testare.
- Încărcare inițială. Coduri SKU, structuri, roteiros, recursos, centros de recurso, calendar.
- Sincronizarea OP și a comenzilor de achiziție. Interogări periodice cu filtre și reîncercări, plus webhookul pentru starea etapelor.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire, scule, numărul de operatori pentru fiecare operație și utilaje sau personal alternativ.
- Scrierea programului înapoi în ERP. Datele calendaristice ale etapelor și resursele din webhookurile SkyPlanner, plus apontamentos dacă se alege această opțiune.
- Testare în paralel. Rulați SkyPlanner în paralel cu planul actual, comparați datele calendaristice și corectați nomenclatoarele.
- Punere în producție. Activați transmiterea datelor înapoi după ce datele corespund.
Ce trebuie să aveți în vedere la integrarea cu Senior ERP
- Patru timpi pentru fiecare resursă. Recurso conține timpul de procesare, de pregătire, de încărcare și descărcare și de transfer. Timpii de încărcare și de transfer pot reprezenta manipulare, nu timp de utilizare a utilajului. Stabiliți pentru fiecare resursă cum se mapează acești timpi; altfel, toate duratele vor fi greșite.
- Un singur timp de pregătire pentru fiecare resursă. Tempo setup din Senior are o singură valoare. În etapa de implementare inițială, construiți matricea timpilor de pregătire în SkyPlanner pe baza schimbărilor de serie efectuate în producție.
- Variante de produs. În Senior, un SKU este format dintr-un produs și o derivação, iar roteiros pot diferi de la o variantă la alta. Includeți codul variantei în cheile de produs din SkyPlanner.
- Stările OP. Doar OP cu stările Liberada și Andamento acceptă raportări de producție. Gestionați schimbările de stare în Senior și lăsați SkyPlanner să le urmărească prin Events Hub.
- Implementare hibridă. Serviciile web G5 rulează pe serverul dumneavoastră Senior, iar Events Hub rulează în Senior X. Planificați accesul la rețea pentru ambele.
- Formatul numerelor. Serviciile web Senior resping numerele cu separatori de mii și impun virgula ca separator zecimal. Trimiteți numerele în acest format.
Cine configurează integrarea cu Senior ERP și asigură suportul
- Echipa SkyPlanner configurează integrarea în etapa de implementare și asigură suportul după punerea în funcțiune, pentru serviciile web, API-urile Senior X și webhook-urile Events Hub convenite. Fiecare fabrică folosește Senior ERP diferit, iar această experiență este pusă în practică aici.
- Partenerul dumneavoastră Senior poate participa. Acesta vă cunoaște configurația, personalizările și licențele și poate colabora cu echipa SkyPlanner pentru a configura utilizatorul de integrare, înregistrarea în portalul API și serviciile web.
- Dezvoltatorii dumneavoastră pot extinde integrarea folosind interfața REST API SkyPlanner și un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă asistență la nevoie. Consultați documentația de integrare SkyPlanner.
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. Consultați prețurile, programarea cu capacitate finită pentru Senior ERP, pagina Senior ERP și 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.
+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 centrele de lucru, durează mai puțin de 30 de minute.
1.000 de comenzi și mai multprogramate automat în producție
„Controlăm producția într-un mod diferit și avem o cu totul altă înțelegere a capacității noastre.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție la comandă de înaltă tehnologie
Mii de comenzi de producție sunt programate automat, iar întreaga organizație are o imagine în timp real asupra producției.
Mai puțineopriri cauzate de lipsa materialelor
„Valoarea pe care ne-o aduce SkyPlanner constă în faptul că este un instrument care funcționează în activitatea de zi cu zi, mai ales pentru stabilirea termenelor de livrare.”
Tommi Männistö, manager de planificare a producției
Eskomatic · Prelucrări mecanice la comandă
Programarea automată a încărcării permite stabilirea unor termene de livrare mai precise, iar opririle de producție cauzate de lipsa materialelor s-au redus considerabil.
Întrebări frecvente
Senior ERP are un API pentru comenzile de producție?
Da. Serviciul web G5 com.senior.g5.co.mpr.pcp.ordemproducao generează OP-uri folosind aceeași rutină ca ecranul din ERP, iar alte servicii G5 acoperă produsele și raportarea producției. Senior X Platform adaugă API-uri REST cu autentificare prin token Bearer și webhook-uri Events Hub.
Senior ERP acceptă webhook-uri?
Da. Senior X Events Hub trimite webhook-uri, inclusiv orderProductionStageChangeStatus atunci când se schimbă starea unei etape dintr-un OP. SkyPlanner îl folosește pentru a urmări în timp real progresul din producție, iar propriile webhook-uri transmit înapoi modificările programului.
Cum sunt transmise înapoi în Senior ERP datele planificate?
SkyPlanner stabilește datele planificate de început și de sfârșit ale fiecărei etape dintr-un OP, precum și resursa aleasă pentru aceasta. Sunt aceleași câmpuri pe care planificatorul le modifică în Programação de produção. Un webhook SkyPlanner declanșează actualizarea în Senior ERP la fiecare modificare a programului, prin ruta stabilită de echipa SkyPlanner pentru instalarea dumneavoastră Senior în etapa de definire a domeniului integrării, la implementare.
Integrarea funcționează cu Senior X și ERP XT?
Da. ERP XT rulează pe serverul dumneavoastră, cu servicii cloud pe Senior X. Integrarea folosește serviciile web G5 de pe server, precum și API-urile Senior X și Events Hub din cloud.
Putem testa SkyPlanner înainte de a realiza integrarea?
Da. Perioada de testare gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu importuri CSV sau Excel din Senior, fără a fi necesar un card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
