POST https://app.alaaqat.com/api/invoices/properties/groups
تُنشئ هذه النقطة مجموعة تنظّم فيها خصائص الفواتير. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية invoice-property-group-create، ويحتاج عضو الفريق الذي أنشأ المفتاح إلى صلاحية إنشاء مجموعة حقول.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
{
name: {
en?: string,
ar?: string
},
desc?: {
en?: string,
ar?: string
}
}
| الحقل | مطلوب | التحققات | الوصف |
|---|---|---|---|
| name | مطلوب | كائن يضم لغة واحدة على الأقل، وقيمة كل لغة نص | اسم المجموعة بالإنجليزية en أو بالعربية ar أو بكلتيهما. |
| desc | اختياري | كائن من اللغات | وصف المجموعة بالإنجليزية أو بالعربية أو بكلتيهما. |
يضع نظام علاقات قيمة internal_name للمجموعة انطلاقاً من اسمها، ويملأ account_id بنفسه، ويُرفض الطلب الذي يرسل أياً منهما.
{
"name": {
"en": "Key account details",
"ar": "تفاصيل الحسابات الرئيسية"
},
"desc": {
"en": "Extra details we keep on our largest invoices",
"ar": "تفاصيل إضافية نحفظها عن أكبر فواتير"
}
}
201 Created، وتأتي المجموعة الجديدة ضمن data. استخدم قيمة _id الخاصة بها في group_id للخصائص التي تُنشئها.
{
"data": {
"_id": "6654e0f1a2b3c4d5e6f7a901",
"internal_name": "key_account_details",
"name": {
"en": "Key account details",
"ar": "تفاصيل الحسابات الرئيسية"
},
"desc": {
"en": "Extra details we keep on our largest invoices",
"ar": "تفاصيل إضافية نحفظها عن أكبر فواتير"
},
"account_id": 1024,
"made_by": 12,
"updated_at": "2026-10-19T14:00:00.000000Z",
"created_at": "2026-10-19T14:00:00.000000Z",
"user": {
"id": 12,
"email": "sara.haddad@example.com",
"firstname": "Sara",
"lastname": "Haddad",
"image": null,
"locale": "en",
"created_at": "2026-03-02T08:00:00.000000Z",
"updated_at": "2026-10-01T07:30:00.000000Z",
"fullname": "Sara Haddad"
}
},
"message": "Entity was created successfully."
}