شرکت نمونه (Demo)
← بازگشت به راهنما

اتصال سامانه مودیان (صورت‌حساب الکترونیکی)



> version: 1.0 | last_updated: 2026-07-27 | audience: admin

معرفی



ماژول **مودیان** برای ارسال صورتحساب‌های الکترونیکی به سامانه مالیاتی ایران (مودیان) طراحی شده است.

**وضعیت فعلی:** Stub + Sandbox — اتصال production پس از دریافت Memory ID و کلید خصوصی.

---

فعال‌سازی



  • `/panel` → **تنظیمات مالی**

  • کد اقتصادی و شناسه ملی شرکت را وارد کنید

  • بخش **سامانه مودیان** → فعال + Sandbox


  • ---

    ارسال فاکتور



  • `/panel` یا `/admin` → **فاکتورها** → مشاهده فاکتور

  • دکمه **ارسال به مودیان**

  • در Sandbox: مرجع `MOADIAN-SBX-...` و Tax ID شبیه‌سازی می‌شود


  • ---

    فیلدهای موردنیاز production



    | فیلد | توضیح |
    |------|--------|
    | `economic_code` | کد اقتصادی فروشنده |
    | `company_national_id` | شناسه ملی شرکت |
    | `moadian_memory_id` | Memory ID از سامانه مودیان |
    | `moadian_private_key` | کلید خصوصی (فاز بعد) |

    ---

    جدول `moadian_submissions`



    هر ارسال ثبت می‌شود: status, reference, tax_id, payload, response.

    ---

    تست



    ```bash

    پس از فعال‌سازی moadian در تنظیمات Tenant


    از Filament روی فاکتور پرداخت‌شده → ارسال به مودیان


    ```

    ---

    فاز بعد



  • اتصال API واقعی مودیان (SDK/GSB)

  • ارسال خودکار پس از پرداخت فاکتور

  • ابطال/اصلاح صورتحساب