Integrációk / ERP / Xero
Xero-integrációs útmutató a SkyPlanner APS-sel végzett gyártásütemezéshez
Ez az integrációs útmutató bemutatja a Xero-tanácsadóknak, konzulenseknek és informatikai csapatoknak, hogyan kapcsolható össze a Xero a SkyPlanner APS-sel. A SkyPlanner és a Xero között kétirányú az adatátvitel a Xero Accounting API és Projects API felületén keresztül:
- A SkyPlanner átveszi a partnereket, a készletnyilvántartásban szereplő cikkeket az aktuális készletmennyiséggel, az elfogadott ajánlatokat és a beszerzési rendeléseket az érkezési dátumukkal együtt.
- A tervezett befejezési dátum megjegyzésként kerül vissza az egyes ajánlatok előzményeibe.
- Az elkészült rendelésekből kimenő számlapiszkozatok kerülnek vissza a Xero rendszerébe az ajánlat tételeivel és hivatkozásával, az ajánlat pedig Invoiced állapotba kerül.
- A projektmunkákra rögzített munkaórák munkaidő-bejegyzésekként kerülnek vissza a Xero Projects rendszerébe.
- A Xero webhookjai jelzik a partnerek és számlák változásait, a SkyPlanner webhookjai pedig azonnal továbbítják az ütemterv módosításait.
A Xero könyvelőprogram, ezért nem tárol darabjegyzékeket, technológiai útvonalakat, gépeket vagy gyártási rendeléseket. A munkaállomásokat, műveleteket, műszakokat és átállási időket a SkyPlanner kezeli. A SkyPlanner csapata a bevezetés során beállítja az integrációt az Ön Xero-szervezetéhez, és az éles indulás után is támogatást nyújt hozzá. Ez az útmutató azoknak a tanácsadóknak és fejlesztőknek szól, akik részt kívánnak venni ebben, vagy maguk szeretnének fejleszteni a SkyPlanner dokumentált REST API felületére építve (API-referencia).
A Xero Accounting API
A Xero egyetlen, több bérlőt kiszolgáló felhőalapú termék, és minden szervezet ugyanazt az API-t használja. Az Accounting API egy JSON- vagy XML-formátummal használható REST API a https://api.xero.com/api.xro/2.0/ címen. Minden hívás a Xero-tenant-id fejlécben adja meg a szervezetet. (forrás)
A gyártásütemezéshez szükséges végpontok:
- Törzsadatok:
/Contacts(vevők és szállítók),/Items(Code, IsTrackedAsInventory, QuantityOnHand). - Igények:
/Quotes(Status ACCEPTED, LineItems), illetve az előre számlázó üzemeknél/Invoices, ahol a Type értéke ACCREC. - Anyagellátás:
/PurchaseOrders(DeliveryDate, ExpectedArrivalDate, valamint LineItems az ItemCode mezővel). - Visszaírás:
/Quotes/{QuoteID}/History,/Invoices,/Quotes, valamint a Projects API ahttps://api.xero.com/projects.xro/2.0/projects/{projectId}/timecímen.
Minden listázó végpont fogad If-Modified-Since fejlécet, így a szinkronizálás csak a megváltozott adatokat olvassa be. A létrehozás és a frissítés kötegelve történik. Darabjegyzékekhez, technológiai útvonalakhoz és gyártási rendelésekhez nincs végpont.
Hitelesítés, jogosultsági körök és korlátok
A Xero OAuth 2.0-t használ. A Xero rendszergazdája egyszer bejelentkezik, jóváhagyja az alkalmazást, és kiválasztja a szervezetet. Az alkalmazás offline_access jogosultságot kér, hogy frissítési tokenekkel fenntarthassa a kapcsolatot. (forrás)
A Xero a széles jogosultsági köröket részletesebbekre cseréli, és az új alkalmazások már ezeket kapják. Egy gyártásütemezési integrációhoz a következők szükségesek:
accounting.invoicesaz ajánlatokhoz, számlákhoz, beszerzési rendelésekhez és cikkekhezaccounting.contactsa vevőkhöz és szállítókhozaccounting.settings.reada cikkbeállításokhozprojectsa munkaidő-bejegyzésekhezoffline_access
A Xero szervezetenként korlátozza az egyidejű, a percenkénti és a napi hívások számát, és alkalmazásonként is megszab korlátokat. Túllépés esetén HTTP 429 választ ad vissza Retry-After fejléccel. A napi keret és a csatlakoztatott szervezetek száma az alkalmazás partneri szintjétől függ. Mindkettő megtalálható a Xero API-korlátokat ismertető oldalán. A webhookokkal, az If-Modified-Since alapú lekérdezésekkel és a kötegelt írásokkal a gyártásütemezési integráció bőven a korlátokon belül marad.
A SkyPlanner oldalán a REST API az Authorization-Token fejlécben megadott API-tokennel hitelesít (SkyPlanner Settings > API), dokumentációja pedig Swagger/OpenAPI formátumú. Az integrációs oktatóanyag végigvezeti az első hívásokon.
Webhookok
“Webhooks allow you to subscribe to certain events that happen in Xero.” (A webhookokkal feliratkozhat a Xero bizonyos eseményeire.) (forrás) A gyártásütemezés szempontjából a Contact és az Invoice eseményei fontosak, mindkettőnél a CREATE és az UPDATE.
Így működnek:
- Alkalmazásonként egy webhook kezeli az összes csatlakoztatott szervezet eseményeit.
- Minden kézbesített üzenet tartalmaz egy events tömböt az erőforrás-azonosítóval és az eseménytípussal. A fogadó ezután lekéri az erőforrást.
- Minden kézbesített üzenet aláírását az
x-xero-signaturefejléc tartalmazza, amely az alkalmazás webhookkulcsával készül. A kézbesítés megkezdése előtt a Xero egy „Intent to receive” ellenőrzést küld. - A Xero újrapróbálkozik a sikertelen kézbesítésekkel, a tartósan hibás webhookot pedig letiltja. Ezért a fogadó gyorsan válaszol, és csak ezután végzi el a feldolgozást.
Az ajánlatokhoz, cikkekhez és beszerzési rendelésekhez nem tartoznak webhookesemények. A SkyPlanner rövid időközönként kérdezi le őket If-Modified-Since fejléccel. Ha semmi sem változott, ez entitásonként egy hívást igényel.
Adatmegfeleltetés
| Xero-objektum (végpont) | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
Contact, IsCustomer (/Contacts) | Customer (external_identifier, delivery_priority) | Xero → SkyPlanner | Kezdeti betöltés, majd webhook hatására |
Item, készletnyilvántartással és anélkül, QuantityOnHand mezővel (/Items) | Termékek és anyagok, készlet | Xero → SkyPlanner | Kezdeti betöltés, majd If-Modified-Since alapján |
Quote, Status ACCEPTED, LineItems mezővel (/Quotes) | Order (external_order_number, delivery_date), tételenként gyártási feladatok | Xero → SkyPlanner | Időszakos lekérdezés If-Modified-Since alapján |
Invoice, Type ACCREC (előre számlázó üzemek) (/Invoices) | Order és gyártási feladatok | Xero → SkyPlanner | Valós időben, webhookon keresztül |
PurchaseOrder ExpectedArrivalDate vagy DeliveryDate mezővel (/PurchaseOrders) | Beérkező anyag (estimated_delivery_date) | Xero → SkyPlanner | Időszakos lekérdezés If-Modified-Since alapján |
Megjegyzés az ajánlat előzményeiben (PUT /Quotes/{QuoteID}/History) | Tervezett befejezési dátum | SkyPlanner → Xero | Az ütemterv változásakor |
Invoice, Type ACCREC, Status DRAFT, Reference = ajánlatszám (POST /Invoices) | Elkészült rendelés | SkyPlanner → Xero | A rendelés elkészültekor |
Quote, Status INVOICED (POST /Quotes) | Elkészült rendelés | SkyPlanner → Xero | A számla létrehozásakor |
Projects munkaidő-bejegyzés (POST /projects/{projectId}/time) | Mobile Confirmations, munkaidőnaplók | SkyPlanner → Xero | A munka rögzítésekor |
| Nincs a Xero rendszerében | Munkaállomások, műveletek, műszakok, távollétek, átállásiidő-mátrix, szerszámok, kezelői létszámok, alternatív munkaállomások | A SkyPlannerben karbantartva | Beállítás a bevezetés során |
Integrációs minták
1. A törzsadatok kezdeti betöltése. Kérje le lapozva a partnereket és a cikkeket, majd a nyitott beszerzési rendeléseket és az elfogadott ajánlatokat. Hozza létre a SkyPlannerben az ügyfeleket a Xero ContactID értékét használva az external_identifier mezőben, a termékeket és anyagokat pedig a cikkszámmal mint kulccsal. Ezután rögzítse azt, amit a Xero nem tárol: a munkaállomásokat, a termékenkénti műveleteket, a műszakokat, a szabadságokat és az átállási időket. A műveletek betöltésének leggyorsabb módja a CSV- vagy Excel-import.
2. A rendelések szinkronizálása. Kérdezze le időszakosan az ajánlatokat If-Modified-Since fejléccel. Amikor egy ajánlat ACCEPTED állapotba kerül, a SkyPlanner létrehoz egy rendelést, amelynek external_order_number mezőjébe az ajánlatszám kerül. A delivery_date értékét abból a mezőből veszi át, amelyet az üzem a vállalt határidőhöz használ; ezt a megfeleltetést a bevezetés során állítják be. Minden tételből gyártási feladatok keletkeznek a termék műveletei alapján. A beszerzési rendelések tételei a várható érkezési dátumukkal beérkező anyagként jelennek meg, így a gyártási feladatok megvárják a szállítmányt. A nyitott ajánlatok és beszerzési rendelések éjszakánkénti teljes lekérdezése pótolja az esetleg kimaradt adatokat.
3. Az ütemterv és az elkészülés visszaírása. Három hívás juttatja vissza az eredményeket a Xero rendszerébe:
- A PUT
/Quotes/{QuoteID}/Historymegjegyzésként hozzáadja a tervezett befejezési dátumot. Elfogadott ajánlaton csak a partner és a megjegyzések módosíthatók, ezért a dátum az előzmények megjegyzésében kap helyet. (forrás) - A rendelés elkészültekor a POST
/Invoiceslétrehoz egy kimenő számlát: a Type értéke ACCREC, a Status értéke DRAFT, a partner és a tételek az ajánlatból származnak, a Reference pedig az ajánlatszám. A könyvelő ezt a Xero rendszerében hagyja jóvá és küldi el. - A QuoteID és a Status INVOICED megadásával indított POST
/Quoteslezárja az ajánlatot. Az Accounting API engedélyezi az Accepted állapotból Invoiced állapotba váltást.
4. Üzemi visszajelentések és projektmunkaidő. A dolgozók a SkyPlanner Mobile Confirmations, Production Timer vagy Quick Log Mode funkciójával rögzítik a munkát. Az előrehaladás azonnal frissíti az ütemtervet, az Autopilot pedig újratervezi a hátralévő feladatokat. Projektmunka esetén a SkyPlanner munkaidő-bejegyzésként küldi el az órákat a projektfeladatra, a Xero-felhasználó, a dátum és az időtartam megadásával. (forrás)
5. Adatgazdák és ütközéskezelési szabályok. Rögzítse őket az éles indulás előtt:
| Adatok | Adatgazda |
|---|---|
| Partnerek, cikkek, árak, ajánlatok, beszerzési rendelések, számlák, könyvelés | Xero |
| Munkaállomások, műveletek, műszakok, távollétek, átállásiidő-mátrix, szerszámok, alternatív erőforrások | SkyPlanner |
| A gyártási feladatok sorrendje, kezdési és befejezési ideje, feladatonként kijelölt munkaállomás | SkyPlanner |
| A tervezett befejezést tartalmazó megjegyzés az ajánlaton | SkyPlanner, visszaírva a Xero rendszerébe |
| Számlatervezet az elkészült rendelésekhez, projektre fordított munkaidő | A SkyPlanner hozza létre, jóváhagyás után a Xero kezeli |
A projekt szokásos lépései
A megvalósítás általában a bevezetés megkezdésétől számított néhány héten belül lezárul. Ezt megelőzően a 30 napos ingyenes próba során saját adataival dolgozhat: a partnerek, termékek és nyitott árajánlatok adatait a Xero rendszerből exportált CSV-fájlból töltheti be.
A projekt a következő lépésekből áll:
- Csatlakoztatás. Egy Xero-rendszergazda engedélyezi a SkyPlanner hozzáférését, és kiválasztja a szervezetet.
- A gyártást indító objektum. Közösen meghatározzuk, hogy az elfogadott árajánlatok vagy a kimenő számlák indítsák-e el a gyártást.
- Adatmegfeleltetés. Rögzítjük a megfeleltetési táblát, a cikkszámokat, a számlákhoz tartozó főkönyvi számlákat, az alapértelmezett adóbeállításokat és az adatgazdai szabályokat.
- Kezdeti adatbetöltés. Partnerek, cikkek, nyitott beszerzési rendelések és elfogadott árajánlatok betöltése.
- Gyártási modell. A SkyPlanner rendszerben beállítjuk a munkaállomásokat, a termékenkénti műveleteket, a műszakokat, az átállásiidő-mátrixot, a szerszámokat és a dolgozói létszámokat.
- Szinkronizálás. A partnerekhez és számlákhoz webhookokat használunk, az árajánlatokat, cikkeket és beszerzési rendeléseket pedig rendszeresen lekérdezzük az
If-Modified-Sincehasználatával. Ezt éjszakai adategyeztetés egészíti ki. - Visszaírás. Először az árajánlatok megjegyzéseit, majd a számlatervezeteket és az árajánlatok állapotát írjuk vissza, végül a projektek munkaidőadatait is, ahol használják ezt a funkciót.
- Párhuzamos tesztelés és éles indulás. Hasonlítsa össze a SkyPlanner dátumait a jelenlegi tervével, ellenőriztesse az első számlatervezeteket a könyvelőjével, majd kapcsolja be a visszaírást.
Mire érdemes felkészülni a Xero-integráció során?
- A Xero nem tartalmaz gyártási objektumokat. A termékenkénti műveleteket a SkyPlanner rendszerben tartsa nyilván, a Xero cikkszámához kapcsolva. A cikkszámokat ne változtassa meg.
- Az árajánlatokhoz nincs webhook. Rövid időközönként kérdezze le őket az
If-Modified-Sincehasználatával, a percenkénti és napi korlátok betartásával. - Az elfogadott árajánlatok zárolva vannak. Elfogadás után csak a partner adatai és a megjegyzések módosíthatók. Ezért az ígért határidőt egyszer, az elfogadáskor olvassuk be, a tervezett dátumot pedig az előzményekben rögzítjük megjegyzésként.
- A készlet a számlák alapján változik. A készletnyilvántartásba bevont cikkeknél a Xero a kimenő és bejövő számlák, valamint a jóváíró bizonylatok alapján módosítja a készleten lévő mennyiséget. Egyeztessen könyvelőjével a késztermékek és a felhasznált anyagok elszámolásáról.
- A projektmunkaidő rögzítéséhez Xero-felhasználó szükséges. A munkaidő-bejegyzések egy-egy Xero-felhasználóhoz tartoznak. Döntse el, mely gépkezelők munkaideje kerüljön a Xero Projects rendszerbe, a többi adatot pedig tartsa a SkyPlanner rendszerben.
- Részletes hozzáférési jogosultságok. Már az elején részletes jogosultságokat igényeljen, mivel a széles körű jogosultságokat fokozatosan kivezetik.
- Az alkalmazás besorolási szintje. A partnerszint határozza meg, hány szervezethez csatlakozhat egy alkalmazás, és naponta hány API-hívást indíthat. A szint kiválasztásakor vegye figyelembe az üzemek számát.
Ki állítja be és támogatja a Xero-integrációt?
A munka kiterjed a cikkekre, árajánlatokra, beszerzési rendelésekre és arra, hogyan kerül az elkészült munka a számlázásba. Emellett beállítjuk mindazt, amit a Xero nem tart nyilván: a munkaállomásokat, műveleteket, műszakokat, az átállásiidő-mátrixot, a szerszámokat, a gépkezelői létszámokat és az alternatív erőforrásokat.
- A SkyPlanner csapata a bevezetés során beállítja az integrációt, és az éles indulás után is támogatja. Minden üzem másképp kezeli a cikkeket, árajánlatokat és készleteket a Xero rendszerben. A beállításoknál ezt a helyi tudást vesszük alapul.
- Xero-tanácsadója vagy integrációs partnere is elkészítheti az integrációt. A SkyPlanner ehhez REST API-t, Swagger/OpenAPI dokumentációt és webhookokat biztosít.
- Saját fejlesztői is építhetnek rá egy API-token segítségével. Az induláshoz elegendő egy API-token, a SkyPlanner csapata pedig szükség esetén segít. A SkyPlanner dokumentációjában megtalálja a termék leírását, benne a beszerzési rendelésekre, valamint a termékek és anyagok API-jára vonatkozó tudnivalókkal.
A SkyPlanner havonta 199 €-tól érhető el, havi számlázással, 5 munkaállomással. Az integrációra a folyamatai és igényei alapján előre adunk árajánlatot a választott csomaggal együtt, így már az indulás előtt látja a teljes költséget. Tekintse meg az árakat és a funkciókat, a Van gyártásütemezés a Xero rendszerben? című oldalon pedig azt is megtudhatja, mire képes önmagában a Xero. Áttekintést a Xero oldalán talál, a többi rendszert pedig az összes integráció között tekintheti meg.
Gyártóvállalatok véleménye a SkyPlanner rendszeréről
2 hmegtakarítás hetente
„A SkyPlanner segítségével az Excel-táblázatokra épülő gyártástervezésről áttértünk a gyártás valós idejű optimalizálására.”
Kalle Kalliomäki, ellátásilánc-szakértő
UTU · Elektromos kapcsolótáblák és kapcsolóberendezések
A gyártástervezés hetente 2 óra munkaidőt takarít meg, az új feladatsor pedig másodpercek alatt eljut a gyártósorra.
+90%gyártási hatékonyság
„A gyártás hatékonysága 90%-kal nőtt.”
Abdul Rucyinga, informatikai vezető
Laboratory & Allied · Gyógyszergyártás
A gyártás hatékonysága 90%-kal nőtt, és kevesebb mint 30 perc alatt elkészül az összes munkaállomásra kiterjedő, három hónapos optimalizált terv.
Kevesebbleállás anyaghiány miatt
„Számunkra a SkyPlanner értékét az adja, hogy a mindennapokban jól használható eszköz, különösen a szállítási határidők meghatározásához.”
Tommi Männistö, gyártástervezési vezető
Eskomatic · Bérforgácsolás
A terhelés automatikus ütemezése pontosabb szállítási határidőket eredményez, az anyaghiány miatti gyártásleállások pedig jelentősen csökkentek.
1 000-es nagyságrendbenautomatikusan ütemezett gyártási rendelések
„Egészen másképp tartjuk kézben a gyártást, és teljesen más szinten látjuk át a kapacitásunkat.”
Hannu Ryynänen, vezérigazgató
Mamec · Ipari keverők, szivattyúk és csúcstechnológiás bérgyártás
A rendszer több ezer gyártási rendelést ütemez automatikusan, miközben az egész szervezet valós időben látja a gyártás állapotát.
Gyakori kérdések
Van a Xero rendszernek API-ja a gyártási adatokhoz?
A Xero az Accounting API és a Projects API felületeket biztosítja; mindkettő REST-alapú, OAuth 2.0 hitelesítéssel. Ezeken keresztül érhetők el a partneradatok, cikkek, árajánlatok, számlák, beszerzési rendelések és munkaidő-bejegyzések. A gyártási adatokat, például a munkaállomásokat és műveleteket a SkyPlanner tárolja.
Tud a SkyPlanner adatokat visszaírni a Xero rendszerbe?
Igen. A SkyPlanner minden árajánlat előzményeihez hozzáadja a tervezett befejezési dátumot. A rendelés elkészültekor az árajánlat tételeivel kimenőszámla-tervezetet hoz létre, az árajánlat állapotát Invoiced értékre állítja, és átadja a projektek munkaidő-bejegyzéseit.
Valós időben küldi a Xero a változásokat?
A Xero webhookjai a partneradatok és a számlák változásairól küldenek értesítést. A SkyPlanner az If-Modified-Since használatával olvassa be az utolsó szinkronizálás óta módosult árajánlatokat, cikkeket és beszerzési rendeléseket, éjszakánként pedig adategyeztetést végez. Így az újonnan elfogadott árajánlat gyorsan bekerül az ütemtervbe.
Honnan származnak a darabjegyzékek, technológiai útvonalak és gépadatok, ha a Xero nem tartalmazza őket?
A SkyPlanner rendszerből. A munkaállomásokat, a termékenkénti műveleteket, a műszakokat és a beállítási időket egyszer kell megadnia, kézzel vagy CSV-, illetve Excel-importtal. Minden termék a Xero cikkszámához kapcsolódik, így az újonnan elfogadott árajánlatok automatikusan bekerülnek az ütemezésbe.
Kipróbálhatjuk a SkyPlanner rendszerét az integráció kiépítése előtt?
Igen. A 30 napos ingyenes próba legfeljebb 20 munkaállomást támogat, a Xero adatai pedig CSV-importtal tölthetők be. Bankkártya nem szükséges. Indítsa el a próbát, vagy egyeztessen értékesítőinkkel az integráció terjedelméről.
