ماژول فاکتور رسمی WHMCS؛ حسابفا و سامانه مودیان

26 آبان 1405

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

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

فاکتور رسمی صادرشده با ماژول فاکتور رسمی WHMCS
فاکتور رسمی صادرشده: اطلاعات فروشنده و خریدار، اقلام، ارزش افزوده، مهر و امضا و QR تایید اصالت

امکانات ماژول فاکتور رسمی WHMCS در یک نگاه

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

انتخاب حالت صدور فاکتور رسمی برای کسب‌وکار

پیش از راه‌اندازی، مشخص کنید چه صورتحساب‌هایی باید در مسیر صدور رسمی قرار بگیرند. ماژول سه الگوی کاری دارد تا تنظیمات با فرایند فروش کسب‌وکار هماهنگ شود:

نوع شرکتحالت مناسب در ماژول
همه فروش‌ها با ارزش افزوده است«همه صورتحساب‌ها رسمی‌اند»: هر صورتحساب پرداخت‌شده فاکتور رسمی می‌گیرد و ماژول بیشتر برای ثبت در حسابداری، خروجی و ارسال به مودیان استفاده می‌شود.
فقط بخشی از فروش رسمی است و قاعده مشخصی دارد«قانون همین ماژول»: مثلاً فقط صورتحساب‌های بالای ۲۰۰ هزار تومان، فقط گروه «مشتریان سازمانی» یا فقط افزایش اعتبار رسمی شوند.
مشتری خودش انتخاب می‌کند«ترکیبی»: مشتری با پروفایل پیش‌فرض همیشه فاکتور رسمی می‌گیرد؛ نماینده‌ای که سرویس را به دیگران می‌فروشد پیش‌فرض ندارد و فقط برای صورتحساب‌هایی که خودش بخواهد «درخواست فاکتور رسمی» می‌دهد.

حالت ترکیبی: رسمی شدن صورتحساب قبل از پرداخت

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

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

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

صورتحساب WHMCS با ارزش افزوده پس از رسمی شدن
نمونهٔ صورتحساب پس از رسمی شدن و اعمال نرخ مالیات تنظیم‌شده در ماژول
فهرست صورتحساب‌های پرداخت‌نشده در ناحیه کاربری
صفحه فاکتور رسمی مشتری: پروفایل‌های خریدار و وضعیت رسمی یا غیررسمی هر صورتحساب پرداخت‌نشده

عنوان آیتم‌ها به انتخاب مشتری

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

ویرایش عنوان آیتم‌های صورتحساب رسمی
ویرایش عنوان آیتم‌ها توسط مشتری

کنترل کامل برای مدیر

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

رسمی کردن صورتحساب توسط مدیر
صورتحساب غیررسمی: رسمی کردن با انتخاب پروفایل
صورتحساب رسمی‌شده در پنل مدیریت
صورتحساب رسمی‌شده با درخواست مشتری، با دکمه برگرداندن به غیررسمی

این ابزار تغییر وضعیت برای صورتحساب‌های پرداخت‌شده در دسترس نیست. در صورت استفاده از ماژول درگاه چندگانهٔ سازگار، مسیرهای پرداخت نمایش‌داده‌شده با وضعیت صورتحساب رسمی هماهنگ می‌شوند.

پروفایل‌های خریدار

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

فرم پروفایل خریدار در ناحیه کاربری
فرم افزودن پروفایل خریدار در ناحیه کاربری
مدیریت پروفایل‌های خریدار
فهرست پروفایل‌ها در پنل مدیریت؛ پروفایل‌های در انتظار تایید بالای فهرست

فاکتور رسمی برای مشتری: صفحه وب، PDF و QR

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

لینک فاکتور رسمی در فهرست صورتحساب‌های مشتری
لینک فاکتور رسمی در فهرست صورتحساب‌ها
نسخه PDF فاکتور رسمی
نسخه PDF فاکتور رسمی

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

صفحه تایید اصالت فاکتور رسمی
صفحه تایید اصالت پس از اسکن QR

طراح قالب با پیش‌نمایش زنده

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

طراح قالب فاکتور رسمی
طراح قالب: تنظیمات و بلوک‌ها در یک طرف، پیش‌نمایش زنده در طرف دیگر

ثبت خودکار در حسابفا

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

اتصال ماژول فاکتور رسمی به حسابفا
اتصال حسابفا، نوع مودی و نگاشت هر درگاه پرداخت به حساب بانک یا صندوق
سند فاکتور رسمی ثبت‌شده در حسابفا
جزئیات سند ثبت‌شده: شماره حسابداری، شماره مالیاتی، ردیف‌ها و گزارش همه درخواست‌ها

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

