> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة على العقود

> تقوم العقود في Gorelo بفوترة العمالة والمنتجات وفق جدول متكرر. كوّن الفوترة ومعدلات العمالة والمنتجات للفوترة الشهرية أو السنوية.

<iframe src="https://www.youtube.com/embed/3GfpP2iAmx4" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

استخدم العقود لفوترة العمالة والمنتجات على أساس متكرر. يحتوي العقد على ثلاثة أقسام تقوم بتكوينها: **Invoicing** و**Labor** و**Products**.

## أقسام العقد

<Tabs>
  <Tab title="Invoicing">
    هذا هو المكان الذي تحدد فيه كل ما يتعلق بالفاتورة.

    | القسم                                 | الاستخدام                                                                                                                                                                                                                                                                                       |
    | :------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Start Date**                        | ستبدأ تغطية العقد في هذا التاريخ                                                                                                                                                                                                                                                                |
    | **Repeat Period**                     | تتكرر تغطية العقد وإنشاء الفاتورة بناءً على هذا التردد (شهريًا، ربع سنوي، نصف سنوي، سنويًا)                                                                                                                                                                                                     |
    | **End Date**                          | ستنتهي تغطية العقد في هذا التاريخ ولن يُنشئ أي فواتير بعد ذلك (اختياري)                                                                                                                                                                                                                         |
    | **Invoice Creation** (أيام قبل)       | ستُنشأ الفاتورة في Start Date وكل شهر بعد ذلك بناءً على فترة التكرار (عند ضبطه على **0**).                                                                                                                                                                                                      |
    | **Invoice Due** (أيام لاحقًا)         | ستستحق الفاتورة في نفس اليوم الذي تُنشأ فيه عند ضبطه على **0**.                                                                                                                                                                                                                                 |
    | **Invoice Template**                  | سيُنشأ ملف PDF للفاتورة بناءً على هذا الاختيار.<br />انتقل إلى Settings —> Billing —> [**Invoice Template**](https://app.gorelo.io/Admin/admin-settings#billing#invoicetemplate) لإنشاء وتخصيص القالب                                                                                           |
    | **Invoice Email Template**            | يعتمد بريد الفاتورة المُرسل إلى جهات الاتصال المحددة على هذا الاختيار.<br />انتقل إلى Settings —> Email —> [**Settings**](https://app.gorelo.io/Admin/admin-settings#email#settings) وعدّل عنوان بريد الفاتورة. يمكنك بعد ذلك إنشاء القالب وتخصيصه عبر علامة التبويب Email Template Management. |
    | **Xero Branding Theme** (لـ Xero فقط) | حدّد قالب العلامة التجارية المستخدم في Xero — يتيح ذلك المدفوعات التلقائية عبر مزودين خارجيين، مثل Payrix وPinch                                                                                                                                                                                |
    | **Reference**                         | اسم الفاتورة — يمكن استخدام حقول القالب هنا مثل billingmonth وcontractgroupname وlocationname.                                                                                                                                                                                                  |
    | **Auto Approve & Send**               | سينشئ العقد مسودة فاتورة عندما يكون هذا الخيار متوقفًا (افتراضي). فعّل هذا الخيار وحدّد جهات الاتصال ليقوم العقد تلقائيًا بإنشاء الفاتورة وإرسالها إلى جهة الاتصال ومزامنتها مع Xero/QBO.                                                                                                       |

    ### أمثلة على إنشاء الفاتورة

    * **مثال 1**: تاريخ البدء **1 يناير 2025** مع فترة تكرار **شهريًا** وإنشاء الفاتورة قبل **0** يوم — ستبدأ فترة التغطية الثانية في 1 فبراير 2025 وستُنشأ الفاتورة في **1 فبراير 2025**
    * **مثال 2**: تاريخ البدء **1 يناير 2025** مع فترة تكرار **شهريًا** وإنشاء الفاتورة قبل **7** أيام — ستبدأ فترة التغطية الثانية في 1 فبراير 2025 وستُنشأ الفاتورة في **25 يناير 2025**

    ### أمثلة على استحقاق الفاتورة

    * **مثال 1**: تاريخ البدء **1 يناير 2025** مع فترة تكرار **شهريًا**، وإنشاء الفاتورة قبل **0** يوم واستحقاقها بعد **0** يوم — ستبدأ فترة التغطية الثانية في 1 فبراير 2025، وستُنشأ الفاتورة في **1 فبراير 2025** وستستحق في **1 فبراير 2025**
    * **مثال 2**: تاريخ البدء **1 يناير 2025** مع فترة تكرار **شهريًا**، وإنشاء الفاتورة قبل **0** يوم واستحقاقها بعد **7** أيام — ستبدأ فترة التغطية الثانية في 1 فبراير 2025، وستُنشأ الفاتورة في **1 فبراير 2025** وستستحق في **8 فبراير 2025**
    * **مثال 3**: تاريخ البدء **1 يناير 2025** مع فترة تكرار **شهريًا**، وإنشاء الفاتورة قبل **7** أيام واستحقاقها بعد **7** أيام — ستبدأ فترة التغطية الثانية في 1 فبراير 2025، وستُنشأ الفاتورة في **25 يناير 2025** وستستحق في **1 فبراير 2025**
  </Tab>

  <Tab title="Labor">
    هذا هو المكان الذي تختار فيه نوع العمالة وتكوّن طريقة عملها.

    ### ساعات غير محدودة

    العمالة بلا سقف بالكامل (نوع كل ما تستطيع استهلاكه).

    * **Auto Approve** يعتمد تلقائيًا جميع إدخالات الوقت، بافتراض أنك تستخدم تقرير Contract Profitability لمراقبة صحة العقد.
    * **Covered items** تحدد أي مجموعة من أنواع العمل وأدوار الفوترة سيتم تغطيتها تلقائيًا بالعقد.
          <Frame>
            <img src="https://mintcdn.com/gorelo/4BKr24ec6qlG7MEp/images/image-141.png?fit=max&auto=format&n=4BKr24ec6qlG7MEp&q=85&s=f399362bfa64caec29e3918776f237de" alt="Image" width="625" height="105" data-path="images/image-141.png" />
          </Frame>
      * **مثال 1**: **Remote Support** الذي يقدمه **فني** سيكون مشمولًا ✅.
      * **مثال 2**: **Onsite (Off Hours)** الذي يقدمه **فني** لن يكون مشمولًا وسيتدفق بدلًا من ذلك إلى معدلات العمالة الافتراضية أو إلى عقد بديل ❌.

    ### بالساعة

    يقوم Gorelo بفوترة العمالة بالمعدلات التي تحددها.

    | المعدل                        | الاستخدام                                                                                                                       |
    | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |
    | ***Use default labor rates*** | يتيح لك استخدام المعدلات الافتراضية ثم يمنحك خيار اختيار مجموعات Work Type وBilling Role التي سيتم تغطيتها تلقائيًا بهذا العقد. |
    | ***Use fixed labor rate***    | يتيح لك تعيين معدل ثابت يتجاوز جميع مجموعات Work Type وBilling Role المحددة.                                                    |
    | ***Use custom labor rates***  | يتيح لك تجاوز فرادى Work Type وBilling Roles واختيار مجموعات Work Type وBilling Role التي سيتم تغطيتها تلقائيًا بهذا العقد.     |

    ### ساعات الكتلة (تعبئة لمرة واحدة)

    يخصم Gorelo العمالة من كتلة ساعات يشتريها العميل مقدمًا. تفوترها مرة واحدة ولا تتجدد.

    * انتقل إلى Settings > Billing > [**Block Hour Templates**](https://app.gorelo.io/Admin/admin-settings#billing#blockhourstemplate) وأنشئ قوالبك (على سبيل المثال، كتلة من 10 ساعات).
    * يتدفق **السعر** الأولي و**Block Balance** عبر أول فاتورة.

    | القسم                 | الاستخدام                                                                                                                                                                                                                |
    | :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Warning Threshold** | يحدد النسبة المئوية من الساعات المتبقية التي يظهر عندها بنر للعميل. على سبيل المثال، 10 ساعات مع عتبة 20٪ تُظهر بنر العميل عند تبقّي ساعتين.                                                                             |
    | **Overrun Threshold** | يحدد ما إذا كان لا يزال بالإمكان فوترة الوقت رغم تبقّي 0 ساعة. على سبيل المثال، 10 ساعات مع تجاوز 30٪ يسمح بفوترة ما يصل إلى 3 ساعات رغم تبقّي 0 ساعة. تستهلك التعبئة التالية لساعات الكتلة هذه الساعات المتجاوزة فورًا. |
    | **Covered Items**     | يحدد أي مجموعة من Work Type وBilling Roles سيتم تغطيتها تلقائيًا بالعقد.                                                                                                                                                 |

    ### ساعات محدودة (فاتورة متكررة)

    يحدّد Gorelo العمالة عند عدد ساعات محدد، ثم يفوتر أي زيادة على أساس بالساعة. يتجدد السقف في بداية كل شهر.

    * قسم **Allocated hours** هو المكان الذي تحدد فيه الحد الأقصى للساعات المشمولة بالعقد.
    * تحدد بعد ذلك كيفية فوترة **excess hours** (انظر **بالساعة**).

    ### بلا عمالة

    لا يشتمل العقد على أي مكون عمالة. استخدم هذا الخيار عندما يغطي العقد المنتجات أو الرسوم المتكررة فقط.
  </Tab>

  <Tab title="Products">
    هذا هو المكان الذي تضيف فيه المنتجات والحزم التي ستظهر في ملف PDF للفاتورة وتتم مزامنتها مع Xero/QBO.

    * استخدم القائمة المنسدلة للبحث لإضافة المنتجات/الحزم.
    * يمكنك تعديل الوصف والتكلفة والسعر وغير ذلك لمنتج/حزمة، ولا يؤثر التغيير إلا على هذا العقد المحدد — لا يتغير المنتج/الحزمة الأساسي.
    * يمكنك عرض قيم **invoice period** و**dynamic quantity** عبر تعديل وصف منتج/حزمة.

    <Frame>
      <img src="https://mintcdn.com/gorelo/yjnYoEKaVuZMxOVh/images/image-142.png?fit=max&auto=format&n=yjnYoEKaVuZMxOVh&q=85&s=fa298d3dcc0506253aae58b018270587" alt="Image" width="534" height="659" data-path="images/image-142.png" />
    </Frame>
  </Tab>
</Tabs>

## أمثلة على حالات الاستخدام

يحتوي الجدول التالي على العناصر القابلة للفوترة التي تناسب الإعداد بشكل أفضل:

| إعداد العقد                                               | العناصر                                             |
| :-------------------------------------------------------- | :-------------------------------------------------- |
| تخصص رصيد وقت مرة واحدة وتخصم الساعات                     | <ul><li>Block hours</li><li>Labor rates</li></ul>   |
| تفوتر مبلغًا ثابتًا كل شهر بغض النظر عن الساعات المستهلكة | <ul><li>Recurring product</li></ul>                 |
| تفوتر بشكل صارم بناءً على الساعات، دون أي منتج            | <ul><li>Labor rates</li></ul>                       |
| تخصص بدل وقت ثابت، ثم تفوتر على أساس بالساعة بمجرد تجاوزه | <ul><li>Limited hours</li><li>Labor rates</li></ul> |