ملی ای‌پی‌آی

شناسهٔ صنفی چیست و با کد ملی و شناسهٔ ملی شرکت چه فرقی دارد؟

شناسهٔ صنفی عددی ده‌رقمی روی جواز کسب است و باید به‌صورت رشته با صفر ابتدایی نگه‌داری شود، چون با کد ملی و شناسهٔ ملی شرکت فرق دارد.

شناسهٔ صنفی عددی ده‌رقمی است که روی جواز کسب نوشته شده و واحد صنفی را مشخص می‌کند؛ نه کد ملی است، نه شناسهٔ ملی شرکت، نه شمارهٔ پروانه‌ای که شاید روی کاغذ دیده باشید. اگر یکی را به‌جای دیگری وارد کنید، استعلام یا خطا می‌دهد یا بدتر، چیز دیگری برمی‌گرداند.

در عمل بیشتر سردرگمی از همین‌جا می‌آید. این مقاله می‌گوید این عدد چه ویژگی‌هایی دارد، با چه عددهایی قاطی می‌شود و چطور باید در یک فرم یا پایگاه داده نگه‌داشته شود. اگر می‌خواهید با آن استعلام بگیرید، سرویس استعلام اطلاعات صنف دقیقاً همین ورودی را می‌خواهد.

مشخصات شناسهٔ صنفی

از روی قرارداد سرویس ما این‌ها قطعی است:

  • ده رقم است. نه نه رقم، نه یازده.
  • فقط رقم دارد. حرف و خط‌تیره ندارد.
  • سرویس ارقام فارسی را به لاتین تبدیل می‌کند و غیر رقم‌ها را حذف می‌کند، ولی طول باید ده باشد، وگرنه ورودی نامعتبر است.
  • از روی نام کسب‌وکار یا نشانی پیدا نمی‌شود؛ ورودی همین عدد است.

نمونهٔ فرمی که ما نشان می‌دهیم «۰۱۲۳۴۵۶۷۸۹» است. توجه کنید که با صفر شروع می‌شود، و این به نکتهٔ بعدی می‌رسد.

صفر ابتدای عدد را از دست ندهید

اگر شناسه را در پایگاه داده به‌صورت عدد صحیح ذخیره کنید، صفر ابتدایی می‌افتد و ۰۱۲۳۴۵۶۷۸۹ می‌شود ۱۲۳۴۵۶۷۸۹ یعنی نه رقم. سپس استعلام «ده رقم نیست» می‌گوید و تیم به‌جای ریشه‌یابی، به کاربر می‌گوید شناسه‌اش غلط است.

قاعده ساده است: هر عدد شناسایی (شناسهٔ صنفی، کد ملی، کد پستی، شماره کارت) را به‌صورت رشته ذخیره کنید. در اکسل هم همین مشکل هست؛ فایل CSV که فروشنده‌ها از آن شناسه‌هاشان را وارد می‌کنند معمولاً صفر را می‌خورد. اگر محصولتان آپلود فایل دارد، پیش از اعتبارسنجی، رقم‌های کمتر از ده تا را از چپ با صفر پر کنید و به کاربر بگویید چنین کرده‌اید. من این کار را برای ورودی فایل ایمن می‌دانم، ولی در ورودی دستی (فرم) نه؛ آنجا کاربر باید همان عددی را که روی جواز می‌بیند وارد کند.

چهار عدد که با شناسهٔ صنفی اشتباه می‌شوند

عددچند رقمبرای که
شناسهٔ صنفی۱۰واحد صنفی دارای جواز
کد ملی۱۰شخص حقیقی
شناسهٔ ملی شرکت۱۱شخص حقوقی
کد پستی۱۰نشانی

دو چیز اینجا مهم است. کد ملی و شناسهٔ صنفی هر دو ده رقم‌اند و اعتبارسنج طول نمی‌تواند تفاوتشان را تشخیص دهد. اگر کاربر کد ملی را در جایگاه شناسه صنفی بنویسد، فرم ورودی را می‌پذیرد، ولی نتیجه معنادار نخواهد بود. پس برچسب فرم را واضح بنویسید («شناسهٔ صنفی، روی جواز کسب») و جایی که لازم است، تصویر یک جواز نمونه نشان دهید.

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

این شناسه چه چیزی را به شما می‌دهد

با شناسهٔ درست، پاسخ دو بخش دارد. بخش اول هویت دارنده: نام، نام خانوادگی، نام پدر، کد ملی و موبایل. بخش دوم مشخصات پروانه: نام اتحادیه، رسته فعالیت، حقیقی یا حقوقی بودن، وضعیت، تاریخ صدور و انقضا، نشانی، کد پستی و تلفن.

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

چه چیزی را ثابت نمی‌کند

