QuickBooks Online integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS

QuickBooks Online ir vienots mākoņpakalpojums ar vairāku nomnieku arhitektūru, un visi uzņēmumi izmanto vienu un to pašu Accounting API. Tas ir REST API ar versiju v3. Katrs izsaukums ir adresēts vienam uzņēmumam pēc tā realm ID: https://quickbooks.api.intuit.com/v3/company/{realmId}/{entity}. Testēšanai ir atsevišķs smilškastes vides resursdators. Pieprasījumi un atbildes ir JSON formātā, un shēmas versiju izvēlas ar parametru minorversion. (avots)

Ražošanas grafiku sastādīšanai nepieciešamie objekti:

• Pamatdati: Customer, Item (Inventory, NonInventory, Service), Employee, Vendor.
• Pieprasījums: Estimate (TxnStatus Accepted, rindas, ShipDate), bet uzņēmumiem, kas vispirms izraksta rēķinu, — Invoice vai SalesReceipt.
• Apgāde: PurchaseOrder (POStatus Open, rindas ar precēm un daudzumiem), Bill.
• Ierakstīšana atpakaļ: Estimate, Invoice, TimeActivity, InventoryAdjustment.

Datu nolasīšanai izmanto vaicājumu galapunktu, piemēram, select * from Estimate where MetaData.LastUpdatedTime > '2026-10-01'. Atjauninājumi var būt daļēji, tāpēc SkyPlanner nosūta tikai tos laukus, kurus maina. Accounting API nav pārdošanas pasūtījuma, tehnoloģiskā procesa, darba centra vai ražošanas pasūtījuma objekta.

QuickBooks tīmekļa aizķeres paziņo lietotnei, kad mainās pievienotā uzņēmuma dati. “Webhooks automatically notify you whenever data changes in your end-user’s QuickBooks Online company files.” (Tīmekļa aizķeres automātiski paziņo, kad mainās dati galalietotāja QuickBooks Online uzņēmuma failos.) (avots) Grafiku sastādīšanai svarīgie objekti:

• Customer, Item, Employee
• Estimate, Invoice, SalesReceipt
• PurchaseOrder, Bill
• TimeActivity

Darbību veidi ietver Create, Update, Delete, Merge un Void. Paziņojumā ir objekta nosaukums, ID, darbība un pēdējās atjaunināšanas laiks, nevis pilns ieraksts. Saņēmējs ierakstu nolasa pēc paziņojuma saņemšanas.

Datu izmaiņu uztveršana (GET /cdc?entities=...&changedSince=...) atgriež visas izmaiņas kopš norādītā laika zīmoga, taču tikai par ierobežotu periodu nesenā pagātnē. SkyPlanner to izmanto datu salīdzināšanai katru nakti, tāpēc nepamanīts tīmekļa aizķeres paziņojums nekad neatstāj pasūtījumu ar novecojušiem datiem. Datu izmaiņu uztveršana neaptver TimeActivity, tāpēc šos datus salīdzina ar vaicājuma palīdzību. (avots)

1. Sākotnējā pamatdatu ielāde. Izmantojot vaicājumu galapunktu, pa lapām nolasiet klientus, preces, darbiniekus un atvērtos iepirkuma pasūtījumus. Izveidojiet SkyPlanner klientus, norādot QuickBooks ID laukā external_identifier, kā arī produktus un materiālus, par atslēgu izmantojot preces ID. Pēc tam izveidojiet to, kā QuickBooks nav: darba centrus, katra produkta procesa soļus, maiņas, atvaļinājumus un iekārtu sagatavošanas laikus. Procesa soļus visātrāk var ielādēt no CSV vai Excel faila.

