Integrări / ERP / SAP Business One
Ghid de integrare SAP Business One cu SkyPlanner APS pentru programarea producției
Acest ghid le arată partenerilor SAP Business One și echipelor IT cum să conecteze B1 la SkyPlanner APS. Explică ce API-uri să folosiți, ce obiecte se transferă în fiecare direcție și unde apar probleme în proiectele B1. SkyPlanner se integrează bidirecțional cu SAP Business One prin Service Layer:
- În SkyPlanner se importă comenzi de producție, etape ale fluxului tehnologic, resurse, articole și comenzi de achiziție.
- Datele planificate de începere și de finalizare sunt retransmise către B1 și înscrise în comenzile de producție.
- Pontajele operatorilor sunt înregistrate ca Receipt and Issue for Production.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
SAP Business One păstrează articolele, BOM-urile, comenzile de producție, stocurile și datele financiare, iar modulul dumneavoastră de producție rămâne neschimbat. Echipa SkyPlanner configurează integrarea cu obiectele standard B1 în etapa de implementare și asigură asistență după punerea în funcțiune. Etapele fluxului tehnologic, grupurile de resurse, câmpurile definite de utilizator și extensiile diferă de la o bază de date de companie la alta. Configurarea stabilește corespondențele pentru aceste particularități.
Laboratory & Allied folosește SkyPlanner cu SAP Business One pe HANA. Pentru argumentele economice, consultați pagina despre programarea producției cu SAP Business One.
Opțiuni de integrare cu SAP Business One
SAP Business One oferă trei interfețe de integrare. Pentru o aplicație de programare în cloud, opțiunea implicită este Service Layer.
| Opțiune | Descriere | Utilizare pentru integrarea cu APS |
|---|---|---|
| Service Layer | API REST/OData. /b1s/v1 folosește OData v3, iar /b1s/v2 folosește OData v4. Funcționează pe versiunea SAP Business One pentru SAP HANA și, începând cu 10.0 PL01, pe Microsoft SQL Server. | Varianta principală. Folosește HTTP și JSON și poate fi accesată dintr-un serviciu cloud. |
| DI API | Bibliotecă COM pentru Windows. Comenzile de producție sunt reprezentate de obiectul ProductionOrders, stocat în tabelul OWOR (tip de obiect 202). | Pentru middleware existent sau instalat local. Necesită o gazdă Windows. |
| Integration Framework (B1if) | Soluția middleware SAP pentru scenarii de integrare la nivel de document. | Utilă dacă partenerul rulează deja scenarii B1if. |
Autentificare
Service Layer folosește autentificarea pe bază de sesiune. Trimiteți POST /b1s/v1/Login cu CompanyDB, UserName și Password și primiți un cookie B1SESSION (plus un ROUTEID opțional pentru configurațiile cu echilibrarea încărcării). Valoarea implicită pentru SessionTimeout este de 30 de minute de inactivitate. Apelați explicit Logout la încheierea fiecărei sincronizări. Creați un utilizator B1 dedicat integrării, astfel încât fiecare modificare transmisă din SkyPlanner să poată fi urmărită în jurnalul de modificări.
Entități Service Layer pentru programarea producției
| Date | Entitate Service Layer |
|---|---|
| Articole și date de planificare | Items |
| Liste de materiale și etape ale fluxului tehnologic | ProductTrees (Lines, Stages) |
| Utilaje, forță de muncă, alte resurse | Resources, ResourceGroups |
| Comenzi de producție | ProductionOrders (Lines, Stages) |
| Stocuri pe depozite | Date de stoc din Items, Warehouses |
| Comenzi de achiziție deschise și date de livrare | PurchaseOrders (DocumentLines: cantitate rămasă de livrat, ShipDate) |
| Recepții de mărfuri aferente comenzilor de achiziție | PurchaseDeliveryNotes (Goods Receipt PO, tip de obiect 20) |
| Issue for Production | InventoryGenExits |
| Receipt from Production | InventoryGenEntries |
| Configurarea webhook-urilor | EventSubscriptions, EventNotifications |
Dimensiunea implicită a paginii este de 20 de înregistrări. Măriți-o prin antetul Prefer: odata.maxpagesize (sau prin PageSize în b1s.conf) și urmați odata.nextLink. Folosiți $expand pentru a prelua liniile și etapele comenzilor de producție într-un singur apel, iar pentru actualizările masive în sistemul sursă, grupați cererile în loturi.
Evenimente și webhookuri
Începând cu SAP Business One 10.0 FP 2602, Service Layer acceptă webhook-uri. Acestea sunt dezactivate implicit. Le activați pentru fiecare companie prin CompanyService_UpdateAdminInfo (EnableWebhook = tYES). Apoi trimiteți POST EventSubscriptions cu trei componente:
- un
WebhookURL - un
AuthenticationType: None, Basic, HMAC sau OAuth, cu HMAC ca valoare implicită - un
EventCollectioncu obiecte de business și tipuri de tranzacții
WebhookURL trebuie să folosească HTTPS și un certificat care corespunde numelui gazdei. EventSubscriptionsService_GetEventCatalog listează evenimentele la care vă puteți abona. Serviciul Webhook Messenger Service trebuie să fie pornit.
Pe versiunile mai vechi, interogați periodic sistemul (vedeți mai jos problema legată de UpdateDate). SBO_SP_TransactionNotification este un mecanism de validare la nivelul bazei de date, nu un canal de transmitere a evenimentelor.
Maparea datelor din SAP Business One în SkyPlanner
| SAP Business One (Service Layer) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
Items (articole fabricate, Procurement Method) | Produse | B1 → SkyPlanner | Încărcare inițială, apoi la intervale programate |
Lines din ProductTrees (linii de articole) | Materialele produselor | B1 → SkyPlanner | Încărcare inițială, apoi la modificare |
Stages și linii de resurse din ProductTrees | Etape de proces și timpi de execuție | B1 → SkyPlanner | Încărcare inițială, apoi la modificare |
Resources (Machine, Labor, Other) | Centre de lucru și personal | B1 → SkyPlanner | Încărcare inițială, modificări rare |
ResourceGroups | Grupuri de centre de lucru | B1 → SkyPlanner | Încărcare inițială |
ProductionOrders (Planned, Released) | Comenzi și operații | B1 → SkyPlanner | Webhook (FP 2602+) sau interogare la fiecare câteva minute |
Stages din ProductionOrders | Etapele operațiilor și ordinea lor | B1 → SkyPlanner | Odată cu comanda |
Stocul din Items pe Warehouses | Stocuri de materiale | B1 → SkyPlanner | La intervale programate, de exemplu orar |
Linii deschise din PurchaseOrders (tip de obiect 22), cu data de livrare | Comenzi de achiziție / materiale de primit, cu data estimată de livrare | B1 → SkyPlanner | La intervale programate, de exemplu orar |
Linii din PurchaseDeliveryNotes (Goods Receipt PO) cu BaseType 22 | Cantitatea recepționată pe linia comenzii de achiziție, stoc actualizat | B1 → SkyPlanner | La intervale programate, de exemplu orar |
| Început și sfârșit programate | PATCH ProductionOrders({DocEntry}): StartDate, DueDate, plus StartDate și EndDate pe linia de resursă | SkyPlanner → B1 | Webhook SkyPlanner la modificarea programului |
| Cantități înregistrate | InventoryGenEntries (Receipt from Production) | SkyPlanner → B1 | La confirmare sau în loturi |
| Ore și consum de materiale înregistrate | InventoryGenExits (Issue for Production) | SkyPlanner → B1 | La confirmare sau în loturi |
Calendarele de schimburi, personalul și absențele sunt gestionate în SkyPlanner. Valorile capacității zilnice din B1 nu sunt incluse în transfer (vedeți prima capcană de mai jos).
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Preluați Resources, ResourceGroups, Items cu Procurement Method setat la Make și structurile ProductTrees aferente, cu etapele lor. Asociați fiecare resursă de tip utilaj unui centru de lucru SkyPlanner. Verificați lista împreună cu planificatorii înainte de prima sincronizare a comenzilor.
2. Sincronizarea comenzilor. Citiți ProductionOrders cu starea Planned și Released, folosind $expand pentru linii și etape. Comenzile de producție B1 conțin etapele fluxului tehnologic preluate din BOM, iar planificatorii pot modifica o comandă după creare. Folosiți etapele comenzii, nu pe cele din BOM. O comandă de producție realizează un singur produs, deci pentru un produs cu structură pe mai multe niveluri se folosește câte o comandă de producție pentru fiecare nivel. Legați comenzile între ele, astfel încât SkyPlanner să programeze subansamblele înaintea produsului de nivel superior.
Sincronizați și liniile deschise din PurchaseOrders, cu cantitatea rămasă de livrat și data de livrare, folosind endpoint-urile SkyPlanner pentru comenzi de achiziție. SkyPlanner consideră materialul comandat disponibil la data de livrare a comenzii de achiziție. În B1, stocul se modifică la înregistrarea unei recepții Goods Receipt PO (PurchaseDeliveryNotes). Integrarea citește aceste recepții, marchează cantitatea recepționată ca livrată în SkyPlanner și păstrează deschisă cantitatea rămasă. Recepțiile parțiale sunt luate în calcul o singură dată, iar verificările de disponibilitate a materialelor acoperă atât stocul, cât și aprovizionările în curs.
3. Transmiterea programului către B1. Webhook-urile SkyPlanner se declanșează la modificarea programului. Integrarea trimite PATCH /b1s/v1/ProductionOrders({DocEntry}) cu noile valori StartDate și DueDate, precum și cu StartDate și EndDate pe liniile de resurse ale comenzii (ProductionOrderLines), astfel încât fiecare etapă să aibă intervalul programat. Corpul cererii conține doar câmpurile gestionate de SkyPlanner, iar mai multe comenzi sunt trimise într-o singură cerere $batch. Utilizatorii B1 văd apoi datele programate pe comanda de producție și în fereastra Resource Capacity. În instalările în care Service Layer nu este disponibil, aceeași actualizare se face dintr-un serviciu local prin obiectul ProductionOrders din DI API (GetByKey, setarea datelor, Update).
4. Confirmări din atelier. Operatorii înregistrează activitatea în SkyPlanner prin Mobile Confirmations sau Production Timer. Fiecare înregistrare de timp generează un POST /b1s/v1/InventoryGenEntries pentru cantitatea finalizată (Receipt from Production) și un POST /b1s/v1/InventoryGenExits pentru componente și timpul de utilizare a resurselor (Issue for Production).
Fiecare linie de document are BaseType 202 și BaseEntry setat la valoarea DocEntry a comenzii de producție; liniile de ieșire includ și BaseLine al liniei de componentă sau de resursă. Cantitățile parțiale sunt contabilizate pe măsură ce sunt înregistrate, numerele de lot și de serie sunt adăugate pentru articolele urmărite astfel, iar comanda trebuie să aibă starea Released.
ID-ul pontajului din SkyPlanner este stocat în documentul B1, astfel încât un eveniment retrimis nu generează niciodată o înregistrare dublă. Dacă o înregistrare eșuează, se reîncearcă și se raportează eroarea, în loc să fie abandonată.
5. Reguli privind sistemul responsabil și rezolvarea conflictelor. Stabiliți-le înainte de a scrie cod:
- B1 gestionează articolele, BOM-urile, cantitățile, depozitele și crearea comenzilor.
- SkyPlanner gestionează succesiunea operațiilor, momentele de începere și de finalizare și alocarea la centrele de lucru.
- Dacă datele unei comenzi sunt modificate în ambele sisteme, următoarea rulare SkyPlanner are prioritate, cu excepția cazului în care planificatorii au blocat operația în SkyPlanner.
- Comenzile cu starea Closed sau Cancelled în B1 duc la eliminarea operației din program.
Ce include proiectul
Implementarea se finalizează în mod normal în câteva săptămâni de la începerea etapei de configurare inițială. Înainte de aceasta, puteți folosi propriile date în perioada de testare gratuită de 30 de zile. Exportați articolele, resursele și comenzile de producție deschise din B1 în CSV sau Excel și încărcați-le cu funcția de import de date din SkyPlanner. Planificatorii văd un program real înainte să se scrie codul de integrare.
Un proiect SAP Business One obișnuit include:
- Maparea nomenclatoarelor. Resursele și grupurile de resurse din B1 sunt asociate centrelor de lucru, etapele fluxului tehnologic sunt asociate etapelor de proces, iar articolele de tip Make sunt asociate produselor.
- Încărcarea inițială. Articole, Product Trees cu etape și poziții de articole, resurse și stocuri pe depozit.
- Sincronizarea comenzilor de producție și de achiziție. Comenzi de producție deschise, cu poziții și etape, precum și comenzi de achiziție deschise, cu datele de livrare aferente.
- Transmiterea programului către B1. Datele de început și termenele programate sunt transmise către
ProductionOrders. - Confirmări din producție. Receipt and Issue for Production sunt înregistrate pe baza pontajelor din SkyPlanner.
- Testarea în paralel cu planul actual. Planificatorii compară programul SkyPlanner cu modul în care planifică în prezent.
- Punerea în funcțiune. Programul SkyPlanner devine planul de referință.
Resursele și etapele fluxului tehnologic bine definite în B1 reduc timpul necesar mapării. La Laboratory & Allied, integrarea a fost una dintre cele mai simple părți ale proiectului. Echipa IT internă a realizat integrarea cu SAP Business One pe HANA în mare parte pe cont propriu. Echipa SkyPlanner a intervenit în cazurile cele mai complexe, cum ar fi produsele care se combină pe parcursul unor procese cu mai multe etape.
Capcane la integrarea cu SAP Business One
Capacitatea zilnică nu este un model de lucru în schimburi.
B1 stochează Daily Internal Capacity și Single Run Capacity pentru fiecare resursă, pentru fiecare zi („These capacities are defined on a daily basis,” (Aceste capacități sunt definite pe zi), conform SAP Learning). Ghidul SAP precizează că la calculul Required Days se presupune că „a single production order can be produced on a single machine” (o singură comandă de producție poate fi executată pe un singur utilaj) (ghidul practic SAP). Nu copiați aceste valori pentru a le folosi drept capacitate finită. Definiți schimburile, personalul și eficiența centrelor de lucru în SkyPlanner.
Fluxul tehnologic este definit în BOM.
Nu există un nomenclator separat de fluxuri tehnologice. Liniile Route Stage din Product Tree stabilesc succesiunea, iar valorile Waiting Days se introduc manual. Citiți Stages din ProductTrees și Stages din ProductionOrders și verificați că fiecare linie de resursă aparține unei etape. Comenzile fără etape nu oferă sistemului de programare o succesiune a operațiilor.
Cantitățile din pozițiile de resurse trebuie convertite.
Quantity dintr-o poziție BOM reprezintă necesarul pentru a produce cantitatea din antetul BOM, nu o singură unitate. Additional Quantity se adaugă la timpul planificat „regardless of the quantity of the parent item produced” (indiferent de cantitatea produsă din articolul părinte) (ghidul practic SAP). Tratați această valoare ca pe un timp fix pe comandă, similar timpului de pregătire. Împărțiți la cantitatea din antet înainte de a calcula timpii de execuție pe unitate; altfel, durata fiecărei operații va fi eronată cu un factor multiplicativ.
Nomenclatorul de resurse este rareori lipsit de erori.
Resursele sunt de tip Machine, Labor sau Other. Utilajele pot fi asociate mijloacelor fixe, iar manopera, angajaților. Unei resurse i se poate asocia și un articol nestocabil pentru achiziționarea sau vânzarea acesteia. Niciuna dintre aceste informații nu indică ce resurse sunt utilaje reale care pot fi programate. Corectați grupurile de resurse și eliminați resursele duplicate înainte ca acestea să devină lista centrelor de lucru.
Confirmările pot eșua din cauza regulilor de gestiune a stocurilor.
Recepțiile și ieșirile sunt documente de stoc. Erorile obișnuite sunt confundarea InventoryGenEntries cu InventoryGenExits, lipsa numerelor de lot sau de serie pentru articolele urmărite astfel ori înregistrarea documentelor pe o comandă cu starea Planned.
Sesiuni și paginare.
O sesiune expirată returnează „Invalid session or session already timeout.” (Sesiune nevalidă sau deja expirată.) Autentificați-vă din nou când apare această eroare. Paginarea implicită la 20 de înregistrări trunchiază fără avertisment sincronizările care ignoră odata.nextLink.
UpdateDate nu conține ora.
În tabelul OWOR, UpdateDate este un câmp de tip dată; ora actualizării se află separat în UpdateTS. O interogare periodică filtrată doar după UpdateDate preia la fiecare rulare toate comenzile modificate în ziua respectivă. Combinați cele două câmpuri sau eliminați duplicatele în integrarea dumneavoastră.
Webhookurile garantează livrarea cel puțin o dată.
Webhook Messenger reîncearcă o livrare eșuată de până la cinci ori (2, 4, 8, 16 și 32 de secunde), apoi o marchează ca eșuată. Reîncercările pot produce duplicate, iar ordinea este garantată doar în cadrul aceleiași companii. Implementați procesarea idempotentă pe baza ID-ului evenimentului și păstrați o interogare de reconciliere în fiecare noapte.
Cine configurează integrarea cu SAP Business One
Lucrările includ maparea etapelor fluxului tehnologic, a resurselor și a configurației B1, precum și definirea constrângerilor de care B1 nu ține cont la programare: matricea timpilor de pregătire, sculele, numărul de operatori și resursele alternative.
- Echipa SkyPlanner configurează integrarea în etapa de implementare și asigură asistență după punerea în funcțiune. Fiecare companie folosește B1 diferit, iar această experiență este valorificată în configurare. Aceasta este varianta implicită.
- Partenerul dumneavoastră SAP Business One poate participa. Partenerii care cunosc baza de date a companiei, extensiile și câmpurile definite de utilizator pot dezvolta integrarea folosind Service Layer și API-ul REST SkyPlanner (documentația API).
- Propriii dezvoltatori pot realiza integrarea. API-ul REST SkyPlanner permite citirea și scrierea comenzilor, produselor, materialelor, etapelor de proces, comenzilor de achiziție și pontajelor. Folosește autentificare cu token JWT bearer și este documentat în Swagger/OpenAPI, cu documentație publică disponibilă în documentația SkyPlanner. Webhookurile transmit în timp real modificările de program și de stare. Aveți nevoie doar de o cheie API SkyPlanner pentru a începe dezvoltarea (tutorial de integrare), iar echipa SkyPlanner vă oferă asistență la nevoie. Aceasta este varianta aleasă de echipa IT internă a Laboratory & Allied.
Validați mai întâi programul în perioada de testare gratuită de 30 de zile, astfel încât integrarea să pornească de la un program deja adaptat fabricii.
De ce aleg echipele tehnice SkyPlanner pentru B1
- Alegeți SkyPlanner când doriți o integrare restrânsă, bine definită. Se importă obiecte standard B1 (comenzi de producție, Product Trees, Resources, Items) și se trimit înapoi date calendaristice, plus Issue and Receipt from Production. Fără modificări ale modulului de producție B1 și fără migrarea datelor.
- Alegeți SkyPlanner când proiectul trebuie să-și demonstreze valoarea de la început. Perioada de testare gratuită de 30 de zile folosește un export CSV, cu până la 20 de centre de lucru, fără card de credit. Compania își vede propriul program înainte de începerea integrării.
- Alegeți SkyPlanner când programul trebuie să respecte constrângerile reale. Timpii de schimbare de fabricație, sculele comune, operațiile cu mai mulți operatori, resursele alternative, stocurile și comenzile de achiziție deschise sunt toate modelate în SkyPlanner. Integrarea doar furnizează datele din B1.
- Alegeți SkyPlanner când doriți un singur sistem pentru planificatori și operatori. Motorul Arcturus generează programul în câteva secunde, iar Autopilot îl reface automat când apar schimbări în producție. Operatorii înregistrează activitatea pe telefon sau tabletă, iar integrarea transmite aceste confirmări către B1, unde sunt înregistrate.
- Alegeți SkyPlanner când costurile trebuie să fie previzibile. Prețurile pornesc de la 199 € pe lună, cu 5 centre de lucru incluse, facturare lunară și posibilitatea de a renunța oricând. Oferta pentru integrare este stabilită de la început, în funcție de procesul și nevoile dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe.
Citiți explicația programării cu capacitate finită pentru SAP Business One pentru a înțelege ce lipsește din planificare și consultați pagina integrărilor ERP pentru alte sisteme ERP.
Părerile producătorilor despre SkyPlanner
+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.
2 heconomisite săptămânal
„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.
6 lunipentru care echipa de vânzări vede capacitatea disponibilă
„SkyPlanner oferă o bază solidă și siguranță pentru întreaga planificare a producției.”
Anu Järvinen, directoare de producție
Fredman Operations · Hârtie pentru ambalaje destinată contactului cu alimentele
Echipa de vânzări vede capacitatea disponibilă pentru următoarele șase luni, iar solicitările de modificare a programului, care necesitau o oră sau mai mult, primesc acum răspuns în câteva secunde.
99,2%respectarea termenelor de livrare
„SkyPlanner ne-a oferit vizibilitatea necesară pentru a identifica blocajele și a adus mai multă claritate în gestionarea producției.”
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
Cine realizează integrarea cu SAP Business One?
Echipa SkyPlanner configurează integrarea bidirecțională în etapa inițială de implementare și asigură asistență după punerea în funcțiune. În SkyPlanner sunt importate comenzile de producție, etapele fluxului tehnologic, resursele, comenzile de achiziție și recepțiile de mărfuri. Datele programate și documentele Issue and Receipt from Production sunt transmise înapoi. Partenerul dumneavoastră B1 sau propriii dezvoltatori pot realiza integrarea și folosind Service Layer și API-ul REST al SkyPlanner. Pentru a începe, este suficientă o cheie API.
Cât durează implementarea SkyPlanner cu SAP Business One?
Implementarea se finalizează de obicei în câteva săptămâni de la începerea etapei inițiale. Echipa stabilește corespondențele pentru resurse și etapele fluxului tehnologic, conectează comenzile de producție și de achiziție și verifică programul în raport cu planul dumneavoastră actual înainte de punerea în funcțiune.
Service Layer sau DI API?
Pentru integrările noi, alegeți Service Layer. Acesta folosește HTTP, rulează pe HANA și SQL Server și este potrivit pentru un sistem de programare în cloud. Folosiți DI API doar dacă soluția middleware existentă depinde deja de acesta.
Am nevoie de SAP Business One 10.0 FP 2602?
Doar pentru webhook-uri. Versiunile 10.0 anterioare se integrează prin interogări periodice programate.
Cum sunt transmise înapoi în SAP Business One datele programate?
Prin PATCH /b1s/v1/ProductionOrders({DocEntry}), setând StartDate și DueDate pe comandă și StartDate și EndDate pe liniile ei de resurse. Actualizarea este declanșată de webhook-ul SkyPlanner pentru modificarea programului. Cantitățile produse și timpul sunt transmise înapoi prin InventoryGenEntries și InventoryGenExits, legate de comandă prin BaseType 202 și BaseEntry.
Avem nevoie de o extensie pentru producție în B1?
Nu. Integrarea folosește doar obiecte standard B1: comenzi de producție, Product Trees, Resources, Items, comenzi de achiziție și documente de stoc. Nu se migrează nimic într-un nou model de date pentru producție.
Putem testa SkyPlanner cu datele noastre din B1 înainte de integrare?
Da. Perioada de probă de 30 de zile include până la 20 de centre de lucru, cu import din CSV sau Excel, fără a fi necesar un card de credit. Începeți proba gratuită sau discutați cu echipa de vânzări despre configurația dumneavoastră B1.
