بوابة وافق للفوترة الإلكترونية (ASP): البدء وربط المنشآت (الإمارات)

في هذا الدليل، ستتعرّف على بوابة وافق للفوترة الإلكترونية (Wafeq e-invoicing ASP)، ولمن صُمّمت، وكيف تستخدمها من البداية: إنشاء منشأتك في البوابة، والتجربة في البيئة التجريبية (Sandbox)، والاشتراك للانتقال إلى البيئة الفعلية (Live)، وربط منشأة (دافع ضرائب) عبر إمارات تاكس، وتسجيل الدخول بحساب دافع الضرائب، وإلغاء الربط.

ما بوابة وافق للفوترة الإلكترونية؟

في الإمارات، ترسل المنشآت فواتيرها الإلكترونية وتستقبلها عبر مزوّد خدمة معتمد (ASP). ووافق مزوّد خدمة معتمد، ويظهر في منصة إمارات تاكس باسم Wafeq FZ LLC.

بوابة وافق للفوترة الإلكترونية (einvoicing.wafeq.com) منتج مستقل ومنفصل عن برنامج وافق المحاسبي. تتيح للمنشأة التي تريد الاستمرار في استخدام برنامجها المحاسبي أو نظام ERP الخاص بها أن ترسل الفواتير الإلكترونية وتستقبلها عبر شبكة Peppol وتُبلّغ بها الهيئة الاتحادية للضرائب، إما عن طريق واجهة برمجة التطبيقات (API) أو باستيراد ملفات Excel.

من خلال البوابة يمكنك:

• ربط منشأة واحدة أو أكثر (دافعي ضرائب) والحصول على موافقتها لإرسال الفواتير الإلكترونية واستقبالها نيابةً عنها.
• إرسال الفواتير الإلكترونية باستيراد ملف Excel أو CSV، أو عبر API.
• متابعة كل فاتورة وإشعار دائن وفاتورة شراء وإشعار مدين مع حالة التسليم والإبلاغ للهيئة.
• إدارة مفاتيح API والـ Webhooks لفريقك التقني.
• تجربة كل شيء مجانًا في البيئة التجريبية قبل الانتقال إلى البيئة الفعلية.

لمن صُمّمت البوابة؟

• المنشآت التي تستخدم برنامجًا محاسبيًا آخر أو نظام ERP خاصًا (مثل SAP أو Oracle) وتريد الاستمرار عليه؛ إذ يربط فريقك التقني أو شريك التنفيذ نظامك بوافق عبر API، أو تستورد ملفات Excel.
• مكاتب المحاسبة والمنصات البرمجية التي تتولى الفوترة الإلكترونية لعدة عملاء؛ إذ تُربط كل منشأة عميلة بمنشأتك في البوابة بوصفها دافع ضرائب.
• أي منشأة مرتبطة بوافق مزوّدًا معتمدًا وتريد الاطلاع على فواتيرها الإلكترونية أو إدارة التطبيقات المرتبطة بها، من خلال تسجيل الدخول بحساب دافع الضرائب.

مفاهيم أساسية

• المنشأة في البوابة (Organization): مساحة العمل الخاصة بك في البوابة، وتضم أعضاء فريقك ومفاتيح API والاشتراك ودافعي الضرائب الذين تعمل معهم. ويمكن لمكاتب المحاسبة وشركات التقنية إنشاء أكثر من منشأة، مثل منشأة لكل عميل.
• دافع الضرائب (Taxpayer): المنشأة التي تُصدر الفواتير الإلكترونية أو تستقبلها، وتُعرَّف برقم التعريف الضريبي (TIN). فالمجموعة التي تضم ثلاث شركات لديها ثلاثة دافعي ضرائب.
• الموافقة (الربط): يقوم دافع الضرائب بأمرين لمرة واحدة: أولًا يختار Wafeq FZ LLC مزوّدًا للفوترة الإلكترونية في إمارات تاكس، ثم يوافق على طلب الربط الذي أرسلته منشأتك. ويمكن للمنشأة الربط بأكثر من منشأة في البوابة، وإلغاء أي ربط في أي وقت.
• البيئة التجريبية (Sandbox) والبيئة الفعلية (Live): بيئتان منفصلتان. البيئة التجريبية للاختبار فقط؛ لا يُرسل منها شيء إلى الهيئة أو شبكة Peppol، وهي مجانية. أما البيئة الفعلية فتُرسل فيها الفواتير الإلكترونية الحقيقية وتُبلَّغ بها الهيئة، وتتطلب اشتراكًا مدفوعًا.

