راهنمای فنی صدور صورتحساب ارزی و صادراتی در سامانه مودیان + تنظیمات فیلدهای JSON
2026-09-27
تیم پشتیبانی VORLEX
تجارت بینالملل و صادرات کالا پیچیدگیهای خاص خود را در قانون پایانههای فروشگاهی دارد. سرورهای سازمان امور مالیاتی مبنای تمام محاسبات و اعتبارسنجیها را «ریال ایران» قرار دادهاند، در حالی که شرکتهای بازرگانی فاکتورهای خود را با ارزهای خارجی (دلار، یورو، درهم و...) صادر میکنند. عدم تسلط بر نحوه تبدیل و ارسال این مقادیر، منجر به خطای ساختاری و رد شدن صورتحساب در کارپوشه میشود.
۱. چالش صورتحسابهای ارزی در سامانه مودیان
هنگام صدور فاکتور ارزی، شما نمیتوانید صرفاً اعداد دلاری را در فیلدهای مبلغ وارد کنید. سامانه مودیان نیازمند دریافت همزمان «مبلغ ارزی»، «نرخ برابری ارز در روز صدور» و «معادل دقیق ریالی» است. اگر حاصل ضرب مبلغ ارزی در نرخ برابری، حتی یک ریال با معادل ریالی اعلام شده مغایرت داشته باشد (خطای رندینگ اعشار)، پکت JWS شما به صورت کامل Reject خواهد شد.
۲. ساختار فنی فیلدهای ارزی در Payload صورتحساب
برای ارسال موفق یک فاکتور صادراتی یا ارزی، باید از الگوهای خاص (مانند الگوی صادرات) استفاده کرده و سه فیلد کلیدی زیر را در بدنه JSON صورتحساب مقداردهی کنید:
- کد ارز (cap - Currency Code): این فیلد باید شامل کد استاندارد سه حرفی ایزو ۴۲۱۷ برای ارز مورد نظر باشد (مثلاً USD برای دلار آمریکا، EUR برای یورو یا AED برای درهم امارات).
- مبلغ ارزی (vop - Value of Product): قیمت خالص کالا یا خدمات به ارز خارجی پیش از اعمال هرگونه کسورات یا اضافات.
- نرخ برابری ارز (exr - Exchange Rate): نرخ تبدیل ارز خارجی به ریال ایران که مبنای محاسبه حسابداری شما در روز صدور فاکتور بوده است.
پس از تعیین این سه پارامتر، تمامی فیلدهای ریالی فاکتور (مانند مبلغ کل، تخفیف و...) باید بر اساس ضرب دقیق (vop * exr) محاسبه و در فیلدهای متناظر (مانند fee و am) درج شوند.
۳. مالیات بر ارزش افزوده در فاکتورهای صادراتی (نرخ صفر)
طبق قوانین مالیاتی، صادرات کالا و خدمات به خارج از کشور مشمول مالیات با «نرخ صفر» است. این بدان معناست که شما در صورتحساب صادراتی نباید مالیات ۹ درصدی را از خریدار خارجی کسر کنید. با این حال، درج دقیق اطلاعات پروانه گمرکی (کوتاژ صادراتی) در صورتحساب برای اثبات خروج کالا از مرزهای کشور و برخورداری از این معافیت، الزامی است.
راهکار یکپارچه ارزی در VORLEX
محاسبه دستی نرخ برابری ارز، کنترل تعداد اعشار مجاز در فیلدها و اطمینان از تطابق دقیق مبالغ ریالی و ارزی، در حجم بالای فاکتورهای تجاری عملاً غیرممکن است.
موتور محاسباتی سامانه هوشمند VORLEX دارای سیستم مدیریت چندارزی (Multi-Currency) است. شما در داشبورد VORLEX تنها کافیست مبلغ ارزی و نوع ارز را انتخاب کنید؛ سیستم به صورت خودکار مقادیر (cap, exr, vop) را در کدهای JSON تنظیم کرده، محاسبات ریالی را تا آخرین اعشار بالانس میکند و صورتحساب صادراتی شما را بدون کوچکترین خطای Validation روانه کارپوشه میسازد.
تولید آنلاین و رایگان کلید CSR و Public Key
نیازی به نصب نرمافزارهای پیچیده یا پرداخت هزینه به واسطهها ندارید؛ میتوانید در چند ثانیه فایل درخواست گواهی (CSR) و کلید عمومی شرکت خود را به صورت استاندارد بسازید.
ورود به ابزار ساخت رایگان کلید CSRنیاز به صدور سریع و بیدردسر صورتحساب دارید؟
سامانه VORLEX فرآیند تولید کلیدها و ارسال فاکتور به کارپوشه را به صورت کاملاً خودکار انجام میدهد.
افتتاح رایگان حساب کاربری