نمی‌گوید این کسب‌وکار خوش‌حساب است یا شکایت دارد. نمی‌گوید کسی که شناسه را به شما داده، همان دارندهٔ جواز است. اگر فروشنده‌ای شناسهٔ جوازِ یک نفر دیگر را وارد کرده باشد، استعلام موفق می‌شود و اطلاعات آن نفر را می‌آورد. برای اینکه ثابت شود ورودی‌دهنده خودِ دارنده است، باید نام و کد ملی پاسخ را با هویت احرازشدهٔ کاربرتان مقایسه کنید.

داده‌ی شخصی در پاسخ

پاسخ شامل کد ملی و موبایل دارنده است. دو قاعدهٔ ساده:

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

وقتی کاربر شناسه‌اش را پیدا نمی‌کند

بخش بزرگی از پشتیبانی همین است. چند پیشنهاد برای راهنمای فرم:

  1. بنویسید شناسه روی جواز کسب است و ده رقم دارد.
  2. بگویید اگر عدد یازده رقمی دیده، آن شناسهٔ ملی شرکت است و برای جای دیگری است.
  3. بگویید اگر عدد ده‌رقمی دیده و مطمئن نیست، کد ملی و شناسهٔ صنفی را از هم تفکیک کند.
  4. راه جایگزین بدهید (آپلود تصویر جواز برای بررسی دستی)، تا کاربر بن‌بست نبیند.

از نظر من این چهار خط راهنما، تیکت‌های پشتیبانی را بیشتر از هر بهینه‌سازی فنی کم می‌کند.

یک آزمون سه‌خطی برای فرم

اگر می‌خواهید فرم شما اشتباه‌های رایج را همان لحظه بگیرد، سه کنترل کافی است:

  1. طول پس از حذف غیررقم‌ها دقیقاً ده باشد.
  2. اگر کاربر یازده رقم وارد کرد، پیام بدهید «این عدد یازده رقم دارد؛ شناسهٔ ملی شرکت است، نه شناسهٔ صنفی».
  3. اگر ده رقم بود ولی از الگوی کد ملی پیروی می‌کرد، یک هشدار ملایم نشان دهید («مطمئنید این شناسهٔ صنفی است و کد ملی نیست؟»).

مورد سوم را اگر پیاده‌سازی نکنید هم مشکلی نیست، ولی در تجربهٔ من (به‌عنوان توصیه، نه آمار) بیشترین خطای کاربر همین است. با این هشدار، تعداد استعلام‌های بی‌نتیجه کمتر می‌شود و هزینهٔ آن‌ها برای کاربر کاهش می‌یابد.

کجا استعلام را بزنیم

وقتی شناسه ده رقم و بی‌مشکل شد، استعلام اطلاعات صنف را بزنید. پاسخ را قبل از ذخیره بررسی کنید: نام دارنده در پاسخ را با نامی که کاربر در پروفایل دارد مقایسه کنید. اگر نخواند، به جای رد، از کاربر توضیح بخواهید؛ ممکن است جواز به نام یکی از اعضای خانواده یا شریک باشد.

جواز کاغذی، جواز الکترونیکی و شناسه

بعضی کاربران عکس جواز قدیمی کاغذی دارند و بعضی فایل الکترونیکی. در هر دو حالت دنبال همان عدد ده‌رقمی باشند. اگر روی جواز چند عدد می‌بینند، عددی که با عنوان شناسه نوشته شده را بخوانند. ما شکل دقیق جواز را در مرجع بررسی نمی‌کنیم و ادعای ثابتی دربارهٔ چیدمان آن نداریم؛ برای همین در راهنمای فرم همین عبارت کلی را بنویسید و تصویر نمونه را فقط وقتی بگذارید که از شکل واقعی آن مطمئن‌اید.

خلاصه برای مرور بعدی

شناسهٔ صنفی را به‌صورت رشتهٔ ده‌رقمی، با صفر ابتدایی، نگه دارید؛ آن را با کد ملی و شناسهٔ ملی شرکت قاطی نکنید؛ و بدانید که استعلامش هویت و پروانه را می‌دهد، نه اعتبار تجاری را. اگر قصد دارید از آن برای احراز فروشنده استفاده کنید، مقالهٔ احراز فروشنده با جواز کسب ادامهٔ همین بحث است.

آخرین بازبینی: تیم تحریریه ملی ای‌پی‌آی

وب‌سرویس مرتبط با این راهنما

API استعلام اطلاعات صنف

مشخصات جواز کسب با شناسه صنفی ده‌رقمی.

مشاهده مشخصات فنی و تعرفه

راهنماهای مرتبط

پرسش و تجربه کاربران

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

هنوز پرسشی ثبت نشده، اولین نفر باشید.