قبل أن تبدأ

تأكد من توفر ما يلي:

• حساب في وافق لتسجيل الدخول إلى بوابة المطورين (Developer portal)، ويمكنك استخدام حسابك نفسه في برنامج وافق المحاسبي.
• لكل منشأة ستربطها: رقم التعريف الضريبي (TIN)، والبريد الإلكتروني لمسؤول (Admin) حسابها في إمارات تاكس، وعنوانها، وبيانات التسجيل التجاري (رخصة تجارية أو هوية إماراتية أو جواز سفر أو قرار مجلس الوزراء).
• صلاحية الدخول إلى حساب المنشأة في إمارات تاكس، أو تواجد مالك المنشأة لإكمال خطوة إمارات تاكس.
• اشتراك مدفوع في باقة Platform Start أو Platform Scale قبل ربط أي دافع ضرائب في البيئة الفعلية. لا تحتاج البيئة التجريبية إلى اشتراك.

الخطوة 1: افتح البوابة واختر طريقة تسجيل الدخول

انتقل إلى einvoicing.wafeq.com. تعرض صفحة تسجيل الدخول خيارين:

• "Developer portal" (بوابة المطورين): اختره لإدارة منشأتك في البوابة وربط دافعي الضرائب واستيراد الملفات وإدارة الربط التقني. يبدأ معظم المستخدمين من هنا.
• "Taxpayer account" (حساب دافع الضرائب): اختره فقط لتسجيل الدخول بوصفك منشأة مرتبطة بوافق مسبقًا، باستخدام البريد الإلكتروني المسجّل لدى الهيئة في إمارات تاكس. راجع قسم: تسجيل الدخول بحساب دافع الضرائب .

الخطوة 2: أنشئ منشأتك في البوابة

اضغط على "Developer portal" وسجّل الدخول بحسابك في وافق. عند تسجيل الدخول لأول مرة، يُطلب منك إنشاء منشأة:

1. تحت "Where will this organization issue e-invoices?"، اختر "United Arab Emirates".
2. أدخل اسم المنشأة في حقل "Organization name".
3. اضغط على "Continue to portal".

تُفتح منشأتك في البيئة التجريبية (Sandbox) على صفحة "Get started" التي ترشدك إلى الخطوات الأولى، وتتضمن فيديو تعريفيًا بالبوابة.

الخطوة 3: تعرّف على البوابة

التبديل بين البيئة التجريبية والبيئة الفعلية

استخدم قائمة "Environment" أعلى القائمة الجانبية للتبديل بين "Live" و"Sandbox". البيئة التجريبية نسخة منفصلة للاختبار؛ لا يُرسل منها شيء إلى الهيئة ولا تُحتسب ضمن الفوترة، ويظهر شريط أصفر أعلى الصفحة لتذكيرك بأنك فيها.

القائمة الرئيسية

• Get started: قائمة خطوات الإعداد للبيئة الحالية.
• Dashboard (لوحة التحكم): نشاط المستندات لدى جميع دافعي الضرائب: ما صدر، وما استُلم، وأي مشكلات في التسليم.
• Reports (التقارير): أعداد الفواتير وإجماليات الضريبة لأي فترة ولكل دافع ضرائب، مع إمكانية التصدير بصيغة CSV.
• Files (الملفات): استيراد الفواتير الإلكترونية من ملفات Excel أو CSV ومتابعة حالتها.
• Taxpayers (دافعو الضرائب): المنشآت المرتبطة بمنشأتك في البوابة.
• Sales (المبيعات: Invoices وCredit Notes) وPurchases (المشتريات: Bills وDebit Notes): كل مستند أصدره دافعو الضرائب أو استلموه، مع حالة التسليم والإبلاغ للهيئة.
• Developer (المطورون): وحدة التحكم الخاصة بالمطورين (Developer Console) لفريقك التقني: مفاتيح API والـ Webhooks والأحداث وإعدادات الربط. لا تحتاج إليها للعمل داخل البوابة.

قائمة الحساب

اضغط على اسمك أسفل القائمة الجانبية لفتح "My account" و"Settings" و"Billing & pricing"، أو للتبديل بين منشآتك، أو لإنشاء منشأة جديدة (+)، أو لتسجيل الدخول بحساب دافع الضرائب عبر "Sign in as taxpayer".

الخطوة 4: ادعُ فريقك (اختياري)

