1. الصفحة الرئيسية
  2. قاعدة المعرفة
  3. بيبول
  4. كيفية البحث عن مستلم Peppol عبر واجهة برمجة التطبيقات (API)
  1. الصفحة الرئيسية
  2. قاعدة المعرفة
  3. إدارة البيانات
  4. كيفية البحث عن مستلم Peppol عبر واجهة برمجة التطبيقات (API)

كيفية البحث عن مستلم Peppol عبر واجهة برمجة التطبيقات (API)

قبل أن يقوم نظام تخطيط موارد المؤسسة (ERP) أو منصتك بإرسال فاتورة أو طلب شراء أو أي مستند Peppol آخر، يمكنه الاستعلام من Qvalia عما إذا كان عنوان « Peppol ID » الخاص بالمستلم مسجلاً أم لا، وعن أنواع المستندات التي يمكن للمستلم استلامها. فالمستند الذي يُرسل إلى مشارك غير مسجل لاستلامه يتم رفضه من قبل الشبكة؛ لذا فإن هذا الفحص يتيح لنظامك اكتشاف أي عنوان « Peppol ID » مفقود أو خاطئ قبل إرسال أي شيء.

# واجهة برمجة تطبيقات الحساب GET /account/{accountRegNo}/action/lookup/peppol/{peppolId} # واجهة برمجة تطبيقات الشريك GET /partner/{partnerRegNo}/peppol/lookup/{peppolId}
# Account API
GET /account/{accountRegNo}/action/lookup/peppol/{peppolId}

# Partner API
GET /partner/{partnerRegNo}/peppol/lookup/{peppolId}
واجهة برمجة تطبيقات الحسابواجهة برمجة التطبيقات للشركاء
يستخدمهالشركات التي ترسل من حساب «كفاليا» الخاص بهاالمنصات ومقدمو الخدمات الذين يقومون بالإرسال نيابة عن عملائهم
مرشح اختياريdocTypeRoot، على سبيل المثال Invoice أو CreditNotedocTypeRoot، على سبيل المثال Invoice, OrderResponse أو MLR
عناوين URL الأساسيةصندوق الرمل api-test.qvalia.com، الإنتاج api.qvalia.comصندوق الرمل api-test.qvalia.com، الإنتاج api.qvalia.com

متى يجب التحقق من هوية المستلم

  • عند إنشاء عميل في نظامك، أو عند تغيير عنوانه البريدي ( Peppol ID )
  • عندما يقوم المستخدم بكتابة عنوان Peppol ID يدويًّا
  • قبل إرسال مستند من نوع لم يسبق للمستلم أن تلقى مثله منك من قبل، مثل الرد على الطلب الأول أو إشعار الائتمان

تقديم الطلب

  1. اكتب عنوان Peppol ID على شكل مخطط ومعرّف مفصولين بفاصلة، على سبيل المثال 0007:1234567890 للحصول على رقم تسجيل المنظمة السويدية.
  2. أرسل طلب GET إلى نقطة نهاية البحث، مع إدراج مفتاح API الخاص بك أو JWT في Authorization العنوان.
  3. إضافة docTypeRoot إذا كنت تريد الإجابة الخاصة بنوع مستند واحد، يُشار إليه باسم عنصره الجذري في لغة UBL.
GET /account/{accountRegNo}/action/lookup/peppol/0007:1234567890 ?docTypeRoot=Invoice Host: api-test.qvalia.com Authorization: <your API key>
GET /account/{accountRegNo}/action/lookup/peppol/0007:1234567890
    ?docTypeRoot=Invoice
Host: api-test.qvalia.com
Authorization: <your API key>

اقرأ الرد

الحالةالمعنىماذا تفعل
200المشارك المسجل في Peppol، مع أنواع المستندات التي يمكنه استلامهاأرسل إذا كان نوع المستند الذي تحتاجه مدرجًا في القائمة
422موقع « Peppol ID » غير متوفر حالياً scheme:identifierقم بتصحيح التنسيق، على سبيل المثال 0007:1234567890
429عدد الطلبات على حسابك كبير جدًّاانتظر حتى Retry-After كما هو مذكور في العنوان، ثم أعد المحاولة

تتضمن استجابة واجهة برمجة التطبيقات (API) الخاصة بالشريك أيضًا exists، والذي يوضح ما إذا كان عنوان Peppol ID مسجلاً أم لا، rootDocTypeExists، والذي يحدد ما إذا كان بإمكانه استقبال نوع المستند في docTypeRoot، وقائمة docTypes.

إذا لم يكن المستلم مسجلاً لهذا النوع من المستندات، فاطلب منه تقديم عنوان البريد الإلكتروني الصحيح ( Peppol ID)، أو اتفق معه على طريقة أخرى لتسليم المستند.

التحقق من مستلم واحد يدويًّا

للتحقق من شركة واحدة دون استخدام ميزة التكامل، استخدم البحث عبرPeppol ID .

مواضيع ذات صلة: Peppol SMP و SML · ما هو « Peppol ID »؟ · واجهة برمجة تطبيقات الفواتير · مرجع واجهة برمجة التطبيقات

واجهة برمجة التطبيقات (API) للبحث عن المستلمين

ألم تتصل بواجهة برمجة تطبيقات (API) Qvalia بعد؟

اتصل بنا للحصول على حق الوصول إلى واجهة برمجة التطبيقات (API)، وبذلك سيتمكن نظامك من التحقق من المستلمين قبل كل عملية إرسال.

اتصل بنا للحصول على حق الوصول إلى واجهة برمجة التطبيقات (API)
هل كانت هذه المقالة مفيدة؟
نعم لا

مقالات ذات صلة

هل تحتاج إلى مساعدة؟

ألا تجد الإجابة التي تبحث عنها؟
اتصل بالدعم الفني