ماژول فاکتور رسمی WHMCS برای کسبوکارهایی طراحی شده که میخواهند صدور سند، اطلاعات خریدار و ثبت حسابداری را در یک مسیر مدیریت کنند. در شرکتهای هاستینگ، ورود دوبارهٔ اطلاعات هر پرداخت در فایلهای جداگانه، پیگیری اسناد را دشوار میکند؛ این ماژول فرایند را به صورتحساب WHMCS متصل میکند.
مشتری پروفایل خریدار را ثبت میکند و پس از تکمیل شرایط صدور، فاکتور رسمی با شمارهٔ مستقل، نسخهٔ قابل چاپ، PDF و QR در اختیارش قرار میگیرد. اتصال حسابفا برای ثبت آنلاین اسناد در نظر گرفته شده است؛ برای نرمافزارهایی که اتصال API ندارند نیز خروجی Excel و CSV با ستونبندی قابل تنظیم وجود دارد.

امکانات ماژول فاکتور رسمی WHMCS در یک نگاه
- فاکتور رسمی استاندارد: قالب «صورتحساب فروش کالا و خدمات»، صفحه وب قابل چاپ، PDF، مهر و امضا و QR تایید اصالت.
- سه حالت کاری برای سه نوع شرکت: همه صورتحسابها رسمی، رسمی بر اساس قانون (مبلغ، گروه مشتری، نوع صورتحساب) یا حالت ترکیبی که مشتری خودش تصمیم میگیرد کدام صورتحساب رسمی شود.
- پروفایلهای خریدار: هر مشتری چند خریدار (حقیقی، حقوقی، مشارکت مدنی، اتباع) با بررسی کد ملی و شناسه ملی و تایید مدیر.
- شماره رسمی پیوسته برای هر سال مالی، بدون شکاف و مستقل از شماره صورتحساب WHMCS.
- اتصال مستقیم به حسابفا: ثبت طرف حساب، خدمت، فاکتور و دریافت؛ بدون ثبت تکراری و با ادامه خودکار بعد از خطا.
- خروجی Excel و CSV برای سپیدار، هلو، محک، راهکاران و سامانه مودیان، با ستونبندی دلخواه.
- فاکتور نسیه برای مشتریانی که قبل از پرداخت فاکتور رسمی لازم دارند.
- طراح قالب بلوکی با پیشنمایش زنده و قالب جدا برای گروههای مشتری.
- ابزار مهاجرت: ساخت فاکتور رسمی برای صورتحسابهای گذشته و انتقال اطلاعات خریداران از روش قبلی.
- سازگار با PHP 7.4 تا ۸.۵ و بدون نیاز به تغییر در هسته WHMCS.
انتخاب حالت صدور فاکتور رسمی برای کسبوکار
پیش از راهاندازی، مشخص کنید چه صورتحسابهایی باید در مسیر صدور رسمی قرار بگیرند. ماژول سه الگوی کاری دارد تا تنظیمات با فرایند فروش کسبوکار هماهنگ شود:
| نوع شرکت | حالت مناسب در ماژول |
|---|---|
| همه فروشها با ارزش افزوده است | «همه صورتحسابها رسمیاند»: هر صورتحساب پرداختشده فاکتور رسمی میگیرد و ماژول بیشتر برای ثبت در حسابداری، خروجی و ارسال به مودیان استفاده میشود. |
| فقط بخشی از فروش رسمی است و قاعده مشخصی دارد | «قانون همین ماژول»: مثلاً فقط صورتحسابهای بالای ۲۰۰ هزار تومان، فقط گروه «مشتریان سازمانی» یا فقط افزایش اعتبار رسمی شوند. |
| مشتری خودش انتخاب میکند | «ترکیبی»: مشتری با پروفایل پیشفرض همیشه فاکتور رسمی میگیرد؛ نمایندهای که سرویس را به دیگران میفروشد پیشفرض ندارد و فقط برای صورتحسابهایی که خودش بخواهد «درخواست فاکتور رسمی» میدهد. |
حالت ترکیبی: رسمی شدن صورتحساب قبل از پرداخت
در حالت ترکیبی، وضعیت صدور رسمی پیش از پرداخت مشخص میشود. ماژول مالیات صورتحساب را بر اساس تنظیمات مربوط اعمال میکند تا مشتری مبلغ نهایی را پیش از پرداخت ببیند. درگاههای پرداخت سازگار نیز میتوانند از همین وضعیت برای نمایش مسیر پرداخت مناسب استفاده کنند.