1. افتح قائمة الحساب واضغط على "Settings"، ثم افتح تبويب "Members".
2. تحت "Invite a member"، أدخل البريد الإلكتروني لزميلك في حقل "Email" واختر دوره من "Role".
3. اضغط على "Send invite". تصل إلى زميلك رسالة بريد إلكتروني، ويقبل الدعوة بتسجيل الدخول (أو إنشاء حساب) بالبريد الإلكتروني نفسه.

ومن تبويب "Organization settings" يمكنك أيضًا ضبط الاسم والشعار وبريد الدعم التي تظهر لدافعي الضرائب في صفحات الربط.

الخطوة 5: اشترك للانتقال إلى البيئة الفعلية

البيئة التجريبية مجانية. أما ربط دافعي الضرائب وإرسال الفواتير الإلكترونية في البيئة الفعلية فيتطلب اشتراكًا فعّالًا. وقبل الاشتراك، تعرض صفحة "Taxpayers" في البيئة الفعلية أنه لا توجد مقاعد متاحة، ولا يظهر زر "Connect a taxpayer".

1. افتح قائمة الحساب واضغط على "Billing & pricing". تعرض الصفحة رصيد المستندات "Document wallet" والباقات المتاحة.
2. اختر الباقة:
   • Platform Start: اشتراك ذاتي لدافعي الضرائب الذين تديرهم من البوابة. اضغط على "Subscribe to Platform Start".
   • Platform Scale: للمنشآت والمنصات التي تحتاج إلى إنشاء دافعي الضرائب عبر API أو خصومات على الكميات أو أسعار تفاوضية. اضغط على "Contact sales".

إذا اخترت Platform Start، فأكمل صفحة الاشتراك:

1. اختر طريقة الدفع (Choose how to pay): "Monthly" (‏89 درهمًا لكل مقعد شهريًا، مع 15 مستندًا لكل مقعد شهريًا) أو "Annual" (‏890 درهمًا لكل مقعد سنويًا، مع 1,000 مستند لكل مقعد سنويًا).
2. اختر عدد المقاعد (Choose your taxpayer seats): مقعد لكل دافع ضرائب ستربطه في البيئة الفعلية، ويمكنك إضافة مقاعد لاحقًا.
3. أضف مستندات إضافية (اختياري): باقات من 100 إلى 10,000 مستند، بسعر يبدأ من 0.35 درهم وينخفض إلى 0.20 درهم للمستند.
4. بيانات الفوترة (Billing details): أدخل اسم المنشأة وبريد الفوترة والعنوان والمدينة والدولة، ورقم التسجيل الضريبي (TRN) إن كنت مسجّلًا في ضريبة القيمة المضافة. تظهر هذه البيانات على فواتيرك.
5. راجع الملخص في "Summary"، ثم اضغط على "Subscribe with Stripe" للدفع بالبطاقة في صفحة Stripe.

الخطوة 6: اربط دافع ضرائب

ترتبط المنشأة بمنشأتك في البوابة عن طريق فتح رابط ربط ترسله إليها. ننصحك بتجربة العملية كاملة في البيئة التجريبية أولًا، ثم تكرارها في البيئة الفعلية.

أنشئ رابط الربط

1. تأكد من اختيار البيئة الصحيحة، ثم اضغط على "Taxpayers" من القائمة الجانبية.
2. اضغط على "Connect a taxpayer".

3. تحت "Access"، أبقِ الصلاحيات التي تحتاج إليها: "Business details" (بيانات المنشأة)، و"Read e-invoices" (قراءة الفواتير)، و"Send e-invoices" (إرسال الفواتير)، و"Receive incoming e-invoices" (استقبال الفواتير الواردة).
4. في حقل "Expected TIN (optional)"، أدخل رقم TIN المكوّن من 10 أرقام للمنشأة، حتى لا يستخدم الرابط غيرها.
5. في حقل "Label (optional)"، أضف اسمًا يساعدك على تمييز الربط، مثل اسم الفرع.
6. اضغط على "Create link".

7. اضغط على "Copy" وأرسل الرابط إلى المنشأة (أو افتحه بنفسك إن كانت لديك صلاحية الدخول إلى حسابها في إمارات تاكس).
8. اضغط على "Done".

ما تفعله المنشأة عند فتح الرابط

عند فتح الرابط، يظهر للمنشأة اسم منشأتك وثلاث خطوات.

1. اختيار وافق في إمارات تاكس (البيئة الفعلية)

تضغط المنشأة على "Go to EmaraTax"، ثم تفتح الفاتورة الإلكترونية (E-Invoicing) في إمارات تاكس، وتختار رقم TIN الخاص بها، ثم تختار Wafeq FZ LLC من قائمة مزوّدي الخدمة المعتمدين، وتضغط على "Proceed to ASP" لتعود إلى البوابة. تجد شاشات إمارات تاكس خطوة بخطوة في دليل: كيفية تعيين وافق مزوّدًا معتمدًا للفوترة الإلكترونية عبر منصة إمارات تاكس.

