راهنمای سامانه مودیان

مستندات پروژه امیر، نرم‌افزار آزاد حسابداری لاراول.

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

برای استفاده از امکانات سامانه مودیان در نرم‌افزار آزاد امیر، به سه مورد نیاز دارید:

  1. نام کاربری سامانه مودیان (شناسه یکتای حافظه مالیاتی)
  2. کلید خصوصی (Private Key)
  3. گواهی امضا (Signature Certificate)

در ادامه نحوه دریافت این اطلاعات توضیح داده شده است.

مرحله ۱: ایجاد کلید خصوصی و فایل CSR

ابتدا باید یک فایل CSR (درخواست صدور گواهی) ایجاد کنید.

یک فایل متنی با محتوای زیر ساخته و اطلاعات شرکت خود را جایگزین نمایید:

[req]
prompt = no
distinguished_name = dn

[dn]
CN = MyCompany [Stamp]
serialNumber = 14000405500
O = Non-Governmental
1.OU = نام شرکت
2.OU = واحد سازمانی
3.OU = واحد سازمانی
L = Tehran
ST = Tehran
C = IR

سپس با استفاده از OpenSSL دستور زیر را اجرا کنید:

openssl req -new -newkey rsa:2048 -nodes \
-keyout private.key \
-out company.csr \
-config csr.conf

پس از اجرای دستور فوق دو فایل ایجاد می‌شود:

  • private.key ← کلید خصوصی
  • company.csr ← فایل درخواست گواهی (CSR)

⚠️ فایل private.key بسیار مهم است. آن را در محل امن نگهداری کرده و از آن نسخه پشتیبان تهیه کنید.

مرحله ۲: درخواست گواهی مهر سازمانی

  1. وارد سایت GICA شوید.
  2. از منوی سمت راست روی «ثبت درخواست گواهی الکترونیکی» کلیک کنید.
  3. گزینه «ثبت درخواست گواهی از طریق CSR» را انتخاب نمایید.
  4. نوع گواهی (یک‌ساله یا دوساله) را انتخاب کنید.
  5. فایل CSR ایجاد شده در مرحله قبل را بارگذاری نمایید.
  6. درخواست را ثبت کنید.

پس از ثبت درخواست، رسید یا معرفی‌نامه‌ای برای شما صادر خواهد شد.

مرحله ۳: مراجعه به دفتر پیشخوان

با مدارک مورد نیاز و معرفی‌نامه صادر شده به یکی از دفاتر پیشخوان دولت مراجعه نمایید.

پس از احراز هویت و تکمیل فرآیند، گواهی مهر سازمانی برای شما صادر خواهد شد.

در پایان معمولاً یک فایل گواهی با پسوند .cer یا .crt دریافت می‌کنید.

مرحله ۴: استخراج کلید عمومی

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

openssl x509 -pubkey -noout -in mystamp.cer > public.key

اکنون دو فایل مورد نیاز نرم‌افزار آزاد امیر را در اختیار دارید:

  • private.key
  • public.key

مرحله ۵: دریافت نام کاربری سامانه مودیان

پس از دریافت گواهی، وارد کارپوشه سامانه مودیان شوید.

  1. به بخش «شناسه‌های یکتای حافظه مالیاتی» مراجعه کنید.
  2. یک حافظه مالیاتی جدید ایجاد نمایید یا حافظه مالیاتی موجود را انتخاب کنید.
  3. گواهی دریافت شده را به حافظه مالیاتی متصل نمایید.
  4. پس از ثبت حافظه مالیاتی، «شناسه یکتای حافظه مالیاتی» برای شما نمایش داده می‌شود.

در نرم‌افزار آزاد امیر، این شناسه با عنوان نام کاربری سامانه مودیان استفاده می‌شود.

⚠️ شناسه یکتای حافظه مالیاتی برای هر حافظه مالیاتی منحصر به فرد است و باید دقیقا همان مقدار درج شده در کارپوشه سامانه مودیان وارد شود.

مرحله ۶: ثبت اطلاعات در نرم‌افزار آزاد امیر

در بخش تنظیمات شرکت در نرم‌افزار آزاد امیر، اطلاعات زیر را وارد نمایید:

فیلد مقدار
نام کاربری سامانه مودیان شناسه یکتای حافظه مالیاتی
کلید خصوصی محتوای فایل private.key
گواهی امضا محتوای فایل .cer یا .crt

پس از ذخیره تنظیمات، اتصال به سامانه مودیان را آزمایش نمایید.

در صورت صحت اطلاعات، نرم‌افزار قادر خواهد بود صورتحساب‌های الکترونیکی را به سامانه مودیان ارسال کند.

نکات مهم

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