Integrációk / ERP / QuickBooks Online
QuickBooks Online integrációs útmutató a SkyPlanner APS-sel végzett gyártásütemezéshez
Ez a QuickBooks Online integrációs útmutató bemutatja a ProAdvisor szakértőknek, tanácsadóknak és informatikai csapatoknak, hogyan kapcsolható össze a QuickBooks Online a SkyPlanner APS-sel. A SkyPlanner az Intuit Accounting API-ján keresztül, kétirányú adatkapcsolattal integrálódik a QuickBooks Online rendszerrel:
- A SkyPlanner átveszi az ügyfeleket, a cikkeket az aktuális készletmennyiséggel együtt, az elfogadott árajánlatokat, a nyitott beszerzési rendeléseket és a dolgozókat.
- A tervezett befejezési időpontot visszaírja az egyes árajánlatok szállítási dátumának mezőjébe.
- Az elkészült rendeléseket az árajánlatukhoz kapcsolt számlaként, a rögzített munkaórákat időráfordításként, a készletváltozásokat pedig készletkorrekcióként írja vissza.
- A QuickBooks webhookjai jelzik a bejövő változásokat, a SkyPlanner webhookjai pedig azonnal továbbítják az ütemterv módosításait.
A QuickBooks Online könyvelőszoftver, ezért nem tárol gépeket, technológiai útvonalakat vagy gyártási rendeléseket. A munkaállomásokat, műveleteket, műszakokat és átállási időket a SkyPlanner kezeli. A bevezetés során a SkyPlanner csapata az Ön QuickBooks-cégéhez konfigurálja az integrációt, és az éles indulás után is támogatást nyújt hozzá. Ez az útmutató azoknak a partnereknek és fejlesztőknek szól, akik részt szeretnének venni ebben a munkában, vagy maguk szeretnének fejleszteni a SkyPlanner dokumentált REST API-jára építve (API-referencia).
A QuickBooks Online Accounting API
A QuickBooks Online több bérlőt kiszolgáló, egységes felhőalapú termék, amelyben minden cég ugyanazt az Accounting API-t használja. Ez egy v3 verziójú REST API. Minden hívás egy adott céget címez meg annak realm ID azonosítójával: https://quickbooks.api.intuit.com/v3/company/{realmId}/{entity}. A teszteléshez külön sandbox-kiszolgáló áll rendelkezésre. A kérések és válaszok JSON-formátumúak, a séma verzióját pedig a minorversion paraméter választja ki. (forrás)
A gyártásütemezéshez szükséges entitások:
- Törzsadatok:
Customer,Item(Inventory, NonInventory, Service),Employee,Vendor. - Igények:
Estimate(TxnStatus Accepted, tételsorok,ShipDate), az előre számlázó üzemeknél pedigInvoicevagySalesReceipt. - Beszerzés:
PurchaseOrder(POStatus Open, cikkeket és mennyiségeket tartalmazó tételsorok),Bill. - Visszaírás:
Estimate,Invoice,TimeActivity,InventoryAdjustment.
Az adatok olvasása a query végponton keresztül történik, például így: select * from Estimate where MetaData.LastUpdatedTime > '2026-10-01'. A frissítések részlegesek is lehetnek, így a SkyPlanner csak a módosított mezőket küldi el. Az Accounting API-ban nincs vevői rendeléshez, technológiai útvonalhoz, munkaállomáshoz vagy gyártási rendeléshez tartozó entitás.
Hitelesítés és korlátok
Az Accounting API OAuth 2.0 hitelesítést használ authorization code folyamattal és a com.intuit.quickbooks.accounting jogosultsági körrel. Egy QuickBooks-rendszergazda egyszer bejelentkezik, és jóváhagyja a hozzáférést. Az alkalmazás ezután egy rövid élettartamú hozzáférési tokent tárol, amelyet az Authorization: Bearer fejlécben küld el, valamint egy frissítési tokent, amely minden frissítéskor megújul. (forrás)
Az Intuit cégenként, percenként és másodpercenként korlátozza a hívások számát, és HTTP 429 választ ad, ha egy alkalmazás túllépi a korlátot. Az Intuit App Partner Program egyes API-hívások havi számát is méri a partneri szint alapján. Mindkettőt az Intuit korlátokról és hívásszám-korlátozásokról szóló oldala ismerteti. A webhookok, az adatváltozások lekérése és a részleges frissítések révén a gyártásütemezési integráció jóval e korlátok alatt marad.
A SkyPlanner oldalán a REST API hitelesítése az Authorization-Token fejlécben megadott API-tokennel történik (SkyPlanner Settings > API), dokumentációja pedig Swagger/OpenAPI formátumban érhető el. Az integrációs útmutató lépésről lépésre bemutatja az első hívásokat.
Webhookok és adatváltozások lekérése
A QuickBooks webhookjai értesítik az alkalmazást, ha egy csatlakoztatott cég adatai megváltoznak. “Webhooks automatically notify you whenever data changes in your end-user’s QuickBooks Online company files.” (A webhookok automatikusan értesítik, amikor a végfelhasználó QuickBooks Online-cégfájljaiban megváltoznak az adatok.) (forrás) A gyártásütemezés szempontjából fontos entitások:
Customer,Item,EmployeeEstimate,Invoice,SalesReceiptPurchaseOrder,BillTimeActivity
A támogatott műveletek közé tartozik a Create, Update, Delete, Merge és Void. Az értesítés az entitás nevét, azonosítóját, a műveletet és az utolsó módosítás időpontját tartalmazza, nem a teljes rekordot. A fogadó fél ezután olvassa be a rekordot.
Az adatváltozások lekérése (GET /cdc?entities=...&changedSince=...) egy közelmúltbeli időablakon belül minden olyan adatot visszaad, amely a megadott időbélyeg óta megváltozott. A SkyPlanner ezt éjszakai egyeztetésre használja, így egy kimaradt webhook miatt soha nem marad elavult rendelés a rendszerben. A TimeActivity nem érhető el az adatváltozások lekérésével, ezért az egyeztetése lekérdezéssel történik. (forrás)
Adatmegfeleltetés
| QuickBooks Online-objektum | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
Customer | Customer (external_identifier, delivery_priority) | QuickBooks → SkyPlanner | Kezdeti betöltés, majd webhook hatására |
Item (Inventory, NonInventory, Service), a QtyOnHand mezővel | Termékek és anyagok, készlet | QuickBooks → SkyPlanner | Kezdeti betöltés, majd webhook hatására |
Estimate (Accepted), tételsorok, ShipDate | Order (external_order_number, delivery_date), tételsoronként gyártási feladatok | QuickBooks → SkyPlanner | Valós időben, webhookon keresztül |
Invoice vagy SalesReceipt (előre számlázó üzemeknél) | Order és gyártási feladatok | QuickBooks → SkyPlanner | Valós időben, webhookon keresztül |
PurchaseOrder (Open), tételsorok | Beérkező anyagok (termékek beszerzési rendelései) | QuickBooks → SkyPlanner | Valós időben, webhookon keresztül |
Employee | Személyi állomány | QuickBooks → SkyPlanner | Kezdeti betöltés, majd webhook hatására |
Estimate.ShipDate (részleges frissítés) | Tervezett befejezés | SkyPlanner → QuickBooks | Az ütemterv változásakor |
Invoice, az Estimate objektumra mutató LinkedTxn kapcsolattal | Elkészült rendelés | SkyPlanner → QuickBooks | A rendelés elkészültekor |
TimeActivity (EmployeeRef, CustomerRef, ItemRef, munkaórák) | Mobile Confirmations, munkaidő-bejegyzések | SkyPlanner → QuickBooks | A munka rögzítésekor |
InventoryAdjustment | Késztermékek bevételezése, felhasznált anyagok | SkyPlanner → QuickBooks | A rendelés elkészültekor |
| Nincs a QuickBooks rendszerben | Munkaállomások, műveletek, műszakok, távollétek, átállásiidő-mátrix, szerszámok, gépkezelői létszámok, alternatív munkaállomások | A SkyPlanner rendszerben kezelve | Beállítás a bevezetés során |
Integrációs minták
1. A törzsadatok kezdeti betöltése. A query végponton keresztül, lapozva kérje le az ügyfeleket, cikkeket, dolgozókat és nyitott beszerzési rendeléseket. Hozza létre az ügyfeleket a SkyPlanner rendszerben úgy, hogy az external_identifier értéke a QuickBooks-azonosító legyen, a termékeknél és anyagoknál pedig a cikkazonosító szolgáljon kulcsként. Ezután állítsa be mindazt, amit a QuickBooks 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álás.
2. Rendelések szinkronizálása. Iratkozzon fel az Estimate, Invoice, Item és PurchaseOrder webhookokra. Amikor egy árajánlat Accepted állapotba kerül, a SkyPlanner beolvassa, és létrehoz egy rendelést: az external_order_number értéke az árajánlat száma, a delivery_date értéke pedig a szállítási dátum lesz. Minden tételsorból a termék műveleteinek megfelelő gyártási feladatok jönnek létre. A nyitott beszerzési rendelések tételsorai beérkező anyagként jelennek meg, így a gyártási feladatok megvárják a szállítmányt. Az adatváltozások éjszakai lekérése minden kimaradt eseményt pótol.
3. Az ütemterv és az elkészülési adatok visszaírása. Négy hívás juttatja vissza az eredményeket a QuickBooks rendszerbe:
- Az
Estimaterészleges frissítése beírja aShipDateértékét, így a QuickBooks rendszerben rögzített vállalt dátum követi a tervet. - Amikor a rendelés elkészül, a POST
/invoicelétrehozza a számlát az árajánlat tételsoraival és az árajánlatra mutatóLinkedTxnkapcsolattal. Az Intuit árajánlatonként egy számlakapcsolatot engedélyez, ezért a részszállítások kezeléséről a felmérés során kell megállapodni. - A POST
/timeactivityminden gépkezelő rögzített munkaóráit a dolgozóhoz, az ügyfélhez és egy szolgáltatáscikkhez rendeli. A számlázható munkaórák ezután hozzáadhatók a számlához a QuickBooks rendszerben. - A POST
/inventoryadjustmentnöveli a késztermékek készletét, és csökkenti a felhasznált anyagokét. Az Intuit ezt az entitást az Egyesült Államokban, a QuickBooks Online Plus és Advanced csomagokban teszi elérhetővé. (forrás)
4. Üzemi visszajelentések. A gépkezelők a SkyPlanner Mobile Confirmations, a Production Timer vagy a Quick Log Mode segítségével rögzítik a munkát. Az előrehaladás azonnal frissíti az ütemtervet, az Autopilot pedig újraütemezi a hátralévő feladatokat. A munkaórák időráfordításként kerülnek át a QuickBooks rendszerbe. Ha az üzem a bérszámfejtéshez továbbra is a QuickBooks Time rendszert használja, a felmérés során válasszanak egyetlen csatornát a gyártási feladatokra fordított munkaórák rögzítéséhez.
5. Adatgazdai és ütközéskezelési szabályok. Rögzítse őket az éles indulás előtt:
| Adatok | Adatgazda |
|---|---|
| Ügyfelek, cikkek, árak, árajánlatok, beszerzési rendelések, számlák, könyvelés | QuickBooks Online |
| 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 időpontjai, feladatonként kijelölt munkaállomás | SkyPlanner |
| Az árajánlat szállítási dátuma | SkyPlanner, visszaírással a QuickBooks rendszerébe |
| Számla a teljesített rendelésekről, munkaórák, késztermékek készletkorrekciója | A SkyPlanner hozza létre, könyvelés után a QuickBooks az adatgazda |
A projekt jellemző 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 QuickBooks rendszeréből exportált ügyfelekkel, termékekkel és nyitott árajánlatokkal.
Maga a projekt a következőket foglalja magában:
- Csatlakoztatás. A QuickBooks rendszergazdája az Intuit OAuth 2.0 képernyőjén engedélyezi a SkyPlanner hozzáférését.
- A gyártást indító bizonylat. Megállapodunk arról, hogy elfogadott árajánlatok, számlák vagy értékesítési nyugták indítsák-e a gyártást.
- Adatmegfeleltetés. Véglegesítjük a megfeleltetési táblát, a cikkazonosítókat, a munkadíjhoz használt szolgáltatáscikkeket és az adatgazdai szabályokat.
- Kezdeti adatbetöltés. Ügyfelek, cikkek, munkavállalók, nyitott beszerzési rendelések.
- Gyártási modell. Munkaállomások, termékenkénti műveletek, műszakok, átállásiidő-mátrix, szerszámok és kezelői létszámok a SkyPlanner rendszerében.
- Eseményalapú szinkronizálás. Webhookok az árajánlatokhoz, cikkekhez és beszerzési rendelésekhez, valamint a változások éjszakánkénti lekérése.
- Visszaírás. Először a szállítási dátum, majd a számlák, munkaidő-bejegyzések és készletkorrekciók.
- Párhuzamos tesztelés és éles indulás. Hasonlítsa össze a SkyPlanner dátumait a jelenlegi tervével, ellenőriztesse könyvelőjével az első számlákat és korrekciókat, majd kapcsolja be a visszaírást.
Mire érdemes felkészülni a QuickBooks Online integrációjánál?
- A vevői rendelések a QuickBooks felületén maradnak. A Plus és az Advanced csomag alkalmazásában elérhetők a vevői rendelések, az integráció viszont az elfogadott árajánlatokat olvassa be, előre számlázó üzemeknél pedig a számlákat. Válasszanak egyetlen indító eseményt, hogy minden rendelés ugyanúgy kerüljön be a rendszerbe.
- A QuickBooks nem tárol technológiai útvonalakat. A termékenkénti műveleteket a SkyPlanner rendszerében tartsa nyilván, a megfelelő QuickBooks-cikkhez rendelve.
- Egy árajánlathoz egy számla kapcsolható. A részszállításokhoz külön szabály szükséges, például szállításonként egy árajánlat.
- A készletkorrekciók elérhetősége csomagtól és régiótól függ. Az Egyesült Államokban a Plus és az Advanced csomag támogatja őket. Más régiókban egyeztessen könyvelőjével arról, hogyan kerüljenek be a késztermékek a QuickBooks rendszerébe.
- Gyártási rendelések az Intuit Enterprise Suite rendszerében. Ha használja ezeket, döntse el, melyik rendszer legyen a gyártások és az alkatrészfoglalások adatgazdája.
- A csomagok az API-n keresztül csak olvashatók. Group típusú cikkek nem hozhatók létre az API-n keresztül, ezért a csomagokat a QuickBooks rendszerében kezelje.
- A frissítési token cseréje. Minden frissítés után tárolja el a legújabb frissítési tokent, különben megszakad a kapcsolat.
Ki állítja be és támogatja a QuickBooks Online integrációját?
A munka kiterjed a cikkekre, az árajánlatokra, a beszerzési rendelésekre és arra, hogyan jut el az elvégzett munka a számlázásig. Az integráció olyan adatokkal is kiegészíti a rendszert, amelyeket a QuickBooks nem tárol: munkaállomásokkal, műveletekkel, műszakokkal, átállásiidő-mátrixszal, szerszámokkal, kezelői létszámokkal és alternatív erőforrásokkal.
- 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, az árajánlatokat és a készleteket a QuickBooks rendszerében; ezt a gyakorlati tudást itt építjük be az integrációba.
- QuickBooks ProAdvisor tanácsadója vagy integrációs partnere is elkészítheti. A SkyPlanner biztosítja a REST API-t, a Swagger/OpenAPI dokumentációt és a webhookokat.
- Saját fejlesztői is építhetnek rá egy API-token használatával. Az induláshoz elegendő egy API-token, a SkyPlanner csapata pedig szükség esetén segít. A termékdokumentációt, beleértve a beszerzési rendeléseket, valamint a termékek és anyagok API-ját, a SkyPlanner dokumentációjában találja.
A SkyPlanner havonta 199 €-tól érhető el, 5 munkaállomással, havi számlázással. Az integrációra az Ön folyamatainak és igényeinek megfelelően, a választott csomaggal együtt előzetes árajánlatot adunk, így már az indulás előtt láthatja a teljes költséget. Tekintse meg az árakat és a funkciókat, illetve olvassa el a Van gyártásütemezés a QuickBooks rendszerében? című cikket arról, mire képes önmagában a QuickBooks. Az áttekintést a QuickBooks Online oldalán, a többi rendszert pedig az összes integráció között találja.
Gyártóvállalatok véleménye a SkyPlannerről
2 óramegtakarítás hetente
„A SkyPlannerrel az Excel-táblázatos 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 munkasorrend 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ónapra optimalizált terv.
100%a szállítási határidők betartása 2021 óta
„A SkyPlanner átláthatóvá teszi a kapacitásunkat és kiszámíthatóvá a tervezést.”
Dan Berglund, COO/CFO
Opes Corporation · Vegyipari és élelmiszeripari gyártás
A SkyPlanner használatának kezdete, 2021 óta minden szállítási határidőt betartottak, az arány a teljes időszakban 100%.
1 000-es nagyságrendautomatikusan ü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
Gyártási rendelések ezreit ütemezik automatikusan, miközben az egész szervezet valós időben láthatja a gyártás állapotát.
Gyakori kérdések
Van a QuickBooks Online rendszernek API-ja a gyártási adatokhoz?
A QuickBooks Online Accounting API-ja egy OAuth 2.0 hitelesítést használó REST API. Ügyfeleket, cikkeket, árajánlatokat, számlákat, beszerzési rendeléseket, munkaidő-bejegyzéseket és készletkorrekciókat kezel. A gyártási adatokat, például a munkaállomásokat és a műveleteket a SkyPlanner tárolja.
Vissza tud írni a SkyPlanner a QuickBooks Online rendszerébe?
Igen. A SkyPlanner minden árajánlatba beírja a tervezett szállítási dátumot, a rendelés teljesítésekor létrehoz egy, az árajánlathoz kapcsolt számlát, a rögzített munkaórákat munkaidő-bejegyzésként továbbítja, a késztermékeket és a felhasznált anyagokat pedig készletkorrekcióként rögzíti az Egyesült Államokban elérhető Plus és Advanced csomagban.
Valós időben küld értesítést a QuickBooks Online a változásokról?
Igen. A QuickBooks webhookjai az ügyfelekre, cikkekre, árajánlatokra, számlákra, beszerzési rendelésekre és munkaidő-bejegyzésekre terjednek ki. A SkyPlanner minden módosult rekordot beolvas, és éjszakánként a change data capture segítségével egyezteti az adatokat.
Honnan származnak a technológiai útvonalak és a gépek adatai, ha a QuickBooks nem tárol ilyeneket?
A SkyPlannerből. A munkaállomásokat, a termékenkénti műveleteket, a műszakokat és az átállási időket egyszer kell beállítania, kézzel vagy CSV-, illetve Excel-importtal. Minden művelet a megfelelő QuickBooks-cikkhez kapcsolódik, így az új árajánlatok automatikusan bekerülnek az ütemezésbe.
Kipróbálhatjuk a SkyPlannert az integráció elkészítése előtt?
Igen. A 30 napos ingyenes próba legfeljebb 20 munkaállomást támogat, a QuickBooks adatai CSV- vagy Excel-importtal tölthetők be, bankkártya pedig nem szükséges. Indítsa el a próbát, vagy keresse értékesítőinket az integráció felméréséhez.
