جرّب الربط على بيئة HARPLINK التجريبية
https://demo.harplink.net ↗ · اسم المستخدم: demo · كلمة المرور: demo
بيئة مشتركة للفحص ببيانات تجريبية. تظهر نتائج عمليات الكتابة داخل ERP وقد يغيّرها مستخدمون آخرون؛ استخدم بيانات وهمية. كل طلب API يتطلب توكناً والصلاحيات اللازمة. لربط شركة فعلية غيّر عنوان ERP واستخدم حسابها المخوّل.
اختر العملية وافحصها من المتصفح ←payment-create
إنشاء سند صرف
/api/platform/v1/accounts/vouchers/payments/الوصول والصلاحيات
Authorization: Bearer <access_token>يمكن لواجهة ERP الداخلية استخدام الجلسة الحالية مع CSRF. هوية المستخدم وصلاحياته وقواعد العملية تحدد الوصول إلى البيانات.
الصلاحيات المذكورة مباشرة في تنفيذ المسار. قد تطبق الخدمات شروطاً إضافية.مصادقة الإضافات
Authorization: HarplinkPlugin <client-uuid>.<secret>يمكن استخدام Bearer للمستخدم المخوّل أو اعتماد الإضافة لهذه العملية. اعتماد الإضافة يتطلب النطاقات التالية إضافة إلى صلاحيات مستخدم ERP:
{
"id": 101,
"voucher_no": "EXAMPLE-101",
"status": 0,
"date": "2026-10-11",
"journal_entry_id": null,
"source_type": "PLG_SAMPLE_SAMPLE",
"source_id": 1001
}الأمثلة تستخدم draft عمداً؛ الافتراضي الفعلي عند حذف posting_status هو posted. approved يتطلب accounts.payment.approve وposted يتطلب كذلك accounts.payment.post.
الصندوق فعال وله عملة وحساب في الفرع الحالي، ويجب السماح للمستخدم بالقبض أو الصرف منه. الحساب المقابل فعال وقابل للترحيل في النظام المحاسبي الحالي.
المبلغ نص عشري موجب من 0.01، بحد18 خانة ودقتين. يستخدم التنفيذ عملة الصندوق وسعر صرف1؛ لا ترسل exchange_rate أو تتوقع تحويل عملات من هذه العملية.
إعادة المصدر ومعرفه داخل الفرع تعيد السند الموجود بـ200 دون تحديثه؛ الجديد يعيد201. لا توجد ضمانة عامة لمنع تكرار الطلبات المتزامنة.
التعامل مع الأخطاء
400راجع بيانات الطلب401أعد المصادقة403راجع صلاحية الحساب429انتظر قبل إعادة المحاولةجهّز مثال الربط
خصّص المعلمات وانسخ المثال إلى تطبيقك.
جرّب الطلب على نظام ERP الخاص بك
الحصول على توكن من المتصفح
أدخل عنوان ERP في الأعلى ثم بيانات حساب ERP، وليس حساب المنصة. بيانات الدخول تُرسل مباشرةً إلى ERP، ولا تُحفظ في المنصة.
يمكنك تسجيل الدخول أعلاه أو إدخال توكن لديك. هذه تجربة فعلية؛ عمليات الإنشاء والتعديل والحذف قد تغيّر بيانات ERP.
ترويسات الاستجابة
مرّر التوكن من التخزين الآمن في تطبيقك. الأمثلة تستخدم متغيراً للتوكن وتُولّد محلياً.