تغذية بيانات REST عنوان آمن واحد يقدم فيه نظامك دفاتره كصفحات JSON، بأعمدة قوالب الاستيراد في نارفن. وهي تناسب نظام ERP داخليًا أو منصة وسيطة أو مسار تكامل. ويقرؤها نارفن عبر HTTPS حسب الجدول الذي تحدده، برمز أو بترويسة مفتاح API أو باسم مستخدم وكلمة مرور، ولا يكتب فيها أبدًا.
ماذا يجب أن تقدم التغذية؟
مجموعة مسارات تحت عنوان أساسي واحد. اثنان منها مطلوبان، والباقي يُقرأ إن وُجد، والمسار الذي يجيب بالرمز 404 يُعدّ غير موجود ببساطة.
| المسار | مطلوب | الأسطر |
|---|---|---|
| /accounts | نعم | دليل الحسابات |
| /journal-entries | نعم | أسطر القيود المرحّلة |
| /customer-invoices و/vendor-bills | لا | البنود المفتوحة، مع الإشعارات الدائنة |
| /customer-invoice-lines و/vendor-bill-lines | لا | البنود مع ضريبتها |
| /customer-payments و/vendor-payments | لا | الدفعات، مع ما بقي غير مخصص |
| /customers و/vendors | لا | البيانات الرئيسية مع الأرقام الضريبية والشروط |
| /exchange-rates | لا | أسعار مؤرخة |
| /companies | لا | رمز كل شركة واسمها وعملتها ودولتها |
يجيب كل مسار بمصفوفة JSON من الأسطر، أو بكائن يضع الأسطر تحت data وعنوان الصفحة التالية تحت next. ويجب أن تبقى الصفحات التالية تحت عنوان التغذية نفسه، فالرابط إلى مكان آخر سيستلم بيانات اعتماد التغذية، لذلك يرفضه نارفن. وتستخدم الأسطر أعمدة القوالب، بمفاتيحها مثل account_code أو بأسمائها العربية أو الإنجليزية.
كيف يسجّل نارفن الدخول إلى التغذية؟
برمز Bearer، أو بمفتاح API في ترويسة تسمّيها (X-API-Key ما لم تختر غيرها)، أو باسم مستخدم وكلمة مرور. وأيًا كان اختيارك يُشفَّر عند حفظه ولا يُعرض مرة أخرى. ولا تُقبل إلا عناوين HTTPS العامة.
كيف تعمل المزامنات الجزئية؟
في المزامنة الكاملة يقرأ نارفن كل المسارات دون تصفية ويعدّ الإجابة الصورة الكاملة: فالقيود التي لم تعد التغذية تقدمها تُعلَّم بأنها حُذفت، إلا إذا كان ذلك سيحذف أكثر من نصف ما هو محمّل، فلا يُحذف شيء وتنبّه المزامنة. وفي المزامنات التالية يضيف نارفن ?since=YYYY-MM-DD إلى المسارات المؤرخة، أي القيود والفواتير والدفعات والبنود، لتعيد التغذية ما تغيّر فقط. والتغذية التي تتجاهل since تعمل أيضًا، لكنها ترسل أكثر.
ويمكن أن يعيد المسار حتى 500,000 سطر في 2,000 صفحة كحد أقصى في المزامنة الواحدة. والأسطر التي لا تجتاز فحوص الاستيراد تُستبعد وتُذكر في التنبيهات. وتعمل الجداول من كل 15 دقيقة إلى أسبوعيًا، بتوقيتك.
كيف تُعامل الشركات والعملات؟
التغذية لعدة شركات تقدم /companies وتضع رمز الشركة في كل سطر، فترتبط كل شركة بشركتها في نارفن بالعملة نفسها. والتغذية لشركة واحدة تستطيع حذف الاثنين وذكر رمز الشركة وعملتها ودولتها في الاتصال.
كيف تربط تغذية بيانات؟
- انشر المسارين المطلوبينقدّم /accounts و/journal-entries بأعمدة القوالب عبر HTTPS، خلف رمز أو مفتاح.
- أضف الاتصالأدخل العنوان الأساسي، ونوع تسجيل الدخول وسرّه، وبيانات الشركة إن لم يكن هناك /companies.
- شغّل مزامنة كاملة وقارنقارن ميزان المراجعة بميزان نظامك، واقرأ التنبيهات.
- أضف المسارات الاختيارية وsinceأضف الفواتير والدفعات والبيانات الرئيسية، واحترم ?since في المسارات المؤرخة لتبقى المزامنات خفيفة.
أسئلة شائعة
هل يستضيف نارفن التغذية؟
لا. يقدمها نظامك أو منصتك الوسيطة، ويقرؤها نارفن. ولا يُدفع شيء إلى نارفن.
هل يمكن أن تكون التغذية على شبكتنا الداخلية؟
تحتاج إلى عنوان HTTPS عام يصل إليه نارفن. وتُرفض العناوين الخاصة وعناوين HTTP غير المشفّرة.
هل علينا دعم ?since؟
لا. من دونه تقرأ كل مزامنة كل شيء، وهذا أبسط لكنه أثقل.