نگاشت کالا و خدمات به کد حسابداری و شناسه مودیان
نگاشت کالا و خدمات به کد حسابداری و شناسه مودیان

فاکتور رسمی نسیه

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

فاکتور رسمی نسیه در صفحه صورتحساب WHMCS
صورتحساب پرداخت‌نشده با فاکتور رسمی نسیه

خروجی Excel برای سپیدار، هلو، محک و سامانه مودیان

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

خروجی فایل Excel فاکتورهای رسمی
گرفتن خروجی با پیش‌تنظیم و بازه تاریخ
تنظیم ستون‌های خروجی Excel
ویرایش پیش‌تنظیم: ترتیب، عنوان و فیلد هر ستون

داشبورد و مدیریت سندها

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

داشبورد ماژول فاکتور رسمی و حسابداری
داشبورد: وضعیت سندها، آخرین خطاها و گزارش ماهانه
فهرست فاکتورهای رسمی در پنل مدیریت
فهرست فاکتورهای رسمی با وضعیت ثبت در حسابداری
کادر فاکتور رسمی در صفحه صورتحساب WHMCS
کادر فاکتور رسمی در صفحه هر صورتحساب پنل مدیریت

انتقال صورتحساب‌ها و اطلاعات قبلی

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

پیش‌نیازهای نصب ماژول در WHMCS

پیش‌نیازحداقل
WHMCS8.0 یا بالاتر (سازگار با WHMCS 9)
PHP7.4 تا ۸.۵، با افزونه‌های mbstring، gd، curl، zip و zlib
ionCube Loaderفعال
CronCron اصلی WHMCS فعال باشد

نصب و راه‌اندازی

  1. ماژول را از دکمه پایین صفحه خریداری کنید و فایل آن را از ناحیه کاربری (سرویس‌ها ← لایسنس‌های من) دانلود کنید.
  2. فایل zip را در پوشه اصلی WHMCS باز کنید تا پوشه modules/addons/officialInvoice ساخته شود.
  3. در پنل مدیریت به System Settings ← Addon Modules بروید، «فاکتور رسمی و حسابداری» را فعال کنید، کلید لایسنس را وارد کنید و دسترسی گروه‌های مدیر را تعیین کنید.
  4. از منوی Addons ← فاکتور رسمی و حسابداری وارد ماژول شوید و در تنظیمات، اطلاعات فروشنده، حالت کاری، مالیات و حسابداری را تعیین کنید.
  5. از ابزارها ← بررسی سیستم مطمئن شوید همه موارد سبز هستند.

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

پرسش‌های متداول

پرسشپاسخ
شماره صورتحساب‌های WHMCS عوض می‌شود؟خیر. شماره رسمی فاکتور مستقل است و برای هر سال مالی پیوسته و بدون شکاف شماره‌گذاری می‌شود.
نرم‌افزار حسابداری ما حسابفا نیست؛ به کارمان می‌آید؟بله. همه امکانات فاکتور رسمی، پروفایل‌ها و قالب مستقل از حسابداری کار می‌کنند و برای ثبت در نرم‌افزار خودتان خروجی Excel با ستون‌های دلخواه می‌گیرید.
مشتری بعد از پرداخت می‌تواند خریدار را عوض کند؟تا پایان مهلتی که خودتان تعیین می‌کنید (پیش‌فرض ۲۴ ساعت) بله؛ پس از صدور، اطلاعات فاکتور ثابت می‌شود.
اگر ارسال به حسابفا خطا بدهد چه می‌شود؟خطا با متن فارسی در داشبورد دیده می‌شود و پس از رفع، ارسال از همان مرحله ناموفق ادامه پیدا می‌کند؛ چیزی دو بار ثبت نمی‌شود.
به ماژول درگاه پرداخت خاصی وابسته است؟خیر. با همه درگاه‌های WHMCS کار می‌کند. اگر ماژول درگاه چندگانه (multiGateWay) را هم داشته باشید، درگاه‌های رسمی و غیررسمی بر اساس رسمی بودن صورتحساب به‌طور خودکار نمایش داده می‌شوند.

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

آموزش راه‌اندازی و سامانه مودیان

برای راه‌اندازی مرحله‌به‌مرحله، از راهنمای ماژول فاکتور رسمی و سامانه مودیان شروع کنید. آموزش‌های تخصصی هر بخش در ادامه آمده‌اند:

لطفا به این محتوا امتیاز دهید