توثيق API, InvoiceIntelligencePack

واجهة API غير متزامنة: حزمة ذكاء الفواتير بالذكاء الاصطناعي

حمّل فاتورة مورد أو إيصالاً. يستخرج العامل النص المضمن أو يشغل OCR، ثم ينشئ حقولاً جاهزة للمحاسبة وملفات CSV لبنود الفاتورة وعمليات التحقق وموجز مراجعة وJSON قابلاً للتنزيل. تحقق من كل المخرجات قبل القيد المحاسبي أو الإقرار الضريبي أو الدفع.

نقطة النهاية: POST https://mxprocess.com/api/files/start-process
المصادقة: JWT من نوع Bearer من POST /api/login_check
التكلفة: 120 رموز، تُحصّل بعد النجاح.

الاستجابة الأولية والاستطلاع

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'file=@"/path/to/invoice.pdf"' \
--form 'actionName="InvoiceIntelligencePack"' \
--form 'parameters=[["language",["English"]],["currency",["EUR"]]]' \
--form 'async=true'

مقبول: PDF وPNG وJPG وTIFF. حمّل ملفاً واحداً بالضبط، حتى 40 ميغابايت. language القيمة الافتراضية English؛ currency والكشف التلقائي هو الافتراضي.

الاستجابة الأولية والاستطلاع

{"id":123,"action":{"actionName":"InvoiceIntelligencePack","slug":"ai-invoice-intelligence-pack"},"accomplished":false,"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

استعلم عن /api/actions/get-action-infos/123 باستخدام JWT نفسه. عند الاكتمال، actionResults يحتوي على TXT المصدر وMarkdown المراجعة وCSV البنود وCSV الفحوصات وJSON. نزّل كل أثر، بما فيه JSON، عبر /api/actions/download-action-result/123/FILENAME.

مثال على خطأ وظيفي

{"error":"ERROR_IIP004 Invoice Intelligence Pack accepts PDF, PNG, JPG and TIFF files only."}

للملفات القصيرة استخدم واجهة API متزامنة.

اتصل بنا