بيبول هي شبكة دولية مفتوحة للتعامل بين الشركات (B2B) تتيح للمؤسسات تبادل المستندات التجارية المنظمة، مثل الطلبات والفواتير، بكفاءة.
يعد فهم المواصفات الفنية لـ Peppol وعملية تنفيذها أمرًا بالغ الأهمية للمطورين من أجل بناء أنظمة قوية تعزز كفاءة المؤسسات. يوضح هذا الدليل المفاهيم الأساسية والإرشادات الفنية التي تساعد المطورين على البدء في استخدام الطلبات الإلكترونية عبر Peppol.
ما هو Peppol؟
Peppol (الشبكة الأوروبية الموحدة للمشتريات العامة عبر الإنترنت) هو إطار عمل يعمل على توحيد معايير تبادل المستندات الإلكترونية بين الشركات والهيئات العامة. وهو ليس نظامًا لإدارة موارد المؤسسات (ERP) أو بوابة إلكترونية أو منصة للمشتريات، بل بروتوكول يتيح التوافق التشغيلي بين الأنظمة المختلفة.
تستخدم Peppol نموذج الأركان الأربعة، مما يعني أن كل مؤسسة تتصل بالشبكة من خلال مزود نقطة الوصول إلى Peppol الذي تختاره، مما يلغي الحاجة إلى مواءمة مزودي الخدمات مع الشركاء التجاريين.
الميزات الرئيسية لـ Peppol هي:
- التوحيد القياسي: لغة موحدة للوثائق التجارية في مختلف القطاعات.
- التوافق التشغيلي: التوافق بين الأنظمة على مستوى العالم.
- قابلية التوسع: يمكن التواصل بسهولة مع شركاء جدد دون الحاجة إلى تطوير إضافي.
توفر Peppol للمطورين إطار عمل لدمج معالجة الطلبات الإلكترونية المنظمة في العمليات التجارية الحالية.
البدء في استخدام نظام الطلبات Peppol
يتطلب تطبيق الطلبات الإلكترونية عبر Peppol فهم " مواصفات التوافق بين الأنظمة التجارية" (BIS) الخاصة بها، وبناء جمل الرسائل، ومتطلبات تبادل البيانات.
فيما يلي تفصيل للخطوات الست الأساسية والاعتبارات الفنية المتعلقة بها.
1. فهم العناصر الأساسية
يجب على المطورين الذين يقومون بتنفيذ فواتير Peppol أن يفهموا كيفية ملء عناصر cbc بشكل صحيح وفقًا لإرشادات Peppol BIS لضمان توافق المستندات ونجاح عملية الإرسال.
في سياق Peppol وبنية UBL (اللغة التجارية العالمية) الخاصة بالفواتير، يُقصد بـ cbc Basic المشتركة". وتمثل عناصر البيانات المحددة مسبقًا ضمن مخطط UBL اللبنات الأساسية القابلة لإعادة الاستخدام في المستندات التجارية مثل الفواتير والأوامر ورسائل إشعار الشحن.
الميزات الرئيسية لعناصر cbc
- أنواع البيانات البسيطة: عادةً ما تكون عناصر cbc عناصر أساسية وتمثل بيانات بسيطة مثل النصوص أو القيم الرقمية أو التواريخ أو الرموز.
- Basic : تضم هذه البيانات نقاطًا أساسية ومباشرةً مثل المعرّفات والتواريخ والمبالغ النقدية أو الأوصاف.
- إمكانية إعادة الاستخدام: صُممت هذه المكونات بحيث يمكن إعادة استخدامها عبر أنواع مختلفة من مستندات UBL.
2. اختر ملف تعريف Peppol BIS للطلبات
يدعم Peppol ثلاث مواصفات أساسية، تُعرف أيضًا باسم "الملفات التعريفية"، لعمليات الطلبات. وقد صُممت كل مواصفة من هذه المواصفات لحالات استخدام محددة، ويجب على الشركاء التجاريين الاتفاق على أي منها سيتم استخدامه.
BIS Order Only: لتقديم الطلبات البسيطة دون رد من المورد.
BIS Ordering: يتضمن ردودًا على الطلبات لتأكيد القبول أو الرفض أو القبول الجزئي.
BIS Despatch Advice: يُعلم المشتري بتفاصيل الشحنة.
3. فهم صيغة طلبات Peppol
تتبع معاملة طلب الشراء عبر Peppol (T01) معيار UBL (اللغة التجارية العالمية) .
لتنفيذ Peppol بفعالية، يحتاج المطورون إلى فهم شامل لكيفية ملء عناصر cbc وفقًا لإرشادات Peppol BIS، مما يضمن الامتثال وقابلية الإرسال السلس. ويعد الالتزام بالبنية النحوية المطلوبة لجميع عناصر المستند أمرًا ضروريًا، حيث إن أي انحراف عن قواعد التحقق من صحة Peppol قد يؤدي إلى أخطاء تعطل عملية الطلب.
فيما يلي بعض الأمثلة على العناصر الأساسية لوثائق الطلبات:
| عنصر UBL | الوصف |
| cbc:ID | معرّف فريد للطلب. |
| cbc:رمز_نوع_الطلب | يحدد نوع الطلب، مثل أمر الشراء. |
| cbc:رمز_عملة_المستند | تشير إلى العملة (مثل "EUR"). |
| cac:فترة_الصلاحية | يشير إلى تاريخ انتهاء صلاحية الطلب. |
خصائص عناصر فحص الدم الكامل
تمثيل البيانات: تمثل عناصر cbc عادةً حقول بيانات فردية، مما يجعلها سهلة الاستخدام والتحقق من صحتها.
السمات: تتضمن بعض عناصر cbc سمات مثل currencyID (للمبالغ) أو unitCode (للكميات).
إلزامية/اختيارية: تحدد إرشادات Peppol BIS (مواصفات التوافق بين الأعمال) عناصر cbc التي تعتبر إلزامية أو اختيارية أو مطلوبة بشروط.
مقارنة مع مكونات التجميع المشتركة (CAC)
في حين تمثل عناصر cbc المكونات الأساسية، تُستخدم عناصر cac (المكونات المجمعة المشتركة) في هياكل البيانات المعقدة التي تجمع بين عناصر cbc ذات الصلة وعناصر cac أخرى. على سبيل المثال، تجمع عناصر cac:Party جميع المعلومات المتعلقة بكيان تجاري، مثل اسمه وعنوانه ومعرّفاته.
لمزيد من التفاصيل حول عناصر cbc المحددة المستخدمة في طلبات Peppol UBL، يرجى الاطلاع على BIS Ordering الرسمية الخاصة بـ Peppol BIS Ordering .
3. التكامل مع نقطة وصول Peppol
يتم توزيع معاملات Peppol عبر نقاط وصول Peppol المعتمدة، والتي تُعرف أيضًا باسم مزودي خدمات Peppol. وبصفتك مطورًا، يجب أن يتصل تطبيقك بواجهة برمجة التطبيقات (API) الخاصة بأحد المزودين من أجل إرسال المستندات واستلامها. وتقوم نقاط الوصول بمعالجة التعقيدات التقنية المتعلقة بتوجيه الرسائل من وإلى الشركاء التجاريين.
تعرف على المزيد حول الوصول إلى طلبات Peppol عبر واجهة برمجة تطبيقات الطلبات (Order API).
4. تنفيذ عمليات التحقق من الصحة ومعالجة الأخطاء
يضمن التحقق من الصحة الامتثال لقواعد Peppol ومتطلبات BIS. قم بتنفيذ عمليات تحقق قوية من الصحة لتحديد الأخطاء قبل الإرسال. على سبيل المثال، تحقق من الحقول الإلزامية مثل cbc:ID و cbc:DocumentCurrencyCode. التحقق من صحة تنسيقات البيانات، بما في ذلك التواريخ والعملات والمعرّفات.
تتوفر عمليات التحقق من صحة التنسيقات بشكل مدمج وتلقائي لمستخدمي نقطة وصول Peppol من Qvalia.
5. الاختبار في بيئة تجريبية
قبل نشر الحل الخاص بك، اختبر عملية التكامل في بيئة تجريبية يوفرها مزود خدمة نقطة الوصول. وهذا يتيح لك محاكاة سيناريوهات متنوعة، مثل تقديم الطلبات وتلقي الردود وإدارة رسائل إشعار الشحن.
نظرة فنية: بنية أوامر Peppol
تعتمد طلبات Peppol على مخططات UBL القائمة على لغة XML. وفيما يلي لمحة موجزة عن العناصر الأساسية في بنية الطلب:
رأس المستند
يحتوي العنوان على بيانات وصفية مهمة تتعلق بالطلب.
| عنصر UBL | الوصف |
| <cbc:ID> | معرّف فريد لوثيقة الطلب (مثل "1234567"). |
| <cbc:IssueDate> | تاريخ إصدار مستند الطلب (على سبيل المثال، «2024-08-14»). |
| <cbc:OrderTypeCode> | يشير إلى نوع الطلب، حيث يمثل الرقم «220» عادةً أمر شراء. |
| <cbc:DocumentCurrencyCode> | يحدد العملة المستخدمة في مستند الطلب (على سبيل المثال، "EUR"). |
معلومات عن المشتري والبائع
يتم تعريف المشتري والبائع باستخدام شرائح cac:BuyerCustomerParty و cac:SellerSupplierParty.
| عنصر UBL | الوصف |
| <cac:BuyerCustomerParty> | يمثل المشتري في المعاملة، ويتضمن تفاصيل عن طرف العميل. |
| <cac:Party> | يقدم معلومات عن طرف المشتري، مثل بيانات التعريف والأسماء. |
| <cbc:EndpointID schemeID=”0088″> | العنوان الإلكتروني للمشتري، حيث يشير "schemeID" إلى نوع المعرّف (مثل "GLN" في هذه الحالة). |
| <cac:PartyName> | يحتوي على الاسم التجاري للمشتري. |
| <cbc:Name> | يحدد اسم المشتري (على سبيل المثال، "اسم المشتري"). |
أسطر الطلب
يحدد كل سطر في الطلب الأصناف والكميات والأسعار.
| عنصر UBL | الوصف |
| <cac:OrderLine> | يمثل سطراً فردياً في الطلب، ويتضمن تفاصيل عن السلعة وكميتها. |
| <cbc:ID> | معرّف فريد لسطر الطلب (مثل "1"). |
| <cbc:Quantity unitCode=”EA”> | يحدد عدد العناصر في سطر الطلب، حيث يحدد «unitCode» وحدة القياس (على سبيل المثال، «50» وحدة، تُقاس بـ «القطعة»). |
| <cac:Item> | يحتوي على تفاصيل حول المنتج الذي تم طلبه. |
| <cbc:Name> | اسم العنصر أو وصفه (مثل: «اسم المنتج»). |
| <cac:SellersItemIdentification> | يقدم معرّف البائع الخاص بالمنتج. |
| <cbc:ID> | المعرّف الفريد الذي يحدده البائع للمنتج (على سبيل المثال، "87654321"). |
الميزات المتقدمة: مستندات إشعار الشحن
تتيح BIS Despatch Advice للموردين إطلاع المشترين على تفاصيل الشحنة.
يمكن أن تتضمن الرسالة ما يلي:
| عنصر UBL | الوصف |
| <cac:DespatchAdvice> | العنصر الأساسي الذي يمثل مستند إشعار الشحن بأكمله، ويُستخدم لإخطار المستلم بتفاصيل الشحنة. |
| <cbc:ID> | معرّف فريد لوثيقة إشعار الشحن (على سبيل المثال، «654321») |
| <cbc:IssueDate> | تاريخ إصدار مستند إشعار الشحن (على سبيل المثال، «2024-08-20») |
| <cac:Delivery> | يحتوي على تفاصيل حول تسليم الشحنة. |
| <cac:DeliveryLocation> | يحدد الموقع الذي سيتم تسليم الشحنة إليه. |
<cbc:ID> (داخل DeliveryLocation) | المعرف الفريد لموقع التسليم (مثل "معرف المستودع"). |
| <cbc:Name> | اسم موقع التسليم (مثل "اسم المستودع"). |
أفضل الممارسات للمطورين
اتبع إرشادات Peppol BIS: التزم دائمًا بالوثائق الرسمية لـ Peppol BIS لضمان الامتثال.
تعامل مع الاختلافات المحلية: على الرغم من أن Peppol معيار عالمي، فقد تتطلب بعض القطاعات أو المناطق تعديلات محددة.
أتمتة عملية التحقق من الصحة: قم بتنفيذ عمليات فحص آلية للتأكد من صحة الصيغة والمحتوى قبل الإرسال.
تأمين البيانات: تأكد من أن جميع البيانات المرسلة تتوافق مع اللائحة العامة لحماية البيانات (GDPR) ولوائح الخصوصية الأخرى.
يوفر Peppol إطار عمل قويًا للطلبات الإلكترونية، مما يمكّن الشركات من تبسيط العمليات وتحسين دقة البيانات. بالنسبة للمطورين، يعد فهم المواصفات الفنية لـ Peppol BIS ومخططات UBL وتكامل نقاط الوصول أمرًا حيويًا لإنشاء حلول قابلة للتطوير وفعالة.
مقالات ذات صلة
لقد انتقلت معظم الشركات بالفعل من العمل الورقي إلى الرقمي، لكن الكثير منها لا يزال يعاني من استخدام أدوات غير متكاملة، وإجراءات يدوية، وأدوات غير كافية مدمجة في أنظمة تخطيط موارد المؤسسات (ERP)، …
نحن نطلق "Connect" — الأداة الإلكترونية وواجهة برمجة التطبيقات (API) الخاصة بالرسائل التجارية، والتي تهدف إلى جعل الفوترة الإلكترونية وإدارة الطلبات أسهل وأسرع وأكثر فعالية من حيث التكلفة لكل شركة.
أصبحت حلول شبكات القيمة المضافة (VAN) والتقنيات القديمة المستخدمة في المراسلات التجارية — أي تبادل المستندات التجارية الإلكترونية — تتخلف بشكل متزايد عن الركب أمام البدائل التي توفر إدارة معاملات أكثر سلاسة وسهولة في الوصول إليها وفعالية من حيث التكلفة.