معدلات الضريبة
معدل الضريبة (Tax Rate) قيمة مرجعية لنسبة الضريبة وتسمية الفاتورة وتعيين الافتراضي. ضمن كتالوج المنتجات تُختار على المنتج عبر taxRateId.
المسار (كتالوج المنتجات): القائمة الجانبية ← كتالوج المنتجات ← معدلات الضريبة
الصفحة (CAT): /Entities/CAT/TaxRate
الصفحة (ORG): /Entities/ORG/TaxRate
واجهة CAT ومسار القائمة الجانبية للكتالوج يفتحان /Entities/CAT/TaxRate. توجد أيضًا واجهة تحت المؤسسة على /Entities/ORG/TaxRate، وواجهة البرمجة الخلفية تتبع متحكم ORG.
ماذا تفعل هذه الشاشة
- تدير معدلات الضريبة بالاسمين والنسبة وتسمية الفاتورة
- تتيح تعيين isDefault للمعدل الافتراضي
- تُربط بالمنتج للضريبة على البيع/الشراء حسب الاستخدام
الحقول
| الحقل | الإلزام | الاستخدام |
|---|---|---|
| name / nameAr | إلزامي في واجهة CAT | الاسم بالإنجليزية والعربية |
| taxValue_prc | اختياري في التحقق (≥ 0) | نسبة الضريبة % |
| labelOnInvoice | اختياري | التسمية على الفاتورة |
| isDefault | اختياري | هل المعدل الافتراضي |
| description / descriptionAr | اختياري | الأوصاف |
أعمدة قائمة CAT
name / nameAr / الأوصاف / Active? / actions — دون عمود taxValue في قائمة CAT الحالية.
أعمدة قائمة ORG
تضيف عمود taxValue_prc إلى جانب الاسمين والأوصاف والنشاط.
كيف تستخدم الشاشة
- افتح
/Entities/CAT/TaxRateمن قائمة الكتالوج (أو مسار ORG عند العمل من المؤسسة) - أنشئ أو عدّل معدلًا بالاسمين وtaxValue_prc وlabelOnInvoice وisDefault
- اختر المعدل لاحقًا من حقل الضريبة في المنتج
أفضل الممارسات
اجعل labelOnInvoice مطابقًا لما يظهر للعميل حتى لا تختلف النصوص ب ين الفرق.
isDefault يميّز المعدل المستخدم افتراضيًا ضمن القائمة.
عدّل من مسار واحد معتمد في مؤسستك (CAT أو ORG) لتجنب ازدواجية الفهم التشغيلي، مع العلم أن الـ API خلفيًا تحت ORG.