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

# التقارير

> طابق رصيدك، وراجع كل رسوم، وصدّر المدفوعات والتسويات والتحويلات ودفتر الرصيد بتنسيق CSV أو XLSX لأي نطاق زمني.

## مقدمة

**التقارير** هي المكان الذي تتتبّع فيه حركة الأموال وتنشئ عمليات التصدير. انتقل إلى
**الإعدادات → التقارير**.

تتكوّن الصفحة من ثلاثة أجزاء:

<CardGroup cols={3}>
  <Card title="Track Money Movement" icon="scale-balanced" href="#track-money-movement">
    عرضان مباشران يوضّحان رصيدك ورسومك على الشاشة.
  </Card>

  <Card title="Download Reports" icon="file-csv" href="#download-reports">
    أربعة تقارير تصدّرها لنطاق زمني بتنسيق CSV أو XLSX.
  </Card>

  <Card title="Generated Reports" icon="clock-rotate-left" href="#generated-reports">
    كل تقرير أنشأته من قبل، جاهز لإعادة تنزيله.
  </Card>
</CardGroup>

<Frame caption="Settings → Reports: live views, custom exports, and your report history">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/reports-hub.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=5ca9b31a0a29106dba531c8e1c5a7f9d" alt="علامة تبويب التقارير في الإعدادات، وتعرض تتبّع حركة الأموال وتنزيل التقارير والتقارير المُنشأة" style={{ maxHeight: '500px', width: 'auto' }} width="1400" height="700" data-path="images/reports/reports-hub.png" />
</Frame>

<Note>
  تتوفر التقارير في كلٍّ من **وضع الاختبار** و**الوضع المباشر**، ويقرأ كل منهما
  بيانات الوضع الخاص به فقط. بدّل الوضع من الشريط الجانبي قبل إنشاء التقرير.
</Note>

***

## تتبّع حركة الأموال

يجيب عرضان عن سؤال على الشاشة من دون تنزيل. يتطلب كل عرض نطاقًا
زمنيًا، ويحتوي على زر **تصدير** يحفظ العرض نفسه كملف.

### ملخص الرصيد والتحويلات

يطابق هذا العرض رصيدك للفترة المحددة. ويتضمن ثلاث كتل.

<Frame caption="Balance and Payout Summary: starting balance, activity breakdown, and payout detail">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/balance-and-payout-summary.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=5b0cfd57bb38fde17a0978bdb6fb56e1" alt="ملخص الرصيد والتحويلات، ويعرض كتلة ملخص الرصيد وكتلة تغيّر الرصيد الناتج عن النشاط" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="798" data-path="images/reports/balance-and-payout-summary.png" />
</Frame>

يعرض **ملخص الرصيد** الفترة من بدايتها إلى نهايتها.

| الصف                               | المعنى                                     |
| ---------------------------------- | ------------------------------------------ |
| الرصيد الافتتاحي                   | رصيدك عند بداية الفترة.                    |
| صافي تغيّر الرصيد الناتج عن النشاط | كل ما حدث خلال الفترة، باستثناء التحويلات. |
| إجمالي التحويلات                   | الأموال التي خرجت عبر التحويلات.           |
| الرصيد الختامي                     | الرصيد الافتتاحي + النشاط − التحويلات.     |

يفصّل **تغيّر الرصيد الناتج عن النشاط** مكوّنات الصف الأوسط.

| الصف                      | ما يتضمنه                                                                                                                                               |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| المدفوعات المستلمة        | المدفوعات الناجحة.                                                                                                                                      |
| المبالغ المستردة المُصدرة | المبالغ المستردة ورسومها، مطروحًا منها أي عكس لأي منهما.                                                                                                |
| النزاعات الخاسرة          | النزاعات ورسومها، مطروحًا منها أي عكس للنزاع.                                                                                                           |
| الرسوم المخصومة           | رسوم المدفوعات، ورسوم التحويلات، ورسوم التحصيل، ورسوم إعادة محاولة الدفع، ورسوم BYOP، ورسوم استرداد السلات المتروكة، ورسوم Ethoca، مطروحًا منها أي عكس. |
| الضريبة المخصومة          | الضريبة، مطروحًا منها أي عكس للضريبة.                                                                                                                   |
| الحركات الأخرى            | أرصدة Dodo، والتسويات اليدوية، وتحويل العملات.                                                                                                          |
| صافي تغيّر الرصيد         | مجموع الصفوف أعلاه.                                                                                                                                     |