أما في البيئة التجريبية، فهذه الخطوة محاكاة؛ إذ تعرض الصفحة "Simulate EmaraTax onboarding". أدخل بريدًا إلكترونيًا تجريبيًا في "Taxpayer email"، وأبقِ "Scenario" على "Successful onboarding"، ثم اضغط على "Simulate onboarding"، فتُنشئ البيئة التجريبية دافع ضرائب تجريبيًا برقم TIN جديد.

2. التحقق من المنشأة

بعد العودة إلى البوابة، تُدخل المنشأة رقم التعريف الضريبي في حقل "Tax Identification Number (TIN)" والبريد الإلكتروني المسجّل في إمارات تاكس، ثم تضغط على "Verify & continue"، ويتحقق وافق من البيانات لدى الهيئة.

تراجع المنشأة بعد ذلك البيانات المسترجعة من الهيئة (الاسم القانوني ورقم التسجيل الضريبي ورقم TIN والشكل القانوني)، ثم تُكمل:

• عنوان المنشأة: "Emirate" (الإمارة) و"Street address" (العنوان) و"City" (المدينة)، ويُستخدم بوصفه عنوان البائع على الفواتير.
• التسجيل التجاري: "Registration type" (رخصة تجارية أو هوية إماراتية أو جواز سفر أو قرار مجلس الوزراء)، و"Registration number"، و"Issuing authority" (اختياري). تظهر هذه البيانات على كل فاتورة إلكترونية، ولا توفرها الهيئة.

تضغط المنشأة على "Connect" ثم تؤكد، فيسجّل وافق المنشأة لدى الهيئة وعلى شبكة Peppol، ويستغرق ذلك عادةً بضع ثوانٍ.

3. الموافقة على الصلاحيات

تظهر للمنشأة الصلاحيات التي تطلبها منشأتك بالتحديد، مثل عرض بيانات المنشأة وقراءة فواتيرها الإلكترونية وإصدار الفواتير نيابةً عنها. تضغط على "Connect" للموافقة، أو "Don’t allow" للرفض.

تؤكد صفحة "Connection complete" اكتمال الربط.

عرض دافع الضرائب المرتبط

في منشأتك بالبوابة، تظهر المنشأة في صفحة "Taxpayers" بالحالة "Onboarded".

اضغط على اسم دافع الضرائب لعرض بياناته (رقم TIN ورقم التسجيل الضريبي ومعرّف Peppol والحالة و"Taxpayer ID")، والصلاحيات الممنوحة، وسجل الربط، وفواتيره. ستحتاج إلى Taxpayer ID (يبدأ بـ txpay_) عند استيراد الفواتير الإلكترونية من ملف.

الخطوة 7: أرسل الفواتير الإلكترونية وتابعها

بعد ربط دافع الضرائب، يمكنك إرسال فواتيره الإلكترونية بطريقتين:

• استيراد ملف: املأ قالب Excel واستورده من "Files". راجع دليل:

   كيفية إرسال الفواتير الإلكترونية من ملف Excel عبر بوابة وافق للفوترة الإلكترونية (الإمارات).

• واجهة برمجة التطبيقات (API): يستخدم المطورون قسم "Developer" (مفاتيح API والـ Webhooks والإعدادات) ودليل الربط على docs.wafeq.com/uae-einvoicing، ويبدؤون بمفتاح API من البيئة التجريبية.

يظهر كل مستند تحت Sales أو Purchases مع أعمدة "Status" (الحالة) و"Delivery" (التسليم) و"Tax report" (الإبلاغ للهيئة). واستخدم "Reports" للاطلاع على أعداد الفواتير وإجماليات الضريبة.

تسجيل الدخول بحساب دافع الضرائب

يمكن للمنشأة المرتبطة بوافق تسجيل الدخول إلى حساب دافع الضرائب الخاص بها لعرض فواتيرها الإلكترونية والتحكم في التطبيقات التي يمكنها الوصول إلى بياناتها.

1. انتقل إلى einvoicing.wafeq.com واضغط على "Taxpayer account". (إذا كنت داخل بوابة المطورين، افتح قائمة الحساب واضغط على "Sign in as taxpayer".)
2. في حقل "Email registered with the FTA"، أدخل البريد الإلكتروني المسجّل في إمارات تاكس.
3. اضغط على "Email me a sign-in link"، ثم افتح الرابط من بريدك. لا توجد كلمة مرور.

