النظام الذي يستطيع تصدير الملفات ولا يقدم واجهة برمجية يكفيه تصدير مجدول إلى مجلد SFTP واحد. تستخدم الملفات أعمدة قوالب نارفن وتُسمّى بما تحتويه، ويقرأ نارفن المجلد كاملًا في كل مزامنة، مع تثبيت مفتاح الخادم وبمستخدم لا يستطيع إلا القراءة. ولا يتغير شيء على الخادم.
ماذا يوضع في المجلد؟
ملفات CSV أو Excel (.xlsx) بأعمدة قوالب الاستيراد نفسها، تُسمّى بما تحتويه. وتُقرأ ملفات النوع الواحد معًا، فيستطيع النظام كتابة ملف لكل شهر.
| يبدأ اسم الملف بـ | يحتوي |
|---|---|
| accounts | دليل الحسابات |
| journal_entries | أسطر القيود المرحّلة |
| customer_invoices وvendor_bills | البنود المفتوحة، مع الإشعارات الدائنة |
| customer_invoice_lines وvendor_bill_lines (CSV) | البنود مع ضريبتها |
| customer_payments وvendor_payments | الدفعات، مع ما بقي غير مخصص |
| customers وvendors | البيانات الرئيسية مع الأرقام الضريبية والشروط |
| exchange_rates | أسعار مؤرخة |
| companies.csv | رمز كل شركة واسمها وعملتها ودولتها |
يصل حجم الملف إلى 50 ميجابايت، وتقرأ المزامنة الواحدة حتى 250 ميجابايت إجمالًا. وتُقرأ الملفات تدفقيًا وتُقطع عند حدها، أيًا كان الحجم الذي يذكره الخادم.
لماذا يقرأ نارفن المجلد كاملًا في كل مرة؟
لأن المجلد هو الصورة الكاملة للدفاتر. فالقيد الذي لم يعد في أي ملف يُعلَّم بأنه حُذف، وهكذا يصل إلى نارفن القيد المعكوس أو المحذوف في المصدر. وهناك ضمانتان: المجلد الذي لا يحوي أي ملف قيود لا يحذف شيئًا، والمزامنة التي ستحذف أكثر من نصف ما هو محمّل لا تحذف شيئًا وتنبّهك بدلًا من ذلك. لذلك أبقِ ملف كل فترة في المجلد، ولا تستبدل ملف الشهر الماضي بملف هذا الشهر.
وتجري المزامنات حسب الجدول الذي تحدده، من كل 15 دقيقة إلى أسبوعيًا بتوقيتك، فاضبطه ليتبع موعد التصدير. والأسطر التي لا تجتاز فحوص الاستيراد تُستبعد وتُذكر في التنبيهات.
كيف يُحمى الاتصال بالخادم؟
- يُثبَّت مفتاح الخادم ببصمته SHA256. أدخلها عند الربط، وإن لم تفعل يُسجَّل المفتاح الذي يقدمه الخادم أول مرة، ويُرفض أي مفتاح آخر بعد ذلك حتى يعيد أحدهم الربط بالبصمة الجديدة.
- يسجّل نارفن الدخول بكلمة مرور أو بمفتاح خاص (PEM أو OpenSSH، مع عبارة مرور اختيارية)، يُشفَّر عند حفظه ولا يُعرض مرة أخرى.
- امنح نارفن مستخدمًا لا يستطيع إلا قراءة المجلد. فنارفن يعرض الملفات ويقرؤها فقط، ولا يكتب أو ينقل أو يحذف أي ملف.
- يجب أن يكون للخادم عنوان عام، وتُرفض العناوين الخاصة والمحلية.
هل يمكن أن يضم المجلد الواحد عدة شركات؟
نعم. أضف companies.csv ورمز الشركة في كل سطر، فترتبط كل شركة بشركتها في نارفن بالعملة نفسها. والمجلد لشركة واحدة يستطيع حذف الاثنين وذكر رمز الشركة وعملتها ودولتها في الاتصال. والأسطر بعملة أخرى تحمل سعر صرفها.
كيف تُعدّ مجلد SFTP؟
- جدول التصديراجعل نظامك يكتب ملفات القوالب في مجلد واحد، بأسماء مثل accounts… وjournal_entries… وغيرها.
- أنشئ مستخدم SFTP للقراءة فقطاحصره في ذلك المجلد، ودوّن بصمة مفتاح الخادم SHA256.
- أضف الاتصالأدخل الخادم والمنفذ والمجلد والبصمة والمستخدم بكلمة مروره أو مفتاحه، وبيانات الشركة إن لم يكن هناك companies.csv.
- شغّل مزامنة كاملة وقارنقارن ميزان المراجعة بميزان النظام المصدر، واقرأ التنبيهات قبل ضبط الجدول.
أسئلة شائعة
هل يمكن أن نضع ملف هذا الشهر فقط في كل مرة؟
لا. يُقرأ المجلد كصورة كاملة، فتبدو قيود الفترات السابقة محذوفة. أبقِ ملف كل فترة في المجلد، والمزامنة التي ستحذف أكثر من نصف ما هو محمّل لا تحذف شيئًا وتنبّه.
هل يحذف نارفن الملفات بعد قراءتها؟
لا. يعرضها ويقرؤها فقط، وتنظيف الملفات القديمة متروك لك.
هل يستطيع بنكنا استخدام المجلد نفسه للكشوف؟
لكشوف البنوك مجلدها الخاص، ويُقرأ في التسوية البنكية. اطلع على [كشوف البنوك](/integrations/bank-statements).