حان وقت تجربة "ساندبوكس"
ساعات العمل
قم بالتحقق من صحة البيانات مقارنةً بأنظمتك الخاصة وشبكة اختبار Peppol.
حان وقت الإطلاق
من أيام إلى أسابيع
قم بالتشغيل وفقًا لعملية التكامل وعملية « release » الخاصة بك.
حد عدد المرات
تم الاتفاق عليه مع كل شريك على حدة
السعة المخصصة لكل شريك.
دور مزود الخدمة
Qvalia
تتولى شركة «كفاليا» تشغيل نقطة الوصول وخدمة SMP وإدارة الشبكة.
الدعم الفني
السطر الثالث
تقدم شركة «كفاليا» الدعم الفني من المستوى الثالث.
صُمم من أجل
مزودي أنظمة تخطيط موارد المؤسسات (ERP) · برامج الفوترة والمحاسبة · أنظمة إدارة علاقات العملاء (CRM) · مشغلي خدمات « VAN »
· أسواق B2B · وكالات المحاسبة · شركات استشارات تكنولوجيا المعلومات
منتجكم، بنيتنا التحتية
الشركاء هم من يقومون بتصميم وتطوير تجربة المستخدم. أما شركة Qvalia فتتولى تشغيل «نقطة الوصول» و«SMP» والبنية التحتية للرسائل التي تدعمها، والتي يمكن الوصول إليها عبر واجهة برمجة تطبيقات واحدة.
أنت تتحكم في تجربة العميل والعقد والتسعير. وتقوم شركة Qvalia بتشغيل خدمة Peppol خلف واجهتك.
ما نديره، ما تملكه
ما الذي تديره شركة «كفاليا»
- نقطة الوصول وSMP في إطار دور مزود خدمة Peppol الذي تضطلع به شركة Qvalia
- التحقق من صحة الرسائل، وتحويل التنسيق، وتسليمها عبر الشبكة
- تسجيل المشاركين والبحث عنهم
- المراقبة والتحديثات والامتثال لمعايير الشبكة
ما تمتلكه
- الواجهة التي يستخدمها عملاؤك، داخل منتجك الخاص
- العلاقة مع العميل، والعقد، والتسعير
- مسار التمهيد والدعم الخاص بك
سير عمل واجهة برمجة التطبيقات (API) للشركاء
تغطي واجهة برمجة التطبيقات (API) الخاصة بالشركاء عمليات المصادقة على النظام، وإعداد حسابات العملاء، وتقديم المستندات، ومعالجة الرسائل الواردة. وتقوم شركة Qvalia بإدارة عمليات النقل والاكتشاف والتحقق من الصحة وإدارة الشهادات في نظام Peppol.
1. المصادقة
تقوم أنظمة الشركاء بالمصادقة باستخدام مفتاح واجهة برمجة التطبيقات (API)، أو تستبدله بـ JWT قصير الأمد. وتغطي بيانات الاعتماد الواحدة واجهات برمجة التطبيقات الخاصة بالمعاملات، والشركاء، والحسابات، والتحسين.
curl --location --globoff -X POST \
'https://api.qvalia.com/token' \
--data '{
"client_id": "{partnerRegNo}",
"client_secret": "{apiKey}"
}'
# Valid for one hour. Send it on every call:
# Authorization: Bearer <token>2. إنشاء العميل
قم بإنشاء الحساب وتسجيل معرّف المشارك الخاص به في Peppol. تتولى Qvalia إدارة تسجيل المشاركين وتحديثات الدليل
curl --location --globoff -X POST \
'https://api.qvalia.com/partner/{partnerRegNo}/account' \
--header 'Authorization: Bearer <token>' \
--data '{
"accountRegNo": "5567321707",
"name": "Nordkap Logistik AB",
"address": "Wallingatan 33",
"postalCode": "111 24",
"country": "SE"
}'
curl --location --globoff -X PUT \
'https://api.qvalia.com/partner/{partnerRegNo}/account/5567321707/peppol/0007:5567321707' \
--header 'Authorization: Bearer <token>'3. إرسال واستقبال الرسائل
يتم التحقق من صحة المستندات وفقًا لمواصفات Peppol المعمول بها قبل إرسالها. ويتم إرسال ردود التحقق المنظمة إلى نظامكم، وتكون الرسائل الواردة متاحة عبر الحساب نفسه.
curl --location --globoff -X POST \
'https://api.qvalia.com/partner/{partnerRegNo}/transaction/5567321707/invoices/outgoing' \
--header 'Authorization: Bearer <token>' \
--data '{ "Invoice": { } }'
# 200
# { "status": "success", "data": { "message": "invoice 12335675 sent" } }4. الاشتراك في الفعاليات
اشترك لتتبع أحداث المستندات باستخدام «webhooks». تقوم Qvalia بإرسال إشعارات إلى نقطة النهاية الخاصة بك عند وصول مستند، وعند تغير حالة التسليم، وعند فشل التسليم.
curl --location --globoff -X PUT \
'https://api.qvalia.com/partner/{partnerRegNo}/webhook/configure' \
--header 'Authorization: Bearer <token>' \
--data '{
"url": "https://your-platform.example/qvalia/events",
"events": ["new_document", "document_delivery", "document_error"]
}'
# Delivered as HTTPS POST with a JSON body.
# Respond 2xx within 10 seconds.| المواصفات | التفاصيل |
| النقل | تتولى شركة «كفاليا» تشغيل نقل البيانات عبر بروتوكول Peppol AS4، وتبادل الرسائل عبر بروتوكول ebMS، وإدارة شهادات البنية التحتية للمفاتيح العامة (PKI). |
| زمن الاستجابة | يعتمد وقت استجابة واجهة برمجة التطبيقات (API) على حجم الحمولة وجودة الاتصال. ويتم التسليم عبر Peppol بشكل غير متزامن ويعتمد على نقطة الوصول المستقبلة. |
| التغييرات الجذرية | يتم إصدار التغييرات الجذرية كإصدار جديد من واجهة برمجة التطبيقات (API) مع إشعار مسبق مدته شهر على الأقل، وعادةً ما تكون المدة أطول من ذلك |
نماذج الحسابات متعددة المستأجرين
اختر إعدادًا موحدًا أو حسابًا منفصلاً لكل عميل، وفقًا لمتطلبات التسجيل وفصل البيانات وإدارة المستخدمين.
| المجمعة | حساب لكل مستأجر | |
| التسجيل في Peppol | إعداد مشترك تديره أنت | الحساب الخاص و Peppol ID لكل عميل نهائي |
| البيانات والمستخدمون | تتم إدارتها معًا عبر منصتكم | بيانات ومستخدمون وإعدادات منفصلة لكل مستأجر |
| الإعداد والتأهيل | أسرع طريقة لإضافة عميل | تتولى شركة «كفاليا» تسجيل المشاركين وتحديث دليل المشاركين |
| مناسب | العديد من العملاء الصغار ضمن خدمة واحدة تديرها | العملاء الذين يحتاجون إلى هوية Peppol خاصة بهم وسجل تتبع |
أنت تتحكم في تجربة التسجيل في كلا النموذجين. ويحدد نموذج الحساب عملية تسجيل المشاركين وفصل البيانات.
المستندات التجارية المدعومة
ويدعم هذا التكامل عمليات إصدار الفواتير وتقديم الطلبات وتدفقات المستندات التجارية ذات الصلة المتاحة.
| وثيقة | اسم Peppol | التفاصيل |
| الفاتورة | الفاتورة | طلب دفع، يتضمن بنودًا تفصيلية والضرائب وشروط الدفع |
| مذكرة ائتمان | مذكرة ائتمان | تصحيح أو إلغاء فاتورة تم إرسالها بالفعل |
| فاتورة ذاتية الإصدار | فاتورة ذاتية الإصدار | فاتورة يصدرها المشتري نيابة عن المورد |
| مذكرة ائتمان ذاتية الفوترة | إشعار الائتمان الذاتي | إشعار الائتمان المقابل للفاتورة المُصدَّرة ذاتيًا |
| الطلب | الطلب | أمر شراء من المشتري إلى المورد |
| الرد على الطلب | استجابة الطلب | قبول الطلب أو رفضه أو تعديله |
| اتفاقية الطلب | اتفاقية الطلب | اتفاقية إطارية يُشار إليها في الأوامر اللاحقة |
| تغيير الطلب | تغيير الطلب | تعديل على أمر تم إرساله بالفعل |
| إلغاء الطلب | إلغاء الطلب | إلغاء طلب تم إرساله بالفعل |
| إشعار الشحن | إرشادات الشحن | ما الذي تم شحنه فعليًّا، وبناءً على أي طلب |
| الكتالوج | الكتالوج | المنتجات والأوصاف والأسعار المتفق عليها |
| الرد على الكتالوج | رد على الكتالوج | قبول الكتالوج أو رفضه |
| الاستجابة على مستوى الرسالة | رد على مستوى الرسالة | الإقرار الفني باستلام رسالة ما أو رفضها |
| حالة الرسالة | حالة مستوى الرسالة | حالة معالجة رسالة على الشبكة |
Punchout، ويمكن لخدمات PDF وEDI استخدام نفس هيكل الحساب. وتقوم Qvalia بمعالجة التحقق من الصحة، والتوجيه، والتسليم، ومعالجة الأخطاء على مستوى الشبكة.
بيانات المعاملات المنظمة
تتوفر المستندات في شكل بيانات معاملات منظمة لأغراض إعداد التقارير والتحليلات وأتمتة العمليات المحاسبية.
بند الفاتورة، كما ورد
ART 4471-B
Printing paper A4 80G 5X500
12 pcs 489,00 SEKنفس السطر، إعلانات مبوبة
| UNSPSC | 14111507 ورق النسخ |
| الفئة | اللوازم المكتبية |
| الوحدة | 12 × 2500 ورقة |
| سعر الوحدة | 40.75 SEK |
| المورد | متطابقة مع البيانات الرئيسية |
يمكن تنظيم البنود وتصنيفها في الوقت الفعلي، مع ربط البيانات الأساسية بتدفق المعاملات. وهذا يدعم إعداد التقارير وتحليلات الإنفاق وأتمتة العمليات المحاسبية في منتجك. وتتوفر تقنية التعرف الضوئي على الحروف (OCR) والمحاسبة الآلية وإثراء التصنيف كإضافات اختيارية.
مسؤوليات الامتثال لمعايير Peppol
تضطلع شركة «كفاليا» بدور «مزود خدمة Peppol» فيما يتعلق بـ«Peppol المدمج». ويظل الشريك مسؤولاً عن علاقته بعملائه وعروضه التجارية. ولا يجوز تخصيص رقم تعريف مزود الخدمة ( Peppol ID) إلا للكيانات القانونية النشطة.
| المسؤولية | Qvalia | أنت |
| دور مزود خدمات Peppol المعتمد | Qvalia | |
| نقطة الوصول وتشغيل SMP | Qvalia | |
| شهادة Peppol، وعمليات التدقيق، وإدارة الشبكة | Qvalia | |
| نظم إدارة ISO/IEC 27001:2022 و ISO 22301:2019 | Qvalia | |
| التحقق من هوية العملاء | الشركاء | |
| التأكد من أن العملاء ليسوا مسحوبين من السجل، أو معسرين، أو مخالفين لمتطلبات مكافحة غسل الأموال | الشركاء | |
| عقد العميل النهائي، والتسعير، والعلاقة التجارية | الشركاء |
وينطبق هذا على خدمة «Peppol المدمجة» وعلى المنصة ذات العلامة البيضاء. أما الشركاء الذين يحتاجون إلى تولي دور «مزود خدمة Peppol» باسمهم الخاص، فينبغي عليهم الاطلاع على خدمة «نقطة الوصول المستضافة» بدلاً من ذلك.
الأسئلة الشائعة
ماذا يعني مصطلح «Peppol المدمج» في الواقع العملي؟
أنت توفر لعملائك إمكانية الاتصال بشبكة Peppol وتبادل الرسائل التجارية المتوافقة مع المعايير، وذلك من خلال دمج هذه الخدمة في منتجك عبر واجهة برمجة التطبيقات (API). وتقوم شركة Qvalia بتشغيل البنية التحتية لشبكة Peppol في الخلفية. أما أنت فتتولى إدارة العلاقة مع العملاء وتقديم الخدمة.
هل يتعين علينا إدارة الامتثال لمعايير Peppol بأنفسنا؟
لا. مع خدمة «Embedded Peppol»، تتولى «Qvalia» دور مزود خدمة Peppol وتقوم بتشغيل نقطة الوصول (Access Point) ونظام إدارة الخدمات (SMP). وتدير «Qvalia» حوكمة شبكة Peppol والامتثال التقني للخدمة. أما أنت، فتظل مسؤولاً عن عقود العملاء النهائيين، ومعلومات التسجيل، والتسعير، والدعم. أما الشركاء الذين يحتاجون إلى تولي دور مزود الخدمة باسمهم الخاص، فينبغي عليهم النظر في خدمة «Hosted Access Point».
كيف تدعمون إعدادات Peppol متعددة المستأجرين؟
يدعم نظام Qvalia كلاً من النموذج الموحد ونموذج الاستخدام المتعدد. يمكنك إدارة عدة عملاء نهائيين في بيئة مشتركة، أو توفير حسابات منفصلة ومعرّفات Peppol لكل عميل.
ما هي أنواع رسائل Peppol التي يمكننا تقديمها لمستخدمينا وعملائنا النهائيين؟
الفواتير، ومذكرات الائتمان، وأوامر الشراء، وردود أوامر الشراء، وإشعارات الشحن، والكتالوجات، والرسائل التجارية ذات الصلة، بالإضافة إلى خدمة « punchout ». تتولى «Qvalia» مهام التحقق من الصحة، وتوجيه الرسائل، وتسليمها، ومعالجة الأخطاء عبر الشبكة. ويتم معالجة ملفات PDF وEDI من خلال نفس بنية الحساب.
كيف يتم تسجيل العملاء النهائيين وإدارتهم؟
يتم تخصيص معرّفات Peppol وقواعد التوجيه الخاصة بالعملاء النهائيين أثناء عملية التسجيل. تتولى Qvalia إدارة تسجيل المشاركين وتحديثات الدليل وتكوين الشبكة خلف الكواليس، بينما تتولى أنت التحكم في تجربة التسجيل.
هل يتعين علينا إجراء استقصاء بشأن المستندات الواردة؟
لا. اشترك في أحداث الويب هوك ومنشورات Qvalia على نقطة النهاية الخاصة بك عند وصول رسالة أو مستند Peppol، وعندما تتغير حالة التسليم، وعندما يفشل التسليم. تتوفر نقاط النهاية التي تعمل بنظام الاستقصاء كبديل.
هل يمكننا تقديم ما هو أكثر من مجرد تبادل الرسائل؟
نعم. تتوفر كل معاملة في شكل بيانات منظمة مصنفة حسب البنود، وهو ما يتيح لك دمج إعداد التقارير وتحليلات الإنفاق والمحاسبة الآلية في منتجك الخاص، بدلاً من الاكتفاء بنقل المستندات فقط. وتتوفر تقنية التعرف الضوئي على الحروف (OCR) والمحاسبة الآلية وإثراء التصنيف كإضافات اختيارية.
هل توجد حدود على معدل الاستخدام؟
نعم. يتم تخصيص حسابات الشركاء بحدود أعلى بكثير من الحدود القياسية للحسابات العادية، ويتم تعديل الحد وفقًا لحجم المعاملات المتوقع. إذا كنت تخطط لعملية تسجيل كبيرة أو توقع نشاطًا مكثفًا في نهاية الشهر، فيرجى الاتصال بنا.
متى يمكننا البدء؟
عادةً ما يتوفر الوصول إلى بيئة الاختبار (Sandbox) في غضون ساعات. أما إطلاق الإصدار النهائي فيعتمد على عمليات التكامل والاختبار وإجراءات " release " الخاصة بكم.
كيف يتم تنفيذ عملية التكامل؟
تتم دمج المنصة من خلال واجهات برمجة التطبيقات (API) من نوع REST. وتستخدم المصادقة في النظام بيانات اعتماد العميل وفقًا لمعيار OAuth 2.0. ويتم تكوين ميزة تسجيل الدخول الموحد (SSO) للمستخدمين بشكل منفصل من خلال خيارات الهوية المدعومة. وإذا لم تكن بحاجة إلى الواجهة داخل منتجك، فإن المنصة ذات العلامة البيضاء توفر تطبيق Qvalia تحت علامتك التجارية.
حلول بديلة
اختر منصة «العلامة البيضاء» للحصول على تطبيق متكامل، أو «نقطة الوصول المستضافة» عندما تحتاج مؤسستك إلى تولي دور مزود الخدمة.
أنت تريد المنتج، وليس الإصدار
منصة «العلامة البيضاء» هي التطبيق الكامل من Qvalia الذي يعمل تحت علامتك التجارية ونطاقك الإلكتروني وأسعارك. وهي توفر واجهة كاملة دون الحاجة إلى مشروع تطوير.
يجب أن تكون أنت صاحب الحساب، باسمك الخاص
تجعلك «نقطة الوصول المستضافة» مزود خدمة Peppol معتمدًا، مع هوية نقطة وصول خاصة بك وشهادة PKI، وذلك على البنية التحتية التي تديرها Qvalia.
تواصَل معنا
ادمج الفواتير الإلكترونية والطلبات الإلكترونية وإثراء البيانات في منصتك باستخدام Qvalia.
تتيح لك واجهة برمجة التطبيقات (API) الخاصة بشركائنا، وأدوات الإدارة المتطورة، وحلول العلامة البيضاء، تقديم إدارة سلسة للمعاملات لمستخدميك النهائيين.
انضم إلينا لتوسيع نطاق إمكانيات منصتك ودفع عجلة التحول الرقمي. اتصل بنا لمعرفة المزيد.
تبادل المستندات التجارية عبر Peppol وEDI وغيرها
تمكين إثراء البيانات المدعوم بالذكاء الاصطناعي على مستوى كل بند
وسّع نطاق منتجاتك وحسّن سهولة استخدامها