Liidestused / ERP / QuickBooks Online
QuickBooks Online’i integreerimise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See QuickBooks Online’i integreerimise juhend näitab ProAdvisoritele, konsultantidele ja IT-meeskondadele, kuidas ühendada QuickBooks Online SkyPlanner APS-iga. SkyPlanner vahetab QuickBooks Online’iga andmeid mõlemas suunas Intuiti Accounting API kaudu:
- SkyPlannerisse tuuakse kliendid, artiklid koos laoseisuga, kinnitatud pakkumised, avatud ostutellimused ja töötajad.
- Planeeritud valmimisaeg kirjutatakse tagasi iga pakkumise lähetuskuupäevaks.
- Valminud tellimused saadetakse tagasi pakkumistega seotud arvetena, registreeritud töötunnid ajakirjetena ja laoseisu muutused laokorrigeerimistena.
- QuickBooksi veebihaagid teavitavad lähteandmete muutustest ning SkyPlanneri veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
QuickBooks Online on raamatupidamistarkvara, seega ei sisalda see masinaid, tehnoloogilisi marsruute ega tootmistellimusi. Töökeskusi, protsessietappe, vahetusi ja seadistusaegu hallatakse SkyPlanneris. SkyPlanneri meeskond seadistab integratsiooni juurutamise käigus teie QuickBooksi ettevõtte jaoks ning pakub tuge ka pärast kasutuselevõttu. See juhend on mõeldud partneritele ja arendajatele, kes soovivad projektis osaleda või ise SkyPlanneri dokumenteeritud REST API abil lahendusi luua (API dokumentatsioon).
QuickBooks Online Accounting API
QuickBooks Online on üks mitut klienti teenindav pilvetoode ning kõik ettevõtted kasutavad sama Accounting API-t. See on REST API versiooniga v3. Iga kutse on suunatud ühele ettevõttele selle realm ID kaudu: https://quickbooks.api.intuit.com/v3/company/{realmId}/{entity}. Testimiseks on eraldi liivakastiserver. Päringud ja vastused on JSON-vormingus ning skeemi versioon valitakse parameetriga minorversion. (Allikas)
Ajakava koostamiseks vajalikud olemid:
- Põhiandmed:
Customer,Item(Inventory, NonInventory, Service),Employee,Vendor. - Nõudlus:
Estimate(TxnStatus Accepted, read,ShipDate) ning ettevõtetes, kus arve esitatakse enne tootmist,InvoicevõiSalesReceipt. - Tarned:
PurchaseOrder(POStatus Open, artiklite ja kogustega read),Bill. - Tagasikirjutamine:
Estimate,Invoice,TimeActivity,InventoryAdjustment.
Andmete lugemiseks kasutatakse query-otspunkti, näiteks select * from Estimate where MetaData.LastUpdatedTime > '2026-10-01'. Uuendused võivad olla osalised, seega saadab SkyPlanner ainult muudetavad väljad. Accounting API-s puuduvad müügitellimuse, tehnoloogilise marsruudi, töökeskuse ja tootmistellimuse olemid.
Autentimine ja piirangud
Accounting API kasutab OAuth 2.0 autoriseerimiskoodi voogu ja pääsuulatust com.intuit.quickbooks.accounting. QuickBooksi administraator logib ühe korra sisse ja kinnitab juurdepääsu. Seejärel on rakendusel lühiajaline pääsutõend, mis saadetakse kujul Authorization: Bearer, ning värskendustõend, mis asendatakse iga värskendamise käigus uuega. (Allikas)
Intuit piirab kutsete arvu ettevõtte kohta nii minutis kui ka sekundis ning tagastab piirangu ületamisel HTTP 429. Intuiti App Partner Program arvestab ka teatud API-kutsete igakuist mahtu vastavalt partneri tasemele. Mõlemat käsitleb Intuiti kasutuspiirangute leht. Veebihaagid, muudatuste hõive ja osalised uuendused hoiavad ajakava koostamiseks vajalike kutsete arvu neist piiridest kindlalt allpool.
SkyPlanneri REST API kasutab autentimiseks API-tõendit päises Authorization-Token (SkyPlanner Settings > API). API on dokumenteeritud Swagger/OpenAPI vormingus. Integreerimise õpetus selgitab, kuidas teha esimesi kutseid.
Veebihaagid ja muudatuste hõive
QuickBooksi veebihaagid teavitavad rakendust ühendatud ettevõtte andmete muutumisest. “Webhooks automatically notify you whenever data changes in your end-user’s QuickBooks Online company files.” (Veebihaagid teavitavad teid automaatselt, kui lõppkasutaja QuickBooks Online’i ettevõttefailides andmed muutuvad.) (Allikas) Ajakava koostamisel olulised olemid:
Customer,Item,EmployeeEstimate,Invoice,SalesReceiptPurchaseOrder,BillTimeActivity
Toimingute hulka kuuluvad Create, Update, Delete, Merge ja Void. Teavitus sisaldab olemi nime, ID-d, toimingut ja viimase uuendamise aega, mitte kogu kirjet. Vastuvõtja loeb kirje seejärel eraldi.
Muudatuste hõive (GET /cdc?entities=...&changedSince=...) tagastab kõik etteantud ajatemplist hilisemad muudatused piiratud tagasivaatamisvahemikus. SkyPlanner kasutab seda igaöiseks andmete võrdlemiseks ja ühtlustamiseks, nii et saamata jäänud veebihaagiteavitus ei jäta tellimust kunagi aegunud seisu. Muudatuste hõive ei hõlma olemit TimeActivity, mistõttu kontrollitakse ja ühtlustatakse selle andmed päringuga. (Allikas)
Andmete vastendamine
| QuickBooks Online’i objekt | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Customer | Klient (external_identifier, delivery_priority) | QuickBooks → SkyPlanner | Esmane laadimine, seejärel veebihaagiteavituse saabumisel |
Item (Inventory, NonInventory, Service) koos väljaga QtyOnHand | Tooted ja materjalid, laoseis | QuickBooks → SkyPlanner | Esmane laadimine, seejärel veebihaagiteavituse saabumisel |
Estimate (Accepted), read, ShipDate | Tellimus (external_order_number, delivery_date), tööd iga rea kohta | QuickBooks → SkyPlanner | Reaalajas veebihaagi kaudu |
Invoice või SalesReceipt (ettevõtted, kus arve esitatakse enne tootmist) | Tellimus ja tööd | QuickBooks → SkyPlanner | Reaalajas veebihaagi kaudu |
PurchaseOrder (Open), read | Saabuv materjal (toodete ostutellimused) | QuickBooks → SkyPlanner | Reaalajas veebihaagi kaudu |
Employee | Personal | QuickBooks → SkyPlanner | Esmane laadimine, seejärel veebihaagiteavituse saabumisel |
Estimate.ShipDate (osaline uuendus) | Planeeritud valmimisaeg | SkyPlanner → QuickBooks | Ajakava muutumisel |
Invoice, mis on väljaga LinkedTxn seotud olemiga Estimate | Valminud tellimus | SkyPlanner → QuickBooks | Tellimuse valmimisel |
TimeActivity (EmployeeRef, CustomerRef, ItemRef, tunnid) | Mobile Confirmations, tööaja kirjed | SkyPlanner → QuickBooks | Töö registreerimisel |
InventoryAdjustment | Valmistoodangu lattu võtmine, materjalikulu | SkyPlanner → QuickBooks | Tellimuse valmimisel |
| QuickBooksis puudub | Töökeskused, protsessietapid, vahetused, puudumised, seadistusaegade maatriks, tööriistad, operaatorite arv, alternatiivsed töökeskused | Hallatakse SkyPlanneris | Seadistatakse juurutamise käigus |
Liidestuslahendused
1. Põhiandmete esmane laadimine. Lugege kliendid, artiklid, töötajad ja avatud ostutellimused query-otspunkti kaudu lehekülgede kaupa sisse. Looge SkyPlanneris kliendid, kasutades väljal external_identifier QuickBooksi ID-d, ning tooted ja materjalid, mille võtmeks on artikli ID. Seejärel lisage andmed, mida QuickBooks ei sisalda: töökeskused, iga toote protsessietapid, vahetused, puhkused ja seadistusajad. Protsessietapid saab kõige kiiremini sisse tuua CSV- või Exceli impordiga.
2. Tellimuste sünkroonimine. Tellige olemite Estimate, Invoice, Item ja PurchaseOrder veebihaagiteavitused. Kui pakkumine saab oleku Accepted, loeb SkyPlanner selle sisse ja loob tellimuse, kasutades pakkumise numbrit väljal external_order_number ning lähetuskuupäeva väljal delivery_date. Igast reast luuakse tööd toote protsessietappide järgi. Avatud ostutellimuste ridadest tekib saabuv materjal, nii et tööd ootavad tarnet. Igaöine muudatuste hõive leiab kõik vahele jäänud sündmused.
3. Ajakava ja valmimisandmete tagasikirjutamine. Tulemused kantakse QuickBooksi nelja kutsega:
- Olemi
Estimateosaline uuendus muudab väljaShipDateväärtust, nii et QuickBooksis lubatud kuupäev vastab plaanile. - Tellimuse valmimisel loob POST
/invoicepakkumise ridadega arve ja seob selleLinkedTxnkaudu pakkumisega. Intuit lubab iga pakkumise kohta ühe arveseose, seega lepitakse osatarnete käsitlus kokku ulatuse määramisel. - POST
/timeactivitysalvestab iga operaatori registreeritud töötunnid, sidudes need töötaja, kliendi ja teenuseartikliga. Seejärel saab arveldatavad tunnid QuickBooksis arvele lisada. - POST
/inventoryadjustmentsuurendab valmistoodangu laoseisu ja vähendab kasutatud materjalide laoseisu. Intuit pakub seda olemit USA-s QuickBooks Online Plus ja Advanced pakettides. (Allikas)
4. Tööde kinnitamine tootmises. Operaatorid registreerivad tööd funktsioonidega SkyPlanner Mobile Confirmations, Production Timer või Quick Log Mode. Töö edenemine uuendab ajakava kohe ning Autopilot planeerib ülejäänu ümber. Töötunnid saadetakse QuickBooksi ajakirjetena. Kui ettevõte kasutab palgaarvestuseks edasi QuickBooks Time’i, valige ulatuse määramisel üks kanal töödele kulunud tundide edastamiseks.
5. Andmete haldamise ja vastuolude lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Kliendid, artiklid, hinnad, pakkumised, ostutellimused, arved, raamatupidamine | QuickBooks Online |
| Töökeskused, protsessietapid, vahetused, puudumised, seadistusaegade maatriks, tööriistad, alternatiivsed ressursid | SkyPlanner |
| Tööde järjekord, algus- ja lõpuajad, iga töö töökeskus | SkyPlanner |
| Pakkumise lähetuskuupäev | SkyPlanner, salvestatakse QuickBooksi |
| Lõpetatud tellimuste arved, töötunnid, valmistoodangu laoseisu korrigeerimine | SkyPlanner loob, pärast kirjendamist haldab QuickBooks |
Projekti tavapärased etapid
Juurutamine saab tavaliselt valmis mõne nädala jooksul pärast kasutuselevõtu alustamist. Enne seda saate 30-päevasel tasuta prooviperioodil kasutada oma andmeid: QuickBooksist eksporditud kliente, tooteid ja avatud pakkumisi.
Projekt hõlmab järgmisi etappe:
- Ühendamine. QuickBooksi administraator annab SkyPlannerile loa Intuiti OAuth 2.0 vaates.
- Tootmise käivitav objekt. Leppige kokku, kas tootmise käivitavad kinnitatud pakkumised, arved või müügikviitungid.
- Vastendamine. Määrake kindlaks vastendustabel, artiklite võtmed, tööjõukulu teenuseartiklid ja andmete haldamise reeglid.
- Esmane andmete laadimine. Kliendid, artiklid, töötajad ja avatud ostutellimused.
- Tootmismudel. Töökeskused, toodete tööetapid, vahetused, seadistusaegade maatriks, tööriistad ja operaatorite arv SkyPlanneris.
- Sündmuspõhine sünkroonimine. Veebihaagid pakkumiste, artiklite ja ostutellimuste jaoks ning igaöine muudatuste hõive.
- Tagasikirjutamine. Esmalt lähetuskuupäev, seejärel arved, tööajakirjed ja laoseisu korrigeerimised.
- Paralleeltestimine ja töösse võtmine. Võrrelge SkyPlanneri kuupäevi oma praeguse plaaniga, laske raamatupidajal esimesed arved ja korrigeerimised üle kontrollida ning lülitage seejärel tagasikirjutamine sisse.
Millega QuickBooks Online’i liidestamisel arvestada
- Müügitellimused jäävad QuickBooksi kasutajaliidesesse. Pakettide Plus ja Advanced rakenduses on müügitellimused olemas. Liidestus loeb kinnitatud pakkumisi või arveid, kui ettevõte esitab arve enne tootmist. Leppige kokku üks käivitav sündmus, et kõik tellimused jõuaksid tootmisse ühtemoodi.
- QuickBooksis pole tehnoloogilisi marsruute. Hoidke toodete tööetappe SkyPlanneris ja siduge need QuickBooksi artikliga.
- Iga pakkumisega saab siduda ühe arve. Osatarnete jaoks on vaja reeglit, näiteks üks pakkumine iga tarne kohta.
- Laoseisu korrigeerimine sõltub paketist ja piirkonnast. USA paketid Plus ja Advanced toetavad seda. Mujal leppige raamatupidajaga kokku, kuidas valmistoodangu andmed QuickBooksi jõuavad.
- Intuit Enterprise Suite’i tootmistellimused. Kui kasutate neid, otsustage, milline süsteem haldab tootmist ja komponentide reserveeringuid.
- Komplekte saab API kaudu ainult lugeda. Group-tüüpi kaupu ei saa API kaudu luua, seega hallake komplekte QuickBooksis.
- Värskendustõendi vahetumine. Salvestage pärast iga värskendamist uusim värskendustõend, muidu ühendus katkeb.
Kes seadistab QuickBooks Online’i liidestuse ja pakub tuge?
Töö hõlmab teie kaupu, pakkumisi, ostutellimusi ja seda, kuidas lõpetatud tööd arveldamisse jõuavad. Lisatakse andmed, mida QuickBooksis pole: töökeskused, tööetapid, vahetused, seadistusaegade maatriks, tööriistad, operaatorite arv ja alternatiivsed ressursid.
- SkyPlanneri meeskond seadistab liidestuse kasutuselevõtu käigus ja pakub tuge pärast töösse võtmist. Iga tootmisettevõte seadistab QuickBooksis kaubad, pakkumised ja laovarud omamoodi. Liidestuse seadistamisel arvestatakse just nende eripäradega.
- Liidestuse saab luua teie QuickBooks ProAdvisor või liidestuspartner. SkyPlanner pakub REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Teie enda arendajad saavad liidestuse luua API tõendi abil. Alustamiseks piisab API tõendist ning SkyPlanneri meeskond aitab vajaduse korral. Toote dokumentatsiooni, sealhulgas ostutellimuste ning toodete ja materjalide API kirjeldused, leiate SkyPlanneri dokumentatsioonist.
SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub iga kuu. Liidestuse hinnapakkumine koostatakse ette teie tööprotsessi ja vajaduste põhjal koos paketi pakkumisega, nii et näete kogukulu enne alustamist. Vaadake hindu ja funktsioone ning lugege artiklist „Kas QuickBooks võimaldab koostada tootmise ajakava?”, mida QuickBooks iseseisvalt võimaldab. Ülevaate leiate QuickBooks Online’i lehelt, teised süsteemid on toodud kõigi liidestuste lehel.
Tootjate kogemused SkyPlanneriga
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest reaalajas tootmise optimeerimiseni.”
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ning uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise tõhusust
„Tootmise tõhusus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise tõhusus on kasvanud 90% ning kõiki töökeskusi hõlmava optimeeritud kolmekuulise plaani koostamine võtab alla 30 minuti.
100%tarnekindlus alates 2021. aastast
„SkyPlanner annab meile ülevaate tootmisvõimsusest ja muudab planeerimise prognoositavaks.”
Dan Berglund, COO/CFO
Opes Corporation · Keemia- ja toiduainetööstus
Tarnekindlus on olnud 100% kogu SkyPlanneri kasutamise aja, alates 2021. aastast.
1 000-dautomaatselt ajakavastatud töökäsud
„Tootmine on nüüd hoopis paremini kontrolli all ja meie arusaam tootmisvõimsusest on täiesti teisel tasemel.”
Hannu Ryynänen, tegevjuht
Mamec · Tööstuslikud segistid, pumbad ja kõrgtehnoloogiline lepinguline tootmine
Tuhanded töökäsud saavad ajakava automaatselt ning kogu organisatsioonil on tootmisest reaalajas ülevaade.
Korduma kippuvad küsimused
Kas QuickBooks Online’il on tootmisandmete jaoks API?
QuickBooks Online’il on Accounting API — REST API, mis kasutab OAuth 2.0 autentimist. See hõlmab kliente, kaupu, pakkumisi, arveid, ostutellimusi, tööajakirjeid ja laoseisu korrigeerimisi. Tootmisandmeid, näiteks töökeskusi ja tööetappe, hallatakse SkyPlanneris.
Kas SkyPlanner saab andmeid QuickBooks Online’i tagasi kirjutada?
Jah. SkyPlanner salvestab igale pakkumisele kavandatud lähetuskuupäeva, loob tellimuse valmimisel pakkumisega seotud arve ja edastab registreeritud tunnid tööajakirjetena. USA pakettides Plus ja Advanced kirjendab see ka valmistoodangu ja kasutatud materjalid laoseisu korrigeerimistena.
Kas QuickBooks Online edastab muudatusi reaalajas?
Jah. QuickBooksi veebihaagid hõlmavad kliente, kaupu, pakkumisi, arveid, ostutellimusi ja tööajakirjeid. SkyPlanner loeb iga muudetud kirje ning ühtlustab andmed igal ööl muudatuste hõive abil.
Kust tulevad tehnoloogilised marsruudid ja masinad, kui neid QuickBooksis pole?
SkyPlannerist. Töökeskused, toodete tööetapid, vahetused ja seadistusajad sisestate ühe korra käsitsi või impordite CSV- või Exceli failist. Iga tööetapp seotakse QuickBooksi kaubaga, nii et uued pakkumised saavad ajakava automaatselt.
Kas saame SkyPlannerit enne liidestuse loomist katsetada?
Jah. 30-päevasel tasuta prooviperioodil saate kasutada kuni 20 töökeskust ja importida QuickBooksi andmeid CSV- või Exceli failist. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata liidestuse ulatus.
