API استعلام رنگ چک صیادی

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

برای کسب‌وکاری که چک می‌گیرد، رنگ کوتاه‌ترین خلاصهٔ سابقهٔ صادرکننده است. سفید یعنی چک برگشتیِ رفع‌نشده‌ای برایش ثبت نیست و هرچه رنگ به قرمز نزدیک‌تر شود، سابقهٔ برگشتی یا مبلغ رفع‌نشده بیشتر است. همین یک مقدار، تصمیم «چک این مشتری پذیرفته شود یا نه» را از سلیقهٔ صندوق‌دار بیرون می‌آورد و به قاعده‌ای در سامانهٔ شما می‌سپارد.

آنچه این استعلام نمی‌کند

دربارهٔ یک برگهٔ چک مشخص چیزی نمی‌گوید. رنگ، وضعیت امروزِ صادرکننده است، نه وضعیت چکی که در دست دارید؛ مشخصات یک برگه را استعلام چک صیادی با شناسهٔ صیادی می‌دهد.

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

نکته پیاده‌سازی

منطق تصمیم را روی cheque_color_code بنویسید و cheque_color را فقط برای نمایش نگه دارید. مقایسهٔ عددی، مثل «کد بالاتر از دو به تأیید مدیر برود»، پایدارتر از مقایسهٔ یک رشتهٔ فارسی است که با نیم‌فاصله یا «ی» عربی می‌شکند.

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