شرح واجهة برمجة الفوترة الإلكترونية في الإمارات
«واجهة الفوترة الإلكترونية» تعني عادة واجهات برمجية لإنشاء الفواتير المنظّمة أو التحقق منها أو إرسالها أو تتبع حالتها—غالباً عبر مزوّد ASP—وليست عنوان REST حكومي عام لكل شركة صغيرة.
- الموضوع
- التكاملات · واجهات ASP
- واجهة Finvora
- Open API لبيانات الدفاتر
- الوصول
- مفاتيح API محصورة بالمستأجر
- إرسال ASP
- على خارطة الطريق — غير متاح
النقاط الأساسية
- «واجهة الفوترة الإلكترونية» عادة مجموعة واجهات عند مزوّد ASP أو طبقة التكامل—لا نقطة حكومية واحدة تتصل بها كل شركة مباشرة.
- التدفق المعتاد: ERP/محاسبة ← تكامل أو واجهة ASP ← الشبكة الوطنية ← الحالة تعود إلى ERP.
- تعرض Open API في Finvora العملاء والفواتير والقيود والمخزون لتكاملاتك؛ وهي ليست واجهة إرسال ASP / PINT AE.
- «لديه واجهة» لا تعني أبداً «معتمد». اسأل عن مزوّد ASP وإصدار المواصفة والبيئة التجريبية وwebhooks.
- صمّم تكاملاتك الآن لتخزين المعرّفات والحالات ليكون إضافة ASP لاحقاً اتصالاً لا إعادة كتابة.
تفيدك هذه الصفحة إذا كنت…
- مطوراً أو مسؤول تقنية تحدد نطاق تكامل فوترة إلكترونية لنشاط في الإمارات.
- تحتاج أن تشرح للمالية ما تستطيعه «واجهة الفوترة الإلكترونية» وما لا تستطيعه.
- تريد البناء على بيانات دفاتر Finvora اليوم والبقاء جاهزاً لمزوّد ASP لاحقاً.
ليست هذه الصفحة لك إذا كنت…
- تحتاج المواصفة التقنية الرسمية أو مخططات الرسائل—استخدم مواد وزارة المالية.
- تتوقع أن ترسل Open API في Finvora الفواتير إلى شبكة الفوترة الإلكترونية الإماراتية اليوم.
- تريد مرجع واجهة ASP معتمداً—اسأل مزوّد ASP مباشرة.
ماذا يقصد الناس بـ«واجهة الفوترة الإلكترونية»
تشمل العبارة أربعة أشياء مختلفة على الأقل: إنشاء بيانات الفاتورة في نظامك، والتحقق منها وفق مواصفة، وإرسالها إلى الشبكة، واستلام حالة راجعة. يعرض البائعون مجموعات فرعية مختلفة.
توضيح أي واحد من الأربعة يقصده المتحدث أسرع طريق لتجنب سوء فهم يمتد ستة أسابيع بين المالية والتقنية والبائع.
بنية التكامل المعتادة
أنظمة الأعمال (ERP/محاسبة) تحتفظ ببيانات الفاتورة ← تكامل أو واجهة ASP تتحقق وترسل بالصيغة المطلوبة ← الشبكة الوطنية تُرجع الحالات والأخطاء.
نادراً ما تتصل الشركات الصغيرة بالشبكة مباشرة؛ تستخدم واجهة ASP أو تكامل بائع يغلّفها.
من يملك كل طبقة
يسهل فهم المسؤولية عند فصل الطبقات. يلخّص الجدول التقسيم المعتاد؛ أكّد النموذج الدقيق لدى مزوّدك.
وعند حدوث عطل يخبرك هذا التقسيم بمن تتصل: بيانات الفاتورة السيئة مشكلة دفاتر، وخطأ التحويل مشكلة تكامل، والمستند المرفوض شيء يستطيع مزوّد ASP والشبكة تفسيره.
الطبقات في تكامل فوترة إلكترونية معتاد
| الطبقة | المالك المعتاد | نشاط واجهة مثالي |
|---|---|---|
| الدفاتر وبيانات الفاتورة | محاسبتك/ERP (مثل Finvora) | إنشاء الفواتير والعملاء والقيود وقراءتها |
| التكامل / التحويل | موصّل البائع أو مطوروك | تحويل حقول ERP إلى الصيغة المطلوبة |
| الإرسال | مزوّد خدمة معتمد لدى وزارة المالية | تقديم الفواتير المنظّمة والتحقق منها وإرسالها |
| الشبكة | البرنامج الوطني للفوترة الإلكترونية | استقبال المستندات وإرجاع الحالة أو الأخطاء |
ما يقدّمه Finvora اليوم
Open API في Finvora يعرض العملاء والفواتير والقيود والمخزون لتكاملاتك. ذلك ليس نفسه إرسال ASP / PINT AE الحيّ.
عندما يُشحن إرسال ASP يبقى المسار المقصود: Finvora ← تكامل الفوترة الإلكترونية ← مزوّد ASP ← الشبكة.
الوصول إلى API محصور بالمستأجر عبر مفاتيح تُدار داخل المنتج، ويساعدك سجل التدقيق على رؤية ما تغيّر في الدفاتر.
ما تشمله واجهة ASP عادةً
دون وصف مزوّد بعينه، تغطي واجهات أسلوب ASP عادةً تقديم مستند، واستلام نتيجة تحقق، واستطلاع حالة التسليم أو استقبالها عبر webhooks، ومعالجة الرفض.
يحتاج تكاملك إلى تخزين هذه الحالات مقابل الفاتورة الأصلية ليرى فريق المالية أي الفواتير مقبولة أو معلّقة أو مرفوضة دون الدخول إلى بوابة أخرى.
- تقديم مستند منظّم واستلام إقرار
- أخطاء التحقق مربوطة بحقول محددة
- حالة التسليم والقبول عبر الاستطلاع أو webhook
- معالجة الرفض وسير إعادة التقديم
ما يجب أن يوضحه المطوّرون
اسأل أي بائع: أي مزوّد ASP، وأي إصدار مواصفة، وهل توجد بيئة تجريبية وwebhooks للحالة. لا تفترض أن «API» تعني الاعتماد.
واسأل أيضاً عن حدود الطلبات وطريقة المصادقة وكيفية نمذجة التصحيحات والإشعارات الدائنة وماذا يحدث للمستندات قيد المعالجة أثناء نوافذ الصيانة.
تصميم التكاملات لتكون جاهزة لـ ASP
ابنِ تكاملك بحيث تحمل كل فاتورة معرّفاً داخلياً ثابتاً، واترك مكاناً لمعرّف المستند الخارجي وحقل للحالة. أبقِ أرقام تسجيل العملاء وأسماءهم القانونية موحّدة عند المصدر.
تعامل مع عمليات الإرسال كعمليات متكافئة (idempotent): إعادة المحاولة يجب ألا تنشئ فاتورة ثانية على الشبكة. تصميم ذلك الآن أسهل من إضافته لاحقاً.
الأمان وحصر المستأجر
أبعد مفاتيح API عن نظام التحكم بالإصدارات، وحصرها في أقل الموارد اللازمة، وبدّلها عند تغيّر الموظفين. مفاتيح Finvora محصورة بالمستأجر فلا يصل مفتاح مساحة عمل إلى بيانات أخرى.
Finvora ليس مزوّد خدمة معتمداً (ASP) لدى وزارة المالية للفوترة الإلكترونية (PINT AE). تدعم مساحات العمل بنود ضريبة الهيئة وحقول رقم التسجيل ومسودات الإقرار للدفاتر؛ اربط مزوّد ASP معتمداً عندما ينطبق التفويض.
FAQ
أسئلة شائعة
- هل لدى Finvora واجهة فوترة إلكترونية للإمارات اليوم؟
- لدى Finvora Open API لبيانات المحاسبة والفوترة. واجهات إرسال ASP / PINT AE على خارطة الطريق؛ Finvora ليس مزوّد ASP.
- أين أقرأ وثائق واجهة Finvora؟
- ابدأ من صفحة Open API وفي إعدادات مفاتيح API داخل المنتج للوصول حسب المستأجر.
- هل توجد واجهة حكومية واحدة تتصل بها كل شركة صغيرة؟
- عادةً لا. تتصل الشركات عبر واجهة مزوّد خدمة معتمد أو تكامل بائع. أكّد النموذج من مصادر وزارة المالية الرسمية.
- هل أستطيع إرسال الفواتير إلى الشبكة الإماراتية عبر Open API في Finvora؟
- لا. تتيح Open API الوصول إلى بيانات الدفاتر. الإرسال إلى الشبكة يتطلب مزوّد خدمة معتمداً، وFinvora ليس كذلك.
- ماذا أسأل مزوّد ASP عن واجهته؟
- اطلب مرجع الاعتماد وإصدار المواصفة المدعوم والوصول إلى بيئة تجريبية وطريقة المصادقة ودعم webhooks وكيفية معالجة الرفض والتصحيحات.
- كيف أجهّز تكاملي لمزوّد ASP لاحقاً؟
- خزّن معرّفات فواتير ثابتة، ووحّد أرقام التسجيل والأسماء، وأضف حقولاً لمعرّف المستند الخارجي والحالة، واجعل عمليات الإرسال متكافئة.
مصادر رسمية
روابط ذات صلة
اربط على بيانات دفاتر حقيقية
استخدم Open API للفواتير والقيود اليوم؛ خطّط لربط ASP للإرسال لاحقاً.
إنشاء مساحة عمل