سرویس «استعلام وضعیت نظام وظیفه» در دسته احراز هویت و شناخت مشتری فینوتک، با گرفتن کد ملی و تاریخ تولد مشخص میکند وضعیت نظام وظیفه فرد مجاز است یا غیرمجاز و شرح آن را هم برمیگرداند. با این نتیجه میتوانید در استخدام، صدور خدمات و پروندههای اداری، شرط وضعیت خدمت را بدون دریافت کارت و مدرک کاغذی کنترل کنید.
استعلام وضعیت نظام وظیفه چه مشکلی را حل میکند؟
کنترل وضعیت نظام وظیفه در بیشتر سازمانها هنوز با دیدن کارت پایان خدمت یا معافیت انجام میشود؛ متقاضی باید کارت را حضوری بیاورد یا تصویر آن را بفرستد و کارشناس درباره اصالت و اعتبار آن قضاوت کند. این مسیر هم برای متقاضی زمانبر است، هم برای سازمان قابل اتکا نیست و هم سوابق آن به شکل پرونده کاغذی بایگانی میشود که در ممیزی بهسختی قابل استناد است.
این سرویس همان کنترل را به یک فراخوانی API تبدیل میکند: با کد ملی و تاریخ تولد، وضعیت خدمت فرد در قالب مجاز یا غیرمجاز و بههمراه شرح وضعیت بازمیگردد. برای افرادی که کارت پایان خدمت یا معافیت دارند و همچنین برای بانوان، نتیجه مجاز و برای افرادی که چنین کارتی ندارند یا کارت آنها هوشمند نیست، نتیجه غیرمجاز است. خروجی مستقیم به قاعده پذیرش شما وصل میشود و تصمیم، ثبتشده و قابل بازبینی میماند.
کاربردهای استعلام وضعیت نظام وظیفه
- غربالگری متقاضیان استخدام — واحد منابع انسانی پیش از دعوت به مصاحبه یا عقد قرارداد، شرط وضعیت خدمت را خودکار بررسی میکند.
- پذیرش نیرو در پلتفرمهای خدماتی و پیمانکاری — پیش از فعالسازی پنل همکار یا راننده، وضعیت خدمت او کنترل میشود.
- پروندههای آموزشی و بورسیه — موسسهها هنگام ثبتنام دورههای بلندمدت، وضعیت خدمت متقاضی را بهعنوان یکی از شرایط پرونده استعلام میکنند.
- فرآیندهای اداری نیازمند مدرک خدمت — بهجای درخواست کارت از متقاضی، همان شرط با استعلام برخط احراز میشود.
- تکمیل پرونده هویتی در فرآیند شناخت مشتری — نتیجه این استعلام کنار سایر بررسیهای هویتی، تصویر کاملتری از پرونده متقاضی میسازد.
مزایای استعلام وضعیت نظام وظیفه
- پاسخ آماده تصمیمگیری — نتیجه به شکل مجاز یا غیرمجاز برمیگردد و بدون تفسیر اضافه به قاعده پذیرش وصل میشود.
- شرح وضعیت در کنار نتیجه — علاوه بر خود نتیجه، شرح وضعیت هم بازمیگردد و میتوانید پیام دقیقتری به متقاضی نشان دهید.
- حذف مدرک کاغذی از جریان پذیرش — نیازی به ارائه کارت پایان خدمت یا معافیت و بررسی چشمی آن نیست.
- معیار یکسان برای همه پروندهها — نتیجه به قضاوت کارشناس وابسته نیست و پذیرش متقاضیان مختلف یکدست میماند.
- سوابق قابل ممیزی — نتیجه استعلام همراه شناسه پیگیری در پرونده ثبت میشود و در بازرسی داخلی قابل استناد است.
چه چیزی از استعلام وضعیت نظام وظیفه دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار استعلام وضعیت نظام وظیفه
- ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ
kyc:military-inquiry:getتوکن Client Credential بگیرید. - ۲. دریافت ورودیها — کد ملی و تاریخ تولد متقاضی را در فرم درخواست یا پرونده منابع انسانی بگیرید.
- ۳. فراخوانی استعلام — درخواست را همراه یک شناسه پیگیری یکتا ارسال کنید.
- ۴. اعمال قاعده پذیرش — نتیجه مجاز یا غیرمجاز را به تصمیم خود نگاشت کنید و در صورت نیاز، شرح وضعیت را در پیام به متقاضی بیاورید.
- ۵. ثبت نتیجه در پرونده — نتیجه و شناسه پیگیری را برای ممیزی و پاسخ به اعتراض ذخیره کنید.
نحوه شروع استعلام وضعیت نظام وظیفه
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: kyc:military-inquiry:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات استعلام وضعیت نظام وظیفه
- تاریخ تولد را در قالب
yyyy/mm/ddبفرستید و پیش از فراخوانی، سازگاری آن با کد ملی را در سمت خود بررسی کنید. - نتیجه غیرمجاز لزوما به معنای نداشتن معافیت نیست؛ نداشتن کارت هوشمند هم میتواند به همین نتیجه منجر شود، بنابراین مسیر بررسی دستی را برای اعتراض متقاضی باز بگذارید.
- شرح وضعیت بازگشتی را در پیام کاربر بهصورت خام نمایش ندهید؛ آن را به متن روشن و قابل فهم برای متقاضی تبدیل کنید.
- نتیجه، تصویری از همان لحظه است؛ وضعیت خدمت افراد تغییر میکند و برای پروندههای باز، استعلام را در زمان تصمیم نهایی تکرار کنید.
- برای هر فراخوانی شناسه پیگیری یکتا بفرستید تا بررسی خطا و تطبیق سوابق ساده شود.
- وضعیت نظام وظیفه داده شخصی است؛ آن را فقط برای همان تصمیم کسبوکاری نگه دارید و دسترسی به آن را محدود کنید.
سوالات متداول استعلام وضعیت نظام وظیفه
استعلام وضعیت نظام وظیفه چیست؟
سرویسی است که با دریافت کد ملی و تاریخ تولد، وضعیت نظام وظیفه فرد را در قالب مجاز یا غیرمجاز و بههمراه شرح وضعیت برمیگرداند تا شرط خدمت بدون مدرک کاغذی بررسی شود.
در چه حالتی نتیجه مجاز و در چه حالتی غیرمجاز است؟
برای افرادی که کارت پایان خدمت یا معافیت دارند و همچنین برای بانوان، نتیجه مجاز نمایش داده میشود؛ برای افرادی که چنین کارتی ندارند یا کارت آنها هوشمند نیست، نتیجه غیرمجاز است.
تفاوت این سرویس با استعلام اطلاعات هویتی چیست؟
این سرویس فقط وضعیت خدمت را ارزیابی میکند؛ برای دریافت مشخصات ثبت احوال مانند نام، نام پدر و مشخصات شناسنامه از استعلام اطلاعات هویتی استفاده کنید.
آیا برای بانوان هم قابل فراخوانی است؟
بله؛ سرویس برای هر کد ملی فراخوانی میشود و برای بانوان نتیجه مجاز بازمیگردد.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی استعلام وضعیت نظام وظیفه
مشاهده مستندات فنی «استعلام وضعیت نظام وظیفه» — endpoint، پارامترها، نمونه درخواست و پاسخ.