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

# شرح عملية التوجيه

> اكتشف كيفية عمل توجيهات الشركة وكيفية استخدام واجهة برمجة التطبيقات API الخاصة بالتوجيه لإجراء تحليلات مالية استشرافية

## نظرة عامة

* ما المقصود بتوجيهات الشركة
* الفرق بين توجيهات الشركة وتقديرات المحللين
* لماذا تُعد التوجيهات مهمة في التحليل المستقبلي
* مصدر البيانات: إفصاحات إدارة الشركة

***

<div id="what-company-guidance-represents">
  ## ما الذي تمثّله إرشادات الشركة
</div>

تمثّل إرشادات الشركة توقعات مالية مستقبلية تصدر مباشرة عن إدارة الشركة. وعادةً ما تتضمّن نطاقات أو تقديرات للقيم المتوقعة لمقاييس أداء رئيسية مثل ربحية السهم (EPS) والإيرادات لفترة مالية محددة. تعكس الإرشادات التوقّعات الداخلية للإدارة، وافتراضاتها، ورؤيتها الاستراتيجية في وقت إصدارها.

<Note>
  على عكس النتائج المالية التاريخية، تُعد الإرشادات توقعات مستقبلية يمكن أن تتغيّر استنادًا إلى أوضاع السوق، وأداء الأعمال، والعوامل الخارجية.
</Note>

***

<div id="difference-between-guidance-vs-analyst-estimates">
  ## الفرق بين التوجيه وتقديرات المحللين
</div>

| الجانب            | توجيه الشركة                                  | تقديرات المحللين                     |
| ----------------- | --------------------------------------------- | ------------------------------------ |
| **المصدر**        | إدارة الشركة                                  | محللون ماليون مستقلون                |
| **الأساس**        | توقعات داخلية ورؤى تشغيلية                    | نماذج بحثية وافتراضات خارجية         |
| **المنظور**       | الأداء المتوقع من قِبل الإدارة                | توقعات إجماع السوق                   |
| **وتيرة التحديث** | يُصدَر بشكل دوري أو عند تغيّر التوقعات        | يُحدَّث باستمرار                     |
| **الهدف**         | توصيل النظرة المستقبلية وتحديد مستوى التطلعات | تقييم الأداء المستقبلي للشركة وتوقعه |

***

<div id="why-guidance-matters-for-forward-looking-analysis">
  ## لماذا تُعد الإرشادات مهمة في التحليل المستقبلي
</div>

تُعد الإرشادات مدخلاً حاسمًا في التحليل المستقبلي لأنها:

* **ترسّخ توقعات السوق** استنادًا إلى النظرة المستقبلية للإدارة
* **تشير إلى درجة الثقة أو الحذر** بشأن الأداء المستقبلي
* **توفر سياقًا** لتفسير نتائج الأرباح
* **تساعد في تقييم التغيّرات في الاتجاه** مثل رفع أو خفض أو تأكيد التوقعات

<Tip>
  يقارن المستثمرون والمحللون غالبًا بين الإرشادات الحالية والإرشادات السابقة وتوقعات المحللين لتقييم الزخم ومخاطر التنفيذ والاتجاه الاستراتيجي.
</Tip>

***

<div id="data-source-company-management-disclosures">
  ## مصدر البيانات: إفصاحات إدارة الشركة
</div>

تُستمد بيانات التوجيه مباشرةً من الاتصالات الرسمية الصادرة عن الشركات، بما في ذلك:

* مكالمات الأرباح
* البيانات الصحفية الخاصة بالأرباح
* العروض التقديمية للمستثمرين
* الإفصاحات التنظيمية

<Note>
  تعكس كل بيانات التوجيه معلومات أُفصِح عنها صراحةً من قبل إدارة الشركة، وتُبنى بطريقة تحافظ على النطاقات والتقديرات والأطر الزمنية الأصلية كما قُدِّمت وقت الإعلان.
</Note>

***

<div id="guidance-api-developer-guide">
  ## دليل المطورين لواجهة برمجة التطبيقات Guidance
</div>

<div id="overview">
  ### نظرة عامة
</div>