2. Pasūtījumu sinhronizācija. Abonējiet Estimate, Invoice, Item un PurchaseOrder tīmekļa aizķeru paziņojumus. Kad piedāvājuma statuss kļūst Accepted, SkyPlanner to nolasa un izveido pasūtījumu, norādot piedāvājuma numuru laukā external_order_number un nosūtīšanas datumu laukā delivery_date. Katra rinda tiek pārvērsta ražošanas uzdevumos atbilstoši produkta procesa soļiem. Atvērto iepirkuma pasūtījumu rindas kļūst par ienākošajiem materiāliem, tāpēc ražošanas uzdevumi gaida piegādi. Datu izmaiņu uztveršana katru nakti atrod visus nepamanītos notikumus.

3. Grafika un izpildes datu ierakstīšana atpakaļ. Četri izsaukumi ievada rezultātus QuickBooks:

• Daļējs Estimate atjauninājums ieraksta ShipDate vērtību, tāpēc QuickBooks norādītais solītais datums atbilst plānam.
• Kad pasūtījums ir pabeigts, POST /invoice izveido rēķinu ar piedāvājuma rindām un LinkedTxn saiti uz piedāvājumu. Intuit katram piedāvājumam atļauj saiti uz vienu rēķinu, tāpēc par daļējām piegādēm jāvienojas tvēruma noteikšanas laikā.
• POST /timeactivity reģistrē katra operatora uzskaitītās stundas, piesaistot tās darbiniekam, klientam un pakalpojuma pozīcijai. Pēc tam apmaksājamās stundas var pievienot rēķinam QuickBooks.
• POST /inventoryadjustment palielina gatavās produkcijas krājumus un samazina patērēto materiālu krājumus. Intuit šo objektu piedāvā ASV QuickBooks Online Plus un Advanced versijās. (avots)

4. Izpildes apstiprinājumi ražotnē. Operatori reģistrē paveikto darbu, izmantojot SkyPlanner Mobile Confirmations, Production Timer vai Quick Log Mode. Darba izpildes dati uzreiz atjaunina grafiku, un Autopilot pārplāno atlikušos darbus. Stundas nonāk QuickBooks kā darba laika ieraksti. Ja uzņēmums algu aprēķinam turpina izmantot QuickBooks Time, tvēruma noteikšanas laikā izvēlieties vienu kanālu ražošanas uzdevumu stundu uzskaitei.

5. Atbildība par datiem un konfliktu risināšanas noteikumi. Fiksējiet tos rakstiski pirms palaišanas:

• Pārdošanas pasūtījumi paliek QuickBooks saskarnē. Plus un Advanced versijās pārdošanas pasūtījumi ir pieejami lietotnē, bet integrācija nolasa apstiprinātus piedāvājumus vai rēķinus uzņēmumos, kuros rēķinu izraksta pirms ražošanas. Vienojieties par vienu sākšanas nosacījumu, lai visi pasūtījumi nonāktu sistēmā vienādi.
• QuickBooks nav tehnoloģisko procesu. Katra produkta procesa soļus uzturiet SkyPlanner un sasaistiet tos ar attiecīgo QuickBooks preci.
• Katram piedāvājumam var piesaistīt vienu rēķinu. Dalītām piegādēm jānosaka kārtība, piemēram, katrai piegādei veidot atsevišķu piedāvājumu.
• Krājumu korekcijas ir atkarīgas no plāna un reģiona. ASV tās atbalsta Plus un Advanced. Citos reģionos vienojieties ar grāmatvedi, kā gatavā produkcija tiks uzskaitīta QuickBooks.
• Intuit Enterprise Suite ražošanas pasūtījumi. Ja tos izmantojat, izlemiet, kura sistēma pārvaldīs izgatavošanu un komponentu rezervācijas.
• Komplekti API ir pieejami tikai lasīšanai. Ar API nevar izveidot Group tipa preces, tāpēc komplektus uzturiet QuickBooks.
• Atjaunošanas pilnvaras maiņa. Pēc katras atjaunošanas saglabājiet jaunāko atjaunošanas pilnvaru, pretējā gadījumā savienojums pārtrūks.