جرّب الربط على بيئة HARPLINK التجريبية
https://demo.harplink.net ↗ · اسم المستخدم: demo · كلمة المرور: demo
بيئة مشتركة للفحص ببيانات تجريبية. تظهر نتائج عمليات الكتابة داخل ERP وقد يغيّرها مستخدمون آخرون؛ استخدم بيانات وهمية. كل طلب API يتطلب توكناً والصلاحيات اللازمة. لربط شركة فعلية غيّر عنوان ERP واستخدم حسابها المخوّل.
اختر العملية وافحصها من المتصفح ←journal-reverse
إنشاء مستند عكسي للترحيل الأصلي
/api/platform/v1/journals/{entry_id}/reverse/الوصول والصلاحيات
Authorization: Bearer <access_token>يمكن لواجهة ERP الداخلية استخدام الجلسة الحالية مع CSRF. هوية المستخدم وصلاحياته وقواعد العملية تحدد الوصول إلى البيانات.
الصلاحيات المذكورة مباشرة في تنفيذ المسار. قد تطبق الخدمات شروطاً إضافية.مصادقة الإضافات
Authorization: HarplinkPlugin <client-uuid>.<secret>يمكن استخدام Bearer للمستخدم المخوّل أو اعتماد الإضافة لهذه العملية. اعتماد الإضافة يتطلب النطاقات التالية إضافة إلى صلاحيات مستخدم ERP:
معلمات المسار
| المعلمة | النوع | الاستخدام |
|---|---|---|
entry_id | int | استبدلها بمعرف المورد الفعلي. |
{
"id": 102,
"entry_no": "EXAMPLE-102",
"status": 2,
"source_type": "JOURNAL_REVERSAL",
"source_id": 101
}reason سبب غير فارغ بطول أقصى1000. المورد مطلوب ضمن الشركة والفرع الحاليين؛ غيابه يعيد404.
أخطاء التحقق المالية الصادرة كـ Django ValidationError تعيد400، مع اسم الحقل أو non_field_errors. أخطاء الخادم الأخرى لا تحول إلى نجاح. العكس ينشئ مستنداً مقابلاً مرحلاً، ولا يحذف الأصل. رفض المستند غير المرحل أو المعكوس سابقاً أو المستند العكسي نفسه يخضع لقواعد خدمة العكس.
القبض يُعكس بسند صرف والصرف بسند قبض؛ يتطلب قيداً مرحلاً له حركات أستاذ ومبالغ متطابقة وصلاحية الصندوق.
عكس القيد يتطلب الشركة والفرع. اعتماد الإضافة يقبل بادئة مصدر الإضافة نفسها؛ Bearer يقبل PLG_SESSION وCUST_INV وCUST_EXP. المصدر غير المتاح يعيد404، وتعارض بادئات الإضافات يعيد400 ويحتاج مراجعة المسؤول.
التعامل مع الأخطاء
400راجع بيانات الطلب401أعد المصادقة403راجع صلاحية الحساب429انتظر قبل إعادة المحاولةجهّز مثال الربط
خصّص المعلمات وانسخ المثال إلى تطبيقك.
جرّب الطلب على نظام ERP الخاص بك
الحصول على توكن من المتصفح
أدخل عنوان ERP في الأعلى ثم بيانات حساب ERP، وليس حساب المنصة. بيانات الدخول تُرسل مباشرةً إلى ERP، ولا تُحفظ في المنصة.
يمكنك تسجيل الدخول أعلاه أو إدخال توكن لديك. هذه تجربة فعلية؛ عمليات الإنشاء والتعديل والحذف قد تغيّر بيانات ERP.
ترويسات الاستجابة
مرّر التوكن من التخزين الآمن في تطبيقك. الأمثلة تستخدم متغيراً للتوكن وتُولّد محلياً.
حقول ظاهرة في تنفيذ العملية
هذه أسماء مستخرجة من الكود، وقد توجد حقول إضافية أو شروط تعتمد على نوع العملية. راجع عقد العملية ونتيجة الفحص.
حقول الاستجابة
entry_no id source_id source_type status