توفر واجهة برمجة التطبيقات للتوجيه Guidance API بيانات مهيكلة للتوجيهات الاستشرافية الصادرة عن الشركات، بما في ذلك توقعات ربحية السهم وتوقعات الإيرادات. تعكس هذه التوجيهات توقعات الإدارة لفترة مالية محددة، وهي عنصر أساسي للتحليل الاستشرافي، والمقارنة، وسير العمل القائم على الأحداث.

***

<div id="guidance-metrics">
  ## مقاييس التوجيه المستقبلي
</div>

<div id="eps-guidance">
  ### إرشادات ربحية السهم (EPS)
</div>

قد يتضمن كل سجل من سجلات الإرشادات ما يلي:

| الحقل              | الوصف                                   |
| ------------------ | --------------------------------------- |
| `eps_guidance_min` | الحد الأدنى لتوقع ربحية السهم           |
| `eps_guidance_max` | الحد الأقصى لتوقع ربحية السهم           |
| `eps_guidance_est` | نقطة المنتصف المتوقعة لتوقع ربحية السهم |
| `eps_type`         | الأساس المحاسبي (GAAP أو معدَّل)        |

<div id="revenue-guidance">
  ### إرشادات الإيرادات
</div>

قد يتضمّن كل سجل للإرشادات ما يلي:

| Field                  | Description                       |
| ---------------------- | --------------------------------- |
| `revenue_guidance_min` | الحد الأدنى لتوقع الإيرادات       |
| `revenue_guidance_max` | الحد الأقصى لتوقع الإيرادات       |
| `revenue_guidance_est` | تقدير نقطة الوسط للإيرادات        |
| `revenue_type`         | الأساس المحاسبي (GAAP أو مُعدَّل) |

<div id="prior-vs-current-guidance">
  ### التوجيه السابق مقابل التوجيه الحالي
</div>

| الحقل                        | الوصف                                |
| ---------------------------- | ------------------------------------ |
| `eps_guidance_prior_min`     | الحد الأدنى السابق لتوقع ربحية السهم |
| `eps_guidance_prior_max`     | الحد الأقصى السابق لتوقع ربحية السهم |
| `revenue_guidance_prior_min` | الحد الأدنى السابق لتوقع الإيرادات   |
| `revenue_guidance_prior_max` | الحد الأقصى السابق لتوقع الإيرادات   |

<Tip>
  قارن التوجيه الحالي بالتوقعات السابقة لمعرفة ما إذا كانت الإدارة قد رفعت أو خفّضت أو أبقت على توقعاتها كما هي.
</Tip>

***

<div id="timing-and-period">
  ## التوقيت والفترة
</div>

| Field             | Description                         |
| ----------------- | ----------------------------------- |
| `period`          | الفترة المالية (مثل Q1, FY)         |
| `period_year`     | السنة المالية                       |
| `date` and `time` | تاريخ ووقت الإعلان                  |
| `updated`         | الطابع الزمني لآخر تحديث (Unix UTC) |
| `prelim`          | مؤشر أولي                           |

***

<div id="record-classification">
  ## تصنيف السجلات
</div>

<div id="primary-guidance">
  ### الإرشاد الأساسي
</div>

| الحقل        | الوصف                                                                       |
| ------------ | --------------------------------------------------------------------------- |
| `is_primary` | Y/N – يحدد السجل الافتراضي عندما توجد عدة إدخالات إرشاد للشركة/التاريخ نفسه |

<Note>
  يُعطى الإرشاد المعدّل أولوية على GAAP عند اختيار السجل الأساسي.
</Note>

<div id="confirmation-status">
  ### حالة التأكيد
</div>

| الحقل       | الوصف                                                                         |
| ----------- | ----------------------------------------------------------------------------- |
| `confirmed` | Y/N – تشير Y إلى توجيه رسمي من الشركة، وتشير N إلى توجيه متوقَّع (غير مؤكَّد) |

**التوجيه المؤكَّد** (`Y`) يمثّل إفصاحًا رسميًا من الشركة.

**التوجيه غير المؤكَّد** (`N`) يتم إنشاؤه تلقائيًا للأرباح القادمة، ويُحدَّث يوميًا، وقد يشمل:

* التوقيت المتوقَّع للإعلان
* المقاييس المتوقَّعة
* التصنيف الأساسي/الثانوي

***

<div id="security-identification">
  ## تعريف الورقة المالية
</div>

