الإضافات
التعيين والتصنيف
المبلغ المطلوب لكل مستند
خطوة الدعم
التقاط
تحويل الفواتير بصيغة PDF إلى بيانات منظمة
التصنيف
UNSPSC
النتائج المعروضة حسب معرّف المنتج
المعالجة
غير متزامن
يتم إجراء الاستطلاع كل 30 ثانية على الأكثر
نشر الاقتراحات وتصنيف UNSPSC
يُعد النشر والتصنيف من عمليات الإثراء. أما عملية الاستخراج فهي الخطوة التي تحول فاتورة PDF إلى بيانات منظمة، بحيث يمكن تنفيذ كلتا العمليتين.
اقتراحات للنشر
اقتراحات لتصنيف الحسابات لكل سطر في فاتورة المورد، تم تدريب النظام عليها استنادًا إلى سجل عمليات التسجيل في مؤسستكم. ويقوم فريقكم بالموافقة على كل اقتراح.
تصنيف المنتجات
رموز UNSPSC الخاصة ببنود الفواتير والمنتجات الواردة في الكتالوجات وقوائم الأسعار، حيث يتم إرجاع كل رمز مع معرّف خاص بك.
التصوير كوسيلة دعم
عندما تصل فاتورة بصيغة PDF، يقوم برنامج «Capture» باستخراج بيانات الرأس والبنود التفصيلية أولاً، بحيث تتوفر بيانات منظمة يمكن الاعتماد عليها في عمليات التسجيل والتصنيف.
جمع النتائج
يعرض كل طلب معرّف استطلاع. قم بجمع النتائج حسب نوع الإثراء، مع عدم إجراء الاستطلاع أكثر من مرة واحدة كل 30 ثانية.
تقسيم قائمة المنتجات إلى طلبين
أرسل أسماء المنتجات مع معرّفاتك الخاصة، على سبيل المثال، عناصر من كتالوج أو قائمة أسعار أو سجل العناصر الخاص بك. ستحصل في الرد على معرّف الاستعلام، وستعرض النتيجة كل معرّف منتج مع تصنيفه وفقًا لنظام UNSPSC.
- يتم عرض معرّفات منتجاتك في النتيجة
- تسجيل الدخول باستخدام مفتاح API أو JWT من واجهة برمجة تطبيقات الحساب
- لا تُجرِ الاستطلاع أكثر من مرة واحدة كل 30 ثانية
- عناوين URL منفصلة لبيئة الاختبار وبيئة الإنتاج
● ● ●
طلب "صندوق الرمل": تصنيف المنتجات
curl -X POST \
"https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/categorisation" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"enrichmentTypes": "unspsc",
"products": [
{ "id": 1, "product_name": "Nitrile gloves, size M" },
{ "id": 2, "product_name": "A4 copy paper, 80 g" }
]
}'
# Collect the result with the pollingId
curl "https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/$POLLING_ID" \
-H "Authorization: $QVALIA_API_KEY"نقاط النهاية الخاصة بالتخصيب
جميع المسارات نسبية بالنسبة إلى عنوان URL الأساسي لبيئة الاختبار أو بيئة الإنتاج، وتقتصر نطاقها على رقم تسجيل حسابك.
| طلب | نقطة النهاية | المرتجعات |
| إضافة تفاصيل إلى الفاتورة | 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) الإثراء بشكل منفصل، ويقوم فريق دعم Qvalia بتفعيل ميزات الإثراء التي يستخدمها حسابك.
في الحالات التي تُستخدم فيها البيانات المُثريّة
يُستخدم نشر الاقتراحات ورموز UNSPSC في عمليات أخرى، سواء في منصتك الخاصة أو في Qvalia.
- الحسابات الدائنة
يتم تفعيل ترميز الحساب المحدد مع مرور الفاتورة إلى مراحل الموافقة والتسجيل. - الكتالوجات وقوائم الأسعار
أضف رمز UNSPSC إلى عناصر الكتالوج وقائمة الأسعار التي تفتقر إلى هذا الرمز. - يتيح لك تحليل الإنفاق
ورموز UNSPSC تجميع المشتريات حسب القطاع والمجموعة والفئة عبر الموردين. - منصتك الخاصة
: اعرض الاقتراحات والتصنيفات على مستخدميك من خلال واجهتك الخاصة.
اختر نقطة انطلاقك
النشر
API المحاسبة
كيف يتم تدريب فريقك على تقديم الاقتراحات، ومراجعتها، والتأكد منها.
بيانات المنتج
تصنيف UNSPSC
كيف تقوم «كفاليا» بتصنيف بنود الفواتير وبيانات المنتجات باستخدام نظام UNSPSC.
التقاط
API التعرف الضوئي على الحروف
خطوة الاستيلاء بحد ذاتها، مع اختبار مجاني لفاتورتك بصيغة PDF.
الأسئلة الشائعة حول واجهة برمجة تطبيقات (API) الإثراء
ما هي واجهة برمجة تطبيقات Enrichment؟
واجهة برمجة تطبيقات REST تتضمن ميزتين إضافيتين: تقديم اقتراحات لتسجيل فواتير الموردين، وتصنيف بنود الفواتير والمنتجات وفقًا لنظام UNSPSC. وتُعد عملية «Capture» خطوة داعمة تعمل على تحويل فواتير PDF إلى بيانات منظمة قبل إجراء عملية التسجيل والتصنيف.
لماذا يُعتبر «التقاط» خطوة داعمة؟
عملية قيد البيانات وتصنيفها على البيانات المنظمة. الفواتير التي تصل في صيغة Peppol أو مستندات XML أخرى تحتوي على هذه البيانات بالفعل. يتم أولاً استخراج الفاتورة بصيغة PDF، بحيث يمكن قيد بيانات رأس الفاتورة وبنودها وتصنيفها. كما تتوفر ميزة الاستخراج بشكل مستقل من خلال واجهة برمجة تطبيقات التعرف الضوئي على الحروف (OCR).
كيف تعمل اقتراحات النشر؟
يتم تدريب النظام على الفواتير التي قامت مؤسستكم بتسجيلها بالفعل. وتُقترح تصنيفات حسابية لكل سطر في كل فاتورة جديدة من الموردين، ويقوم فريقكم بتأكيدها. اقرأ المزيد على صفحة واجهة برمجة تطبيقات المحاسبة (API).
هل يمكنني تصنيف الكتالوجات وقوائم الأسعار؟
نعم. يتطلب طلب التصنيف قائمة بالمنتجات، بحيث يكون لكل منتج معرّف خاص به واسم المنتج، لذا يتم إرسال العناصر الواردة في الكتالوج أو قائمة الأسعار أو سجل العناصر أو بنود الفاتورة بنفس الطريقة.
ما هي التصنيفات التي يستخدمها التصنيف؟
UNSPSC. تعرض النتيجة كل معرّف منتج مع تصنيفه، بحيث يمكنك مطابقته مع سجلاتك الخاصة.
هل توجد منطقة تجارب؟
نعم. استخدم api-test.qvalia.com للاختبار، وapi.qvalia.com في بيئة الإنتاج.
هل واجهة برمجة التطبيقات (API) الخاصة بـ«Enrichment» مضمنة في واجهات برمجة التطبيقات الأخرى الخاصة بـ«Qvalia»؟
لا. يتم احتساب تكلفة واجهة برمجة تطبيقات (API) الإثراء بشكل منفصل، كما أنها تتطلب أذونات إضافية. ويقوم فريق دعم Qvalia بتمكين ميزات الإثراء التي يستخدمها حسابك.
