---
title: الفواتير دفتر الأستاذ
description: مكان تسجيل الأموال في NexCMP - دفتر أستاذ المحفظة، الفواتير، مدفوعات الشحن، الاستردادات وعمليات الدفع، قسائم الشراء وتقارير الإيرادات.
url: https://nexcmp.com/ar/docs/billing/invoices-and-ledger/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# الفواتير دفتر الأستاذ {#invoices-and-ledger}

> **أين في لوحة التحكم:** Finance › Billing (`/billing`) مع تبويبات Overview و Transactions (`/billing/ledger`) و Invoices (`/billing/invoices`) و Top-ups (`/billing/deposits`) و Payouts (`/billing/payouts`) و Vouchers (`/billing/vouchers`) و Reports (`/billing/reports`). **أين في بوابة العملاء:** Billing (`/billing`).

## الوظيفة {#what-it-does}

يتم تخزين كل مبلغ في NexCMP كسنتاً بالدولار الأمريكي وتسجيله مرة واحدة. الفكرة الأساسية: **دفتر أستاذ المحفظة** هو مصدر الحقيقة للأرصدة؛ الفواتير ومدفوعات الشحن والتقارير هي عروض مبنية عليه. دفتر الأستاذ **يقتصر على الإضافة فقط** — يتم إصلاح الخطأ إضافة قيد عكسي، وليس عن طريق تعديل السجل أبداً.

## المتطلبات {#requirements}

