إنشاء مجموعة خصائص للفواتير

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."
}