جرّب الربط على بيئة HARPLINK التجريبية
https://demo.harplink.net ↗ · اسم المستخدم: demo · كلمة المرور: demo
بيئة مشتركة للفحص ببيانات تجريبية. تظهر نتائج عمليات الكتابة داخل ERP وقد يغيّرها مستخدمون آخرون؛ استخدم بيانات وهمية. كل طلب API يتطلب توكناً والصلاحيات اللازمة. لربط شركة فعلية غيّر عنوان ERP واستخدم حسابها المخوّل.
اختر العملية وافحصها من المتصفح ←journal-create
إنشاء قيد محاسبي متوازن في فرع المستخدم
/api/platform/v1/journals/الوصول والصلاحيات
Authorization: Bearer <access_token>يمكن لواجهة ERP الداخلية استخدام الجلسة الحالية مع CSRF. هوية المستخدم وصلاحياته وقواعد العملية تحدد الوصول إلى البيانات.
الصلاحيات المذكورة مباشرة في تنفيذ المسار. قد تطبق الخدمات شروطاً إضافية.مصادقة الإضافات
Authorization: HarplinkPlugin <client-uuid>.<secret>يمكن استخدام Bearer للمستخدم المخوّل أو اعتماد الإضافة لهذه العملية. اعتماد الإضافة يتطلب النطاقات التالية إضافة إلى صلاحيات مستخدم ERP:
{
"id": 101,
"entry_no": "EXAMPLE-101",
"status": 0,
"date": "2026-10-11",
"source_type": "PLG_SAMPLE_SAMPLE",
"source_id": 1001
}استبدل معرفات الحسابات بحسابات فعلية متاحة من accounts/choices/. اختر draft أولاً؛ approved يتطلب accounts.journal.approve وposted يتطلب كذلك accounts.journal.post.
من 2 إلى 100 سطر؛ كل سطر مدين أو دائن، ويجب تساوي مجموع المدين والدائن. الحسابات فعالة وقابلة للترحيل ضمن النظام المحاسبي وشركة المستخدم، ويمكن أن تكون من فروع أو وكالات أخرى. العملة فعالة. عند الاعتماد والترحيل يلزم توازن نطاق الفروع ونطاق الوكالات بالتسوية داخل القيد.
يتطلب شركة وفرعاً ونظاماً محاسبياً. الخدمات تطبق قواعد إضافية عند الاعتماد والترحيل.
الخادم يصنع source_type ببادئة PLG ومعرف الإضافة المختصر. إعادة نفس المصدر ومعرفه داخل الفرع تعيد السجل الموجود بـ200، ولا تحدث محتواه. الجديد يعيد201.
هذا ليس دعماً عاماً لترويسة Idempotency-Key؛ لا تعتمد على منع التكرار عند طلبات متزامنة دون اختبار.
يمكن عكس القيد المرحل عبر journals/{entry_id}/reverse/ مع سبب. اعتماد الإضافة مقيد بمصدر الإضافة نفسه، بينما Bearer يقبل مصدر PLG_SESSION ومصدري CUST_INV وCUST_EXP.
التعامل مع الأخطاء
400راجع بيانات الطلب401أعد المصادقة403راجع صلاحية الحساب429انتظر قبل إعادة المحاولةجهّز مثال الربط
خصّص المعلمات وانسخ المثال إلى تطبيقك.
اختيار حسابات القيد من ERP
بعد تسجيل الدخول، ابحث بالكود أو الاسم. نعرض حتى 100 نتيجة حسب صلاحيات ERP. إدراج الحساب يغير جسم الطلب فقط ولا ينشئ قيداً.
جرّب الطلب على نظام ERP الخاص بك
الحصول على توكن من المتصفح
أدخل عنوان ERP في الأعلى ثم بيانات حساب ERP، وليس حساب المنصة. بيانات الدخول تُرسل مباشرةً إلى ERP، ولا تُحفظ في المنصة.
يمكنك تسجيل الدخول أعلاه أو إدخال توكن لديك. هذه تجربة فعلية؛ عمليات الإنشاء والتعديل والحذف قد تغيّر بيانات ERP.
ترويسات الاستجابة
مرّر التوكن من التخزين الآمن في تطبيقك. الأمثلة تستخدم متغيراً للتوكن وتُولّد محلياً.