في هذا الدليل، ستتعرّف على كيفية إرسال الفواتير الإلكترونية من ملف Excel عبر بوابة وافق للفوترة الإلكترونية: تنزيل القالب وتعبئته، واستيراد الملف، وتصحيح ما تشير إليه البوابة، والموافقة على إرسال الفواتير الجاهزة.
قبل أن تبدأ، تأكد من إعداد منشأتك في البوابة وربط دافع ضرائب واحد على الأقل. راجع دليل:
بوابة وافق للفوترة الإلكترونية (ASP): البدء وربط المنشآت (الإمارات).
ملاحظة: واجهة البوابة متوفرة حاليًا باللغة الإنجليزية فقط، لذلك تظهر أسماء الأزرار والأعمدة في هذا الدليل بالإنجليزية كما تراها على الشاشة.
نصيحة: جرّب أول ملف في البيئة التجريبية (Sandbox)؛ فلا يصل شيء إلى عميلك أو إلى الهيئة، ويمكنك اختبار العملية كاملة مجانًا.
كيف يعمل استيراد الملفات؟
- كل صف في الملف يمثل بندًا واحدًا من بنود الفاتورة، والصفوف التي تحمل
taxpayer_idورقم الفاتورة نفسيهما تُجمع في فاتورة واحدة. - تحفظ البوابة الفواتير مسوداتٍ، وتتحقق من كل فاتورة وفق قواعد الإمارات، وتبحث عن كل عميل على شبكة Peppol.
- لا يُرسل شيء حتى توافق عليه، وعند موافقتك تُرسل كل فاتورة إلى مزوّد الخدمة الخاص بالعميل.
يمكنك استيراد Invoices (فواتير)، وCredit Notes (إشعارات دائنة)، وSelf-Billed Invoices وSelf-Billed Credit Notes (الفواتير والإشعارات الدائنة ذاتية الإصدار). ويمكن أن يحتوي الملف الواحد على 50,000 صف و5,000 مستند و25 ميجابايت كحد أقصى.
ملاحظة: يقتصر استيراد الملفات على مالكي المنشأة والمسؤولين (Owners وAdmins).
الخطوة 1: افتح عملية استيراد جديدة
- من القائمة الجانبية، اضغط على "Files". تعرض هذه الصفحة جميع الملفات التي استوردتها.
- اضغط على "New import".
- من "Document type"، اختر نوع المستندات في الملف.
- في "Dates in your file"، أبقِ "Detect unambiguous dates" إذا كان ملفك يستخدم تواريخ Excel فعلية. وإذا كانت التواريخ نصًا مثل 03/04/2026، فاختر Day first (اليوم أولًا) أو Month first (الشهر أولًا).
- اضغط على "Download Excel template" لتنزيل القالب.
الخطوة 2: املأ قالب Excel
يتكون القالب من أربع أوراق:
- Import: الورقة الوحيدة التي تُستورد. املأها ولا تغيّر عناوين الأعمدة.
- Instructions: قواعد تعبئة الملف.
- Examples: صفوف أمثلة، ولا تُستورد هذه الورقة أبدًا.
- Dropdown values: الرموز المتاحة للاختيار، مثل الإمارات وفئات الضريبة وأسباب الإعفاء.
يحتوي عنوان كل عمود على ملاحظة توضّح ما يُدخل فيه. املأ ورقة Import كما يلي:
-
taxpayer_id: ابدأ كل صف بـ Taxpayer ID للمنشأة المُصدِرة للفاتورة. تجده في صفحة دافع الضرائب ضمن "Taxpayers" (ويبدأ بـ
txpay_). -
بيانات الفاتورة: أدخل
invoice_number(رقم الفاتورة) وissue_date(تاريخ الإصدار) وcurrency(العملة) وdue_date(تاريخ الاستحقاق، وهو إلزامي للفواتير). وإذا لم تكن العملة الدرهم الإماراتي، فأدخل أيضًاcurrency_exchange_rate(سعر الصرف). -
بيانات العميل: أدخل
customer_nameوcustomer_vatوالعنوان والمدينة والدولة والإمارة (مثلDXB). وفيcustomer_id، أدخل معرّف Peppol الخاص بالعميل بصيغة0235:متبوعة برقم TIN المكوّن من 10 أرقام (مثل0235:1234567890)، واتركه فارغًا إذا لم يكن لدى العميل رقم TIN. -
بيانات البند: صف ما بعته في
line_description، ثم أدخل الكمية فيline_quantityوسعر الوحدة فيline_unit_price. -
الضريبة: اختر
line_tax_categoryمن القائمة (S للنسبة الأساسية، وZ للنسبة الصفرية، وE للمعفى، وO لخارج النطاق، وAE للاحتساب العكسي). وأدخلline_tax_percentرقمًا مجردًا: 5 للنسبة 5%، وليس 0.05. ولبنود E وO، أضف رمز سبب الإعفاء أو نصه. -
أكثر من بند: أضف صفًا جديدًا لكل بند إضافي، وكرّر
taxpayer_idوinvoice_numberنفسيهما. أكمل بيانات الفاتورة والعميل في الصف الأول فقط.
ملاحظة: تُترك أعمدة الحالات الخاصة (free_zone وmargin_scheme وdisclosed_agent_billing) فارغة في معظم الفواتير، فلا تختر Yes إلا إذا انطبقت إحداها. ويجب أن تشير الإشعارات الدائنة إلى الفاتورة الأصلية. أما فواتير التصدير والتجارة الإلكترونية والفواتير الإجمالية والتوريد الافتراضي والتوريد المستمر فتحتاج إلى حقول لا تتوفر إلا عبر API.
نصيحة: لا تختار نوع الفاتورة بنفسك؛ إذ تُصدر البوابة فاتورة ضريبية، أو فاتورة تجارية إذا لم يكن لدى البائع رقم تسجيل ضريبي أو كانت جميع البنود معفاة أو خارج النطاق.
الخطوة 3: ارفع الملف وراجع المعاينة
في صفحة "New import"، اسحب ملفك إلى منطقة الرفع أو اضغط عليها لاختياره. يتحقق متصفحك من الملف قبل رفع أي شيء، وإذا كانت هناك مشكلة في أحد الصفوف، تحدد البوابة رقم الصف المطلوب تصحيحه.
صحّح الصف في Excel، ثم اختر الملف مرة أخرى. وعند اجتياز الفحوصات الأساسية، تعرض المعاينة كل فاتورة مع دافع الضرائب والتواريخ والعملة وعدد البنود.
الخطوة 4: احفظ المسودات وتحقّق منها
اضغط على "Save drafts and validate". يُحفظ الملف، وتُتحقق كل فاتورة، ويُبحث عن العميل على شبكة Peppol في الخلفية. يمكنك مغادرة الصفحة والعودة إليها لاحقًا من "Files".
بعد اكتمال التحقق، راجع أعمدة "Peppol network" و"Status" و"Details":
- Draft · Ready to send: الفاتورة صحيحة والعميل موجود على شبكة Peppol.
- Invalid draft: يجب تصحيح شيء في الملف، ويوضّح عمود "Details" المطلوب.
- Recipient not found: العميل غير مسجّل على شبكة Peppol، فلا يمكن تسليم الفاتورة حاليًا. تحقق من معرّف العميل، أو أعد المحاولة بعد تسجيله.
- Lookup retry scheduled: البحث على شبكة Peppol غير متاح مؤقتًا، وستعيد البوابة المحاولة تلقائيًا.
اضغط على "Download errors" لتنزيل جميع الأخطاء في جدول بيانات. وللبدء من جديد، حدد المسودات واضغط على "Discard drafts"، ثم صحّح ملفك واستورده مرة أخرى.
الخطوة 5: وافق وأرسل
- حدد الفواتير الجاهزة، أو اضغط على "Select all ready".
- اضغط على "Approve and send".
تُرسل كل فاتورة إلى مزوّد الخدمة الخاص بعميلها، وعند نجاح التسليم تتغير حالتها إلى "Received by access point". اضغط على "View delivery" لعرض التفاصيل.
مهم: لا يمكن استرجاع فاتورة جارٍ إرسالها أو تم قبولها. لتصحيح فاتورة مُرسلة، أصدر إشعارًا دائنًا.
تظهر الفواتير المُرسلة أيضًا ضمن Sales ثم "Invoices" مع باقي فواتير دافع الضرائب، بما في ذلك حالة التسليم والإبلاغ للهيئة.
ملاحظة: في البيئة التجريبية، يعرض عمود "Tax report" القيمة "Disabled in Sandbox" لأنه لا يُبلَّغ أي شيء للهيئة.
الأسئلة الشائعة
هل يمكنني استيراد ملف CSV بدلًا من Excel؟
نعم، تقبل منطقة الرفع ملفات CSV وExcel، لكننا ننصح باستخدام قالب Excel لأنه يتضمن قوائم اختيار وملاحظات لكل عمود.
هل يستهلك استيراد الملفات رصيد المستندات؟
في البيئة الفعلية، يستهلك كل مستند يُعالَج بنجاح رصيدًا واحدًا من رصيد المستندات، أما الاستيراد في البيئة التجريبية فمجاني.
هل يمكن أن يحتوي ملف واحد على فواتير لعدة دافعي ضرائب؟
نعم، أدخل taxpayer_id الصحيح في كل صف.
تعليقات
لا توجد تعليقات
الرجاء تسجيل الدخول لترك تعليق.