دلایل نامعتبر شدن کلید خصوصی در سامانه لیموتکس و راهکارها
خلاصه مراحل
اگر در صفحه ایجاد و ویرایش مودیان سامانه لیموتکس با پیام «خطا در فرمت کلید» (مانند تصویر زیر) مواجه شدید:

دلیل:
فایل کلید خصوصی ناقص، خراب یا بهدرستی کپی نشده است.
راه حل:
مطمئن شوید که کلید خصوصی را دقیقاً از صفحه تولید کلید خصوصی/عمومی سامانه لیموتکس دریافت کردهاید و گزینه «کپی» را کلیک کردهاید تا داده کامل منتقل شود.
محتویات کلید خصوصی به صورت کامل کپی شود
نمونه:
-----BEGIN PRIVATE KEY-----
Jqw18XeAC8FR4Rmeb5qnI8xBnTzFxbii8f+WnLzwKKYBY0/jIPlD+nGHMFaFHpSz
uGZoHKTqAJP0/a14yNrRB2K8W2kFa3nGC+OSTjHBzzgqKadPXr0pu+CXAoGBAIY4
1nwcrYb4DGUMwFmvbdqoni96/ppcgD4gQkiXDEJaTIugpDYrgyogf2Ot3kFQ8ebH
zvkgNyKneIAkE9AuFlrOGuH2BeaIPdcL9wqX7tgoipbyAuWLtsaUjHyW38oSHmOY
mNxbgx0i07KjDb0Vqw4JBiXhPcr4q15uVZNx/eXDAoGBAIXt3cOW0M0sQanVWZXb
Daq+IiYKLCLNL/6VUKeHL8RFy95W4OUTu1equCBq3pzweOwXJfauERS86EwYjJmX
OOEzZxB9gjBbOfv1qrgRitG1uGR0bCyd17sAKJlrKMj66GMhikFhwz5UKa6ua9fU
-----END PRIVATE KEY-----
اگر صفحه ایجاد و ویرایش مودیان سامانه لیموتکس با پیام «نامعتبر» (مانند تصویر زیر) مواجه شدید:

دلایل:
-
کلید خصوصی، کلید عمومی و شناسه یکتا با هم همخوانی ندارند.
-
شناسه یکتا شما فعال نیست، یا دادهها میان سامانه مودیان، سامانه لیمو و گواهیها همگام نشدهاند.
راه حل:
مراحل بار گزاری کلیدها را به دقت انجام دهید.
آموزش جامع
این خطاها یکی از رایجترین پیامهای اعتبارسنجی سامانه است و معمولاً به معنی وجود مشکل در ارتباط بین کلید خصوصی، کلید عمومی و شناسه یکتای حافظه مالیاتی است.
این خطا در ظاهر ساده به نظر میرسد، اما در واقع بخش مهمی از امنیت و اصالت صورتحساب شما را تضمین میکند.
در این مقاله، به زبان ساده توضیح میدهیم:
-
کلید خصوصی در سامانه لیمو چیست و چه نقشی دارد؟
-
چرا گاهی «نامعتبر» میشود یا خطا در فرمت آن رخ میدهد؟
-
ارتباط بین شناسه یکتا، کلید خصوصی و کلید عمومی چگونه است؟
-
و در نهایت، چطور میتوان این خطا را سریع و مطمئن رفع کرد.
دریافت رایگان کلید خصوصی و عمومی و گواهی امضا سامانه مودیان در کمتر از 5 دقیقه
اول: کلید خصوصی چیست و چرا سامانه لیمو آن را چک میکند؟
برای اینکه صورتحساب شما در سامانه مودیان با اعتبار ثبت شود، نیاز به امضای دیجیتال دارید. سامانه لیمو در این مسیر دو بخش اصلی دارد:
-
کلید عمومی (Public Key): سامانه یا سازمان مالیاتی از این استفاده میکند تا امضای شما را پس از ارسال بررسی کند.
-
کلید خصوصی (Private Key): این بخش در اختیار شما قرار میگیرد و شما با آن امضا تولید میکنید (یا سامانه تولید و در اختیار شما قرار میدهد) تا ارتباط بین شما و سامانه رسمی حفظ شود.
در سامانه لیمو، قبل از ارسال صورتحساب، سیستم بررسی میکند که کلیدها بهدرستی تولید، بارگذاری و با «شناسه یکتا» شما هماهنگ شده باشند.
اگر این هماهنگی نباشد، پیام خطا ظاهر میشود.

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

