این راهنما، نقطهٔ شروع راهاندازی ماژول فاکتور رسمی WHMCS است. هدف این است که تنظیمات پایه، اطلاعات خریدار، صدور سند و روش ارتباط با حسابداری و سامانه مودیان را به ترتیب تکمیل کنید؛ هر مرحلهٔ ناقص میتواند ادامهٔ فرایند را متوقف کند.
برای شروع، ابتدا پیشنیازها و شیوهٔ ارسال را مشخص کنید. سپس مراحل راهاندازی را از فهرست زیر دنبال کنید. برای بررسی خطا، از راهنمای همان مرحله استفاده کنید تا مجبور به تغییر دوبارهٔ همهٔ تنظیمات نشوید.

ماژول چه کارهایی انجام میدهد؟
- فاکتور رسمی: صفحه قابل چاپ و PDF با مهر، امضا و QR تأیید اصالت، با شماره رسمی پیوسته برای هر سال مالی.
- پروفایل خریدار: هر مشتری چند خریدار حقیقی یا حقوقی دارد، با بررسی کد ملی و شناسه ملی و تأیید مدیر.
- ارسال مستقیم به مودیان: امضا و رمزنگاری صورتحساب با API نسخه ۲، بدون نرمافزار واسط.
- حسابداری: ثبت خودکار طرف حساب، فاکتور و دریافت در حسابفا. برای سپیدار، هلو و نرمافزارهای بدون API، خروجی Excel دارد.
- صدور فوری توسط مشتری: مشتری بدون انتظار، فاکتور رسمی را صادر میکند و مراحل را زنده میبیند.
- اصلاحیه، ابطال و برگشت از فروش: همه از صفحه همان فاکتور، با بهروزرسانی خودکار حسابداری.
تصاویر، حالتهای کاری و امکانات خرید در صفحهٔ معرفی ماژول فاکتور رسمی WHMCS آمدهاند. این صفحه روی ترتیب نصب و اتصال اجزا تمرکز دارد.
شروع سریع: ترتیب راهاندازی
- نصب: فایل zip را در پوشه اصلی WHMCS باز کنید و از System Settings ← Addon Modules ماژول «فاکتور رسمی و حسابداری» را فعال کنید. در ابزارها و گزارش ← بررسی سیستم همه موارد باید سبز باشند.
- تنظیمات پایه: در تنظیمات به ترتیب فروشنده، قانون فاکتور رسمی، مالیات و ارز، شمارهگذاری و کالا و خدمات را پر کنید.
- روش ارسال به مودیان را انتخاب کنید: مستقیم از ماژول یا از نرمافزار حسابداری. آموزش حالتهای ارسال و اتصال حسابفا.
- گواهی امضا بگیرید: کلید و CSR را داخل ماژول بسازید و گواهی را از مرکز صدور میانی بگیرید. آموزش ساخت CSR.
- ارسال مستقیم را فعال کنید: شناسه حافظه، گواهی و تاریخ شروع را ثبت و اتصال را تست کنید. آموزش اتصال به سامانه مودیان.
- شرح ردیفها: تعیین کنید چه شرحی به مودیان برود و مشتری از چه شرحهایی انتخاب کند. آموزش شرح کالا و خدمات.
- تجربه مشتری: صدور فوری را روشن کنید. آموزش صدور فوری.
- بعد از ارسال: برای اشتباهها و مرجوعیها اصلاحیه، ابطال و برگشت از فروش را بخوانید.
تا پایان کنترل اطلاعات، حالت پیشنمایش را حفظ کنید. در این حالت میتوانید فهرست اسناد آماده و اطلاعات ناقص را بررسی کنید، بدون اینکه صرفاً برای آزمودن تنظیمات، سند واقعی ارسال شود.
پیشنیازها
| مورد | حداقل |
|---|---|
| WHMCS | 8.0 و بالاتر |
| PHP | 7.4 تا ۸.۵، با افزونههای mbstring، gd، curl، zip، zlib و openssl |
| ionCube Loader | فعال |
| Cron | Cron اصلی WHMCS باید مرتب اجرا شود |
اگر به مشکل خوردید
اگر مرحلهای متوقف شد، پیام خطا و شمارهٔ فاکتور را در گزارش رویدادها و صفحهٔ همان سند بررسی کنید. راهنمای خطاهای رایج سامانه مودیان مسیر بررسی خطاهای گواهی، اعشار و ارسال را توضیح میدهد.
آموزشهای این مجموعه
- راهنمای کامل ماژول (همین صفحه)
- ۱. ساخت CSR و دریافت گواهی امضا
- ۲. اتصال مستقیم به سامانه مودیان
- ۳. اتصال حسابفا و حالتهای ارسال
- ۴. شرح کالا و خدمات در مودیان
- ۵. صدور فوری فاکتور رسمی
- ۶. اصلاحیه، ابطال و برگشت از فروش
- ۷. خطاهای رایج و راه حل
پرسشهای متداول
از کدام آموزش شروع کنم؟
ابتدا پیشنیازها و روش ارسال را بررسی کنید. برای مسیر مستقیم، ساخت CSR و ثبت گواهی و شناسهٔ حافظه مراحل بعدی هستند.
چه زمانی ارسال واقعی را روشن کنم؟
وقتی اطلاعات فروشنده و خریدار، نگاشت ردیفها، گواهی و مسیر ارسال را در پیشنمایش بررسی کردهاید و مسئول حسابداری نیز تنظیمات را تأیید کرده است.
