یکپارچهسازی با سامانههای مالیاتی
اتصال نرمافزار به سامانه مودیان؛ معماری، کلیدها و کنترل خطا
ارسال صورتحساب به سامانه مودیان یک فراخوانی ساده نیست؛ صف، کلید، تکرار امن و تطبیق وضعیت تعیین میکنند که هیچ صورتحسابی گم یا تکراری نشود.
انتشار: · آخرین بهروزرسانی:
نویسنده: امیرعلی سعیدی — عضو تیم پیکا؛ تهیه با کمک ابزارهای هوش مصنوعی و مسئولیت انتشار با پیکا
اتصال نرمافزار به سامانه مودیان یعنی صورتحسابهای فروش از نرمافزار حسابداری، فروش یا ERP شما بهصورت خودکار و امن به سامانه سازمان امور مالیاتی ارسال و وضعیت هرکدام پیگیری شود. این کار یا مستقیم از نرمافزار خودتان انجام میشود یا از طریق یک واسط مجاز. مقررات و قالب دقیق را همیشه از درگاه رسمی سازمان بگیرید؛ این راهنما فقط معماری فنی اتصال را توضیح میدهد.
دو مسیر اصلی اتصال به سامانه مودیان کداماند؟
مقایسه مسیرهای اتصال
| مسیر | مناسب برای | مسئولیت شما |
|---|---|---|
| اتصال مستقیم از نرمافزار خودتان | سازمانی با تیم فنی و حجم صورتحساب زیاد | نگهداری کلید، صف، تکرار امن و بهروزرسانی با تغییر مقررات |
| اتصال از طریق واسط یا شرکت معتمد | سازمانی که نمیخواهد زیرساخت ارسال را نگه دارد | انتقال امن داده به واسط و تطبیق وضعیت با آن |
| ماژول آماده نرمافزار حسابداری | سازمانی که حسابداری آن این امکان را دارد | ارتقای نسخه و آزمون خروجی پیش از استفاده |
صفحه رسمی صدور صورتحساب الکترونیکی سازمان امور مالیاتی، کارپوشه هر مودی و روند صدور و تأیید را توضیح میدهد. پیش از انتخاب مسیر، همین صفحه و راهنماهای بهروز آن را بخوانید.
چرا ارسال صورتحساب باید از صف عبور کند؟
اگر نرمافزار فروش هنگام ثبت فاکتور مستقیم منتظر پاسخ سامانه بیرونی بماند، هر کندی یا قطعی آن سامانه، فروش شما را متوقف میکند. الگوی امنتر این است که صورتحساب در یک صف داخلی ثبت و جداگانه ارسال شود، وضعیت آن ذخیره و خطاها به کارشناس نمایش داده شوند. این همان اصل جداسازی است که در مقایسه API یا تبادل فایل هم دیده میشود.
کلید خصوصی و گواهی را چگونه نگه داریم؟
- کلید خصوصی فقط روی سرور ارسال و در مخزن امن کلید نگهداری شود، نه در کد یا فایل اشتراکی
- دسترسی به کلید فقط برای سرویس ارسال و مدیر سامانه مجاز باشد
- تعویض کلید و تاریخ انقضای گواهی از قبل برنامهریزی و یادآوری شود
- هر استفاده از کلید و هر ارسال در سابقه ممیزی ثبت شود
این موارد با کنترلهای مدیریت کلید و ممیزی در NIST SP 800-53 همخوان است و برای هر اتصال حساس مالی کاربرد دارد.
تلاش دوباره چگونه صورتحساب تکراری نسازد؟
وقتی پاسخ سامانه نمیرسد، نمیدانید صورتحساب ثبت شده یا نه. پیش از ارسال دوباره، وضعیت را با شناسه یکتای همان صورتحساب استعلام کنید و فقط در صورت ثبتنشدن دوباره بفرستید. شناسه یکتا، شمارش تلاش و فاصله رو به افزایش میان تلاشها را از ابتدا طراحی کنید. اصول عمومی این طراحی در راهنمای یکپارچهسازی نرمافزارها و API آمده است.
تطبیق وضعیت صورتحسابها چگونه انجام شود؟
روزانه فهرست صورتحسابهای صادرشده در نرمافزار را با وضعیت ثبتشده در سامانه مقایسه کنید: ارسالنشده، در انتظار، پذیرفتهشده و ردشده. صورتحساب ردشده باید با دلیل به مسئول مالی برگردد. برای تعیین اینکه کدام سامانه مرجع هر وضعیت است، همان منطقی را به کار ببرید که در اتصال نرمافزار عملیاتی به حسابداری لازم است.
هزینه و زمان این یکپارچهسازی به چه چیزی بستگی دارد؟
تعداد نرمافزارهایی که صورتحساب صادر میکنند، کیفیت داده پایه مانند شناسه خریدار و کالا، مسیر انتخابشده و نیاز به گزارش تطبیق، هزینه را تعیین میکنند. برآورد این اقلام در راهنمای هزینه یکپارچهسازی سامانهها آمده است.
چه زمانی این راهنما پاسخ شما نیست؟
اگر پرسش شما درباره تکلیف قانونی، نوع صورتحساب، مهلت یا جریمه است، این صفحه مرجع آن نیست و باید به درگاه رسمی سازمان امور مالیاتی یا مشاور مالیاتی مراجعه کنید. اگر نرمافزار حسابداری شما ماژول آماده دارد، ابتدا همان را آزمایش کنید.
پرسشهای پرتکرار
اتصال مستقیم بهتر است یا استفاده از واسط؟
اتصال مستقیم کنترل بیشتری میدهد اما نگهداری کلید، صف و بهروزرسانی با تغییر مقررات بر عهده شماست. واسط این بار را کم میکند و در عوض به وابستگی و قرارداد با واسط نیاز دارد.
اگر سامانه مودیان در دسترس نباشد فروش متوقف میشود؟
نباید متوقف شود. با صف داخلی، صورتحساب ثبت و بعداً ارسال میشود؛ مهلتهای قانونی ارسال را از منبع رسمی بررسی کنید تا صف بیش از حد مجاز نماند.
چند نرمافزار داریم که فاکتور صادر میکنند؛ چه کنیم؟
بهتر است ارسال از یک سرویس مرکزی انجام شود تا کلید در یک جا نگهداری و شمارهگذاری و تطبیق یکسان باشد.