يضم حساب دافع الضرائب أربعة تبويبات:

• Overview (نظرة عامة): عدد المستندات المُرسلة والمستلمة والتطبيقات المرتبطة وأحدث المستندات.
• Documents (المستندات): جميع الفواتير الإلكترونية والإشعارات الدائنة الصادرة والمستلمة عبر حسابك لدى مزوّد الخدمة، من أي تطبيق مرتبط.
• Connected apps (التطبيقات المرتبطة): التطبيقات والمنشآت التي سمحت لها بالوصول إلى منشأتك، مثل برنامج وافق المحاسبي. اضغط على "Disconnect" لإيقاف وصول أي تطبيق فورًا.
• Account (الحساب): بيانات منشأتك المسجّلة لدى الهيئة (رقم TIN ورقم التسجيل الضريبي ومعرّف Peppol والحالة وبريد الدخول)، وبيانات التسجيل التجاري التي يمكنك تعديلها من هنا.

إذا كنت تدير أكثر من منشأة، أو كنت عضوًا في منشأة في البوابة أيضًا، فاستخدم القائمة أعلى يمين الصفحة للتبديل بين المنشآت، أو "Onboard a business" لربط منشأة جديدة، أو "Sign in with another email"، أو للعودة إلى منشأتك في البوابة.

إلغاء الربط: التوقف عن استخدام وافق مزوّدًا معتمدًا

يبدأ تغيير مزوّد الخدمة أو إلغاء التسجيل دائمًا من إمارات تاكس، ولا يمكن بدؤه من البوابة؛ فهذا من متطلبات منصة إمارات تاكس.

1. سجّل الدخول إلى إمارات تاكس وافتح الفاتورة الإلكترونية (E-Invoicing) ثم حالة الربط (Linkage status).
2. بجوار Wafeq FZ LLC، اختر إلغاء الربط (Offboarding)، فتنتقل إلى البوابة.
3. أدخل رقم TIN وبريدك في إمارات تاكس، ثم اضغط على "Verify & disconnect".
4. راجع بياناتك واضغط على "Disconnect"، ثم أكّد.

تُزال وافق بوصفها مزوّدك لدى الهيئة، ويُسحب تسجيلك على شبكة Peppol، وتفقد التطبيقات المرتبطة صلاحية الوصول، مع الاحتفاظ بحساب دافع الضرائب ومستنداتك. وتظهر حالة الربط في إمارات تاكس على أنها غير مرتبطة. وإذا أردت العودة لاحقًا، فما عليك إلا الربط من جديد.

حل المشكلات

هل البوابة هي نفسها برنامج وافق المحاسبي؟
لا. البوابة منتج منفصل للمنشآت التي تحتفظ ببرنامجها المحاسبي أو نظام ERP الخاص بها، أما برنامج وافق المحاسبي فيتضمن الفوترة الإلكترونية دون تكلفة إضافية في جميع الباقات.

هل أحتاج إلى اشتراك لتجربة البوابة؟
لا. البيئة التجريبية مجانية ولا تتطلب اشتراكًا، ولا تحتاج إلى اشتراك إلا لربط دافعي الضرائب وإرسال الفواتير في البيئة الفعلية.

هل يمكن لمنشأة واحدة في البوابة إدارة عدة منشآت؟
نعم. كل منشأة دافع ضرائب يشغل مقعدًا واحدًا، وتتوفر باقة Platform Scale للمنشآت التي لديها عدد كبير من دافعي الضرائب.

هل ما زلت بحاجة إلى إرسال الفاتورة بصيغة PDF إلى عميلي؟
نعم. لا تعرض جميع برامج المشترين الفواتير الإلكترونية الواردة، لذا استمر في إرسال فواتيرك كالمعتاد.

هل تتضمن الفواتير الإلكترونية في الإمارات رمز QR؟
لا. لا تحمل الفواتير الإلكترونية في الإمارات رمز QR.

هل يمكن تغيير لغة البوابة إلى العربية؟
البوابة متوفرة حاليًا باللغة الإنجليزية فقط.

لمعرفة المزيد عن الفوترة الإلكترونية في الإمارات، راجع هذا الدليل :

الفاتورة الإلكترونية في الإمارات: الدليل الكامل مع وافق

ولإرسال الفواتير الإلكترونية من ملف Excel راجع  هذا الدليل:

 كيفية إرسال الفواتير الإلكترونية من ملف Excel عبر بوابة وافق للفوترة الإلكترونية (الإمارات)