طبقة المستندات بين نظام ERP وأدواتك
Arhivix نظام لإدارة المستندات مع REST API v1 وwebhooks موقّعة وخادم MCP، من تطوير NOTIX DOO في بلغراد. يستلم المستندات، ويقرؤها بتقنية OCR والذكاء الاصطناعي، ويطلب من شخص تأكيد القيم التي تحددها للمراجعة، ثم يمرر البيانات إلى نظام ERP وأدواتك.
يُستضاف على AWS في الاتحاد الأوروبي (فرانكفورت ودبلن). تُعدّ كل عملية أعمال جديدة داخل التطبيق على شكل أنواع مستندات وسير عمل وسجلّات بيانات، فتبقى الشيفرة التي تكتبها صغيرة: مستقبِل واحد بجوار نظام ERP.
آخر مراجعة: . رُوجعت المعلومات مقابل إصدار التطبيق في ذلك اليوم.
موقع Arhivix حين تحمل المستندات البيانات
تصل فواتير الموردين وإشعارات التسليم وأوامر الشراء والشهادات والعقود ملفاتِ PDF ومسوحات ضوئية، بينما ينتظر نظام ERP قيودًا نظيفة. يتولى Arhivix جانب المستندات من هذا الربط، في ست خطوات.
-
تصل المستندات
بالرفع، أو من صناديق بريد الشركة عبر Gmail أو Microsoft 365 أو IMAP، أو من ماسح ضوئي مكتبي، أو بكاميرا الهاتف، أو من برنامجك عبر API. ويستلم Arhivix المستندات أيضًا من OneDrive وSharePoint وGoogle Drive، ومن bucket في Amazon S3 أو حاوية Azure Blob.
-
يقرؤها Arhivix
يحوّل OCR المسوحات الضوئية إلى نص. ويتعرّف نموذج لغوي على نوع المستند ويقترح الحقول: المورّد والمشتري والأرقام الضريبية والمبالغ وضريبة القيمة المضافة والتواريخ والأرقام في الفاتورة، أو الأطراف والتواريخ ومهلة الإشعار والقيمة وشروط الدفع في العقد.
-
يؤكد شخص القيم
تبقى القيمة المقروءة اقتراحًا إلى أن تتحقق قاعدة المراجعة الخاصة بها. لكل حقل في نوع المستند تختار القاعدة: تلقائي، أو يحتاج إلى مراجعة، أو يجب تأكيده. ويقارن المراجعون القيم بالأصل ويؤكدونها حقلًا حقلًا.
-
تتقدم المعالجة
يتحقق سير العمل من الشروط، ويرسل المستند للموافقة إلى شخص أو دور، ويؤرشفه، ويضيفه إلى ملف أعمال، ويتابع موعده النهائي.
-
يتلقى برنامجك الإشعار
ترسل خطوة في سير العمل رسالة موقّعة إلى المستقبِل، فيقرأ المستقبِل القيد عبر REST API. وتصل أيضًا عمليات الرفع والمستندات الجديدة والفواتير والبريد الإلكتروني على شكل أحداث webhook موقّعة وفي موجز التغييرات.
-
يبقى ERP النظام المرجعي للبيانات
يكتب المستقبِل في نظام ERP عبر آلية الاستيراد التي يدعمها. وحين يحتاج سير العمل إلى إثبات أن نظام ERP قبِل القيد، يطلب تأكيدًا خارجيًا وينتظر استدعاءك الراجع الموقّع.
نظام ERP لديك
- نظام ERP قديم، أو نظام محاسبة، أو نظام أعمال متخصص
- يبقى النظام المرجعي للبيانات
آلية الاستيراد التي يدعمها نظام ERP
المستقبِل لديك
- يتحقق من التوقيع
- يقرأ القيد عبر API
- يكتب عبر آلية الاستيراد التي يدعمها نظام ERP
webhooks موقّعة وREST API
Arhivix
- الاستلام
- القراءة بتقنية OCR والذكاء الاصطناعي
- التأكيد من شخص
- سير العمل والموافقات
- ملفات الأعمال
- التخزين والإصدارات وسجل التدقيق
Webhooks وREST API وMCP
الأدوات والمساعدون
- إشعارات Microsoft Teams
- Zapier وMake وn8n وPower Automate عبر خطوات webhook وHTTP فيها
- Claude وClaude Code وCodex عبر MCP
ربط نظام ERP قديم لا يملك API
يبقى نظام ERP كما هو. وتستمر المستندات في الوصول بالطريقة نفسها التي تصل بها اليوم، ويتكوّن جانب ERP من الربط من المستقبِل لديك وآلية الاستيراد التي يدعمها نظام ERP أصلًا.
- البريد الإلكتروني والمسوحات الضوئية: يواصل الموردون إرسال ملفات PDF، ويقرؤها Arhivix من صندوق البريد أو الماسح الضوئي أو الهاتف.
- مستقبِل صغير، أي برنامج وسيط خاص بك بجوار نظام ERP: يستقبل webhooks موقّعة أو يستطلع
GET /events، ويقرأ القيد عبر API، ثم يكتبه بآلية الاستيراد التي يوفرها نظام ERP نفسه، مثل إسقاط ملف في مجلد، أو جدول مرحلي، أو SDK الخاص بمورّده. - SAP Business One: تربطه من الإعدادات عبر SAP Service Layer، ويقرأ منه Arhivix كل 15 دقيقة شركاء الأعمال والأصناف والمستودعات وأوامر الشراء وأذونات الاستلام والفواتير.
- الأدوات التي تملك مشغّل webhook وخطوة HTTP، مثل Zapier وMake وn8n وPower Automate: تستقبل الحدث وتقرأ القيد عبر API.
- Microsoft Teams: تتلقى القناة رسالة عند إنشاء فاتورة أو الموافقة عليها أو رفضها، وعند طلب الموافقة على فاتورة أو إتمامها، وعند إنشاء استثناء.
- الاتجاه المعاكس: يرسل سير العمل رسالة موقّعة إلى نظامك، ويمكنه انتظار تأكيده الموقّع قبل المتابعة.
- الفواتير الإلكترونية عبر Peppol: من خلال حساب شركتك لدى Storecove، وهي نقطة وصول Peppol، يرسل Arhivix الفواتير التي تصدرها (BIS Billing 3.0) ويستقبل فواتير الموردين.
يبقى نظام ERP النظام المرجعي للبيانات. يقرأ Arhivix المستندات ويتحقق منها ويوجهها، وتمرر شيفرتك النتائج.
ما تحصل عليه بدلًا من بناء خط معالجة للمستندات
استدعاء نموذج لغوي على ملف PDF هو الجزء الصغير. فالربط بنظام ERP يحتاج أيضًا إلى الاستلام، والتأكيد من شخص (human in the loop)، والموافقات، ومكان للأصل، وسجل تدقيق لكل قرار. وهذه الأجزاء تعمل في Arhivix اليوم.
| جزء الربط | ما يفعله Arhivix | نقطة التقاء شيفرتك به |
|---|---|---|
| الاستلام | الرفع، وصناديق بريد الشركة، والماسح الضوئي، وكاميرا الهاتف، والمصادر المربوطة مثل OneDrive وSharePoint وGoogle Drive وAmazon S3 وAzure Blob. | POST /nodes/{id}/upload: بصيغة multipart، حتى 200 MiB. |
| القراءة | OCR، والحقول المقترحة، و22 نوعًا معروفًا من المستندات. | يعيد GET /nodes/{id}/metadata القيمة ocr_status، والتصنيف مع doc_type، وملخصًا ووسومًا، وتفاصيل الفاتورة المستخرجة. |
| التأكيد | يعرض Smart Inbox مسارًا مقترحًا ودرجة ثقة الذكاء الاصطناعي، ويوافق شخص أو يرفض. وتُؤكَّد القيم المقروءة حقلًا حقلًا وفق قاعدة المراجعة التي تحددها. | تحمل قيم سجلّ البيانات حالة مثل confirmed أو proposed، ويحمي شرط سير العمل «مؤكَّد» (Is confirmed) الخطوات الموجودة في فرع «نعم». |
| الموافقات | سلاسل من خمسة أشخاص أو أدوار كحد أقصى، بالترتيب، مع موعد نهائي وتصعيد إلى دور. ويُستبعد من المراحل اللاحقة الشخص الذي بدأ المعالجة ومن وافقوا في المراحل السابقة. | داخل Arhivix، في قائمة انتظار موافقات الأعمال. ويتابع سير العمل تلقائيًا بعد القرار. |
| حالة العمل | ملفات الأعمال مع قائمة تحقق بالمستندات المطلوبة، والكيانات المتتبَّعة، والمستندات المتوقعة، وسجلّات البيانات. | يعيد POST /document-pipelines/registers/{id}/query صفوف سجلّ البيانات. ويمكن قراءة مستندات الكيانات المتتبَّعة عبر API أيضًا. |
| التخزين وسجل التدقيق | الإصدارات، والصلاحيات لكل مساحة عمل ومجلد، وسجل تدقيق يسجّل إجراءات API مع المفتاح الذي نفّذها. | GET /nodes/{id}/versions وGET /nodes/{id}/download. |
يمكن لأنواع المستندات الخاصة بك استخدام 22 نوعًا من القيم، منها: جدول، وقائمة، وقيد مرتبط، وقيمة محسوبة.
كيف تُنمذَج حالة العمل في Arhivix
تتكوّن كل عملية أعمال من الأجزاء نفسها: كيان له بيانات، وأدلة، وقواعد، وحالة، وإجراءات مسموح بها. وفي Arhivix يمثّل ذلك ملفُ الأعمال، وهو نموذج لإدارة الحالات تخدم أجزاؤه عمليات مختلفة تمامًا.
| جزء الحالة | في Arhivix | تأهيل المورّد | تسليم المشروع |
|---|---|---|---|
| الكيان | ملف له نوع، ومفتاح أعمال، وفترة، ومالك، وتاريخ استحقاق. | مورّد واحد. | مشروع واحد. |
| الأدلة | مستندات تُقبل وفق قائمة تحقق. ويُسجَّل كل منها مع بصمة محتواه وتاريخ صلاحيته. | تسجيل الشركة، والشهادة المطلوبة، والتأمين. | مستندات التنفيذ الفعلي، وأدلة التشغيل، والضمانات والشهادات، وسجلات الفحص والاختبار. |
| الروابط | حقول القيد المرتبط، وسجلّات البيانات، والكيانات المتتبَّعة: شريك، أو قطعة معدات، أو عقار، أو نوع تحدده أنت. | الشريك وشهاداته. | العقار ومعداته. |
| القواعد | عناصر مطلوبة بحد أدنى للعدد وفحص لتاريخ الانتهاء، وقاعدة مراجعة لكل حقل، وشروط سير عمل بـ 18 عاملًا. | يجب أن تكون الشهادة والتأمين ساريَين. | تحتاج كل مجموعة إلى مستند واحد على الأقل. |
| الحالة | قيد الجمع، بانتظار المراجعة، جاهز للحزمة النهائية، مؤرشف. | الحالات الأربع نفسها. | الحالات الأربع نفسها. |
| الإجراءات | طلب المستندات الناقصة عبر رابط رفع آمن، وقبول كل مستند أو رفضه، وتأكيد المجموعة، والإرسال للموافقة، والإشعار، وإرسال البيانات إلى نظام آخر. | طلب شهادة مجددة من المورّد. | طلب أدلة التشغيل الناقصة من المقاول. |
| النتيجة | مجموعة مؤكَّدة، وسجل قرارات يضم الإجراء والسبب والشخص، وحزمة ZIP نهائية. | مورّد مؤهَّل، مع الإثبات. | حزمة تسليم. |
المثالان كلاهما قالبان جاهزان في التطبيق، إلى جانب قالب المستندات الشهرية للعميل (فواتير المبيعات وفواتير المشتريات وكشوف الحسابات المصرفية).
لماذا تكون العملية التالية إعدادًا لا مشروعًا جديدًا
بين العملية الأولى والثانية يبقى المحرك نفسه. ما يتغير هو التعريفات: أنواع المستندات وسير العمل وسجلّات البيانات، وقالب الملف الذي تتبعه العملية. يضبطها فريقك داخل التطبيق، في وحدة معالجة المستندات، ويواصل المستقبِل لديك عمله.
-
اختر المهمة
يسألك معالج الإعداد عمّا يجب أن يفعله Arhivix: الفواتير الواردة من البريد الإلكتروني، أو العقود والمواعيد النهائية، أو سجلات الخدمة، أو مستندك الخاص. ولا يُفعَّل شيء حتى تؤكد.
-
قدّم مثالًا
صِف نوع المستند أو أسقط مستندات نموذجية، فيقترح مساعد الأنواع حقوله. وتراجع الاقتراح قبل حفظ أي شيء.
-
اختبر ثم انشر
يُختبر النوع على مستند معروف القيم، ولا يُنشر إلا الإصدار المختبَر. ويبقى كل إصدار في السجل.
-
ارسم سير العمل
يضم مصمّم سير العمل 24 نوعًا من الخطوات: الموافقة، والشروط، والتوجيه وفق عدة قواعد، والأرشفة، والتسميات، والملفات، والإشعارات، والمواعيد النهائية والتذكيرات، والبحث في سجلّات البيانات، والمسارات المتوازية، وسير العمل الفرعي، وإرسال البيانات إلى نظام آخر، وطلب تأكيد خارجي.
-
أعد استخدام الإعداد
تحفظ قوالب الأعمال تعريفات النوع وسجلّ البيانات وطريقة العرض والأداة المصغّرة في ملف JSON تستورده حيثما احتجت إلى الإعداد نفسه. وتبقى الأنواع المستوردة مسودات إلى أن تُفحص على نموذج.
ما يتذكره Arhivix
- أين تذهب مستندات المورّد: بعد أن يؤرشف شخص مستندات تحمل الرقم الضريبي نفسه للمورّد في مجموعة الأرشيف نفسها ثلاث مرات، تُؤرشف المستندات الجديدة من هذا المورّد هناك تلقائيًا.
- كيف يُقرأ نوع المستند: يحفظ الخيار «تذكّر لهذا النوع من المستندات» (Remember for this document type) موضع الحقل أو معناه في إصدار جديد من النوع، يُستخدم بعد اختبار هذا الإصدار ونشره.
- المصطلحات التي تستخدمها مستنداتك: ملاحظة لكل حقل عن مكان العثور عليه ومعناه، وعبارات محفوظة لخيارات الاختيار.
- القواعد التي يضعها فريقك: قواعد الأرشفة حسب المورّد أو نوع المستند أو الفئة، وقواعد البريد الإلكتروني، وسير العمل.
- كل قرار: تبقى التصحيحات والقرارات في السجل، مع الشخص والسبب.
هذه الذاكرة ملك لشركتك، وتُحفظ على شكل قواعد وتعيينات وإصدارات أنواع. لا تُستخدم بيانات العملاء لتدريب نماذج الذكاء الاصطناعي، وتنص على ذلك اتفاقية معالجة البيانات.
REST API v1: المصادقة والحدود والرفع والأخطاء
- المسار الأساسي
/v1/api/v1، وكلا الجزأينv1جزء من المسار. API واحد لكل المناطق: تُحدَّد الشركة من المفتاح.- المصادقة
Authorization: Bearer <key>أوX-API-Key: <key>. تبدأ المفاتيح بـak_live_.- المفاتيح
- ينشئها المسؤول أو دور المطوّر المدمج في الإعدادات، Developer API. للمفتاح اسم، وصلاحيات لكل مجال، وحد للطلبات، وتاريخ انتهاء اختياري، وقائمة اختيارية بعناوين IP المسموح بها، ويُعرض مرة واحدة فقط.
- نموذج الوصول
- كل مفتاح هوية خدمة مستقلة. تحدّ الصلاحيات من العمليات، وتحدد أدوار الشركة الموارد التي يصل إليها المفتاح، ويبدأ كل مفتاح جديد بلا وصول إلى أي مورد حتى يراجعه شخص.
- حد الطلبات
- لكل مفتاح، من 10 إلى 10,000 طلب في الدقيقة، و1,000 افتراضيًا. تحمل الاستجابات
X-RateLimit-LimitوX-RateLimit-RemainingوX-RateLimit-Reset. - عمليات الكتابة
- تحمل كل عملية كتابة الترويسة
Idempotency-Key. وتُعاد النتيجة المكتملة نفسها لمدة سبعة أيام، فتكون إعادة المحاولة آمنة. - الرفع
multipart/form-data، حتى 200 MiB، مع الترويسةX-Arhivix-Request-SHA256: قيمة SHA-256 لجسم الطلب كما هو بالضبط. ويضع الرفع OCR في قائمة الانتظار تلقائيًا.- النتائج
- يعيد
GET /nodes/{id}/metadataالقيمةocr_status، والتصنيف معdoc_type، والفئة، وملخصًا ووسومًا، وتفاصيل الفاتورة المستخرجة. ويعيدGET /nodes/{id}/textنص OCR صفحةً صفحة. - سجلّات البيانات
- يعيد
POST /document-pipelines/registers/{id}/queryالقيم المقروءة لأنواع المستندات الخاصة بك. تحمل كل قيمة حالة، مثلconfirmedأوproposed، ويمكن لعامل التصفية طلب حالة واحدة. - القوائم
- ترقيم صفحات بالمؤشر (keyset):
limitمن 1 إلى 100، والمؤشر منmeta.pagination.next_cursor. - موجز التغييرات
- يعيد
GET /eventsالأحداث من الأقدم إلى الأحدث، من السجل نفسه الذي يغذي webhooks. - البحث
GET /search، مع عوامل تصفية حسب نوع المستند والفئة ومساحة العمل.- الأخطاء
- بنية واحدة لكل الأخطاء:
errorوmessageوmeta.request_id. أرسلX-Request-IDلمطابقة سجلاتك مع سجلاتنا. - المرجع
- وصف بصيغة OpenAPI 3.1، ومخططات JSON Schema لأحداث webhook، وأمثلة عملاء بلغتي Go وJavaScript. نرسلها عند الطلب.
# Upload a document into a folder. The digest covers the exact multipart body.
boundary="bridge-example-boundary"
body="$(mktemp)"
{
printf -- '--%s\r\nContent-Disposition: form-data; name="file"; filename="invoice.pdf"\r\nContent-Type: application/octet-stream\r\n\r\n' "$boundary"
cat invoice.pdf
printf '\r\n--%s--\r\n' "$boundary"
} > "$body"
curl --fail-with-body -sS \
-H "Authorization: Bearer $API_KEY" \
-H "Idempotency-Key: invoice-4471-upload" \
-H "X-Arhivix-Request-SHA256: $(sha256sum "$body" | awk '{print $1}')" \
-H "Content-Type: multipart/form-data; boundary=$boundary" \
--data-binary "@$body" \
"$BASE_URL/nodes/$FOLDER_ID/upload"
# OCR and reading start by themselves. Read the result with the id from the response:
curl --fail-with-body -sS \
-H "Authorization: Bearer $API_KEY" \
"$BASE_URL/nodes/$NODE_ID/metadata"BASE_URL بـ /v1/api/v1.Webhooks موقّعة
تضيف عنوان webhook داخل التطبيق، في الإعدادات، Developer API، Webhooks: عنوان HTTPS عام، مع كل الأحداث أو الأحداث التي تختارها. ويُعرض سر التوقيع مرة واحدة فقط. ولإشعار نظامك بالبيانات المؤكَّدة فقط، ضع الخطوة «إرسال البيانات إلى نظام آخر» (Send data to another system) بعد الشرط «مؤكَّد» في سير العمل.
- الأحداث
document.created،file.uploaded،email.received،invoice.created،invoice.updated،invoice.deleted،invoice.approved،invoice.rejected،invoice.storno،approval.requested،approval.completed،exception.created،exception.resolved،despatch_advice.created،despatch_advice.received.- من سير العمل
- ترسل الخطوة «إرسال البيانات إلى نظام آخر» رسالة موقّعة مع رابط المستند إلى الوجهة التي ضبطتها. وتنتظر الخطوة «طلب تأكيد خارجي» (Request external confirmation) استدعاءً راجعًا موقّعًا من نظامك.
- الحمولة
- صغيرة عن قصد: معرّف الحدث، واسم الحدث، والوقت، والشركة، ومعرّف القيد ونوعه واسمه. ويقرأ المستقبِل القيد عبر API.
- التوقيع
- تحمل
X-Arhivix-Signatureالبادئةsha256=وقيمة HMAC-SHA256 لـX-Arhivix-Timestampثم نقطة ثم جسم الطلب الخام، بمفتاح هو السر الخاص بك. ارفض أي طابع زمني يختلف بأكثر من 300 ثانية. - التسليم
- أي استجابة 2xx تُعدّ إقرارًا بالاستلام. ويُعاد التسليم الفاشل بعد دقيقة واحدة، و5 دقائق، و30 دقيقة، وساعتين، و8 ساعات، و24 ساعة، و36 ساعة: ثماني محاولات على مدى نحو 70 ساعة.
- التكرارات
- التسليم مرة واحدة على الأقل. أزل التكرار اعتمادًا على
idالخاص بالحدث أو علىX-Arhivix-Delivery. - سجل التسليم
- يعرض كل تسليم محاولاته، ورمز HTTP، والحمولة، وآخر استجابة من نقطة النهاية لديك، مع زرَّي إعادة المحاولة وإعادة الإرسال. ويمكنك إرسال حدث تجريبي بنقرة واحدة.
{
"id": "evt_653a9632df26297d6d685aebb8e553fc779785cb260ed6002c4bd0d2d2e1556d",
"event": "file.uploaded",
"schema_version": 1,
"schema": "https://arhivix.com/schemas/webhooks/v1/file.uploaded.schema.json",
"occurred_at": "2026-08-10T09:00:00Z",
"timestamp": "2026-08-10T09:00:00Z",
"company_id": "company_example",
"data": {
"id": "node_example",
"event_id": "workflow_occurrence_example",
"target_type": "node",
"name": "receipt.pdf",
"triggered_by": "user_example"
}
}file.uploaded.import { createHmac, timingSafeEqual } from 'node:crypto';
// rawBody: the request body as a Buffer, captured before JSON parsing
// timestamp: header X-Arhivix-Timestamp
// signature: header X-Arhivix-Signature
export function verifyWebhook({ rawBody, timestamp, signature, secret }) {
const now = Math.floor(Date.now() / 1000);
const match = /^sha256=([a-f0-9]{64})$/.exec(signature ?? '');
if (!/^[0-9]+$/.test(timestamp ?? '') || Math.abs(now - Number(timestamp)) > 300 || !match) {
return false;
}
const expected = createHmac('sha256', secret)
.update(timestamp, 'utf8')
.update('.', 'utf8')
.update(rawBody)
.digest();
const supplied = Buffer.from(match[1], 'hex');
return supplied.length === expected.length && timingSafeEqual(supplied, expected);
}MCP: المساعدون والوكلاء على مستندات شركتك
يشغّل Arhivix خادم MCP مستضافًا على https://mcp.arhivix.com/mcp. تضيف العنوان إلى العميل لديك، وتسجّل الدخول إلى Arhivix في المتصفح، وتوافق على الوصول لشركة واحدة. لا يلزم نسخ أي مفتاح API.
- العملاء
- Claude بوصفه موصلًا مخصصًا، وClaude Code وCodex، مع أوامر جاهزة في التطبيق.
- تسجيل الدخول
- OAuth مع PKCE والتسجيل الديناميكي للعملاء.
- من يوافق
- المسؤول أو شخص له دور المطوّر، لشركة واحدة.
- القراءة
- البحث والقراءة مضمّنان دائمًا: المستندات، والبيانات الوصفية، والفواتير، والأصناف، والشركاء، والأتمتة، والمستخدمون، بحسب ما يسمح به دور الشخص الموافق.
- التغييرات
- الخيار «السماح بالتغييرات» (Allow changes) اختياري، ويشمل الأقراص والمجلدات وعمليات الرفع والأصناف والشركاء والأتمتة والمسودات. ويبقى الإصدار والإرسال بيد الأشخاص.
- التحكم
- يحصل الاتصال على مفتاح خاص به، بوصول محدود، وحد طلبات خاص، وتاريخ انتهاء. ويظهر في الإعدادات، Developer API، مفاتيح API، حيث يمكنك إلغاؤه فورًا.
# Claude Code
claude mcp add --transport http --scope user arhivix "https://mcp.arhivix.com/mcp"
# Codex
codex mcp add arhivix --url "https://mcp.arhivix.com/mcp"
codex mcp login arhivixالاستضافة والتخزين واستخدام بياناتك
- الاستضافة
- AWS في الاتحاد الأوروبي (فرانكفورت ودبلن).
- التشفير
- AES-256 أثناء التخزين وTLS أثناء النقل.
- الذكاء الاصطناعي وبياناتك
- لا تُستخدم بيانات العملاء لتدريب نماذج الذكاء الاصطناعي. وتنص على ذلك اتفاقية معالجة البيانات.
- الـ bucket الخاص بك مصدرًا
- يقرأ Arhivix المستندات الجديدة من bucket الخاص بك في Amazon S3، عبر دور للقراءة فقط في حساب AWS لديك، أو من حاوية Azure Blob الخاصة بك.
- تخزينك الخاص
- تدعم خطة Enterprise استخدام تخزينك الخاص: يبقى الـ bucket في حسابك، تحت مفاتيحك وولايتك القضائية، بينما يواصل Arhivix معالجة المستندات وفهرستها وتقديمها عبر API نفسه.
- العزل
- تُحدَّد الشركة من المفتاح، لذا يصل المفتاح إلى بيانات شركة واحدة.
- سجل التدقيق
- تُكتب إجراءات API في سجل التدقيق مع هوية الخدمة والمفتاح، ويمكن تصدير السجل.
الصورة الكاملة في صفحة الأمان.
أسئلة يطرحها المطوّرون
هل يمكنني إرسال ملفات PDF إلى نموذج لغوي بنفسي بدلًا من استخدام طبقة المستندات؟
يمكنك ذلك، واستدعاء النموذج هو الجزء الصغير. فقبل أن تصل أي قيمة إلى نظام ERP، يجب أن يستلم أحد المستند، ويؤكد ما قُرئ، ويوافق عليه، ويحفظ الأصل مع إصداراته، ويسجّل من قرّر ماذا. يتولى Arhivix هذه الأجزاء، فيبقى لشيفرتك جانب ERP.
كيف أمنع وصول قيمة غير مؤكَّدة إلى نظام ERP؟
اضبط قاعدة المراجعة للحقل على يجب تأكيده، وضع الشرط «مؤكَّد» قبل الخطوة التي ترسل البيانات إلى نظام آخر، فلا يُشعر المستقبِل إلا الفرع المؤكَّد. ثم يقرأ المستقبِل القيم من سجلّ البيانات، حيث تحمل كل قيمة حالتها، مثل confirmed.
ما المستندات التي يقرؤها Arhivix؟
يتعرّف على 22 نوعًا من المستندات، منها الفواتير والعقود وإشعارات التسليم والإشعارات الدائنة وكشوف الحسابات المصرفية والشهادات والضمانات وعروض الأسعار. ولأي مستند آخر، مثل أمر شراء أو سجل خدمة، تعرّف نوعك الخاص وتختار حقوله.
هل يتعلم Arhivix من التصحيحات، وهل يُدرَّب نموذج على مستنداتي؟
يتذكر ما يؤكده فريقك: أين تذهب مستندات المورّد، وأين يوجد الحقل في نوع المستند، وأي الكلمات تعني أي خيار. وتُحفظ هذه الذاكرة على شكل قواعد شركتك وإصدارات أنواعها. لا تُستخدم بيانات العملاء لتدريب نماذج الذكاء الاصطناعي، وتنص على ذلك اتفاقية معالجة البيانات.
ماذا يحدث إذا تعطّل المستقبِل لديّ؟
يعيد Arhivix محاولة التسليم الفاشل بعد دقيقة واحدة، و5 دقائق، و30 دقيقة، وساعتين، و8 ساعات، و24 ساعة، و36 ساعة: ثماني محاولات على مدى نحو 70 ساعة. ويحتفظ سجل التسليم بكل محاولة، مع زرَّي إعادة المحاولة وإعادة الإرسال، ويتيح موجز التغييرات GET /events لشيفرتك استدراك ما فاتها.
كيف أتجنب معالجة الحدث نفسه مرتين؟
التسليم مرة واحدة على الأقل، لذا أزل التكرار اعتمادًا على id الخاص بالحدث أو على X-Arhivix-Delivery. وتحمل عمليات الكتابة إلى API الترويسة Idempotency-Key، وتُعاد النتيجة المكتملة نفسها لمدة سبعة أيام.
هل يمكن لوكلاء الذكاء الاصطناعي العمل على مستنداتنا؟
نعم. يربط خادم MCP المستضاف على https://mcp.arhivix.com/mcp كلًا من Claude وClaude Code وCodex بعد تسجيل الدخول في المتصفح. وتتبع القراءة دور الشخص الذي وافق على الاتصال. والتغييرات اختيارية وتتوقف قبل الإصدار والإرسال، فهما يبقيان بيد الأشخاص.
أين تُخزَّن البيانات؟
على AWS في الاتحاد الأوروبي (فرانكفورت ودبلن)، مشفّرة أثناء التخزين بتقنية AES-256. ويمكن لعملاء Enterprise الاحتفاظ بالمستندات في bucket خاص بهم متوافق مع S3، تحت مفاتيحهم.
كيف أبدأ؟
أنشئ حسابًا على الخطة المجانية وأضف بعض المستندات الحقيقية لترى كيف يقرؤها Arhivix. وREST API v1 وwebhooks الموقّعة مضمّنة في كل خطة مدفوعة، وتُنشأ المفاتيح في الإعدادات، Developer API. اطلب منا مرجع OpenAPI عند إنشاء مفتاحك الأول.
ابدأ بسير عمل واحد للمستندات
اطلب مرجع API، وأنشئ مفتاحًا في الإعدادات، وأرسل مستندك الأول.
لوكلاء البرمجة: هذه الصفحة بصيغة Markdown llms.txt