الإدخال
فاتورة بصيغة PDF أو XML
ملف واحد لكل طلب، مشفر بتنسيق Base64
الإخراج
بيانات الفواتير المنظمة
بيانات الرأس والبنود التفصيلية
المعالجة
غير متزامن
استطلاع مع معرّف استطلاع، بحد أقصى مرة كل 30 ثانية
الوصول
بيئة الاختبار وبيئة الإنتاج
يتم احتساب تكلفتها بشكل منفصل، بفضل دعم Qvalia
تسجيل فاتورة في طلبين
قم بترميز الملف باستخدام Base64، ثم أرسله مع تعيين «enrichmentTypes» على «capture»، واجمع النتيجة باستخدام معرّف الاستقصاء الموجود في الرد.
- ملف فاتورة واحد لكل طلب، بصيغة PDF أو XML
- أدرج امتداد الملف في اسم الملف
- لا تُجرِ الاستطلاع أكثر من مرة واحدة كل 30 ثانية
- احصل على نتيجة الالتقاط فقط باستخدام مسار enrichmentType
● ● ●
طلب "Sandbox": استخراج فاتورة
# capture-request.json
{
"fileName": "invoice.pdf",
"fileContent": "<Base64-encoded PDF>",
"enrichmentTypes": "capture"
}
curl -X POST \
"https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/invoice" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-d @capture-request.json
# Collect the result with the pollingId
curl "https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/$POLLING_ID/capture" \
-H "Authorization: $QVALIA_API_KEY"جرب التقاط صورة لفاتورتك بصيغة PDF بنفسك
قم بتحميل فاتورة بصيغة PDF بحجم يصل إلى 4.5 ميغابايت في اختبار الاستخراج المجاني من Qvalia واطلع على البيانات المنظمة التي يعرضها. لا حاجة إلى أي تكامل، كما يتوفر تقرير نموذجي إذا لم يكن لديك ملف في متناول اليد.
كيفية عمل عملية التقاط الفواتير
عملية الاستيراد تتم بشكل غير متزامن. تقوم بتحميل الملف، ثم تقوم Qvalia بمعالجته، وتستلم النتيجة عندما تصبح جاهزة.
تحميل
أرسل فاتورة واحدة بصيغة PDF أو XML لكل طلب، مشفرة بتشفير Base64، إلى نقطة نهاية الفاتورة.
التقاط
تقوم «كفاليا» بقراءة المستند واستخراج بيانات الرأس والبنود الفردية وتحويلها إلى بيانات فاتورة منظمة.
استطلاع الرأي
استخدم معرّف الاستعلام. تشير القيمة 202 إلى أن المعالجة مستمرة، بينما تشير القيمة 200 إلى إرجاع النتيجة.
مراجعة
تحقق من الأخطاء والتحذيرات التي تم إرجاعها لكل مستند قبل أن تنتقل البيانات إلى المرحلة التالية من العملية.
نقاط النهاية الملتقطة
جميع المسارات نسبية بالنسبة إلى عنوان URL الأساسي لبيئة الاختبار أو بيئة الإنتاج، وتقتصر نطاقها على رقم تسجيل حسابك.
| طلب | نقطة النهاية | المرتجعات |
| تحميل فاتورة | POST /enrichment/{accountRegNo}/invoice | رقم الاستطلاع |
| عرض جميع النتائج | GET /enrichment/{accountRegNo}/{pollingId} | الحالة، أو النتائج حسب النوع |
| الحصول على نتيجة الالتقاط | GET /enrichment/{accountRegNo}/{pollingId}/capture | نتيجة الالتقاط |
صندوق الرمل: api-test.qvalia.com. الإنتاج: api.qvalia.com. تعد ميزة «Capture» جزءًا من واجهة برمجة تطبيقات «Enrichment API»، والتي يتم احتساب تكلفتها بشكل منفصل ويتم تفعيلها من قِبل فريق دعم Qvalia.
ما الذي يجب التخطيط له في عملية الدمج
تتم عمليات التسجيل خارج دورة الطلبات الخاصة بك. يجب التخطيط لهذه النقاط قبل بدء التشغيل الفعلي.
- المعالجة غير المتزامنة
قم بتخزين معرّف الاستقصاء مع المستند، ولا تقم بالاستقصاء أكثر من مرة واحدة كل 30 ثانية. - الأخطاء والتحذيرات
: قم بتوجيه المستندات التي تحتوي على أخطاء إلى المراجعة اليدوية، واجعل التحذيرات ظاهرة للمستخدم. - حدود معدل الاستخدام
يتم احتساب الحدود لكل حساب عبر جميع واجهات برمجة تطبيقات Qvalia. في حالة ظهور رمز الخطأ 429، يرجى الانتظار حتى انقضاء فترة «Retry-After». - بيئات منفصلة
قم بإجراء الاختبار على api-test.qvalia.com قبل الانتقال إلى api.qvalia.com. - معرّفات الاقتراع منتهية الصلاحية
تعني رسالة الخطأ 404 أن معرّف الاقتراع غير معروف أو منتهي الصلاحية. قم بتحميل المستند مرة أخرى إذا لم يتم تسجيل النتيجة مطلقًا.
اختر نقطة انطلاقك
في تطبيق الويب
التعرّف الضوئي على الحروف في الفواتير
يمكنك استيراد فواتير PDF إلى تطبيق الويب Qvalia دون الحاجة إلى إنشاء تكامل.
التعيين والتصنيف
API إثراء البيانات
نشر الاقتراحات وتصنيف UNSPSC. عملية «Capture» هي الخطوة الداعمة التي تعمل على تجهيز فواتير PDF لكليهما.
البدء
دليل البدء السريع لواجهة برمجة التطبيقات (API)
قم بإعداد الوصول إلى واجهة برمجة التطبيقات (API) وأرسل طلبك الأول، خطوة بخطوة.
الأسئلة الشائعة حول واجهة برمجة تطبيقات التعرف الضوئي على الحروف (OCR) للفواتير
ما هي واجهة برمجة تطبيقات التعرف الضوئي على الحروف (OCR) للفاتورات؟
واجهة برمجة تطبيقات REST تعمل على تحويل الفواتير بصيغة PDF إلى بيانات فواتير منظمة. وهي تعمل كنوع من أنواع الاستخراج في واجهة برمجة تطبيقات «Enrichment API».
ما هي الملفات التي يمكنني إرسالها؟
فاتورة واحدة بصيغة PDF أو XML لكل طلب، مشفرة بـ Base64 في حقل fileContent. يجب تضمين امتداد الملف في حقل fileName.
ما الذي تعيده واجهة برمجة التطبيقات (API)؟
بيانات الفاتورة المنظمة التي تتضمن بيانات الرأس وبنود الفاتورة، إلى جانب الأخطاء والتحذيرات المتعلقة بالوثيقة.
كم من الوقت يستغرق عملية الالتقاط؟
تتم المعالجة بشكل غير متزامن، لذا يختلف الوقت حسب كل مستند. لا تقم بالاستعلام عن نقطة نهاية النتيجة أكثر من مرة واحدة كل 30 ثانية حتى تحصل على رمز حالة 200.
ما الفرق بين واجهة برمجة تطبيقات OCR وخدمة التعرف الضوئي على الحروف (OCR) للفواتير؟
يتم التقاط بيانات الفواتير باستخدام تقنية التعرف الضوئي على الحروف (OCR) في تطبيق الويب «Qvalia». وتتيح واجهة برمجة التطبيقات (API) الخاصة بتقنية التعرف الضوئي على الحروف (OCR) لنظامك التقاط البيانات عبر واجهة برمجة تطبيقات REST.
هل توجد منطقة تجارب؟
نعم. استخدم api-test.qvalia.com للاختبار، وapi.qvalia.com في بيئة الإنتاج.
هل واجهة برمجة تطبيقات (API) OCR مضمنة في واجهات برمجة تطبيقات Qvalia الأخرى؟
لا. تعد ميزة «Capture» جزءًا من واجهة برمجة تطبيقات «Enrichment API»، والتي يتم احتساب تكلفتها بشكل منفصل. ويقوم فريق دعم Qvalia بتفعيلها لحسابك.
