← الأساسيات / حزم تطوير البرمجيات (SDK)
استيراد كشوفات الحسابات البنكية (camt.053)
قم بتنزيل كشف حساب ISO 20022 camt.053 من بنكك، وأنشئ نموذج استيراد، ودع Nordlet يُنشئ الشركاء، ويطابق الفواتير، ويقيد الرسوم.
يُغطي هذا الدليل عملية استيراد ملفات كشوفات الحسابات البنكية بتنسيق ISO 20022 camt.053 من خلال نموذج الاستيراد: ما الذي يجب تنزيله، وكيفية إعداد النموذج، وما الذي يُنشئه الاستيراد. تفاصيل واجهة البرمجة التطبيقية (API) موجودة في قسم استيراد البنوك والمدفوعات. للاتصال المباشر بالبنك بدلاً من الملفات، راجع قسم الربط بالبنوك.
1. تنزيل كشف الحساب من بنكك
في خدمتك المصرفية عبر الإنترنت، افتح تصدير كشوفات الحسابات واختر تنسيق ISO 20022 camt.053 (بتنسيق XML). تُدرج البنوك الليتوانية هذا الخيار باسم "ISO 20022 XML" أو "camt.053"؛ بينما توفره معظم البنوك الأوروبية ضمن الخدمات المصرفية للشركات. اختر نطاق التاريخ وقُم بتنزيل الملف. قد يحتوي الملف الواحد على عدة كشوفات حساب (على سبيل المثال، كشف حساب لكل حساب عملة)؛ حيث يتم تخطي كشوفات الحساب التي لا يتطابق رقم الآيبان (IBAN) الخاص بها مع الحساب البنكي المُختار.
يتم استيراد القيود المرحلة فقط (Ntry/Sts = BOOK). بينما يتم تجاهل القيود المعلقة.
2. إنشاء الحساب البنكي
يُستورد كل ملف إلى حساب بنكي محدد. أنشئ حساباً ضمن قسم البنك (Bank) باستخدام رقم الآيبان (IBAN) الخاص بالحساب والعملة. بمجرد تعيين رقم الآيبان، يتحقق نظام الاستيراد من أن كشف الحساب ينتمي إلى ذلك الحساب ويرفض أي ملف يحتوي على رقم آيبان مختلف.
3. إنشاء نموذج الاستيراد
ضمن قسم البنك ← نماذج الاستيراد (Bank → Import templates)، انقر على نموذج استيراد جديد (New import template)، واختر النوع ISO 20022 camt.053، ثم امنحه اسماً.
الحقول. كل عنصر في كشف الحساب يقرأه المُستورد يُمثّل صفاً. يشير مربع مطلوب في الملف (Required in file) إلى أن العنصر يجب أن يكون موجوداً في الملف المُحمَّل؛ فإذا كان الملف يفتقر إلى عنصر مطلوب، يتم رفضه وتُعرض أسماء العناصر المفقودة. العناصر الأساسية التي يتضمنها أي كشف حساب (Stmt/Id، وStmt/Acct/Id/IBAN، والأرصدة، وNtry/Amt، وNtry/CdtDbtInd، وNtry/Sts، وNtry/BookgDt) يتم تحديدها افتراضياً. أما العناصر الاختيارية - مثل اسم البنك، رمز المعاملة، أسماء وأرقام آيبان (IBAN) المدين والدائن، نص التحويل، والمراجع - فلا يتم تحديدها لأن ليس كل بنك يملؤها؛ لذا حدد تلك التي يوفرها بنكك.
حساب دفتر الأستاذ. يمكن تعيين الصفوف التي تحرك الأموال إلى حساب في دفتر الأستاذ (Ledger account)، سواء كان حساباً موجوداً مسبقاً أو حساباً جديداً يُنشأ من نفس الصف. يتم ترحيل كل حركة تنتج من صف مُعيّن وقت الاستيراد: فالأموال الواردة تُقيد في جانب المدين لحساب البنك في دفتر الأستاذ وتُدائن في الحساب المُعيّن، والأموال الصادرة تقوم بالعكس، ويتم تمييز المعاملة البنكية على أنها مطابقة لذلك القيد اليومي. وإلى جانب صف المبلغ العادي Ntry/Amt، توجد صفوف قواعد تلتقط القيود بناءً على رمز المعاملة البنكية أو الاتجاه:
| الصف | يلتقط | الحساب النموذجي |
|---|---|---|
| الرسوم البنكية (BkTxCd CHRG) | القيود التي تكون عائلة رمز معاملتها CHRG |
مصروفات الرسوم البنكية (6800 في الدليل المحاسبي القياسي) |
| الفوائد (BkTxCd INTR) | القيود التي تكون عائلتها INTR |
إيرادات أو مصروفات الفوائد |
| الضرائب (BkTxCd TAXE) | القيود التي تكون عائلتها TAXE |
مدفوعات الضرائب |
| أموال أخرى صادرة | أي قيد مدين آخر | اترك الخيار "غير مُرحَّل" (Not posted) لكي يتم مطابقة المدفوعات مع فواتير الشراء |
| أموال أخرى واردة | أي قيد دائن آخر | اترك الخيار "غير مُرحَّل" (Not posted) لكي يتم مطابقة المقبوضات مع فواتير المبيعات |
Ntry/Amt |
كل قيد لم تلتقطه أي قاعدة | عادةً ما يكون "غير مُرحَّل" (Not posted) |
يتم ترحيل القيد إلى حساب أول صف يتطابق معه: عائلة رمز المعاملة الخاصة به، ثم اتجاهه، ثم صف المبلغ العادي. لا يتم التحقق من صفوف القواعد مقابل الملف. يأتي رمز المعاملة من Ntry/BkTxCd/Domn/Fmly/Cd؛ والبنك الذي لا يُرسل هذا الرمز يترك صفوف الرموز دون مطابقات.
إنشاء العملاء أو الموردين المفقودين. حدد خيار إنشاء العملاء المفقودين (Create missing customers) على صف اسم المدين (…/RltdPties/Dbtr/Nm) لإنشاء عميل لكل دافع غير معروف للأموال الواردة، وحدد خيار إنشاء الموردين المفقودين (Create missing suppliers) على صف اسم الدائن (…/RltdPties/Cdtr/Nm) لكل مستلم غير معروف للأموال الصادرة. يتم التعرف على الشركاء عن طريق رقم الآيبان (IBAN) أولاً (حيث يتم تخزين الآيبان في الحسابات البنكية للشريك)، ثم عن طريق الاسم الدقيق؛ والشريك الذي يتم العثور عليه عن طريق الاسم يُضاف إليه رقم الآيبان، بحيث يتعرف عليه الاستيراد التالي عن طريق الآيبان. يُعتبر الشريك الجديد شركة إذا كان اسمه يحمل شكلاً قانونياً (مثل: UAB أو MB أو AB أو VšĮ أو SIA أو OÜ أو GmbH أو Ltd، وما إلى ذلك)، ويُعتبر فرداً بخلاف ذلك.
إنشاء شريك للبنك. حدد هذا الخيار على صف قواعد الرسوم البنكية. يُنشئ الاستيراد مورداً مُسمّىً باسم البنك (Stmt/Acct/Svcr/FinInstnId/Nm، أو اسم الحساب البنكي عندما لا يحتوي كشف الحساب على اسم البنك) مرة واحدة، ويسجل كل رسوم في دفتر اليومية مع ذلك الشريك.
ربط الفواتير بواسطة هذا الحقل. حدد هذا الخيار على صف التحويل (…/RmtInf/Ustrd)، أو صف المرجع المُهيكل (…/RmtInf/Strd/CdtrRefInf/Ref)، أو صف مرجع من البداية إلى النهاية (…/Refs/EndToEndId). يمكن لصف واحد فقط حمله؛ ومع ذلك، يقرأ الاستيراد النصوص الثلاثة بغض النظر عن الصف المُحدد. يظهر خياران إضافيان:
- إنشاء فواتير دفعات مقدمة للمقبوضات الواردة غير المطابقة - الدفعة الواردة التي لا تطابق أي فاتورة وتأتي من شريك معروف تحصل على فاتورة دفع مقدمة صادرة (سلسلة AV) بالمبلغ، ومؤرخة بتاريخ الدفع، ويتم مطابقة الدفعة بها. يجب أن يكون الشريك معروفاً، لذا حدد خيار إنشاء العملاء المفقودين أيضاً.
- معدل ضريبة القيمة المضافة وعنصر الكتالوج لتلك فواتير الدفع المقدمة. عند اختيار عنصر، يتم استخدام حسابه وإذا كان المعدل فارغاً، يتم استخدام معدل ضريبة القيمة المضافة الخاص به.
احفظ النموذج.
4. استيراد الملف
في قسم البنك (Bank)، اختر الحساب البنكي، والنموذج، والملف، ثم انقر على استيراد (Import). يُظهر سطر النتائج عدد المعاملات التي تم استيرادها، وعدد المعاملات التي كانت موجودة مسبقاً، وعدد الحركات التي تم ترحيلها، وعدد الشركاء الذين تم إنشاؤهم، وعدد الفواتير التي تم ربطها أو إنشاؤها. تعرض التحذيرات المدفوعات التي تعذرت مطابقتها والسبب وراء ذلك.
إعادة استيراد نفس الملف تُعد عملية آمنة: حيث يُتعرف على القيود من خلال مرجع القيد الخاص بالبنك (NtryRef، أو AcctSvcrRef، أو معرف المعاملة TxId)، أو -في حال عدم وجود مرجع- من خلال قيمة تجزئة (hash) لتاريخ الحجز، والمبلغ، والعملة، ورقم الآيبان للطرف المقابل والنص، مع احتسابها بحيث تظل القيود المتطابقة في أي مكان ضمن الملف الواحد منفصلة. يتم التعرف على الشركاء بواسطة رقم الآيبان (IBAN) والاسم. يتم تخطي القيود المرحلة ذات المبلغ الصفري مع إظهار تحذير.
5. ما يفعله خيار "ربط الفواتير بواسطة هذا الحقل"
يتم التحقق من كل قيد بنكي جديد مقابل المستندات المفتوحة:
- الأموال الواردة تُمطابق مع فواتير المبيعات الصادرة التي لم تُسدد بالكامل، عن طريق رقم الفواتير (على سبيل المثال
SF-123) الموجود في نص التحويل، أو المرجع المُهيكل، أو مرجع من البداية إلى النهاية؛ - الأموال الصادرة تُمطابق مع فواتير الشراء المسجلة التي لم تُسدد بالكامل، عن طريق رقم مستند المورد.
تسجل المطابقة عملية الدفع مقابل الفاتورة وتقيد المقبوضات أو المدفوعات؛ ويظهر القيد كأنه مُطابق في البنك ← المعاملات (Bank → Transactions) مع وجود رابط للفاتورة. أما القيود التي ليس لها رقم يمكن التعرف عليه فتظل غير مطابقة ويمكن مطابقتها يدوياً من قائمة المعاملات، أو -بالنسبة للأموال الواردة من عميل معروف- تحويلها إلى فاتورة دفعة مقدمة عندما يكون هذا الخيار مفَعلاً.
6. أين تبحث لاحقاً
- البنك ← المعاملات (Bank → Transactions) - كل قيد مُستورد؛ وترتبط القيود المطابقة بالفاتورة أو قيد دفتر اليومية.
- الفواتير (Invoices) - فواتير الدفع المقدمة المُنشأة للمقبوضات غير المطابقة.
- الشركاء (Partners) - العملاء والموردون المُنشؤون، ولكل منهم رقم الآيبان (IBAN) تحت الحسابات البنكية.
- دفتر الأستاذ ← دفتر اليومية (Ledger → Journal) - القيود الخاصة بالرسوم (مع البنك كشريك)، والفوائد، والضرائب، والمدفوعات.
الفوترة
الملفات التي تصل مساحتها إلى 10 ميغابايت وتتضمن حتى 50,000 قيد. كل 10 قيود مُستوردة تحتسب كطلب واحد لواجهة البرمجة التطبيقية (API).