Integrationer / ERP / QuickBooks Online
Guide til QuickBooks Online integration med SkyPlanner APS til produktionsplanlægning
Denne guide til QuickBooks Online integration viser ProAdvisors, konsulenter og IT-teams, hvordan de forbinder QuickBooks Online med SkyPlanner APS. SkyPlanner integrerer med QuickBooks Online i begge retninger via Intuits Accounting API:
- Kunder, varer med lagerbeholdning, accepterede tilbud, åbne indkøbsordrer og medarbejdere overføres til SkyPlanner.
- Den planlagte slutdato skrives tilbage til afsendelsesdatoen på hvert tilbud.
- Afsluttede ordrer skrives tilbage som fakturaer knyttet til deres tilbud, registrerede timer som tidsaktiviteter og lagerændringer som lagerreguleringer.
- QuickBooks-webhooks melder ændringer ind, og SkyPlanner-webhooks sender ændringer i planen, så snart de sker.
QuickBooks Online er et regnskabsprogram og indeholder derfor hverken maskiner, ruter eller produktionsordrer. Arbejdsstationer, procestrin, skiftehold og omstillingstider ligger i SkyPlanner. SkyPlanner-teamet konfigurerer integrationen til din virksomhed i QuickBooks under opstarten og yder support efter idriftsættelsen. Denne guide er til partnere og udviklere, der vil deltage eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference).
QuickBooks Online Accounting API
QuickBooks Online er ét cloudprodukt med en multitenant-arkitektur, og alle virksomheder bruger samme Accounting API. Det er et REST API i version v3. Hvert kald retter sig mod én virksomhed via dens realm ID: https://quickbooks.api.intuit.com/v3/company/{realmId}/{entity}. Til test bruges en separat sandbox-vært. Forespørgsler og svar er i JSON-format, og parameteren minorversion vælger skemaversionen. (kilde)
De entiteter, en produktionsplanlægger har brug for:
- Stamdata:
Customer,Item(Inventory, NonInventory, Service),Employee,Vendor. - Behov:
Estimate(TxnStatus Accepted, linjer,ShipDate) og, for virksomheder der fakturerer først,InvoiceellerSalesReceipt. - Forsyning:
PurchaseOrder(POStatus Open, linjer med varer og mængder),Bill. - Tilbageskrivning:
Estimate,Invoice,TimeActivity,InventoryAdjustment.
Data læses via query-endpointet, for eksempel select * from Estimate where MetaData.LastUpdatedTime > '2026-10-01'. Opdateringer kan være delvise, så SkyPlanner kun sender de felter, der ændres. Accounting API har ingen entiteter for salgsordrer, ruter, arbejdscentre eller produktionsordrer.
Autentificering og grænser
Accounting API bruger OAuth 2.0 med authorization code-flowet og scopet com.intuit.quickbooks.accounting. En QuickBooks-administrator logger ind én gang og godkender adgangen. Appen har derefter et kortlivet adgangstoken, der sendes som Authorization: Bearer, og et refresh-token, der fornyes ved hver opdatering. (kilde)
Intuit begrænser antallet af kald pr. virksomhed, pr. minut og pr. sekund og returnerer HTTP 429, når en app overskrider grænserne. Intuits App Partner Program måler også visse API-kald pr. måned efter partnerniveau. Begge dele er beskrevet på Intuits side om grænser og begrænsning af kald. Webhooks, ændringsopsamling og delvise opdateringer holder en planlægningsintegration et godt stykke under grænserne.
Hos SkyPlanner bruger REST API et API-token i headeren Authorization-Token til autentificering (SkyPlanner Settings > API). API’et er dokumenteret i Swagger/OpenAPI. Integrationsvejledningen gennemgår de første kald.
Webhooks og ændringsopsamling
QuickBooks-webhooks giver appen besked, når data ændres i en tilsluttet virksomhed. “Webhooks automatically notify you whenever data changes in your end-user’s QuickBooks Online company files.” (Webhooks giver dig automatisk besked, når data ændres i din slutbrugers virksomhedsfiler i QuickBooks Online.) (kilde) Følgende entiteter er relevante for planlægningen:
Customer,Item,EmployeeEstimate,Invoice,SalesReceiptPurchaseOrder,BillTimeActivity
Handlingerne omfatter Create, Update, Delete, Merge og Void. En meddelelse indeholder entitetens navn, ID, handling og tidspunkt for seneste opdatering, men ikke hele posten. Modtageren læser posten bagefter.
Ændringsopsamling (GET /cdc?entities=...&changedSince=...) returnerer alle ændringer siden et tidsstempel inden for et begrænset tidsrum tilbage i tiden. SkyPlanner bruger det til en natlig afstemning, så en overset webhook aldrig efterlader en ordre med forældede data. TimeActivity er ikke omfattet af ændringsopsamling og afstemmes derfor med en forespørgsel. (kilde)
Datamapping
| Objekt i QuickBooks Online | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
Customer | Kunde (external_identifier, delivery_priority) | QuickBooks → SkyPlanner | Første indlæsning, derefter ved webhook |
Item (Inventory, NonInventory, Service) med QtyOnHand | Produkter og materialer, lagerbeholdning | QuickBooks → SkyPlanner | Første indlæsning, derefter ved webhook |
Estimate (Accepted), linjer, ShipDate | Ordre (external_order_number, delivery_date), opgaver pr. linje | QuickBooks → SkyPlanner | I realtid via webhook |
Invoice eller SalesReceipt (virksomheder, der fakturerer først) | Ordre og opgaver | QuickBooks → SkyPlanner | I realtid via webhook |
PurchaseOrder (Open), linjer | Indgående materialer (indkøbsordrer for produkter) | QuickBooks → SkyPlanner | I realtid via webhook |
Employee | Personale | QuickBooks → SkyPlanner | Første indlæsning, derefter ved webhook |
Estimate.ShipDate (delvis opdatering) | Planlagt slutdato | SkyPlanner → QuickBooks | Ved ændring af planen |
Invoice med LinkedTxn til Estimate | Afsluttet ordre | SkyPlanner → QuickBooks | Når ordren afsluttes |
TimeActivity (EmployeeRef, CustomerRef, ItemRef, timer) | Mobile Confirmations, tidsregistreringer | SkyPlanner → QuickBooks | Efterhånden som arbejdet registreres |
InventoryAdjustment | Tilgang af færdigvarer, materialeforbrug | SkyPlanner → QuickBooks | Når ordren afsluttes |
| Findes ikke i QuickBooks | Arbejdsstationer, procestrin, skiftehold, fravær, omstillingstidsmatrix, værktøjer, antal operatører, alternative arbejdsstationer | Vedligeholdes i SkyPlanner | Opsættes under opstarten |
Integrationsmønstre
1. Første indlæsning af stamdata. Hent kunder, varer, medarbejdere og åbne indkøbsordrer side for side via query-endpointet. Opret kunder i SkyPlanner med QuickBooks-ID’et som external_identifier og produkter og materialer med vare-ID’et som nøgle. Opret derefter det, som QuickBooks ikke indeholder: arbejdsstationer, procestrin pr. produkt, skiftehold, fravær og omstillingstider. Import via CSV eller Excel er den hurtigste vej til at oprette procestrin.
2. Ordresynkronisering. Abonner på webhooks for Estimate, Invoice, Item og PurchaseOrder. Når et tilbud får status Accepted, læser SkyPlanner det og opretter en ordre med tilbudsnummeret som external_order_number og afsendelsesdatoen som delivery_date. For hver linje oprettes opgaver ud fra produktets procestrin. Åbne indkøbsordrelinjer bliver til indgående materialer, så opgaverne venter på leveringen. Natlig ændringsopsamling fanger alle oversete hændelser.
3. Tilbageskrivning af plan og færdigmeldinger. Fire kald overfører resultaterne til QuickBooks:
- En delvis opdatering af
Estimateskriver tilShipDate, så den lovede dato i QuickBooks følger planen. - Når ordren afsluttes, opretter POST
/invoicefakturaen med tilbuddets linjer og enLinkedTxntil tilbuddet. Intuit tillader én fakturatilknytning pr. tilbud, så håndteringen af delleverancer aftales under afklaringen. - POST
/timeactivityregistrerer hver operatørs timer på medarbejderen, kunden og en servicevare. Fakturerbare timer kan derefter føjes til fakturaen i QuickBooks. - POST
/inventoryadjustmentøger beholdningen af færdigvarer og reducerer beholdningen af forbrugte materialer. Intuit tilbyder denne entitet i QuickBooks Online Plus og Advanced i USA. (kilde)
4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations, Production Timer eller Quick Log Mode. Fremdriften opdaterer straks planen, og Autopilot omplanlægger resten. Timerne overføres til QuickBooks som tidsaktiviteter. Hvis virksomheden beholder QuickBooks Time til løn, skal I under afklaringen vælge én kanal til registrering af opgavetimer.
5. Dataejerskab og regler for konflikter. Skriv dem ned før idriftsættelsen:
| Data | Dataejer |
|---|---|
| Kunder, varer, priser, tilbud, indkøbsordrer, fakturaer, regnskab | QuickBooks Online |
| Arbejdsstationer, procestrin, skiftehold, fravær, omstillingstidsmatrix, værktøjer, alternative ressourcer | SkyPlanner |
| Opgavernes rækkefølge, start- og sluttider samt arbejdsstation for hver opgave | SkyPlanner |
| Afsendelsesdato på tilbuddet | SkyPlanner, skrives til QuickBooks |
| Faktura for færdige ordrer, timer på opgaver og regulering af færdigvarelager | SkyPlanner opretter, QuickBooks ejer dataene efter bogføring |
Typiske trin i projektet
Implementeringen er normalt afsluttet inden for få uger efter opstarten. Inden da kan du bruge den gratis prøveperiode på 30 dage med dine egne data fra en QuickBooks-eksport af kunder, produkter og åbne tilbud.
Selve projektet omfatter:
- Forbindelse. En QuickBooks-administrator godkender SkyPlanner via Intuits OAuth 2.0-skærmbillede.
- Grundlag for produktionsbehov. Aftal, om accepterede tilbud, fakturaer eller salgskvitteringer skal sætte produktionen i gang.
- Mapping. Fastlæg mappingtabellen, varenøglerne, ydelsesvarerne til arbejdstid og reglerne for dataejerskab.
- Første indlæsning. Kunder, varer, medarbejdere og åbne indkøbsordrer.
- Produktionsmodel. Arbejdsstationer, procestrin for hvert produkt, skiftehold, omstillingstidsmatrix, værktøjer og antal operatører i SkyPlanner.
- Hændelsesbaseret synkronisering. Webhooks til tilbud, varer og indkøbsordrer samt natlig registrering af dataændringer.
- Tilbageskrivning. Først afsendelsesdato, derefter fakturaer, tidsregistreringer og lagerreguleringer.
- Parallel test og idriftsættelse. Sammenlign datoerne i SkyPlanner med din nuværende plan, lad din regnskabsansvarlige kontrollere de første fakturaer og reguleringer, og slå derefter tilbageskrivning til.
Det skal du tage højde for i en QuickBooks Online-integration
- Salgsordrer bliver i QuickBooks-skærmbillederne. Plus og Advanced har salgsordrer i appen, mens integrationen læser accepterede tilbud eller fakturaer hos virksomheder, der fakturerer først. Aftal én udløsende hændelse, så alle ordrer kommer ind på samme måde.
- Ingen ruter i QuickBooks. Vedligehold procestrinnene for hvert produkt i SkyPlanner med en nøgle til varen i QuickBooks.
- Kun én faktura kan knyttes til hvert tilbud. Delleverancer kræver en regel, for eksempel ét tilbud pr. levering.
- Lagerreguleringer afhænger af abonnement og region. Plus og Advanced i USA understøtter dem. I andre regioner skal du aftale med din regnskabsansvarlige, hvordan færdigvarer registreres i QuickBooks.
- Produktionsordrer i Intuit Enterprise Suite. Hvis du bruger dem, skal du beslutte, hvilket system der ejer produktionsregistreringer og reservationer af komponenter.
- Varepakker kan kun læses via API’et. Varer af typen Group kan ikke oprettes via API’et, så vedligehold varepakker i QuickBooks.
- Rotation af refresh token. Gem det nyeste refresh token efter hver fornyelse, ellers afbrydes forbindelsen.
QuickBooks Online-integrationen: Hvem konfigurerer og supporterer den?
Arbejdet omfatter dine varer, tilbud og indkøbsordrer samt overførslen af færdigt arbejde til fakturering. Det tilføjer det, QuickBooks ikke rummer: arbejdsstationer, procestrin, skiftehold, omstillingstidsmatrix, værktøjer, antal operatører og alternative ressourcer.
- SkyPlanner-teamet konfigurerer integrationen under opstarten og yder support efter idriftsættelsen. Hver virksomhed opsætter varer, tilbud og lager på sin egen måde i QuickBooks, og den viden bliver brugt her.
- Din QuickBooks ProAdvisor eller integrationspartner kan bygge den. SkyPlanner stiller REST API, Swagger/OpenAPI-dokumentation og webhooks til rådighed.
- Dine egne udviklere kan bygge videre på den med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper ved behov. Produktdokumentationen, herunder indkøbsordrer og API’et til produkter og materialer, findes i SkyPlanner-dokumentationen.
SkyPlanner koster fra 199 € pr. måned med 5 arbejdsstationer inkluderet og månedlig fakturering. Du får på forhånd et tilbud på integrationen ud fra dine processer og behov sammen med dit abonnement, så du kender den samlede pris, før du starter. Se priser og funktioner, og læs om, hvad QuickBooks kan på egen hånd, i Har QuickBooks produktionsplanlægning? Du finder overblikket på siden om QuickBooks Online og andre systemer under alle integrationer.
Produktionsvirksomheders anmeldelser af SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-regneark til optimering af produktionen i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 arbejdstimer hver uge, og en ny opgavekø når ud til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
100%leveringssikkerhed siden 2021
“SkyPlanner giver os overblik over kapaciteten og gør planlægningen forudsigelig.”
Dan Berglund, COO/CFO
Opes Corporation · Kemi- og fødevareproduktion
Leveringssikkerheden har været 100% i hele den periode, SkyPlanner har været i brug, siden 2021.
Flere 1.000arbejdsordrer planlægges automatisk
“Vi har styr på produktionen på en helt anden måde, og vores forståelse af kapaciteten er på et helt andet niveau.”
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle blandere, pumper og højteknologisk kontraktproduktion
Tusindvis af arbejdsordrer planlægges automatisk, og hele organisationen har overblik over produktionen i realtid.
Ofte stillede spørgsmål
Har QuickBooks Online et API til produktionsdata?
QuickBooks Online har Accounting API, et REST API med OAuth 2.0. Det dækker kunder, varer, tilbud, fakturaer, indkøbsordrer, tidsregistreringer og lagerreguleringer. Produktionsdata som arbejdsstationer og procestrin ligger i SkyPlanner.
Kan SkyPlanner skrive data tilbage til QuickBooks Online?
Ja. SkyPlanner skriver den planlagte afsendelsesdato til hvert tilbud, opretter en faktura knyttet til tilbuddet, når ordren er færdig, og overfører de registrerede timer som tidsregistreringer. I de amerikanske udgaver af Plus og Advanced registreres færdigvarer og forbrugte materialer desuden som lagerreguleringer.
Sender QuickBooks Online ændringer i realtid?
Ja. QuickBooks-webhooks dækker kunder, varer, tilbud, fakturaer, indkøbsordrer og tidsregistreringer. SkyPlanner læser hver ændret post og afstemmer hver nat ved hjælp af change data capture.
Hvor kommer ruter og maskiner fra, når QuickBooks ikke har dem?
Fra SkyPlanner. Du opsætter arbejdsstationer, procestrin for hvert produkt, skiftehold og omstillingstider én gang, enten manuelt eller via import fra CSV eller Excel. Hvert procestrin er knyttet til varen i QuickBooks, så nye tilbud automatisk indgår i produktionsplanlægningen.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med import fra QuickBooks via CSV eller Excel, og du behøver ikke et kreditkort. Start prøveperioden, eller tal med salg for at afklare integrationens omfang.