راهکار:
-
مطمئن شوید که کلید خصوصی را دقیقاً از صفحه تولید کلید سامانه مودیان یا سامانه لیمو دریافت کردهاید و گزینه «کپی» را کلیک کردهاید تا داده کامل منتقل شود.

-
سپس آن را در فیلد «کلید خصوصی» در بخش اطلاعات مودی سامانه لیمو وارد نمایید.


-
اگر از فایل استفاده میکنید، از یک نسخه سالم دوباره استفاده کنید یا مجدداً تولید نمایید.
۲. عدم تطابق بین شناسه یکتا و کلیدها
یکی از دلایل بسیار رایج این است که شناسه یکتا (شناسه مربوط به حافظه مالیاتی) با کلید عمومی و خصوصیِ تولیدشده همخوانی ندارد. این ممکن است به علت ثبت اشتباه شناسه یا تولید کلید برای شناسه دیگر باشد.
راهکار:
-
در سامانه لیمو بخش «اطلاعات مودی» را بررسی کنید و مطمئن شوید شناسه یکتا وارد شده دقیقاً همان شناسهای است در سامانه مودیان کلید عمومی در آن بارگزاری شده است.
-
اگر امکانش هست، کلیدها را مجدداً تولید کنید و مراحل بارگزاری را تکرار نمایید.
۳. شناسه یکتا غیرفعال یا مشکل در اتصال به سامانه مودیان
گاهی ممکن است مشکل از طرف سامانه مودیان یا وضعیت پرونده مالیاتی شما باشد؛ مثلاً شناسه یکتا هنوز فعال نشده یا دادهها بهروزرسانی نشدهاند. در این حالت، سامانه لیمو نمیتواند کلید را با شناسه یکتا تطبیق دهد.
راهکار:
-
با سازمان مالیاتی یا سامانه مودیان بررسی کنید که شناسه یکتا شما فعال و بدون مشکل باشد.
-
چند دقیقه بعد دوباره تلاش کنید؛ ممکن است ارتباط یا سرویس بهمطابق نباشد.
نکات مهم برای جلوگیری از بروز این خطا در آینده
برای اینکه کمتر با این خطاها مواجه شوید، چند نکته ساده اما مؤثر:
-
قبل از ارسال اولین صورتحساب، بخش «ایجاد/ویرایش مودی» در سامانه لیمو را باز کنید و وضعیت کلید خصوصی را کنترل کنید.
-
کلید خصوصی را دقیقاً با گزینه «کپی» از صفحه تولید شده بگیرید و در فیلد مربوطه قرار دهید، از انتقال دستی و تغییر کاراکترها خودداری کنید.
-
شناسه یکتا را با دقت وارد کنید، به ویژه اگر چند شناسه مختلف دارید.
-
اگر تغییری در سیستم، مرورگر یا روند صدور کلید داشتید، دوباره کلید و شناسه را بررسی کنید.
-
اگر همهچیز درست است اما باز هم خطا میده، ممکن است سرویس موقتی قطع شده باشد — اندکی صبر کنید و بعد دوباره امتحان کنید.
نتیجهگیری
خطای «وضعیت کلید خصوصی نامعتبر است» یا «خطا در فرمت کلید» در سامانه لیمو معمولاً به یکی از سه علت زیر بازمیگردد:
-
فایل کلید خصوصی ناقص، خراب یا بهدرستی کپی نشده است.
-
کلید خصوصی، کلید عمومی و شناسه یکتا با هم همخوانی ندارند.
-
شناسه یکتا شما فعال نیست، یا دادهها میان سامانه مودیان، سامانه لیمو و گواهیها همگام نشدهاند.
با ادامه راهکارهایی که بالا توضیح داده شد، میتوانید این مشکل را برطرف کنید و روند صدور و ارسال صورتحساب الکترونیکی را بیدردسرتر پیش ببرید. اگر بعد از انجام مراحل بالا هنوز خطا دارید، توصیه میشود با پشتیبانی سامانه لیمو تماس بگیرید تا وضعیت کلید و شناسه شما از سمت سرور بررسی شود.
🔹 درباره سامانه لیموتکس
لیموتکس (LIMOTX.IR) یکی از سامانههای تخصصی صدور و ارسال صورتحساب الکترونیکی با قیمت مناسب و مطابق با الزامات سازمان امور مالیاتی کشور است.
این سامانه با هدف سادهسازی فرایند صدور صورتحساب، امضای دیجیتال، و اتصال به حافظه مالیاتی طراحی شده است و با گواهیهای معتبر سازگار است.