- مشتری با پروفایل پیشفرض تاییدشده: صورتحسابهای جدیدی که شرایط شما را دارند (حداقل مبلغ، نوع صورتحساب، گروه مشتری) هنگام ساخت خودکار رسمی میشوند و ارزش افزوده میگیرند.
- مشتری با پروفایل تاییدشده ولی بدون پیشفرض: روی هر صورتحساب پرداختنشده دکمه «درخواست فاکتور رسمی» میبیند، خریدار را انتخاب میکند و صورتحساب با ارزش افزوده رسمی میشود.
- مشتری بدون پروفایل: هیچ تغییری نمیبیند و صورتحسابهایش مثل قبل غیررسمی است.

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


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

کنترل کامل برای مدیر
مدیر در صفحهٔ صورتحساب پرداختنشده، پروفایل خریدار و منبع رسمی شدن آن را میبیند. از همین بخش میتواند با انتخاب خریدار، وضعیت صورتحساب را تغییر دهد یا در شرایط مجاز، آن را به حالت غیررسمی برگرداند.


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


فاکتور رسمی برای مشتری: صفحه وب، PDF و QR
پس از صدور، لینک «فاکتور رسمی» کنار صورتحساب مربوط قرار میگیرد. مشتری میتواند نسخهٔ وب را چاپ کند یا PDF بگیرد. برای دسترسی سادهتر، لینک PDF را میتوان در قالب ایمیل صورتحساب هم قرار داد.


QR مشتری را به صفحهٔ بررسی سند در همین سامانه هدایت میکند. در این صفحه، شماره، تاریخ، خریدار و مبلغ قابل مشاهدهاند. این بررسیِ سند را با استعلام وضعیت ثبت صورتحساب در سامانهٔ مودیان یکسان در نظر نگیرید.

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

ثبت خودکار در حسابفا
در اتصال حسابفا، ثبت سند به مراحل طرف حساب، کالا یا خدمت، فاکتور و دریافت وجه تقسیم میشود. حساب هر درگاه پرداخت را به بانک یا صندوق مناسب نگاشت کنید. اگر یک مرحله خطا داشته باشد، گزارش آن برای مدیر ثبت میشود و اجرای بعدی Cron ادامهٔ فرایند را پیگیری میکند. وضعیت شمارهٔ مالیاتی را مطابق روش ارسال انتخابی بررسی کنید.


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

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

خروجی Excel برای سپیدار، هلو، محک و سامانه مودیان
در بخش خروجی فایل، قالب xlsx، xls یا CSV را متناسب با نرمافزار مقصد انتخاب کنید. پیشتنظیمها شامل فاکتورها، اقلام، سند حسابداری، اشخاص، کالا و خدمات و قالب فایل مودیان هستند. ترتیب و عنوان ستونها، تاریخ و نویسههای فارسی قابل تنظیماند. پیش از ورود گروهی، یک خروجی نمونه را با الگوی نرمافزار مقصد تطبیق دهید.


داشبورد و مدیریت سندها
داشبورد، وضعیت فاکتورها، خطاهای اخیر و گزارش ماهانه را کنار هم نمایش میدهد. برای یافتن سند، از فیلتر مشتری، تاریخ و وضعیت استفاده کنید. عملیات گروهی و اقدامهای هر سند را پس از بررسی وضعیت ثبت و ارسال آن انجام دهید تا کارهای معوق از اسناد تکمیلشده تفکیک شوند.



انتقال صورتحسابها و اطلاعات قبلی
- صورتحسابهای گذشته: برای صورتحسابهایی که قبل از نصب ماژول پرداخت شدهاند، با پیشنمایش و به ترتیب تاریخ فاکتور رسمی بسازید. اگر قبلاً آنها را در حسابفا ثبت کردهاید، علامت «ثبتشده» میگیرند تا دوباره ارسال نشوند.
- انتقال پروفایلها: اگر کد ملی یا شناسه ملی مشتریان را قبلاً در ستونهای اضافه جدول مشتریان نگه میداشتید، ابزار انتقال از آنها پروفایل خریدار میسازد.
- بررسی سیستم: پیشنیازها، Cron و ساخت PDF با یک کلیک بررسی میشوند.

