payment-reverse

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

Authorization: Bearer <access_token>

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

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

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

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

معلمات المسار

{
  "id": 102,
  "voucher_no": "EXAMPLE-102",
  "status": 2,
  "date": "2026-10-11",
  "journal_entry_id": 202,
  "source_type": "PAYMENT_REVERSAL",
  "source_id": 101
}

reason سبب غير فارغ بطول أقصى1000. المورد مطلوب ضمن الشركة والفرع الحاليين؛ غيابه يعيد404.

أخطاء التحقق المالية الصادرة كـ Django ValidationError تعيد400، مع اسم الحقل أو non_field_errors. أخطاء الخادم الأخرى لا تحول إلى نجاح. العكس ينشئ مستنداً مقابلاً مرحلاً، ولا يحذف الأصل. رفض المستند غير المرحل أو المعكوس سابقاً أو المستند العكسي نفسه يخضع لقواعد خدمة العكس.

القبض يُعكس بسند صرف والصرف بسند قبض؛ يتطلب قيداً مرحلاً له حركات أستاذ ومبالغ متطابقة وصلاحية الصندوق.

عكس القيد يتطلب الشركة والفرع. اعتماد الإضافة يقبل بادئة مصدر الإضافة نفسها؛ Bearer يقبل PLG_SESSION وCUST_INV وCUST_EXP. المصدر غير المتاح يعيد404، وتعارض بادئات الإضافات يعيد400 ويحتاج مراجعة المسؤول.

التعامل مع الأخطاء