التكاملات / ERP / QuickBooks Online
دليل تكامل QuickBooks Online مع SkyPlanner APS لجدولة الإنتاج
يوضح هذا الدليل لمتخصصي ProAdvisors والاستشاريين وفرق تقنية المعلومات كيفية ربط QuickBooks Online بـ SkyPlanner APS. يتكامل SkyPlanner مع QuickBooks Online في الاتجاهين عبر Accounting API من Intuit:
- تُستورد بيانات العملاء والأصناف مع الكميات المتوفرة في المخزون وعروض الأسعار المقبولة وأوامر الشراء المفتوحة والموظفين.
- يُعاد إرسال موعد الانتهاء المخطط ليُسجَّل في تاريخ الشحن لكل عرض سعر.
- تُعاد الطلبات المكتملة في صورة فواتير مرتبطة بعروض أسعارها، والساعات المسجلة في صورة سجلات وقت العمل، وتغييرات المخزون في صورة تسويات مخزون.
- تُبلغ إشعارات الويب في QuickBooks نظام SkyPlanner بالتغييرات، وترسل إشعارات الويب في SkyPlanner تغييرات الجدول فور حدوثها.
QuickBooks Online برنامج محاسبة، لذا لا يحتفظ ببيانات الآلات أو مسارات الإنتاج أو أوامر الإنتاج. تُدار محطات العمل وخطوات العمليات والورديات وأوقات الإعداد في SkyPlanner. يضبط فريق SkyPlanner التكامل مع شركتك في QuickBooks أثناء التهيئة، ويقدم الدعم بعد بدء التشغيل الفعلي. هذا الدليل موجه للشركاء والمطورين الراغبين في المشاركة أو بناء حلول بأنفسهم باستخدام REST API الموثقة من SkyPlanner (مرجع API).
واجهة Accounting API في QuickBooks Online
QuickBooks Online منتج سحابي موحد متعدد المستأجرين، وتستخدم جميع الشركات واجهة Accounting API نفسها. وهي REST API بالإصدار v3. يستهدف كل استدعاء شركة واحدة باستخدام معرّف realm الخاص بها: https://quickbooks.api.intuit.com/v3/company/{realmId}/{entity}، مع مضيف منفصل لبيئة الاختبار المعزولة. تستخدم الطلبات والاستجابات تنسيق JSON، وتحدد المعلمة minorversion إصدار مخطط البيانات. (المصدر)
الكيانات التي يحتاجها مخطط الإنتاج:
- البيانات الرئيسية:
Customer،Item(Inventory، NonInventory، Service)،Employee،Vendor. - الطلب:
Estimate(بقيمة Accepted في TxnStatus، والبنود، وShipDate)، وللمنشآت التي تصدر الفواتير أولاً،InvoiceأوSalesReceipt. - التوريد:
PurchaseOrder(بقيمة Open في POStatus، وبنود تتضمن الأصناف والكميات)،Bill. - إرسال البيانات إلى QuickBooks:
Estimate،Invoice،TimeActivity،InventoryAdjustment.
تستخدم عمليات القراءة نقطة نهاية الاستعلام، مثل select * from Estimate where MetaData.LastUpdatedTime > '2026-10-01'. ويمكن إجراء تحديثات جزئية، لذا لا يرسل SkyPlanner إلا الحقول التي يغيرها. لا تتضمن Accounting API كيانات لأوامر البيع أو مسارات الإنتاج أو مراكز العمل أو أوامر الإنتاج.
المصادقة والحدود
تستخدم Accounting API بروتوكول OAuth 2.0 بتدفق رمز التفويض ونطاق com.intuit.quickbooks.accounting. يسجل مسؤول QuickBooks الدخول مرة واحدة ويوافق على منح الوصول. يحتفظ التطبيق بعد ذلك برمز وصول قصير الصلاحية يُرسَل بصيغة Authorization: Bearer، ورمز تحديث يُستبدل عند كل تحديث. (المصدر)
تفرض Intuit حدوداً للاستدعاءات لكل شركة، في الدقيقة وفي الثانية، وتُرجع HTTP 429 عندما يتجاوزها التطبيق. ويقيس App Partner Program من Intuit أيضاً عدد بعض استدعاءات API شهرياً حسب فئة الشريك. توضح Intuit كلا النوعين في صفحة الحدود وتقييد معدلات الاستدعاء. تُبقي إشعارات الويب والتقاط تغييرات البيانات والتحديثات الجزئية تكامل الجدولة ضمن هذه الحدود بهامش واسع.
أما في SkyPlanner، فتستخدم REST API رمز API للمصادقة ضمن الترويسة Authorization-Token (SkyPlanner Settings > API)، وهي موثقة باستخدام Swagger/OpenAPI. يشرح دليل التكامل التعليمي كيفية إجراء الاستدعاءات الأولى.
إشعارات الويب والتقاط تغييرات البيانات
تُشعر إشعارات الويب في QuickBooks التطبيق عند تغيّر البيانات في شركة متصلة. “Webhooks automatically notify you whenever data changes in your end-user’s QuickBooks Online company files.” (تُخطرك إشعارات الويب تلقائياً كلما تغيرت البيانات في ملفات شركة المستخدم النهائي في QuickBooks Online.) (المصدر) الكيانات المهمة للجدولة:
Customer,Item,EmployeeEstimate,Invoice,SalesReceiptPurchaseOrder,BillTimeActivity
تشمل العمليات Create وUpdate وDelete وMerge وVoid. يتضمن الإشعار اسم الكيان ومعرّفه والعملية ووقت آخر تحديث، وليس السجل كاملاً. ويقرأ المستقبِل السجل بعد ذلك.
تُرجع آلية التقاط تغييرات البيانات (GET /cdc?entities=...&changedSince=...) كل ما تغير منذ طابع زمني محدد، ضمن نطاق زمني يغطي الماضي القريب. يستخدمها SkyPlanner لمطابقة البيانات كل ليلة، حتى لا يؤدي فوات أي إشعار ويب إلى بقاء طلب ببيانات قديمة. لا تشمل هذه الآلية TimeActivity، لذا تُطابق بياناته باستخدام استعلام. (المصدر)
ربط البيانات
| الكائن في QuickBooks Online | كائن SkyPlanner | الاتجاه | وتيرة المزامنة |
|---|---|---|---|
Customer | Customer (external_identifier، delivery_priority) | QuickBooks → SkyPlanner | تحميل أولي، ثم عند ورود إشعار ويب |
Item (Inventory، NonInventory، Service) مع QtyOnHand | المنتجات والمواد والمخزون | QuickBooks → SkyPlanner | تحميل أولي، ثم عند ورود إشعار ويب |
Estimate (بحالة Accepted)، والبنود، وShipDate | Order (external_order_number، delivery_date)، ومهام لكل بند | QuickBooks → SkyPlanner | فورياً عبر إشعار ويب |
Invoice أو SalesReceipt (للمنشآت التي تصدر الفواتير أولاً) | Order والمهام | QuickBooks → SkyPlanner | فورياً عبر إشعار ويب |
PurchaseOrder (بحالة Open)، والبنود | المواد الواردة (أوامر شراء المنتجات) | QuickBooks → SkyPlanner | فورياً عبر إشعار ويب |
Employee | الموظفون | QuickBooks → SkyPlanner | تحميل أولي، ثم عند ورود إشعار ويب |
Estimate.ShipDate (تحديث جزئي) | موعد الانتهاء المخطط | SkyPlanner → QuickBooks | عند تغيّر الجدول |
Invoice مع LinkedTxn للربط بـ Estimate | الطلب المكتمل | SkyPlanner → QuickBooks | عند اكتمال الطلب |
TimeActivity (EmployeeRef، CustomerRef، ItemRef، الساعات) | Mobile Confirmations، وسجلات الوقت | SkyPlanner → QuickBooks | عند تسجيل العمل |
InventoryAdjustment | المنتجات النهائية الواردة والمواد المستهلكة | SkyPlanner → QuickBooks | عند اكتمال الطلب |
| غير موجودة في QuickBooks | محطات العمل، وخطوات العمليات، والورديات، وحالات الغياب، ومصفوفة أوقات الإعداد، والأدوات، وأعداد المشغلين، ومحطات العمل البديلة | تُدار في SkyPlanner | تُضبط أثناء التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. استرجع بيانات العملاء والأصناف والموظفين وأوامر الشراء المفتوحة صفحة تلو الأخرى باستخدام نقطة نهاية الاستعلام. أنشئ العملاء في SkyPlanner مع وضع معرّف QuickBooks في external_identifier، وأنشئ المنتجات والمواد باستخدام معرّف الصنف كمفتاح. ثم أضف ما لا يحتفظ به QuickBooks: محطات العمل، وخطوات العمليات لكل منتج، والورديات، والإجازات، وأوقات الإعداد. والاستيراد من CSV أو Excel هو أسرع طريقة لإدخال خطوات العمليات.
2. مزامنة الطلبات. اشترك في إشعارات الويب الخاصة بـ Estimate وInvoice وItem وPurchaseOrder. عندما تتحول حالة عرض السعر إلى Accepted، يقرأه SkyPlanner وينشئ طلباً، ويضع رقم عرض السعر في external_order_number وتاريخ الشحن في delivery_date. يتحول كل بند إلى مهام تتبع خطوات عمليات المنتج. وتتحول بنود أوامر الشراء المفتوحة إلى مواد واردة، فتنتظر المهام وصولها. وتلتقط آلية التقاط تغييرات البيانات كل ليلة أي حدث فات رصده.
3. إرسال بيانات الجدولة والإنجاز إلى QuickBooks. تنقل أربعة استدعاءات النتائج إلى QuickBooks:
- يكتب تحديث جزئي للكيان
EstimateقيمةShipDate، ليواكب الموعد المتعهد به في QuickBooks الخطة. - عند اكتمال الطلب، ينشئ POST
/invoiceالفاتورة ببنود عرض السعر، معLinkedTxnللربط بعرض السعر. تسمح Intuit بربط فاتورة واحدة لكل عرض سعر، لذا يُتفق على كيفية التعامل مع التسليمات الجزئية أثناء تحديد النطاق. - يسجل POST
/timeactivityالساعات التي سجلها كل مشغّل، مع ربطها بالموظف والعميل وصنف خدمي. ويمكن بعد ذلك إضافة الساعات القابلة للفوترة إلى الفاتورة في QuickBooks. - يزيد POST
/inventoryadjustmentمخزون المنتجات النهائية ويخفض مخزون المواد المستهلكة. تتيح Intuit هذا الكيان في QuickBooks Online Plus وAdvanced في الولايات المتحدة. (المصدر)
4. تأكيدات العمل من أرضية المصنع. يسجل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer أو Quick Log Mode. يُحدَّث الجدول فوراً مع تقدم العمل، ويعيد Autopilot تخطيط ما تبقى. وتُنقل الساعات إلى QuickBooks في صورة سجلات وقت العمل. إذا كانت المنشأة تواصل استخدام QuickBooks Time لكشوف الرواتب، فاختر قناة واحدة لساعات المهام أثناء تحديد النطاق.
5. قواعد ملكية البيانات وحل التعارضات. دوّنها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| العملاء، والأصناف، والأسعار، وعروض الأسعار، وأوامر الشراء، والفواتير، والمحاسبة | QuickBooks Online |
| محطات العمل، وخطوات العمليات، والورديات، وحالات الغياب، ومصفوفة أوقات الإعداد، والأدوات، والموارد البديلة | SkyPlanner |
| تسلسل المهام، وأوقات البدء والانتهاء، ومحطة العمل لكل مهمة | SkyPlanner |
| تاريخ الشحن في عرض السعر | SkyPlanner، ويُكتب في QuickBooks |
| فاتورة للطلبات المكتملة، وساعات العمل، وتسوية مخزون المنتجات التامة | ينشئها SkyPlanner، وتصبح ملكية البيانات لـ QuickBooks بعد الترحيل |
خطوات المشروع المعتادة
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، يمكنك استخدام بياناتك الفعلية في التجربة المجانية لمدة 30 يومًا، بتصدير العملاء والمنتجات وعروض الأسعار المفتوحة من QuickBooks.
يشمل المشروع نفسه الخطوات التالية:
- الربط. يمنح مسؤول QuickBooks الموافقة على ربط SkyPlanner عبر شاشة OAuth 2.0 لدى Intuit.
- السجل الذي يطلق الإنتاج. اتفقوا على ما إذا كان بدء الإنتاج يعتمد على عروض الأسعار المقبولة أم الفواتير أم إيصالات البيع.
- مطابقة البيانات. حدّدوا جدول المطابقة ومفاتيح الأصناف وأصناف الخدمات الخاصة بالعمالة وقواعد ملكية البيانات.
- التحميل الأولي. تحميل بيانات العملاء والأصناف والموظفين وأوامر الشراء المفتوحة.
- نموذج الإنتاج. إعداد محطات العمل وخطوات التصنيع لكل منتج والورديات ومصفوفة أوقات التهيئة والأدوات وأعداد المشغّلين في SkyPlanner.
- مزامنة الأحداث. استخدام Webhooks لعروض الأسعار والأصناف وأوامر الشراء، إلى جانب التقاط تغييرات البيانات كل ليلة.
- إرسال البيانات إلى QuickBooks. إرسال تاريخ الشحن أولًا، ثم الفواتير وسجلات وقت العمل وتسويات المخزون.
- الاختبار الموازي وبدء التشغيل الفعلي. قارنوا تواريخ SkyPlanner بخطتكم الحالية، واطلبوا من المحاسب مراجعة الفواتير والتسويات الأولى، ثم فعّلوا إرسال البيانات إلى QuickBooks.
ما يجب مراعاته عند التخطيط للتكامل مع QuickBooks Online
- تبقى أوامر البيع ضمن شاشات QuickBooks. تتوفر أوامر البيع داخل التطبيق في خطتَي Plus وAdvanced، بينما يقرأ التكامل عروض الأسعار المقبولة، أو الفواتير لدى المصانع التي تُصدر الفاتورة أولًا. اتفقوا على محفّز واحد لضمان إدخال جميع الطلبات بالطريقة نفسها.
- لا توجد مسارات إنتاج في QuickBooks. احتفظوا بخطوات التصنيع لكل منتج في SkyPlanner، واربطوها بمفتاح الصنف في QuickBooks.
- يمكن ربط فاتورة واحدة بكل عرض سعر. تتطلب عمليات التسليم المجزأة قاعدة محددة، مثل تخصيص عرض سعر واحد لكل عملية تسليم.
- تسويات المخزون حسب الخطة والمنطقة. تدعمها خطتا Plus وAdvanced في الولايات المتحدة. وفي المناطق الأخرى، اتفقوا مع المحاسب على كيفية تسجيل المنتجات التامة في QuickBooks.
- أوامر التصنيع في Intuit Enterprise Suite. إذا كنتم تستخدمونها، فحدّدوا النظام المسؤول عن عمليات التصنيع وحجز المكوّنات.
- الحزم متاحة للقراءة فقط عبر API. لا يمكن إنشاء أصناف من نوع Group عبر API، لذا احتفظوا بالحزم في QuickBooks.
- تدوير رمز التحديث. احفظوا أحدث رمز تحديث بعد كل عملية تحديث، وإلا انقطع الاتصال.
التكامل مع QuickBooks Online: من يتولى الإعداد والدعم؟
يشمل العمل أصنافكم وعروض الأسعار وأوامر الشراء وكيفية تحويل العمل المكتمل إلى فواتير. ويضيف البيانات التي لا يحتفظ بها QuickBooks: محطات العمل وخطوات التصنيع والورديات ومصفوفة أوقات التهيئة والأدوات وأعداد المشغّلين والموارد البديلة.
- يتولى فريق SkyPlanner إعداد التكامل أثناء التهيئة ويدعمه بعد بدء التشغيل الفعلي. يختلف إعداد الأصناف وعروض الأسعار والمخزون في QuickBooks من مصنع إلى آخر، وهنا يأتي دور هذه الخبرة.
- يمكن لمستشار QuickBooks ProAdvisor أو شريك التكامل لديكم بناء التكامل. يوفّر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وWebhooks.
- يمكن لمطوّريكم تطوير التكامل باستخدام رمز API. يكفي رمز API للبدء، ويساعدكم فريق SkyPlanner عند الحاجة. تتوفر وثائق المنتج، بما فيها أوامر الشراء وواجهة API الخاصة بالمنتجات والمواد، في وثائق SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. يُقدَّم عرض سعر التكامل مسبقًا وفقًا لعملياتكم واحتياجاتكم، إلى جانب سعر خطتكم، لتعرفوا التكلفة الكاملة قبل البدء. اطّلعوا على الأسعار والميزات، وتعرّفوا على ما يقدّمه QuickBooks بمفرده في هل يوفّر QuickBooks جدولة الإنتاج؟ تجدون نظرة عامة في صفحة QuickBooks Online، والأنظمة الأخرى في جميع عمليات التكامل.
آراء المصنّعين في SkyPlanner
2 سمن وقت العمل تُوفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج وقت عمل قدره 2 ساعة أسبوعيًا، وتصل قائمة مهام جديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
100%الالتزام بمواعيد التسليم منذ 2021
“يمنحنا SkyPlanner رؤية واضحة للطاقة الإنتاجية ويجعل نتائج التخطيط قابلة للتوقع.”
Dan Berglund، مدير العمليات والمدير المالي (COO/CFO)
Opes Corporation · الصناعات الكيميائية والغذائية
بلغ الالتزام بمواعيد التسليم 100% طوال فترة استخدام SkyPlanner، منذ 2021.
1,000sمن أوامر العمل تُجدول تلقائيًا
“أصبحنا نتحكم في الإنتاج بطريقة مختلفة، وبلغ فهمنا للطاقة الإنتاجية مستوى مختلفًا تمامًا.”
Hannu Ryynänen، الرئيس التنفيذي
Mamec · خلاطات ومضخات صناعية وتصنيع تعاقدي عالي التقنية
تُجدول آلاف أوامر العمل تلقائيًا، مع إتاحة رؤية لحظية للإنتاج لجميع أقسام المؤسسة.
الأسئلة الشائعة
هل يوفّر QuickBooks Online واجهة API لبيانات الإنتاج؟
يوفّر QuickBooks Online واجهة Accounting API، وهي REST API تستخدم OAuth 2.0. وتشمل العملاء والأصناف وعروض الأسعار والفواتير وأوامر الشراء وسجلات وقت العمل وتسويات المخزون. أما بيانات الإنتاج، مثل محطات العمل وخطوات التصنيع، فتُحفظ في SkyPlanner.
هل يستطيع SkyPlanner ترحيل البيانات إلى QuickBooks Online؟
نعم. يكتب SkyPlanner تاريخ الشحن المخطط في كل عرض سعر، وينشئ فاتورة مرتبطة بعرض السعر عند اكتمال الطلب، ويرحّل الساعات المسجلة كسجلات وقت عمل، ويسجّل المنتجات التامة والمواد المستخدمة كتسويات مخزون في خطتَي Plus وAdvanced في الولايات المتحدة.
هل يرسل QuickBooks Online التغييرات في الوقت الفعلي؟
نعم. تشمل Webhooks في QuickBooks العملاء والأصناف وعروض الأسعار والفواتير وأوامر الشراء وسجلات وقت العمل. يقرأ SkyPlanner كل سجل تغيّر، ويُجري مطابقة كل ليلة باستخدام التقاط تغييرات البيانات.
من أين تأتي مسارات الإنتاج والآلات إذا لم تكن موجودة في QuickBooks؟
من SkyPlanner. تُعدّون محطات العمل وخطوات التصنيع لكل منتج والورديات وأوقات التهيئة مرة واحدة، يدويًا أو باستيراد ملف CSV أو Excel. ترتبط كل خطوة تصنيع بالصنف في QuickBooks، لذا تُجدول عروض الأسعار الجديدة تلقائيًا.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد بيانات QuickBooks عبر ملف CSV أو Excel، دون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