<Note>
  تتضمن **الحركات الأخرى** الإدخالات التي لا تنتمي إلى أي صف مُسمّى أعلاه:
  **أرصدة Dodo** (الأرصدة التي تضيفها Dodo Payments إلى رصيدك)، و**التسويات
  اليدوية** (تصحيح ينشره فريقنا)، و**تحويل العملات** (الفرق المسجل عند تحويل
  الرصيد بين العملات).
</Note>

يسرد **تسوية التحويلات** كل تحويل خلال الفترة في صف مستقل، مع المبلغ الإجمالي، وكل خصم، وصافي المبلغ المحوّل.

<Frame caption="Payout Reconciliation: one row per payout, gross to net">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/payout-reconciliation.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=a6c50e1b10b010deae1cb020c1afa179" alt="قسم تسوية التحويلات، ويسرد كل تحويل مع مبلغه الإجمالي وخصوماته وصافي المبلغ المحوّل" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="790" data-path="images/reports/payout-reconciliation.png" />
</Frame>

<Tip>
  يطالب التحويل بكل إدخال غير مُطالب به في دفتر الحسابات حتى تاريخ القطع الخاص به، وليس
  المدفوعات الموجودة في الفترة فقط. لذلك يمكن أن تموّل أرصدة Dodo والتسويات جزءًا
  من التحويل، وتظهر ضمن **أخرى**.
</Tip>

### كل الرسوم

كل رسم أُخذ من رصيدك خلال الفترة، مع الإجمالي وتفصيل لكل معاملة.

<Frame caption="All Fees: a total, then every fee itemized by transaction">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/all-fees.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=bae2394ff27670737555d6237e792462" alt="صفحة كل الرسوم، وتعرض إجمالي ملخص الرسوم وقسم تفصيل الرسوم حسب المعاملة" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="426" data-path="images/reports/all-fees.png" />
</Frame>

***

## تنزيل التقارير

تنشئ أربعة تقارير ملفًا لأي نطاق زمني. يفتح كل تقرير لوحة تختار فيها
الفترة والتنسيق والفلاتر الخاصة بذلك التقرير.

يُصدّر كل تقرير بتنسيق **CSV** أو **XLSX**.

| التقرير                        | ما يتضمنه                                                       |
| ------------------------------ | --------------------------------------------------------------- |
| **تقرير المعاملات**            | كل دفعة تمت معالجتها، مع حالة كل معاملة.                        |
| **تقرير التسويات**             | المبالغ المستردة والنزاعات معًا — كل خصم من الرصيد في ملف واحد. |
| **تقرير التحويلات**            | ملخص للتحويلات، مع التفصيل الكامل للرسوم لكل فترة تحويل.        |
| **تقرير مطابقة دفتر الحسابات** | دفتر الرصيد، بصف واحد لكل حركة، لمطابقته مع كشف حسابك البنكي.   |

### تقرير المعاملات

<Frame caption="Create a Transactions Report">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/transactions-report-modal.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=11c1cae00fcd638dd6e38098f3c91def" alt="لوحة إنشاء تقرير المعاملات، مع فلاتر الفترة الزمنية والتنسيق وطريقة الدفع وحالة الدفع" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/transactions-report-modal.png" />
</Frame>

* **طريقة الدفع** — البطاقة، UPI، المحفظة، التحويل البنكي، إعادة التوجيه البنكي، الدفع الآجل، العملات المشفرة، أو الخصم البنكي. اختر **الكل** لجميع الطرق.
* **حالة الدفع** — ناجحة أو فاشلة أو معلّقة.

### تقرير التسويات

<Frame caption="Create an Adjustment Report">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/adjustments-report-modal.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=ab43d59e062dd154f6d190cfb733f75b" alt="لوحة إنشاء تقرير التسويات، مع فلاتر نوع التسوية وطريقة الدفع وحالة المبلغ المسترد وحالة النزاع" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/adjustments-report-modal.png" />
</Frame>

* **نوع التسوية** — الكل، أو المبالغ المستردة، أو النزاعات.
* **طريقة الدفع** — طرق الدفع الثماني نفسها المذكورة أعلاه.
* **حالة المبلغ المسترد** — ناجح أو فاشل أو معلّق.
* **حالة النزاع** — مفتوح، أو تم الطعن فيه، أو مقبول، أو خاسر، أو رابح، أو ملغى، أو منتهي الصلاحية.

### تقرير التحويلات

اختر فترة وتنسيقًا. لا يحتاج هذا التقرير إلى أي فلتر آخر.

