receipt-create

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

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.receipt.approve وposted يتطلب كذلك accounts.receipt.post.

الصندوق فعال وله عملة وحساب في الفرع الحالي، ويجب السماح للمستخدم بالقبض أو الصرف منه. الحساب المقابل فعال وقابل للترحيل في النظام المحاسبي الحالي.

المبلغ نص عشري موجب من 0.01، بحد18 خانة ودقتين. يستخدم التنفيذ عملة الصندوق وسعر صرف1؛ لا ترسل exchange_rate أو تتوقع تحويل عملات من هذه العملية.

إعادة المصدر ومعرفه داخل الفرع تعيد السند الموجود بـ200 دون تحديثه؛ الجديد يعيد201. لا توجد ضمانة عامة لمنع تكرار الطلبات المتزامنة.

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