برای رفع خطاهای سامانه مودیان در WHMCS، ابتدا مشخص کنید خطا در کدام مرحله رخ داده است: ساخت CSR، ثبت گواهی، آمادهسازی صورتحساب، ارسال یا ثبت حسابداری. این راهنما پیامهای رایج را به علت احتمالی و اقدام بعدی متصل میکند تا بدون ارسال تکراری، همان مرحله را بررسی کنید.
خطای ۰۱۰۳۶۰۹: حداکثر تعداد رقم اعشار در فیلد «تعداد/مقدار» صحیح نیست
این خطا میتواند از نمایش عدد اعشاری در JSON ناشی شود. عددی مانند ۳۷٫۰۵ در محاسبات ممیز شناور ممکن است با رقمهای اضافی نمایش داده شود؛ تنظیم serialize_precision نیز روی خروجی برخی برنامهها اثر میگذارد. قبل از تغییر مبلغ واقعی، دادهٔ ارسالی و تعداد اعشار را بررسی کنید.
در راهنمای ماژول، اصلاح تبدیل اعداد از نسخهٔ ۱.۴.۳ ذکر شده است. ابتدا نسخهٔ نصبشده را بررسی و در صورت نیاز بهروزرسانی کنید، سپس وضعیت قبلی صورتحساب را کنترل کنید. برای نرمافزارهای دیگر، تنظیم serialize_precision و منطق گرد کردن باید توسط مسئول فنی بررسی شود؛ تغییر تنظیم سراسری را بدون آزمون سازگاری انجام ندهید.
خطای OpenSSL: string too short … minsize=1
error:06800098:asn1 encoding routines:ASN1_mbstring_ncopy:string too short:crypto\asn1\a_mbstr.c:100:minsize=1
پیام string too short میتواند به خالی بودن یک فیلد الزامی در فایل تنظیمات OpenSSL مربوط باشد. سطرهای بخش مشخصات درخواست را بررسی کنید؛ نمونههای زیر از مواردی هستند که باید با اطلاعات صحیح تکمیل شوند:
- بعد از
=چیزی نوشته نشده، مثلL =. - مقدار با
#شروع شده است. OpenSSL بعد از#را توضیح حساب میکند. این حالت وقتی پیش میآید که الگوی راهنما با توضیحهای فارسیاش کپی شده باشد، یا متن از PDF کپی شده و ترتیب راستبهچپ به هم ریخته باشد.
برای پیدا کردن علت، پیام کامل OpenSSL و فیلد نامبردهشده را ملاک قرار دهید. قالب فایل و نویسههای اضافی را هم در صورت اشارهٔ گزارش بررسی کنید؛ از نتیجهگیری قطعی تنها با دیدن بخشی از پیام خودداری کنید.
فیلدهای اجباری را با مقدار واقعی تکمیل و گزینههای اختیاریِ خالی را مطابق راهنمای مرکز صدور تنظیم کنید. اگر از این ماژول استفاده میکنید، ساخت CSR داخل WHMCS نیاز به تنظیم دستی فایل OpenSSL را کاهش میدهد.
[req]
prompt = no
distinguished_name = dn
[dn]
CN = Nemooneh Fanavaran Co [Stamp]
serialNumber = 10326976451
O = Non-Governmental
1.OU = شرکت نمونه فناوران
L = تهران
ST = تهران
C = IR
خطای GICA: «فیلد نام ثبتی سازمان/شرکت (فارسی) اجباری است»
اگر مرکز صدور نام فارسی سازمان را اجباری اعلام میکند، متن نام ثبتی و اطلاعات فرم مرکز را با مدارک تطبیق دهید. قبل از ساختن کلید جدید، مراحل زیر را بررسی کنید:
- CSR را در «محتوای درخواست گواهی» بگذارید، دکمه «بررسی درخواست» و سپس «نمایش اطلاعات فرم» را بزنید و ببینید «نام ثبتی» پر شده یا خالی است. اگر خالی بود، آن را دقیقاً مطابق روزنامه رسمی بنویسید.
- مطمئن شوید «نام سازمان به فارسی (۱.OU)» در ماژول دقیقاً نام ثبتی شرکت است.
- اگر خطا ماند، CSR را یک بار بدون پست الکترونیکی بسازید. گزینه «کلید جدید» را تیک نزنید.
«در دیکودر CSR بهجای ۱.OU فقط OU نوشته شده»
نمایش OU بدون پیشوند عددی در دیکودر، بهتنهایی خطا نیست. عددهای ۱.OU و ۲.OU در فایل تنظیمات برای مشخص کردن چند ورودی همنام استفاده میشوند؛ در CSR خود فیلد OU ذخیره میشود. مقدارها و نوع گواهی را با الزامات مرکز صدور مقایسه کنید.
گواهی خودامضا یا متعلق به کلید دیگر
گواهی باید با کلید خصوصیِ استفادهشده برای CSR مطابقت داشته باشد. اگر درخواست روی دستگاه دیگری ساخته شده یا هنگام ساخت مجدد، کلید تغییر کرده است، این تطابق را بررسی کنید. کلید صحیح را فقط از مسیر امن وارد کنید؛ اگر به آن دسترسی ندارید، روند دریافت گواهی متناسب با کلید در اختیار را با مرکز صدور پیگیری کنید.
یک فروش دو بار به مودیان رفته است
ارسال همزمان از ماژول و نرمافزار حسابداری میتواند برای یک فروش، دو سند ایجاد کند. ابتدا شمارهها، وضعیت و منبع ارسال را ثبت کنید. سپس با مسئول حسابداری، اقدام مناسب برای سند تکراری را تعیین و تنها یک سیستم را مسئول ارسال کنید. مقایسهٔ روشهای ارسال به انتخاب مسیر کمک میکند.
شماره مالیاتی در حسابفا خالی میماند
پذیرفته شدن درخواست API لزوماً به معنی ذخیره شدن تمام فیلدها نیست. در رفتار مستندشدهٔ این ماژول، اگر حسابفا شمارهٔ مالیاتی را در پاسخِ خواندن سند برنگرداند، هشدار ثبت میشود. شماره و وضعیت موجود در ماژول و پاسخ سامانهٔ مودیان را جدا بررسی کنید؛ این رفتار ممکن است با نسخهٔ API تغییر کند.
صورتحسابی ارسال نمیشود
- حالت سامانه مودیان «پیشنمایش» است.
- تاریخ شروع ارسال خالی است یا فاکتور قبل از آن صادر شده است.
- یکی از مراحل نوار پیشرفت (کلید، گواهی یا شناسه حافظه) کامل نیست.
- Cron اصلی WHMCS اجرا نمیشود. زمان آخرین اجرا بالای پنل ماژول نمایش داده میشود.
- اطلاعات فاکتور ناقص است، مثلاً شناسه کالا یا اطلاعات خریدار. فهرست موارد ناقص در ابزارها و گزارش ← مودیان است.
برای مرور مرحلهٔ قبلی، راهنمای اصلاحیه، ابطال و برگشت از فروش را ببینید.
آموزشهای این مجموعه
- راهنمای کامل ماژول
- ۱. ساخت CSR و دریافت گواهی امضا
- ۲. اتصال مستقیم به سامانه مودیان
- ۳. اتصال حسابفا و حالتهای ارسال
- ۴. شرح کالا و خدمات در مودیان
- ۵. صدور فوری فاکتور رسمی
- ۶. اصلاحیه، ابطال و برگشت از فروش
- ۷. خطاهای رایج و راه حل (همین صفحه)
پرسشهای متداول
برای عیبیابی چه اطلاعاتی آماده کنیم؟
نسخهٔ ماژول، مرحلهٔ عملیات، پیام کامل خطا و شمارهٔ سند را ثبت کنید. کلید خصوصی و رمز اتصال را در گزارش ارسالی قرار ندهید.
آیا هر خطا با ارسال مجدد حل میشود؟
خیر؛ ابتدا علت و وضعیت پاسخ قبلی را بررسی کنید. مشکل گواهی، نگاشت یا اطلاعات خریدار با تکرار درخواست برطرف نمیشود.