كل سجل مقترن بـ:

| Field      | Description                              |
| ---------- | ---------------------------------------- |
| `ticker`   | رمز التداول                              |
| `name`     | اسم الشركة                               |
| `cusip`    | معرّف CUSIP                              |
| `exchange` | البورصة التي تُتداول فيها الورقة المالية |

يضمن ذلك ربط الإرشادات بالشركة والورقة المالية الصحيحتين بدقة.

***

<div id="display-interpretation-guidelines">
  ## إرشادات العرض والتفسير
</div>

* استخدم **الإرشاد الأساسي** (`is_primary = Y`) للعروض الافتراضية
* اعرض النطاقات الكاملة عند توافرها؛ واستخدم التقديرات عند الضرورة
* **الإرشاد المؤكد** يُعد إفصاحًا رسميًا؛ أما **الإرشاد غير المؤكد** فهو استرشادي فقط
* يجب تفسير الإرشاد بالاقتران مع تقديرات المحللين والأداء التاريخي

***

<div id="error-handling">
  ## معالجة الأخطاء
</div>

| السيناريو                      | السلوك                          |
| ------------------------------ | ------------------------------- |
| لم تُرجَع أي بيانات            | مصفوفة إرشادات فارغة            |
| القيم الدنيا/العظمى غير متوفرة | إرشادات تقديرية فقط             |
| سجلات متعددة بدون علامة أساسية | يتم الحسم باستخدام `is_primary` |

***

<div id="frequently-asked-questions">
  ## الأسئلة الشائعة
</div>

<AccordionGroup>
  <Accordion title="ما هي التوجيهات غير المؤكدة؟">
    هي التوجيهات المتوقعة قبل إفصاح الشركة الرسمي. يتم تحديثها يوميًا وقد تتغيّر.

    **توفّر سجلات التوجيهات المتوقعة عدة مزايا رئيسية:**

    * يتم إنشاؤها تلقائيًا بمجرد تأكيد تواريخ الأرباح القادمة
    * تحديد التاريخ والوقت المتوقعين لإعلان التوجيه
    * التنبؤ بنوع التوجيه (ربحية السهم أو الإيرادات)، بما في ذلك معايير GAAP مقابل المقاييس المعدَّلة
    * التمييز بين التوجيهات الأساسية والثانوية ضمن الفترة المالية
    * تضمين تقديرات محدَّثة باستمرار، يتم تحديثها يوميًا حتى الإعلان الرسمي عن التوجيه
  </Accordion>

  <Accordion title="أي سجل يجب أن أستخدم بشكل افتراضي؟">
    السجل الذي يحتوي على `is_primary = Y`.
  </Accordion>

  <Accordion title="لماذا توجد عدة سجلات توجيهات للتاريخ نفسه؟">
    قد تصدر الشركات توجيهات وفق GAAP وتوجيهات معدَّلة، أو توجيهات لعدة مقاييس.
  </Accordion>

  <Accordion title="هل يمكن تعديل التوجيهات بعد تأكيدها؟">
    نعم، يمكن للشركات تحديث التوجيهات أو سحبها في إعلانات لاحقة.
  </Accordion>

  <Accordion title="لماذا قد تكون التوجيهات مفقودة لبعض الشركات؟">
    ليست كل الشركات تقدّم توجيهات رسمية.
  </Accordion>
</AccordionGroup>

***

<div id="related-apis">
  ## واجهات api ذات الصلة
</div>

<CardGroup cols={2}>
  <Card title="واجهة api لتقويم الأرباح" icon="calendar" href="/ar/api-reference/calendar-api/get-earnings">
    تتبّع أحداث الأرباح القادمة
  </Card>

  <Card title="واجهة api لتقويم الإرشادات" icon="compass" href="/ar/api-reference/calendar-api/get-guidance">
    احصل على بيانات إرشادات الشركة
  </Card>

  <Card title="واجهة api لتصنيفات المحللين" icon="users" href="/ar/api-reference/calendar-api/get-ratings">
    قارن الإرشادات بتوقعات المحللين
  </Card>

  <Card title="واجهة api للأساسيات المالية" icon="building" href="/ar/api-reference/fundamentals/overview">
    تحقّق من الإرشادات قياسًا بالأداء التاريخي
  </Card>
</CardGroup>