HARPLINK ↗HARPLINK DEVELOPERSمساحة المطور ↗متجر التطبيقات ↗
OFFICIAL SANDBOX

جرّب الربط على بيئة HARPLINK التجريبية

https://demo.harplink.net ↗ · اسم المستخدم: demo · كلمة المرور: demo

بيئة مشتركة للفحص ببيانات تجريبية. تظهر نتائج عمليات الكتابة داخل ERP وقد يغيّرها مستخدمون آخرون؛ استخدم بيانات وهمية. كل طلب API يتطلب توكناً والصلاحيات اللازمة. لربط شركة فعلية غيّر عنوان ERP واستخدم حسابها المخوّل.

اختر العملية وافحصها من المتصفح ←

تنزيل مرجع OpenAPI ↓

منصة الإضافات

journal-create

إنشاء قيد محاسبي متوازن في فرع المستخدم

دليل العملية
POST
/api/platform/v1/journals/
AUTHENTICATION

الوصول والصلاحيات

Authorization: Bearer <access_token>

يمكن لواجهة ERP الداخلية استخدام الجلسة الحالية مع CSRF. هوية المستخدم وصلاحياته وقواعد العملية تحدد الوصول إلى البيانات.

accounts.journal.create
الصلاحيات المذكورة مباشرة في تنفيذ المسار. قد تطبق الخدمات شروطاً إضافية.

مصادقة الإضافات

Authorization: HarplinkPlugin <client-uuid>.<secret>

يمكن استخدام Bearer للمستخدم المخوّل أو اعتماد الإضافة لهذه العملية. اعتماد الإضافة يتطلب النطاقات التالية إضافة إلى صلاحيات مستخدم ERP:

accounts.journal.write

استجابة توضيحية

201 OK
{
  "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انتظر قبل إعادة المحاولة
REQUEST BUILDER

جهّز مثال الربط

خصّص المعلمات وانسخ المثال إلى تطبيقك.

اترك الفرع فارغاً عند اختيار Bearer. للقوائم، أدخل القيم مفصولة بفواصل؛ نرسل معلمة متكررة لكل قيمة.

اختيار حسابات القيد من ERP

بعد تسجيل الدخول، ابحث بالكود أو الاسم. نعرض حتى 100 نتيجة حسب صلاحيات ERP. إدراج الحساب يغير جسم الطلب فقط ولا ينشئ قيداً.

TRY THIS ENDPOINT

جرّب الطلب على نظام ERP الخاص بك

الحصول على توكن من المتصفح

أدخل عنوان ERP في الأعلى ثم بيانات حساب ERP، وليس حساب المنصة. بيانات الدخول تُرسل مباشرةً إلى ERP، ولا تُحفظ في المنصة.

أدخل التوكن أو client-uuid.secret بدون اسم نوع المصادقة. يُستخدم لهذا الطلب ولا يُحفظ في المتصفح.

يمكنك تسجيل الدخول أعلاه أو إدخال توكن لديك. هذه تجربة فعلية؛ عمليات الإنشاء والتعديل والحذف قد تغيّر بيانات ERP.

cURL

مرّر التوكن من التخزين الآمن في تطبيقك. الأمثلة تستخدم متغيراً للتوكن وتُولّد محلياً.