پیشنیازهای نصب ماژول در WHMCS
| پیشنیاز | حداقل |
|---|---|
| WHMCS | 8.0 یا بالاتر (سازگار با WHMCS 9) |
| PHP | 7.4 تا ۸.۵، با افزونههای mbstring، gd، curl، zip و zlib |
| ionCube Loader | فعال |
| Cron | Cron اصلی WHMCS فعال باشد |
نصب و راهاندازی
- ماژول را از دکمه پایین صفحه خریداری کنید و فایل آن را از ناحیه کاربری (سرویسها ← لایسنسهای من) دانلود کنید.
- فایل zip را در پوشه اصلی WHMCS باز کنید تا پوشه
modules/addons/officialInvoiceساخته شود. - در پنل مدیریت به System Settings ← Addon Modules بروید، «فاکتور رسمی و حسابداری» را فعال کنید، کلید لایسنس را وارد کنید و دسترسی گروههای مدیر را تعیین کنید.
- از منوی Addons ← فاکتور رسمی و حسابداری وارد ماژول شوید و در تنظیمات، اطلاعات فروشنده، حالت کاری، مالیات و حسابداری را تعیین کنید.
- از ابزارها ← بررسی سیستم مطمئن شوید همه موارد سبز هستند.
اگر ارتباط با سرور لایسنس برقرار نیست و سرویس شما از فعالسازی آفلاین پشتیبانی میکند، کلید مربوط را از ناحیهٔ کاربری دریافت و طبق راهنمای همان سرویس ثبت کنید.
پرسشهای متداول
| پرسش | پاسخ |
|---|---|
| شماره صورتحسابهای WHMCS عوض میشود؟ | خیر. شماره رسمی فاکتور مستقل است و برای هر سال مالی پیوسته و بدون شکاف شمارهگذاری میشود. |
| نرمافزار حسابداری ما حسابفا نیست؛ به کارمان میآید؟ | بله. همه امکانات فاکتور رسمی، پروفایلها و قالب مستقل از حسابداری کار میکنند و برای ثبت در نرمافزار خودتان خروجی Excel با ستونهای دلخواه میگیرید. |
| مشتری بعد از پرداخت میتواند خریدار را عوض کند؟ | تا پایان مهلتی که خودتان تعیین میکنید (پیشفرض ۲۴ ساعت) بله؛ پس از صدور، اطلاعات فاکتور ثابت میشود. |
| اگر ارسال به حسابفا خطا بدهد چه میشود؟ | خطا با متن فارسی در داشبورد دیده میشود و پس از رفع، ارسال از همان مرحله ناموفق ادامه پیدا میکند؛ چیزی دو بار ثبت نمیشود. |
| به ماژول درگاه پرداخت خاصی وابسته است؟ | خیر. با همه درگاههای WHMCS کار میکند. اگر ماژول درگاه چندگانه (multiGateWay) را هم داشته باشید، درگاههای رسمی و غیررسمی بر اساس رسمی بودن صورتحساب بهطور خودکار نمایش داده میشوند. |
برای مشاهدهٔ شرایط، قیمت فعلی و انتخاب مجوز، وارد صفحهٔ سفارش شوید. پیش از خرید، نسخهٔ WHMCS، PHP و شیوهٔ حسابداری خود را مشخص کنید تا سازگاری سرویس قابل بررسی باشد.
آموزش راهاندازی و سامانه مودیان
برای راهاندازی مرحلهبهمرحله، از راهنمای ماژول فاکتور رسمی و سامانه مودیان شروع کنید. آموزشهای تخصصی هر بخش در ادامه آمدهاند:
- ساخت CSR و دریافت گواهی امضای سامانه مودیان برای شخص حقیقی و حقوقی
- اتصال مستقیم WHMCS به سامانه مودیان: شناسه حافظه، تاریخ شروع و ارسال واقعی
- اتصال WHMCS به حسابفا و انتخاب روش ارسال صورتحساب به سامانه مودیان
- شرح کالا و خدمات در سامانه مودیان: شرح پیشفرض و شرحهای مجاز برای مشتری
- صدور فوری فاکتور رسمی توسط مشتری در WHMCS با نمایش مراحل مودیان
- اصلاحیه، ابطال و برگشت از فروش در سامانه مودیان از داخل WHMCS
- خطاهای رایج سامانه مودیان و گواهی امضا: علت و راه حل
