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

- ارسال مستقیم: در تنظیمات ← صدور و ارسال، «ارسال به سامانه مودیان» را روی «مستقیم از این ماژول» بگذارید.
- کلید خصوصی و گواهی امضا: طبق آموزش ساخت CSR.
- شناسه یکتای حافظه: شناسه ۶ کاراکتری از نوع «توسط مودی» که در کارپوشه سامانه مودیان میسازید و گواهی را به آن وصل میکنید.
- تاریخ شروع: فاکتورهای صادرشده قبل از این تاریخ هرگز ارسال نمیشوند.
شناسهٔ حافظه را مطابق روش ارسال و ثبت آن در کارپوشه تعیین کنید. اگر همزمان نرمافزار حسابداری دیگری دارید، مسئول ارسال و شمارهگذاری هر مسیر باید روشن باشد؛ متفاوت بودن شناسهها بهتنهایی مانع ثبت دو سند برای یک فروش نمیشود.
حالت پیشنمایش و ارسال واقعی

| حالت | چه اتفاقی میافتد |
|---|---|
| پیشنمایش (پیشفرض) | هیچ صورتحسابی ارسال نمیشود. در ابزارها و گزارش ← مودیان فهرست فاکتورهای آماده، موارد ناقص (مثلاً شناسه کالا یا اطلاعات خریدار) و نمونه داده ارسالی را میبینید. |
| ارسال واقعی | Cron هر بار تا «تعداد در هر اجرای Cron» سند را امضا و ارسال میکند و نتیجه ارسالهای قبلی را استعلام میکند. صورتحساب ارسالشده برگشتپذیر نیست و فقط با اصلاحیه یا ابطال تغییر میکند. |
تست اتصال
تنظیمات را ذخیره کنید و دکمهٔ تست اتصال را بزنید. این آزمون برای بررسی اتصال و احراز هویت است و جای بررسی کامل محتوای صورتحساب و دریافت پاسخ نهایی ارسال را نمیگیرد.
Cron چه کار میکند؟
در حالت ارسال واقعی، Cron اصلی WHMCS کارهای زیر را پیگیری میکند. زمان آخرین اجرای آن را در پنل بررسی کنید؛ در صورت توقف Cron، انتظار برای ارسال خودکار کافی نیست:
- استعلام نتیجه صورتحسابهایی که قبلاً ارسال شدهاند. نتیجه «ثبت شد» یا «رد شد» همراه با پیام سامانه است.
- ثبت پرداخت فاکتورهای نسیهای که پرداخت شدهاند.
- ارسال ابطالی برای نسیه پرداختنشده، بعد از گذشتن «ابطال نسیه پرداختنشده» روز (پیشفرض ۷ روز، ۰ یعنی هرگز).
- گذاشتن فاکتورهای صادرشده جدید در صف و ارسال آنها.
پارامترهای قواعد ارسال، مانند واحد اندازهگیری و تعداد اسناد در هر اجرا، باید با نوع خدمت و ظرفیت پردازش هماهنگ باشند. عدد پیشفرضِ نرمافزار را بدون بررسی، برای همهٔ کالاها و خدمات صحیح فرض نکنید.
وضعیت هر فاکتور
| وضعیت | معنی |
|---|---|
| در صف ارسال | منتظر اجرای بعدی Cron |
| در انتظار نتیجه | ارسال شده و سامانه هنوز پاسخ نهایی نداده |
| ثبت شد | سامانه تأیید کرد؛ شماره مالیاتی روی فاکتور چاپ میشود |
| رد شد | پیام خطا در صفحه فاکتور و گزارش رویدادها ثبت میشود؛ بعد از رفع مشکل «ارسال دوباره به مودیان» را بزنید |
| ثبت توسط حسابداری | همین فروش را نرمافزار حسابداری قبلاً فرستاده و ماژول شماره آن را برداشته است؛ دوباره ارسال نمیشود |
شمارهٔ منحصربهفرد مالیاتی را روی سند و در وضعیت مربوط پیگیری کنید. پیشفاکتور نسیهٔ پرداختنشده را با فاکتور نهایی دارای نتیجهٔ ارسال یکسان در نظر نگیرید.
اگر از حسابفا نیز استفاده میکنید، پیش از فعالسازی روش ارسال و اتصال حسابفا را انتخاب کنید. فقط یک سیستم باید مسئول ارسال هر فروش باشد.
قبلی: ساخت CSR و گواهی امضا | بعدی: اتصال حسابفا و روشهای ارسال
آموزشهای این مجموعه
- راهنمای کامل ماژول
- ۱. ساخت CSR و دریافت گواهی امضا
- ۲. اتصال مستقیم به سامانه مودیان (همین صفحه)
- ۳. اتصال حسابفا و حالتهای ارسال
- ۴. شرح کالا و خدمات در مودیان
- ۵. صدور فوری فاکتور رسمی
- ۶. اصلاحیه، ابطال و برگشت از فروش
- ۷. خطاهای رایج و راه حل
پرسشهای متداول
پیشنمایش، صورتحساب واقعی ارسال میکند؟
طبق تنظیمات این ماژول، حالت پیشنمایش برای بررسی داده و آماده بودن اسناد است و ارسال واقعی انجام نمیدهد.
اگر Cron اجرا نشود چه میشود؟
کارهای زمانبندیشده مانند ارسال و استعلام ممکن است متوقف بمانند. زمان آخرین اجرا و گزارش WHMCS را بررسی کنید.
