الفواتير دفتر الأستاذ

أين في لوحة التحكم: 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).

الوظيفة

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

المتطلبات

العنصر	المتطلب
الدور	مسؤول.
تفاصيل البائع	قم بتعيين الاسم القانوني، الرقم الضريبي، العنوان، بريد الاتصال و بادئة رقم الفاتورة في System › Settings › General، علامة التبويب Seller & invoicing (/settings?tab=seller)، بطاقة Seller details (printed on invoices).
الاعتمادات	Payment channels للأموال الواردة.

الأجزاء

علامة تبويب المشرف	ما تعرضه	الاستخدام النموذجي
Overview	الإيرادات اليوم وهذا الشهر، إجماليات دفتر الأستاذ حسب النوع (إيداع، رسوم، استرداد، تعديل، قسيمة)، الفواتير حسب الحالة، المبالغ المستردة المعلقة، الاختصارات، الإنفاق لكل خدمة في آخر 30 يوماً	فحص يومي
Transactions	دفتر أستاذ المحفظة، سطر واحد لكل حركة	توضيح رصيد العميل
Invoices	الفواتير، وعرض ثانٍ Orders مع كل عملية شراء لكل خدمة	البحث عن مستند، إعادة إرسال، تعيين كمدفوع
Top-ups	المدفوعات المستلمة عبر البوابات	التحقق من الدفع واسترداده
Payouts	استرداد البطاقات، مدفوعات الشركاء التابعين، مسحوبات الموزعين	الموافقة على الأموال الصادرة
Vouchers	رموز الشحن	راجع Promotions
Reports	الإيرادات، حسب الخدمة، حسب الموزع	المحاسبة

Transactions (ledger)

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

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

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

Invoices

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

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

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

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

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

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

عمليات شحن الرصيد (المدفوعات)

سطر واحد لكل محاولة: الوقت، العميل، بوابة الدفع والطريقة، النوع (شحن رصيد أو شحن تلقائي)، الحالة (معلقة، مكتملة، فاشلة، مستردة، متنازع عليها، ملغاة)، ما دفعه العميل، الرسوم، ما ذهب إلى المحفظة، مرجع البوابة ووقت الإكمال. تتمتع مدفوعات Stripe وPayPal المكتملة بإجراء استرداد الأموال (Refund). استخدم صفحات أحداث البوابة لمعرض شبكات الويب (webhooks) (Payment channels).

عمليات الدفع والصرف

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

التقارير

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

ما يراه العميل

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

التحقق

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

الحدود والملاحظات

• الإضافة فقط. لا توجد طريقة لتعديل أو حذف سطر دفتر الأستاذ؛ أضف تسوية مع ذكر السبب.
• العملة. المبالغ بالدولار الأمريكي؛ عملة العرض تجميلية (انظر Currency and exchange rates).
• الاسترداد إلى البطاقة يتم على خطوتين (طلب، ثم موافقة ضمن عمليات الدفع والصرف)؛ ولا يتم استرداد عملات USDT والتحويلات المصرفية إلى المصدر.
• كل شيء خاضع للتدقيق ضمن System › Logs › Admin actions مع السبب الذي أدخلته.
• الطلبات مقابل الفواتير. لا يتم فوترة الاستخدام بالساعة لكل ساعة؛ تقوم طريقة عرض الطلبات بتجميعه حسب اليوم لكي تتمكن من رؤيته على أي حال.

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

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