| العنصر | المتطلب |
|---|---|
| الدور | مسؤول. |
| تفاصيل البائع | قم بتعيين الاسم القانوني، الرقم الضريبي، العنوان، بريد الاتصال و بادئة رقم الفاتورة في **System › Settings › General**، علامة التبويب **Seller & invoicing** (`/settings?tab=seller`)، بطاقة **Seller details (printed on invoices)**. |
| الاعتمادات | [Payment channels](https://nexcmp.com/ar/docs/billing/payment-channels/) للأموال الواردة. |

## الأجزاء {#the-pieces}

| علامة تبويب المشرف | ما تعرضه | الاستخدام النموذجي |
|---|---|---|
| **Overview** | الإيرادات اليوم وهذا الشهر، إجماليات دفتر الأستاذ حسب النوع (إيداع، رسوم، استرداد، تعديل، قسيمة)، الفواتير حسب الحالة، المبالغ المستردة المعلقة، الاختصارات، الإنفاق لكل خدمة في آخر 30 يوماً | فحص يومي |
| **Transactions** | دفتر أستاذ المحفظة، سطر واحد لكل حركة | توضيح رصيد العميل |
| **Invoices** | الفواتير، وعرض ثانٍ **Orders** مع كل عملية شراء لكل خدمة | البحث عن مستند، إعادة إرسال، تعيين كمدفوع |
| **Top-ups** | المدفوعات المستلمة عبر البوابات | التحقق من الدفع واسترداده |
| **Payouts** | استرداد البطاقات، مدفوعات الشركاء التابعين، مسحوبات الموزعين | الموافقة على الأموال الصادرة |
| **Vouchers** | رموز الشحن | راجع [Promotions](https://nexcmp.com/ar/docs/billing/promotions/) |
| **Reports** | الإيرادات، حسب الخدمة، حسب الموزع | المحاسبة |

### Transactions (ledger) {#transactions-ledger}

الأعمدة: الوقت، العميل، **النوع**، الخدمة، المبلغ (موقع)، الجهاز الظاهري (VM)، المرجع، الفاعل، الملاحظة. المرشحات: النوع، الخدمة، معرف العميل، الموقع (عندما يكون لديك موزعون)، نطاق التاريخ، ورابط الجهاز الظاهري (VM).

| النوع | المعنى |
|---|---|
| `deposit` | شحن من بوابة |
| `charge` | الأموال المأخوذة مقابل خدمة (طلب، تجديد، استخدام بالساعة ...) |
| `refund` | الأموال المعادة إلى المحفظة |
| `adjust` | رصيد دائن أو مدين من المسؤول، وأيضاً رموز الشحن (المرجع يبدأ بـ `vch:`) — تعرض النظرة العامة القسائم كسطر خاص بها |

كل صف له مرجع مثل `dep:stripe:<payment-id>`؛ ولا يمكن كتابة نفس المرجع مرتين أبداً، ولهذا السبب لا يمكن لخطأ الويب المتكرر (webhook) أن يمنح رصيداً مرتين. استخدم **Customers › List › customer › Credit / debit** لإضافة تعديل يدوي: السبب إلزامي، والمبلغ الموجب يحاول أيضاً إلغاء قفل الأجهزة الظاهرية (VMs) المقفلة لعدم وجود رصيد، ويتم تأكيد الإجراء في خطوتين.

![علام تبويب المعاملات تعرض صفوف دفتر الأستاذ للمحفظة مع النوع والخدمة والمبلغ والمرجع](https://nexcmp.com/ar/docs/images/billing/invoices-and-ledger-01-ledger.webp)

### Invoices {#invoices}

يتم إنشاء الفاتورة تلقائياً عندما يقوم العميل بشراء أو تجديد شيء مدفوع من المحفظة، أو مقابل عملية شحن. تبدو الأرقام مثل `<prefix><YYYYMM>-<000001>` (على سبيل المثال `NX202610-000042`)؛ تستخدم مواقع الموزعين بادئة وتسلسلاً خاصين بها. لا تتغير الأرقام الموجودة أبداً عند تغيير البادئة.

| الحقل | القيم |
|---|---|
| النوع | إيصال، تجديد، شحن، يدوي، استرداد |
| Status | غير مدفوع، مدفوع، متأخر، ملغى، مسترد |

الإجراءات على الصف:

| الإجراء | التأثير |
|---|---|
| **View** / **Print** | يفتح الفاتورة؛ ويمكن للبوابة أيضاً طباعتها أو حفظها كملف PDF. |
| **Mark paid** (غير مدفوع أو متأخر فقط) | يتم وضع علامة مدفوع **دون نقل أموال المحفظة** — يُستخدم عندما يدفع لك العميل خارج NexCMP. السبب مطلوب. بالنسبة لفاتورة التجديد، فإنها تمدد أيضاً الجهاز الوهمي المقفل وتلغي قفله. |
| **إلغاء** (للغير مدفوعة أو المتأخرة فقط) | يلغي الفاتورة. السبب مطلوب. |
| **إعادة إرسال** | يرسل الفاتورة بالبريد الإلكتروني مرة أخرى. |

**إنشاء فاتورة يدوية** (زر في أعلى علامة التبويب): معرف العميل، من 1 إلى 50 بنداً (الوصف، الكمية، سعر الوحدة)، معرف الجهاز الوهمي الاختياري، أيام الاستحقاق الاختيارية (من 0 إلى 365، الافتراضي 7)، ملاحظة اختيارية. يتم إنشاؤها كغير مدفوعة؛ ويراها العميل في **Billing › Invoice History**.

تُسدَّد فواتير الخدمات غير المدفوعة **تلقائياً من المحفظة** بمجرد توفر الأموال، لذا فإن إجراء العميل يقتصر ببساطة على إضافة رصيد.


### عمليات شحن الرصيد (المدفوعات) {#top-ups-payments}

سطر واحد لكل محاولة: الوقت، العميل، **بوابة الدفع والطريقة**، النوع (شحن رصيد أو شحن تلقائي)، الحالة (معلقة، مكتملة، فاشلة، مستردة، متنازع عليها، ملغاة)، ما دفعه العميل، الرسوم، ما ذهب إلى المحفظة، مرجع البوابة ووقت الإكمال. تتمتع مدفوعات Stripe وPayPal المكتملة بإجراء **استرداد الأموال** (Refund). استخدم صفحات أحداث البوابة لمعرض شبكات الويب (webhooks) ([Payment channels](https://nexcmp.com/ar/docs/billing/payment-channels/)).

### عمليات الدفع والصرف {#payouts}

ثلاث علامات تبويب فرعية: **استرداد البطاقات** (الموافقة على طلبات الاسترداد أو رفضها؛ يتم إنشاء الطلب من عملية دفع مكتملة)، **مدفوعات الشركاء التابعين** (سحب العمولات) و**مسحوبات الموزعين**. يتم تدقيق كل قرار.

### التقارير {#reports}

**الإيرادات** (اتجاه 30 يوماً، شهراً بعد شهر، كبار العملاء)، **حسب الخدمة** و**حسب الموزع**.

![علامة تبويب التقارير التي تعرض مؤشرات الأداء الرئيسية للإيرادات واتجاه الثلاثين يوماً](https://nexcmp.com/ar/docs/images/billing/invoices-and-ledger-03-reports.webp)

## ما يراه العميل {#what-the-customer-sees}

في **Billing**، يمتلك العميل **Balance**، و**Deposit**، و**Redeem code**، و**Settings** (الشحن التلقائي) وسجلًا يحتوي على علامات التبويب **Invoice History**، و**Payment Order**، و**Ledger**، و**Orders** (كل خدمة في قائمة واحدة مع عوامل تصفية حسب الخدمة والنوع). تحتوي كل فاتورة على **View**، و**Print**، و**Save as PDF**؛ المبالغ بالدولار الأمريكي، وتُعرض اختياريًّا بعملة العرض.

## التحقق {#verify}

1. قم بإجراء عملية شحن رصيد صغيرة كعميل اختبار.
2. **Transactions** يوضح `deposit` السطر، ويظهر **Top-ups** الدفع كـ *Completed*، وتزداد إيرادات **Overview**.
3. قم بشراء شيء ما: يظهر `charge` سطر، وتعرض **Invoices** فاتورة *Receipt* أو *Renewal* مع تفاصيل البائع التي قمت بتكوينها.

## الحدود والملاحظات {#limits-notes}

- **الإضافة فقط.** لا توجد طريقة لتعديل أو حذف سطر دفتر الأستاذ؛ أضف تسوية مع ذكر السبب.
- **العملة.** المبالغ بالدولار الأمريكي؛ عملة العرض تجميلية (انظر [Currency and exchange rates](https://nexcmp.com/ar/docs/catalog/currency-and-exchange-rates/)).
- **الاسترداد إلى البطاقة** يتم على خطوتين (طلب، ثم موافقة ضمن عمليات الدفع والصرف)؛ ولا يتم استرداد عملات USDT والتحويلات المصرفية إلى المصدر.
- **كل شيء خاضع للتدقيق** ضمن System › Logs › Admin actions مع السبب الذي أدخلته.
- **الطلبات مقابل الفواتير.** لا يتم فوترة الاستخدام بالساعة لكل ساعة؛ تقوم طريقة عرض الطلبات بتجميعه حسب اليوم لكي تتمكن من رؤيته على أي حال.

## استكشاف الأخطاء وإصلاحها {#troubleshooting}

| العَرَض | السبب | الحل |
|---|---|---|
| رصيد العميل يبدو غير صحيح | رسوم أو تسوية أو قسيمة لم تكن تتوقعها | قم بتصفية **Transactions** حسب معرف العميل واقرأ المراجع والملاحظات. |
| "الفاتورة مدفوعة بالفعل" (409) | وضع علامة مدفوع على فاتورة مدفوعة بالأصل | لا شيء للقيام به. |
| تعذر إلغاء الفاتورة | يمكن إلغاء الفواتير غير المدفوعة أو المتأخرة فقط | بالنسبة للفواتير المدفوعة، استخدم استرداد الأموال أو التسوية. |
| تفاصيل البائع مفقودة على الفواتير | لم يتم تعبئتها | أكمل **Seller details** في System › Settings › General › Seller & invoicing. |
| تم رفض بطاقة الائتمان / الخصم | المبلغ صفر أو يزيد عن $100,000 | استخدم مبلغاً يتراوح بين 1 سنت و $100,000. |
| تظل حالة الدفع *Pending* لفترة طويلة | Webhook مفقود | راجع **Gateway events** وقدم إعادة تشغيل. |