Integrări / ERP / QuickBooks Online
Ghid de integrare QuickBooks Online pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare QuickBooks Online le arată specialiștilor ProAdvisors, consultanților și echipelor IT cum să conecteze QuickBooks Online la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu QuickBooks Online prin Accounting API de la Intuit:
- În SkyPlanner se importă clienții, articolele cu cantitățile disponibile în stoc, ofertele acceptate, comenzile de achiziție deschise și angajații.
- Data planificată de finalizare este transmisă înapoi în câmpul pentru data expedierii al fiecărei oferte.
- Comenzile finalizate sunt transmise înapoi ca facturi asociate ofertelor lor, orele înregistrate ca activități pontate, iar modificările de stoc ca ajustări de stoc.
- Webhook-urile QuickBooks notifică SkyPlanner despre modificări, iar webhook-urile SkyPlanner transmit modificările programului de producție pe măsură ce apar.
QuickBooks Online este un program de contabilitate, deci nu stochează utilaje, fluxuri tehnologice sau comenzi de producție. Centrele de lucru, etapele procesului, schimburile și timpii de pregătire sunt gestionate în SkyPlanner. Echipa SkyPlanner configurează integrarea cu firma dumneavoastră din QuickBooks în etapa de implementare și asigură asistență după punerea în funcțiune. Acest ghid se adresează partenerilor și dezvoltatorilor care vor să participe sau să dezvolte singuri soluții folosind REST API documentat al SkyPlanner (documentația API).
Accounting API din QuickBooks Online
QuickBooks Online este un singur produs cloud cu arhitectură multi-tenant, iar toate firmele folosesc același Accounting API. Acesta este un REST API, versiunea v3. Fiecare apel vizează o firmă identificată prin realm ID: https://quickbooks.api.intuit.com/v3/company/{realmId}/{entity}. Pentru teste se folosește o gazdă sandbox separată. Cererile și răspunsurile sunt în format JSON, iar parametrul minorversion selectează versiunea schemei. (sursă)
Entitățile necesare pentru programarea producției:
- Nomenclatoare:
Customer,Item(Inventory, NonInventory, Service),Employee,Vendor. - Cerere:
Estimate(TxnStatus Accepted, poziții,ShipDate), iar pentru unitățile de producție care facturează în avans,InvoicesauSalesReceipt. - Aprovizionare:
PurchaseOrder(POStatus Open, poziții cu articole și cantități),Bill. - Scriere înapoi în QuickBooks:
Estimate,Invoice,TimeActivity,InventoryAdjustment.
Citirea datelor se face prin endpoint-ul de interogare, de exemplu select * from Estimate where MetaData.LastUpdatedTime > '2026-10-01'. Sunt permise actualizări parțiale, astfel că SkyPlanner trimite doar câmpurile pe care le modifică. Accounting API nu conține entități pentru comenzi de vânzare, fluxuri tehnologice, centre de lucru sau comenzi de producție.
Autentificare și limite
Accounting API folosește OAuth 2.0 cu fluxul authorization code și domeniul de acces com.intuit.quickbooks.accounting. Un administrator QuickBooks se autentifică o singură dată și aprobă accesul. Aplicația deține apoi un token de acces cu durată scurtă de valabilitate, trimis ca Authorization: Bearer, și un token de reîmprospătare care este reînnoit la fiecare reîmprospătare. (sursă)
Intuit limitează apelurile pe firmă, pe minut și pe secundă și returnează HTTP 429 când o aplicație depășește limitele. Prin App Partner Program, Intuit contorizează lunar și anumite apeluri API, în funcție de nivelul partenerului. Ambele mecanisme sunt descrise pe pagina Intuit despre limite și restricționarea apelurilor. Webhook-urile, captarea modificărilor de date și actualizările parțiale mențin integrarea pentru programarea producției cu mult sub aceste limite.
În SkyPlanner, autentificarea la REST API se face cu un token API în antetul Authorization-Token (SkyPlanner Settings > API), iar documentația este disponibilă în Swagger/OpenAPI. Tutorialul de integrare explică pas cu pas primele apeluri.
Webhook-uri și captarea modificărilor de date
Webhook-urile QuickBooks notifică aplicația când se modifică datele unei firme conectate. “Webhooks automatically notify you whenever data changes in your end-user’s QuickBooks Online company files.” (Webhook-urile vă notifică automat ori de câte ori se modifică datele firmei utilizatorului final în QuickBooks Online.) (sursă) Entitățile relevante pentru programarea producției:
Customer,Item,EmployeeEstimate,Invoice,SalesReceiptPurchaseOrder,BillTimeActivity
Operațiunile includ Create, Update, Delete, Merge și Void. O notificare conține numele entității, ID-ul, operațiunea și momentul ultimei actualizări, nu întreaga înregistrare. Destinatarul citește ulterior înregistrarea.
Captarea modificărilor de date (GET /cdc?entities=...&changedSince=...) returnează toate modificările de după un marcaj temporal, în limita unui interval recent anterior interogării. SkyPlanner folosește acest mecanism pentru reconcilierea din fiecare noapte, astfel încât niciun webhook ratat să nu lase o comandă neactualizată. TimeActivity nu este inclus în captarea modificărilor de date, așa că reconcilierea se face printr-o interogare. (sursă)
Maparea datelor
| Obiect QuickBooks Online | Obiect SkyPlanner | Sens | Frecvență |
|---|---|---|---|
Customer | Client (external_identifier, delivery_priority) | QuickBooks → SkyPlanner | Încărcare inițială, apoi la notificarea prin webhook |
Item (Inventory, NonInventory, Service) cu QtyOnHand | Produse și materiale, stocuri | QuickBooks → SkyPlanner | Încărcare inițială, apoi la notificarea prin webhook |
Estimate (Accepted), poziții, ShipDate | Comandă (external_order_number, delivery_date), operații pentru fiecare poziție | QuickBooks → SkyPlanner | În timp real, prin webhook |
Invoice sau SalesReceipt (unități de producție care facturează în avans) | Comandă și operații | QuickBooks → SkyPlanner | În timp real, prin webhook |
PurchaseOrder (Open), poziții | Materiale în curs de aprovizionare (comenzi de achiziție pentru produse) | QuickBooks → SkyPlanner | În timp real, prin webhook |
Employee | Personal | QuickBooks → SkyPlanner | Încărcare inițială, apoi la notificarea prin webhook |
Estimate.ShipDate (actualizare parțială) | Data planificată de finalizare | SkyPlanner → QuickBooks | La modificarea programului de producție |
Invoice cu LinkedTxn către Estimate | Comandă finalizată | SkyPlanner → QuickBooks | La finalizarea comenzii |
TimeActivity (EmployeeRef, CustomerRef, ItemRef, ore) | Mobile Confirmations, pontaje | SkyPlanner → QuickBooks | Pe măsură ce se înregistrează lucrul efectuat |
InventoryAdjustment | Intrări de produse finite, consumuri de materiale | SkyPlanner → QuickBooks | La finalizarea comenzii |
| Nu există în QuickBooks | Centre de lucru, etape ale procesului, schimburi, absențe, matricea timpilor de pregătire, scule, numărul de operatori, centre de lucru alternative | Gestionate în SkyPlanner | Configurate în etapa de implementare |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Parcurgeți paginat clienții, articolele, angajații și comenzile de achiziție deschise, folosind endpoint-ul de interogare. Creați clienții în SkyPlanner cu ID-ul QuickBooks în external_identifier, iar produsele și materialele cu ID-ul articolului drept cheie. Apoi configurați ceea ce QuickBooks nu stochează: centre de lucru, etape ale procesului pentru fiecare produs, schimburi, concedii și timpi de pregătire. Importul din CSV sau Excel este cea mai rapidă cale pentru etapele procesului.
2. Sincronizarea comenzilor. Abonați-vă la webhook-urile Estimate, Invoice, Item și PurchaseOrder. Când o ofertă trece în starea Accepted, SkyPlanner o citește și creează o comandă cu numărul ofertei în external_order_number și data expedierii în delivery_date. Din fiecare poziție se generează operații corespunzătoare etapelor procesului pentru produsul respectiv. Pozițiile comenzilor de achiziție deschise devin materiale în curs de aprovizionare, astfel încât operațiile așteaptă livrarea. Captarea modificărilor de date din fiecare noapte recuperează orice eveniment ratat.
3. Transmiterea înapoi a programului și a datelor de finalizare. Patru apeluri scriu rezultatele în QuickBooks:
- O actualizare parțială a entității
Estimateactualizează valoarea câmpuluiShipDate, astfel încât data promisă din QuickBooks să corespundă planului. - La finalizarea comenzii, POST
/invoicecreează factura cu pozițiile ofertei și unLinkedTxncătre ofertă. Intuit permite asocierea unei singure facturi cu fiecare ofertă, așa că modul de gestionare a livrărilor parțiale se stabilește la definirea domeniului proiectului. - POST
/timeactivityînregistrează orele pontate de fiecare operator, asociindu-le cu angajatul, clientul și un articol de tip serviciu. Orele facturabile pot fi apoi adăugate pe factura din QuickBooks. - POST
/inventoryadjustmentmărește stocul de produse finite și scade stocul materialelor consumate. Intuit oferă această entitate în QuickBooks Online Plus și Advanced în SUA. (sursă)
4. Confirmări din secția de producție. Operatorii înregistrează lucrul efectuat cu SkyPlanner Mobile Confirmations, Production Timer sau Quick Log Mode. Progresul actualizează imediat programul de producție, iar Autopilot reprogramează restul operațiilor. Orele sunt transmise în QuickBooks ca activități pontate. Dacă unitatea de producție păstrează QuickBooks Time pentru salarizare, alegeți un singur canal pentru orele aferente operațiilor la definirea domeniului proiectului.
5. Reguli privind responsabilitatea asupra datelor și rezolvarea conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Clienți, articole, prețuri, oferte, comenzi de achiziție, facturi, contabilitate | QuickBooks Online |
| Centre de lucru, etape ale procesului, schimburi, absențe, matricea timpilor de pregătire, scule, resurse alternative | SkyPlanner |
| Succesiunea operațiilor, orele de început și de sfârșit, centrul de lucru pentru fiecare operație | SkyPlanner |
| Data expedierii din ofertă | SkyPlanner, cu scriere în QuickBooks |
| Factură pentru comenzile finalizate, ore lucrate la operații, ajustarea stocului de produse finite | SkyPlanner creează datele, iar QuickBooks le gestionează după înregistrare |
Etapele obișnuite ale proiectului
Implementarea se încheie, de regulă, în câteva săptămâni de la începerea configurării inițiale. Înainte de aceasta, puteți folosi perioada de probă gratuită de 30 de zile cu propriile date, exportând din QuickBooks clienții, produsele și ofertele deschise.
Proiectul propriu-zis cuprinde:
- Conectare. Un administrator QuickBooks autorizează SkyPlanner în ecranul OAuth 2.0 al Intuit.
- Documentul care declanșează producția. Stabiliți dacă producția pornește de la ofertele acceptate, facturi sau bonuri de vânzare.
- Mapare. Definitivați tabelul de corespondență, cheile articolelor, articolele de tip serviciu pentru manoperă și regulile care stabilesc ce sistem gestionează fiecare categorie de date.
- Import inițial. Clienți, articole, angajați și comenzi de achiziție deschise.
- Modelul de producție. Centre de lucru, etape de proces pentru fiecare produs, schimburi, matricea timpilor de pregătire, scule și numărul de operatori în SkyPlanner.
- Sincronizare pe bază de evenimente. Webhook-uri pentru oferte, articole și comenzi de achiziție, plus capturarea modificărilor datelor în fiecare noapte.
- Scrierea datelor înapoi. Mai întâi data expedierii, apoi facturile, înregistrările de timp lucrat și ajustările de stoc.
- Testare în paralel și punere în funcțiune. Comparați datele din SkyPlanner cu planul actual, solicitați contabilului să verifice primele facturi și ajustări, apoi activați scrierea datelor înapoi.
Ce trebuie să aveți în vedere la integrarea cu QuickBooks Online
- Comenzile de vânzare rămân în interfața QuickBooks. Plus și Advanced oferă comenzi de vânzare în aplicație, iar integrarea citește ofertele acceptate sau facturile, în cazul atelierelor care facturează înainte de producție. Stabiliți un singur declanșator, astfel încât toate comenzile să fie preluate în același mod.
- QuickBooks nu conține fluxuri tehnologice. Păstrați etapele de proces pentru fiecare produs în SkyPlanner, asociate prin cheie cu articolul din QuickBooks.
- O singură factură asociată fiecărei oferte. Pentru livrările parțiale trebuie stabilită o regulă, de exemplu o ofertă pentru fiecare livrare.
- Ajustările de stoc depind de abonament și de regiune. Plus și Advanced din SUA le permit. În alte regiuni, stabiliți împreună cu contabilul cum vor fi înregistrate produsele finite în QuickBooks.
- Ordinele de producție din Intuit Enterprise Suite. Dacă le folosiți, stabiliți ce sistem gestionează asamblările și rezervările de componente.
- Pachetele de articole pot fi doar citite prin API. Articolele de tip Group nu pot fi create prin API, așa că păstrați pachetele în QuickBooks.
- Rotația tokenului de reîmprospătare. Salvați cel mai recent token de reîmprospătare după fiecare reînnoire; altfel, conexiunea se întrerupe.
Integrarea cu QuickBooks Online: cine o configurează și asigură asistența
Lucrările de integrare acoperă articolele, ofertele, comenzile de achiziție și modul în care producția finalizată ajunge la facturare. Se adaugă datele care nu sunt păstrate în QuickBooks: centre de lucru, etape de proces, schimburi, matricea timpilor de pregătire, scule, numărul de operatori și resurse alternative.
- Echipa SkyPlanner configurează integrarea în etapa inițială și asigură asistența după punerea în funcțiune. Fiecare atelier configurează diferit articolele, ofertele și stocurile în QuickBooks, iar această experiență este pusă în practică la integrare.
- Consultantul dumneavoastră QuickBooks ProAdvisor sau partenerul de integrare poate realiza integrarea. SkyPlanner pune la dispoziție REST API, documentația Swagger/OpenAPI și webhook-uri.
- Propriii dezvoltatori pot construi pe această bază folosind un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă asistență la nevoie. Documentația produsului, inclusiv informațiile despre comenzile de achiziție și API-ul pentru produse și materiale, se găsește în documentația SkyPlanner.
SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Primiți de la început o ofertă pentru integrare, adaptată procesului și nevoilor dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe. Consultați prețurile, funcționalitățile și ce poate face QuickBooks singur în articolul Oferă QuickBooks programarea producției? Prezentarea generală se află pe pagina QuickBooks Online, iar celelalte sisteme sunt prezentate în lista tuturor integrărilor.
Părerile producătorilor despre SkyPlanner
2 heconomisite săptămânal
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru în fiecare săptămână, iar o nouă listă de operații ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar realizarea unui plan optimizat pe trei luni pentru toate centrele de lucru durează mai puțin de 30 de minute.
100%respectarea termenelor de livrare din 2021
„SkyPlanner ne oferă vizibilitate asupra capacității și face planificarea predictibilă.”
Dan Berglund, COO/CFO
Opes Corporation · Producție chimică și alimentară
Termenele de livrare au fost respectate în proporție de 100% pe întreaga perioadă de utilizare a SkyPlanner, din 2021.
Mii (1,000s)de ordine de producție programate automat
„Avem un alt control asupra producției, iar înțelegerea capacității a ajuns la un nivel complet diferit.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție la comandă de înaltă tehnologie
Mii de ordine de producție sunt programate automat, iar întreaga organizație are o imagine în timp real asupra producției.
Întrebări frecvente
QuickBooks Online are un API pentru datele de producție?
QuickBooks Online oferă Accounting API, un REST API cu OAuth 2.0. Acesta acoperă clienții, articolele, ofertele, facturile, comenzile de achiziție, înregistrările de timp lucrat și ajustările de stoc. Datele de producție, precum centrele de lucru și etapele de proces, sunt păstrate în SkyPlanner.
Poate SkyPlanner să trimită date înapoi către QuickBooks Online?
Da. SkyPlanner scrie data planificată a expedierii în fiecare ofertă, creează o factură asociată ofertei la finalizarea comenzii, transmite orele pontate ca înregistrări de timp lucrat și înregistrează produsele finite și materialele consumate ca ajustări de stoc în Plus și Advanced din SUA.
QuickBooks Online transmite modificările în timp real?
Da. Webhook-urile QuickBooks acoperă clienții, articolele, ofertele, facturile, comenzile de achiziție și înregistrările de timp lucrat. SkyPlanner citește fiecare înregistrare modificată și reconciliază datele în fiecare noapte folosind change data capture.
De unde provin fluxurile tehnologice și utilajele dacă QuickBooks nu le conține?
Din SkyPlanner. Configurați o singură dată centrele de lucru, etapele de proces pentru fiecare produs, schimburile și timpii de pregătire, manual sau printr-un import CSV ori Excel. Fiecare etapă de proces este asociată cu articolul din QuickBooks, astfel încât ofertele noi sunt programate automat.
Putem testa SkyPlanner înainte de a realiza integrarea?
Da. Perioada de probă gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, cu import CSV sau Excel din QuickBooks, fără card de credit. Începeți proba gratuită sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
