نظرة عامة: أي اتصال يناسبك؟
- منصات الأتمتة مثل n8n و Make و Zapier: عبر واجهة برمجة التطبيقات REST بمفتاح API و عبر الويب هوك. يمكن لـ n8n أيضًا استخدام خادم MCP الخاص بـ PaperOffice.
- أنظمة تخطيط موارد المؤسسات (ERP) والمحاسبة: اتصالات جاهزة لأنظمة Holded و JTL-Wawi تعكس الطلبات والفواتير والأسعار كمصدر تشغيلي.
- شركات الشحن: اتصالات جاهزة لأنظمة GLS و DB Schenker و DHL لجلب حالة الشحنة.
- خدمات البيانات: التحقق من رقم ضريبة القيمة المضافة، وأسعار الصرف، وتحديد المواقع الجغرافية والخرائط، داخل التطبيق و عبر واجهة برمجة التطبيقات.
المصادر التشغيلية جزء من Knowledge Base AI، المتوفرة في خطة Plus. يشارك وكيل الدردشة أو الهاتف الخاص بك بيانات العميل مثل حالة الطلب فقط بعد أن يثبت العميل هويته.
n8n و Make و Zapier
تستخدم الوحدات البنائية القياسية لهذه الأدوات: طلبات HTTP إلى واجهة برمجة التطبيقات REST والويب هوك.
- أنشئ مفتاحًا في صفحة مفاتيح API وأدخله في عقدة HTTP كرمز حامل (bearer token).
- استدعِ واجهة برمجة التطبيقات REST، على سبيل المثال لرفع أو البحث. نقاط النهاية موجودة في وثائق API.
- لتلقي النتائج، افتح Workflow AI → Workflow Agents، وقم بتعديل وكيل محفوظ واختر علامة التبويب خطافات الويب (Webhooks).
- انقر على إضافة هدف ويب هوك وأدخل عنوان الويب هوك من n8n أو Make أو Zapier كـ عنوان URL المستهدف.
- تحت الإرسال عند، اختر اكتمل التنفيذ بنجاح، أو فشل التنفيذ، أو كليهما.
- لمراجعة بشرية، ينشئ تدفقك مهمة مراجعة وينتظر ويب هوك. ويُبلغ حدث task.completed عن القرار.
- طلبات الويب هوك الصادرة من PaperOffice موقّعة في رأس X-PaperOffice-Signature. تحقق من التوقيع في التدفق الخاص بك.
- المساحات النائبة مثل {trigger.pofid} مسموح بها في المسار والاستعلام والرؤوس، وليس في اسم المضيف.
- أهداف الويب هوك في وكلاء سير العمل متوفرة من خطة Professional. يتم دفع كل توصيل ويب هوك ناجح، ويتم دفع استدعاءات API.
Holded
يقرأ PaperOffice طلبات البيع مع تفاصيل جهة الاتصال، والفواتير، وإشعارات الائتمان، والمنتجات من Holded ويعكسها كمصدر تشغيلي. المرآة للقراءة فقط. تذهب المرفقات فقط إلى Holded، مع موافقة منفصلة ومفتاح منفصل للوصول للكتابة.
- افتح Knowledge Base AI → المصادر التشغيلية وانقر على إضافة مصدر. اختر Holded كاتصال.
- في علامة التبويب اتصال، أدخل مفتاح API الخاص بـ Holded.
- اختياري: اختر مساحة عمل للمستندات وحدد الفواتير أو إشعارات الائتمان أو طلبات البيع. يغطي تخزين ملفات PDF المستندات الجديدة فقط بعد الحفظ.
- اختياري: فعّل إرسال المرفقات إلى Holded (مدفوع) وأدخل مفتاح API الخاص بـ Holded مع صلاحية الكتابة.
- في علامة التبويب إثبات، اختر كيفية تعريف العملاء عن أنفسهم، ثم احفظ.
لإرفاق مستند، افتحه، وانقر على إرفاق في Holded وأكد الهدف. يجد PaperOffice الهدف برقم المستند؛ مع تطابقات متعددة أو عدم وجود تطابق، لا يتم إرسال شيء. قد تصل الملفات إلى 10 ميجابايت، ولا يتم إعادة إرسال المرفقات. يتم دفع عمليات الجلب والتخزين والإرفاق.
JTL-Wawi
يقرأ PaperOffice الطلبات، وإشعارات التسليم مع أرقام التتبع، والعناصر مع الأسعار من JTL-Wawi عبر واجهة برمجة التطبيقات الرسمية لـ JTL. الاتصال للقراءة فقط؛ لا يتم تغيير أي شيء في JTL-Wawi.
- افتح Knowledge Base AI → المصادر التشغيلية، وانقر على إضافة مصدر واختر JTL-Wawi كاتصال.
- على علامة التبويب اتصال، اختر JTL Cloud أو JTL-Wawi محلياً. بالنسبة لـ JTL Cloud، أدخل معرف المستأجر؛ أما في حالة التشغيل المحلي، فأدخل عنوان HTTPS ومفتاح API من تسجيل التطبيق.
- أدخل رقم طلب حقيقي للمعاينة واختر الإثبات على علامة التبويب إثبات.
- على علامة التبويب معاينة، انقر فوق معاينة دون حفظ، ثم احفظ وابدأ المزامنة الأولى باستخدام مزامنة الآن.
في حالة التشغيل المحلي، يحتاج JTL-Wawi إلى عنوان HTTPS عام على المنفذ القياسي 443؛ حيث يتم حظر العناوين الداخلية وبروتوكول HTTP. يرجى التحقق مع الدعم الفني مما إذا كان JTL Cloud مفعلاً لحسابك بالفعل. يتوقف المصدر تلقائياً بعد ثلاث محاولات جلب فاشلة متتالية. عمليات الجلب مدفوعة.
تتبع الشحنات مع GLS وDB Schenker وDHL
عندما يسأل العملاء "أين طردي؟"، يقوم PaperOffice بجلب حالة الشحنة من GLS أو DB Schenker أو DHL. تحتاج إلى بيانات اعتماد خاصة بك لدى شركة الشحن.
- افتح Knowledge Base AI → المصادر التشغيلية، انقر فوق إضافة مصدر واختر النوع GLS (المرحلة 2) أو شنكر (المرحلة 2) أو DHL.
- على علامة التبويب اتصال، أدخل بيانات اعتمادك: بالنسبة لـ GLS، أدخل عنوان ShipIT واسم المستخدم وكلمة المرور، وبالنسبة لـ DB Schenker أدخل مفتاح الوصول، وبالنسبة لـ DHL أدخل مفتاح API.
- أدخل رقم تتبع حقيقي للمعاينة، اختر الإثبات، تحقق من المعاينة واحفظ.
- على علامة التبويب مزامنة، انقر فوق مزامنة الآن.
تقرأ عمليات المزامنة اللاحقة أرقام التتبع الموجودة تلقائياً. تُرسل رسائل الحالة إلى العملاء عبر الرسائل القصيرة أو البريد الإلكتروني فقط عند حدوث تغيير حقيقي في الحالة، وشرط تفعيلها من علامة التبويب الرسائل؛ وهي غير مفعّلة افتراضياً. الرسائل القصيرة مدفوعة.
خدمات البيانات: رقم ضريبة القيمة المضافة، أسعار الصرف، الترميز الجغرافي والخرائط
يقدم PaperOffice أربع خدمات بيانات: التحقق من أرقام ضريبة القيمة المضافة ضد نظام VIES في الاتحاد الأوروبي، أسعار الصرف مع التحويل، الترميز الجغرافي والخرائط. يمكنك تجربتها في التطبيق ضمن Data AI Playground، المتاح في جميع الخطط، واستخدامها في أنظمتك الخاصة عبر واجهة برمجة التطبيقات REST أو موصل MCP. طلبات واجهة برمجة التطبيقات مدفوعة.
- ضريبة القيمة المضافة: يتم تشغيل التحقق ضد VIES، ومن خلال واجهة برمجة التطبيقات أيضاً دفعات تصل إلى 100 رقم. تتوفر أيضاً معدلات ضريبة القيمة المضافة لـ 27 دولة في الاتحاد الأوروبي.
- مع AI-DMS Ultra، يتحقق PaperOffice تلقائياً من رقم ضريبة القيمة المضافة للمورد ضد VIES لكل مستند. هذه الخدمة مدفوعة.
- الترميز الجغرافي: تحويل العنوان إلى إحداثيات، والإحداثيات إلى عنوان، واقتراحات العناوين، ومن خلال واجهة برمجة التطبيقات أيضاً دفعات تصل إلى 1,000 عنوان.
- الخرائط: تحت Analytics AI → خريطة المرسلين، ترى مرسلي مستنداتك على الخريطة بمجرد معالجتها بواسطة AI-DMS. يتوفر Analytics AI من خطة Corporate.
الأسئلة الشائعة
- هل هناك عقدة n8n جاهزة؟ يمكنك ربط n8n عبر طلبات HTTP أو الويب هوك (webhooks) أو عميل MCP الخاص به.
- هل يقوم PaperOffice بتغيير البيانات في Holded أو JTL-Wawi؟ JTL-Wawi للقراءة فقط. في Holded، يتم إرسال المرفقات فقط، ويتطلب تفعيل ذلك مفتاحاً منفصلاً.
- هل يرى عملاؤهم حالة الطلب دون إثبات؟ لا. يشارك الوكيل بيانات العميل فقط بعد الإثبات.
- أي شركات شحن مدعومة؟ توجد اتصالات جاهزة حالياً لـ GLS وDB Schenker وDHL.
- هل يمكنني التحقق من العديد من أرقام ضريبة القيمة المضافة في وقت واحد؟ نعم، من خلال واجهة برمجة التطبيقات دفعات تصل إلى 100 رقم.