خطای کلید بخش اختصاصی و عمومی در سامانه مؤدیان را چطور رفع کنیم؟

خطای کلید اختصاصی سامانه مؤدیان یعنی امضای دیجیتال بستهٔ فاکتور با کلید عمومی بارگذاریشده در کارپوشه نمیخواند. فاکتور با یک جفتکلید امضا شده، اما کارپوشه کلید عمومی دیگری را بررسی میکند. خبر خوب: برای رفعش معمولاً نیازی به ابطال صورتحسابها نیست.
خطای کلید اختصاصی سامانه مؤدیان زمانی رخ میدهد که امضای دیجیتال بستهٔ فاکتور با کلید عمومی بارگذاریشده در کارپوشه مطابقت ندارد یا کلید خصوصی اشتباهی برای ساخت شناسه یکتای حافظه مالیاتی به کار رفته است. در چنین وضعیتی سامانه پیام خطای اعتبارسنجی امضا با متن نامعتبر بودن توکن یا خطای ساختار امضا (برای نمونه شماره ۱۰۰۶، یا عدم تطابق کلید بخش عمومی و اختصاصی) برمیگرداند. ریشه این خطا تنها یک موضوع است: فاکتور با یک جفتکلید رمزنگاری شده، اما کارپوشه سازمان امور مالیاتی کلید عمومی دیگری را بررسی میکند.
برای رفع فوری، ابتدا به درگاه ملی خدمات الکترونیک سازمان امور مالیاتی به نشانی my.tax.gov.ir بروید، بخش عضویت و شناسه یکتای حافظه مالیاتی را باز کنید و مطمئن شوید فایلی که در نرمافزار واسط یا حسابداری بارگذاری کردهاید، دقیقاً همان فایل کلید خصوصی (معمولاً با پسوند key یا pem) متناظر با کلید عمومی ثبتشده در کارپوشه است.
اول بفهمید خطا در کدام مرحله رخ داده
انتخاب روش اصلاح به این بستگی دارد که خطای کلید در چه مرحلهای رخ داده است: آیا کلید را گم کردهاید، چند شناسه حافظه مالیاتی همزمان دارید یا فایل گواهی مهر سازمانی بهتازگی تمدید شده است؟ تصمیم اشتباه در این مرحله میتواند باعث شود تمام صورتحسابهای معلق قبلی با خطای ساختار نامعتبر مواجه شوند و مهلت قانونی ارسال از دست برود. طبق دستورالعملهای ثبت صورتحساب در درگاه سازمان امور مالیاتی کشور، صورتحساب الکترونیکی باید با کلید اختصاصی معتبر امضا شود تا پس از ارسال به عنوان خطای سامانه مؤدیان پس زده نشود.
برای اینکه سریعترین و کمهزینهترین مسیر را پیدا کنید، سناریوهای جدول زیر را با شرایط فعلی کارپوشه خود مقایسه کنید:
| وضعیت پرونده و گواهی | علت اصلی خطا | اقدام فنی توصیهشده | ریسک احتمالی |
|---|---|---|---|
| کلید خصوصی کامپیوتر تغییر کرده ولی کلید عمومی در کارپوشه دست نخورده | عدم تطابق جفتکلید (Pair Mismatch) | جایگزینی فایل کلید اختصاصی اصلی در نرمافزار واسط | ارسال مجدد صورتحساب با همان شناسه یکتا |
| گواهی مهر سازمانی تمدید شده اما کارپوشه بهروز نشده | منقضی شدن امضای دیجیتال قبلی | استخراج کلید عمومی جدید و بارگذاری در شناسه حافظه فعلی | تعلیق موقت ارسال تا زمان تایید کارپوشه |
| گم شدن فایل کلید خصوصی روی سیستم | ناممکن بودن بازتولید امضا با کلید قبلی | تعریف شناسه یکتای حافظه جدید در کارپوشه با جفتکلید تازه | عدم امکان ارسال مجدد فاکتورهای ساختهشده با کلید قبلی |
| فعال بودن همزمان چند نرمافزار روی یک شناسه | تداخل کلیدهای اختصاصی چند سیستم | اختصاص یک شناسه یکتای مجزا به هر سیستم یا نرمافزار | ابطال یا خطای توکن در بخش عمده فاکتورها |
[بروز خطای کلید در ارسال]
│
▼
[بررسی دسترسی به فایل کلید اختصاصی قدیمی]
├───> (فایل موجود است) ───> بارگذاری مجدد فایل در نرمافزار ───> تست مجدد ارسال
│
└───> (فایل مفقود یا نامعتبر) ───> تولید جفتکلید جدید ───> ثبت شناسه حافظه جدید در کارپوشه ───> بازتولید شماره مالیاتی فاکتورها
جفتکلید را روی سیستم خودتان بیازمایید
برای رفع خطای کلید اختصاصی سامانه مؤدیان کار را از بررسی جفتکلید در سیستم محلی خود شروع کنید، نه دستکاری شتابزده در کارپوشه مالیاتی. ابتدا یک سند متنی ساده را بررسی کنید: کلید خصوصی شما متنی طولانی است که با عبارت BEGIN PRIVATE KEY آغاز میشود و کلید عمومی متنی است که با BEGIN PUBLIC KEY یا فرمت گواهی BEGIN CERTIFICATE مشخص شده است. اگر در شرکتی چند سیستم حسابداری فاکتور صادر میکنند، مطمئن شوید هر دو بخش از یک جفتکلید یکتا استخراج شده باشند.
در یک سناریوی نمونه، مدیر مالی فرضی یک شرکت توزیع قطعات پس از بهروزرسانی سیستم حسابداری با خطای رد امضا روبرو شد. بررسی فنی مشخص کرد که فایل کلید اختصاصی از پوشه سیستم دیگری کپی شده بود که به شناسه یکتای دیگری در کارپوشه وصل بود؛ بنابراین سیستم با کلید شرکت «الف» فاکتور شرکت «ب» را امضا میکرد. برای جلوگیری از این آشفتگی، این چکلیست عیبیابی را اجرا کنید:
- صحت تطابق: با ابزارهای استاندارد OpenSSL تست کنید که هش کلید عمومی و اختصاصی یکسان باشد.
- یکتایی شناسه: بررسی کنید شناسه یکتای ۶ کاراکتری ثبتشده در نرمافزار دقیقاً با شناسهای که در درگاه مالیاتی باز است یکی باشد.
- سطح دسترسی فایل: مطمئن شوید نرمافزار حسابداری دسترسی خواندن فایل کلید اختصاصی را بدون محدودیت ادمین دارد.
- تاریخ انقضا: تاریخ اعتبار گواهی را از مرکز صدور گواهی الکترونیکی عام بررسی کنید.
پس از بررسی این چهار مرحله، در تنظیمات نرمافزار حسابداری یا واسط خود، آزمون اتصال را اجرا کنید تا ارتباطش با کلید چک شود. اگر همزمان با مشکلات اطلاعات پایه خریداران نیز روبرو هستید، بررسی راهنمای خطای سامانه مؤدیان خریدار برای پالایش شناسههای ملی ضرورت دارد.
شناسهٔ کارپوشه را باطل نکنید، مگر کلید واقعاً گم شده باشد
تصمیم برای «استفاده مجدد از شناسه فعلی» یا «تولید شناسه یکتای جدید» بیشترین اثر را روی زمانبندی و پایداری پرونده مالیاتی شما دارد. مودیان اغلب تصور میکنند با پاک کردن شناسه حافظه و ساخت یک شناسه جدید مشکل به سرعت حل میشود، اما این کار تمام فاکتورهای پیشنویس با شماره مالیاتی قبلی را بیاعتبار میکند. طبق استاندارد سامانههای مالیاتی، ۲۲ رقم شماره منحصربهفرد مالیاتی وابسته به شناسه یکتای حافظه است و تغییر آن نیازمند بازتولید کامل تمامی فاکتورهای ارسالنشده است.
اگر کلید اختصاصی خود را گم نکردهاید و صرفاً خطای فرمت یا ساختار رمزنگاری دارید، هرگز شناسه کارپوشه را باطل نکنید. تصمیم درست، اصلاح ساختار تبدیل کلید (مثلاً از PKCS#8 به RSA استاندارد یا برعکس) بدون تغییر جفتکلید است.
مثال. فرض کنید شرکتی با میانگین روزانه ۲۰۰ فاکتور، با ابطال بیمورد شناسه یکتا مواجه شود؛ بازتولید شمارههای مالیاتی و تطبیق آنها با پایگاه داده مشتریان میتواند ساعتها چرخه انبار و ترخیص را مختل کند. اگر میانگین هر فاکتور ۴٬۰۰۰٬۰۰۰ تومان باشد، ۲۰۰ ضرب در ۴٬۰۰۰٬۰۰۰ میشود ۸۰۰٬۰۰۰٬۰۰۰ تومان فروشِ یک روز که منتظر میماند. اگر این توقف ۲ روز طول بکشد، ۴۰۰ فاکتور و ۱٬۶۰۰٬۰۰۰٬۰۰۰ تومان پشت یک تصمیم عجولانه گیر کرده است — در حالی که اصلاح فرمت کلید شاید یک ساعت وقت میگرفت.
حفظ شناسه کارپوشه، خطر رد صورتحساب و مغایرت دفاتر مالیاتی را به صفر میرساند.
یادداشت عملی — در پشتیبانی زیاد میبینم که اولین واکنش به خطای کلید، ساختن یک جفتکلید تازه است؛ کاری که معمولاً مشکل را بزرگتر میکند. من اول فایل کلید را با کلید ثبتشده در کارپوشه مقایسه میکنم و تا مطمئن نشوم فایل اصلی گم شده، به شناسهٔ کارپوشه دست نمیزنم. و همان روزی که کلید درست کار کرد، یک نسخهٔ پشتیبان از آن جای امن میگذارم.

یک فاصلهٔ اضافه، یک امضای نامعتبر
اصلیترین خطای تکرارشونده، تغییر ناآگاهانه فاصله، خطوط شکست (Line Break) یا اضافه شدن کاراکترهای نامرئی در زمان کپی کردن متن کلید در فیلدهای نرمافزار است. کلیدهای رمزنگاری به کوچکترین تغییر حساس هستند؛ قرار گرفتن یک فاصله خالی (Space) در ابتدا یا انتهای متن کلید خصوصی، هش دیجیتال را تخریب کرده و سامانه پیام خطای امضای نامعتبر صادر میکند. همیشه از فایل اصلی استفاده کنید یا ویرایشگرهای متنی استاندارد بدون قالببندی (مانند Notepad) را به کار بگیرید.
اشتباه پرتکرار بعدی، عدم تطابق نوع متد امضا در نرمافزار با کلید ثبتشده در سامانه مؤدیان است. اگر در کارپوشه نوع کلید را «توسط مؤدی» انتخاب کردهاید، نباید شناسه شرکتهای معتمد را در ساختار بسته به کار ببرید. برای پیادهسازی گامهای امن در جلوگیری از برگشت صورتحسابها، اصول راهنمای جامع پیشگیری از خطای سامانه مودیان را در فرآیندهای مالی خود لحاظ کنید تا تیم حسابداری پیش از پایان هر دوره مالی دچار بحران تمدید نشود.
یک نسخه پشتیبان امن از فایلهای کلید بسازید. این کار ساده، از ساعتها توقف چرخه فروش جلوگیری میکند.
سه کار برای همین امروز
حل ریشهای مشکل تداخل کلیدها یک بار برای همیشه پرونده مالیاتی شما را پایدار میکند. برای اطمینان از صحت جریان کاری امروز، این سه اقدام را سریعاً انجام دهید: نخست، تطابق جفتکلید را مستقیماً در رایانه خود بیازمایید؛ دوم، شناسه ۶ کاراکتری حافظه را بین پنل حسابداری و کارپوشه تطبیق دهید؛ و سوم، یک فاکتور تستی با مبلغ اندک ثبت و نتیجه وضعیت استعلام آن را بررسی کنید.
اگر میخواهید بدون درگیر شدن با پیچیدگیهای رمزنگاری، تولید جفتکلید و فرمتهای مختلف کلیدهای دیجیتال فاکتورهای خود را مدیریت کنید، استفاده از راهکارهای یکپارچه بهترین گزینه است. برای مدیریت دقیقتر اسناد و ارسال مستقیم فاکتورها، از امکانات حسابداری ابری بهرهمند شوید تا فرآیندهای مالیاتی شما خودکار و شفاف پیش برود.
پرسشهای پرتکرار
خطای کلید اختصاصی سامانه مؤدیان یعنی چه؟
یعنی امضای فاکتور با کلید عمومی ثبتشده در کارپوشه نمیخواند؛ فاکتور با یک جفتکلید امضا شده و کارپوشه کلید عمومی دیگری را بررسی میکند.
برای رفع خطای کلید باید صورتحسابها را ابطال کنم؟
معمولاً نه. اول مطمئن شوید فایل کلید خصوصی که در نرمافزار بارگذاری کردهاید، همان کلید متناظر با کلید عمومی ثبتشده در کارپوشه است.
کلید خصوصی را گم کردهام، چه کنم؟
با کلید قبلی نمیشود امضا را بازتولید کرد. باید شناسه یکتای حافظهٔ جدیدی با جفتکلید تازه در کارپوشه تعریف کنید؛ فاکتورهای ساختهشده با کلید قبلی دوباره ارسال نمیشوند.
چرا بعد از کپی کردن متن کلید، امضا نامعتبر شد؟
یک فاصلهٔ خالی، خط شکست یا کاراکتر نامرئی در ابتدا یا انتهای متن کلید، امضا را خراب میکند. از فایل اصلی یا یک ویرایشگر متن ساده استفاده کنید.
آیا میشود چند نرمافزار را روی یک شناسه یکتا فعال کرد؟
این کار کلیدهای اختصاصی را تداخل میدهد. به هر سیستم یا نرمافزار یک شناسه یکتای مجزا اختصاص دهید.
همین امروز اولین فاکتورتان را بزنید
دیجی اینویس با دورهٔ آزمایشی رایگان شروع میشود — بدون کارت بانکی، با ارسال مستقیم به سامانهٔ مودیان.