<Frame caption="Create a Payout Report">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/payout-report-modal.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=ffbf9e7d57956c0172ecbad5460afab8" alt="لوحة إنشاء تقرير التحويلات، مع خيارات الفترة الزمنية والتنسيق" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/payout-report-modal.png" />
</Frame>

### تقرير مطابقة دفتر الحسابات

يتضمن هذا التقرير وضعين. استخدم **المطابقة حسب** لاختيار أحدهما.

<Frame caption="Create a Ledger Reconciliation Report, by period">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/ledger-report-modal.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=1a7eee33cfbb2115ec66236bf670bd70" alt="لوحة إنشاء تقرير مطابقة دفتر الحسابات مضبوطة على الفترة، وتعرض قائمة فلتر أنواع الأحداث" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/ledger-report-modal.png" />
</Frame>

يُصدّر وضع **الفترة** كل حركة في دفتر الحسابات ضمن نطاق زمني.

يُصدّر وضع **معرّف التحويل** حركات تحويل واحد. أدخل مرجع التحويل
(على سبيل المثال `pyt_kxncrebha`) للحصول على الصفوف الدقيقة التي سوّاها ذلك التحويل.

<Frame caption="Look up one payout by its reference ID">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/ledger-report-by-payout-id.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=48f49419884ae9d949ed7ad5425bb30e" alt="اللوحة نفسها مضبوطة على معرّف التحويل، وتعرض الحقل الذي يقبل مرجع التحويل" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/ledger-report-by-payout-id.png" />
</Frame>

<Note>
  يعرض معرّف التحويل غير الموجود خطأً، ولا يعرض ملفًا فارغًا.
</Note>

تعمل **أنواع الأحداث** على فلترة الصفوف حسب نوع حركة الرصيد. اختر
**الكل** للاحتفاظ بكل الأنواع، أو اختر من الأنواع التالية:

| المجموعة         | الخيارات                                                                                |
| ---------------- | --------------------------------------------------------------------------------------- |
| الأموال الواردة  | الدفع، أرصدة Dodo، التسوية، تحويل العملات                                               |
| التحويلات        | التحويل، عكس التحويل، رسوم التحويل، عكس رسوم التحويل                                    |
| المبالغ المستردة | المبلغ المسترد، عكس المبلغ المسترد، رسوم المبلغ المسترد، عكس رسوم المبلغ المسترد        |
| النزاعات         | النزاع، رسوم النزاع، عكس النزاع                                                         |
| الرسوم           | رسوم الدفع، رسم إعادة محاولة الدفع، رسوم التحصيل، رسم استرداد السلات المتروكة، رسم BYOP |
| الضريبة          | الضريبة، عكس الضريبة                                                                    |

لا يتضمن كل نوع عملية عكس. توجد عمليات العكس فقط للتحويل، ورسوم التحويل، والمبلغ المسترد، ورسوم المبلغ المسترد، والنزاع، والضريبة.

<Tip>
  استخدم وضع **معرّف التحويل** للإجابة عن سؤال «ماذا كان في هذا التحويل؟». استخدم **الفترة**
  مع **كل** أنواع الأحداث لمطابقة كشف حساب بنكي سطرًا بسطر.
</Tip>

***

## إنشاء تقرير وتنزيله

<Steps>
  <Step title="Open the report">
    انتقل إلى **الإعدادات → التقارير** واختر التقرير الذي تحتاج إليه.
  </Step>

  <Step title="Choose the period">
    اختر نطاقًا زمنيًا. لا تدخل في الملف إلا البيانات الواقعة ضمن هذا النطاق.
  </Step>

  <Step title="Choose the format and filters">
    اختر **CSV** أو **XLSX**، ثم اضبط فلاتر ذلك التقرير.
  </Step>

  <Step title="Download">
    اختر **تنزيل التقرير**. يُنزّل الملف، ويُضاف التقرير إلى **التقارير المُنشأة**.
  </Step>
</Steps>

يتضمن اسم الملف التقرير والنطاق الزمني، لذلك يمكن التعرّف على التنزيل
من دون فتحه — على سبيل المثال
`dodo_ledger_2026-06-01_to_2026-06-30.csv`.

<Note>
  يبدأ تصدير CSV بعلامة ترتيب بايتات UTF-8، لذلك يفتح Excel الأحرف ذات العلامات
  والنصوص غير اللاتينية بشكل صحيح.
</Note>

### حدود الصفوف

يخضع التصدير الواحد لحد أقصى، لذلك قد تحتاج الفترة الكبيرة إلى تقسيمها.

| التقرير              | CSV        | XLSX       |
| -------------------- | ---------- | ---------- |
| مطابقة دفتر الحسابات | 500,000 صف | 100,000 صف |
| كل تقرير آخر         | 100,000 صف | 50,000 صف  |

