تُضيف واجهة برمجة التطبيقات (API) الخاصة بالإثراء بيانات منظمة إلى فواتير الموردين وبيانات المنتجات. وتشتمل على نوعين من الإثراء: «اقتراحات الترحيل»، التي تقترح ترميز الحسابات لكل بند في فاتورة المورد، و«تصنيف المنتجات»، الذي يخصص رموز UNSPSC لبنود الفواتير وللمنتجات الواردة في الكتالوجات وقوائم الأسعار.
| إثراء بيانات | ما ترسله | ما ستحصل عليه في المقابل |
| اقتراحات للنشر | فاتورة مورد | الترميز المقترح للحسابات لكل بند في الفاتورة، لكي يقوم فريقكم بالتأكيد عليه |
| تصنيف المنتجات | المنتجات التي تحمل رقم تعريف خاص بك واسم المنتج، أو بنود الفاتورة | رمز UNSPSC لكل منتج، يُرفق مع رقم التعريف الخاص بك |
| التسجيل (خطوة داعمة) | فاتورة بصيغة PDF | بيانات العنوان وبنود الفاتورة كبيانات منظمة |
تقوم ميزة «Capture» بتحويل فاتورة PDF إلى بيانات منظمة، بحيث تتوفر البيانات اللازمة لعمليات الإثراء. أما الفواتير التي تصل بصيغة Peppol أو مستندات XML أخرى، فتتخطى هذه الخطوة. كما تتوفر ميزة «Capture» بشكل مستقل باعتبارها واجهة برمجة تطبيقات (API) للتعرف الضوئي على الحروف (OCR).
كيفية عمل الطلب
- أرسل طلب POST إلى نقطة النهاية الخاصة بالفاتورة أو التصنيف.
- قم بتخزين معرّف الاستقصاء الذي تم إرجاعه في الرد.
- احصل على النتيجة باستخدام طلب GET، بحد أقصى مرة واحدة كل 30 ثانية.
- استرجع النتائج لجميع أنواع الإثراء دفعة واحدة، أو لنوع واحد منها.
● ● ●
نقاط النهاية
POST /enrichment/{accountRegNo}/invoice
POST /enrichment/{accountRegNo}/categorisation
GET /enrichment/{accountRegNo}/{pollingId}
GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}صندوق الرمل موجود في api-test.qvalia.com والإنتاج في api.qvalia.com. تتم مصادقة الطلبات باستخدام مفتاح واجهة برمجة التطبيقات (API) أو توقيع JWT من واجهة برمجة تطبيقات الحساب.
أين تُستخدم النتائج
- الحسابات الدائنة: تنتقل الترميزات المؤكدة للحسابات مع الفاتورة إلى مراحل الموافقة والتسجيل.
- الكتالوجات وقوائم الأسعار: أضف رموز UNSPSC إلى العناصر التي تفتقر إليها.
- تحليل الإنفاق: المشتريات الجماعية حسب قطاع UNSPSC، والمجموعة، والفئة، عبر الموردين.
- منصتك الخاصة: اعرض الاقتراحات والتصنيفات عبر واجهتك الخاصة.
الوصول
يتم احتساب تكلفة واجهة برمجة تطبيقات (API) الإثراء بشكل منفصل، وهي تتطلب أذونات إضافية. ويقوم فريق دعم Qvalia بتمكين ميزات الإثراء التي يستخدمها حسابك.
مواضيع ذات صلة: كيفية عمل اقتراحات النشر · كيفية عمل تصنيف UNSPSC · كيفية عمل استخراج ملفات PDF · مرجع واجهة برمجة التطبيقات (API)