إذا تجاوز نطاقك الزمني الحد، يُرفض التصدير وتظهر رسالة. ضيّق النطاق أو أضف فلترًا، ثم أنشئه مرة أخرى.

<Tip>
  اختر CSV لفترة كبيرة، إذ إن حد صفوفه أعلى.
</Tip>

***

## التقارير المُنشأة

يُسجّل كل تقرير تنشئه، حتى تتمكن من تنزيله مرة أخرى دون إعادة إنشائه.

| العمود        | المعنى                             |
| ------------- | ---------------------------------- |
| التقرير       | نوع التقرير.                       |
| النطاق الزمني | الفترة التي يغطيها التقرير.        |
| التنسيق       | CSV أو XLSX.                       |
| الصفوف        | عدد الصفوف التي يحتوي عليها الملف. |
| أنشأه         | عضو الفريق الذي أنشأه.             |
| تاريخ الإنشاء | وقت إنشائه.                        |
| الحالة        | **مكتمل** أو **فاشل**.             |

يظل رابط التنزيل صالحًا لفترة قصيرة. إذا انتهت صلاحية الملف المخزن، تعيد Dodo Payments إنشاءه باستخدام المعلمات نفسها، ويُعلَّم الصف بأنه أُعيد إنشاؤه.

<Warning>
  قد يختلف التقرير المُعاد إنشاؤه عن التقرير الأصلي. تستمر البيانات التي يستند إليها النطاق الزمني في التغيّر — إذ يظهر في إعادة الإنشاء مبلغ مسترد أو نزاع سُجّل بعد الإنشاء الأول. احتفظ بالملف الذي نزّلته إذا كنت تحتاج إلى الأرقام كما كانت تمامًا.
</Warning>

***

## ما التقرير الذي أحتاج إليه؟

| السؤال                                 | التقرير                                     |
| -------------------------------------- | ------------------------------------------- |
| لماذا رصيدي بهذا الرقم؟                | ملخص الرصيد والتحويلات                      |
| ماذا كان في هذا التحويل؟               | مطابقة دفتر الحسابات، حسب **معرّف التحويل** |
| ما الرسوم التي دفعتها؟                 | كل الرسوم                                   |
| أحتاج إلى كل دفعة لمحاسبي.             | تقرير المعاملات                             |
| كم كلّفتني المبالغ المستردة والنزاعات؟ | تقرير التسويات                              |
| أحتاج إلى مطابقة كشف حسابي البنكي.     | مطابقة دفتر الحسابات، حسب **الفترة**        |

***

## أفضل الممارسات

<Tip>
  * ابدأ المطابقة باستخدام **ملخص الرصيد والتحويلات**. نزّل تقريرًا تفصيليًا فقط عندما يحتاج أحد الأرقام إلى تفسير.
  * صدّر **CSV** لفترة طويلة، واستخدم **XLSX** فقط عندما تعمل على الملف يدويًا.
  * احتفظ بالملف الذي نزّلته. لا يُضمن أن تتطابق إعادة الإنشاء معه.
  * طبّق الفلترة قبل توسيع النطاق الزمني. يساعد الفلتر على إبقاء التصدير ضمن حد الصفوف.
</Tip>

<Warning>
  إذا بدا أحد الأرقام غير صحيح، فتحقق أولًا من النطاق الزمني والفلاتر. وإذا ظل غير صحيح، فتواصل مع <a href="mailto:support@dodopayments.com">[support@dodopayments.com](mailto:support@dodopayments.com)</a>
  مع ذكر نوع التقرير والفترة.
</Warning>

## الخطوات التالية

<CardGroup cols={2}>
  <Card title="Dashboard Analytics" icon="chart-line" href="/features/analytics-and-reporting">
    تتبّع الإيرادات والعملاء والاحتفاظ بالعملاء وصحة المعاملات.
  </Card>

  <Card title="Account Summary & Payout Wallet" icon="wallet" href="/features/account-summary-payout-wallet">
    تعرّف على أرباحك وخصوماتك ودورات التحويلات.
  </Card>

  <Card title="Payout Structure" icon="money-bill-transfer" href="/features/payouts/payout-structure">
    اطّلع على كيفية وصول التحويلات إلى حسابك البنكي وموعد وصولها.
  </Card>

  <Card title="Refunds" icon="rotate-left" href="/features/transactions/refunds">
    ابدأ عمليات رد الأموال وتابعها.
  </Card>
</CardGroup>
