পুরোনো সংস্করণ ও স্যান্ডবক্সের উদ্দেশ্য
ছয় পাতার এই নির্দেশিকা 31 মে 2023 তারিখের Version 2.0, যার শিরোনাম YA2022 API Sandbox Testing। দায়বর্জন অংশে পৃথকভাবে তথ্য 16 আগস্ট 2021 অনুযায়ী সঠিক বলা আছে। ভিত্তিবর্ষ 2021-এর দৃশ্যপট ব্যবহার করার সময় তারিখগুলো অক্ষুণ্ণ রাখুন; ওই বছরের পরীক্ষার রেকর্ডকে বর্তমান উৎপাদন ব্যবস্থার তথ্য হিসেবে পাঠানোর নির্দেশ এগুলো নয়। প্রকৃত কমিশন রেকর্ড পাঠানোর আগে ডেভেলপারদের সংযোগ পরীক্ষা করতে স্যান্ডবক্স উৎপাদন পরিবেশের অনুকরণ করে। এই দৃশ্যপটের বাইরে ফিল্ডের সংজ্ঞার জন্য API ও পরিচয় যাচাইয়ের স্পেসিফিকেশন ব্যবহার করুন।
হিসাব তৈরি ও API সাবস্ক্রিপশন
Sandbox Portal-এ নিবন্ধন করে Submission of Commission Records (Corppass)-এ সাবস্ক্রাইব করুন। নিবন্ধন ফর্মে সফটওয়্যারের callback URL নিবন্ধন করুন। হিসাবের First name ও Last name ঘরে নিবন্ধনকারীর প্রকৃত নাম ও পদবি লিখে পরে My organisation-এ প্রতিষ্ঠানের নাম Name of Organisation_Tax reference No of organisation নিয়মে সম্পাদনা করুন। সেটআপের বিস্তারিত জানতে উৎস Commission API (CP) specifications-এর section 2 এবং Corppass Authentication API specifications উল্লেখ করে।
প্রকাশিত পরীক্ষার প্রতিষ্ঠান ব্যবহার
প্রকাশিত স্যান্ডবক্স Singpass লগইন S9991256A এবং পরীক্ষার পাসওয়ার্ড Spcp1111। API কলে প্রতিষ্ঠানের ID ধরন UEN-Local Business এবং নম্বর 98706710M; ডেটায় organisationIDType-এর মান 7। এগুলো নির্দেশিকার প্রকাশ্য স্যান্ডবক্স পরিচয়তথ্য ও কাল্পনিক পরীক্ষার মান, উৎপাদন ব্যবস্থার গোপন লগইন নয়। Set A-তে authorisedPersonIDNo ও idNumber ছাড়া নির্ধারিত মানই নিতে হবে; এই দুই ঘরে বৈধ ID প্রয়োজন। ভিন্ন organisationIDNo দিলে API-তে জমা দেওয়া যাবে না।
Set A দৃশ্যপট 1: মূল রেকর্ড
validateOnly=false, BasisYear=2021, organisationIDType=7, organisationIDNo=98706710M, authorisedPersonIDtype=1 এবং অনুমোদিত ব্যক্তির বৈধ NRIC ব্যবহার করুন। অনুমোদিত ব্যক্তি TESTER 1, পদ MANAGER; organisationName হলো TEST 1 PTE. LTD.; telephone 61234567; email TESTER1@TEST1.COM; batchIndicator O; numOfRecords 2; totalGrossCommission 49856। রেকর্ড 1-এ idType 1, আয়কারীর বৈধ NRIC, নাম EARNER 1, nationality 301, sex M, designation 3, জন্মতারিখ 19810320 ও grossCommission 5396 আছে। রেকর্ড 2-এ idType 8, আয়কারীর বৈধ UEN, নাম EARNER 2 ও grossCommission 44460 আছে। অঙ্ক দুটির যোগফল 49856-এর সঙ্গে মেলে। প্রত্যাশিত ফলাফলে ES17DDMMYYCOMMNNNNNN বিন্যাসের acknowledgementCode, খালি fieldInfoList ও returnCode 10 থাকে।
Set A দৃশ্যপট 2: ঋণাত্মক অঙ্কের সংশোধনী
validateOnly=false, basisYear=2021, organisationIDType=7 এবং একই প্রতিষ্ঠানের নম্বর ব্যবহার করুন। অনুমোদিত ব্যক্তির ID ধরন 1 ও বৈধ NRIC; নাম TESTER 2; পদ IT SUPPORT; organisationName TEST 2 S’PORE BRANCH; telephone 91234567; email TESTER2@TEST2.COM। batchIndicator A, numOfRecords 1 ও totalGrossCommission -4256। একমাত্র আয়কারীর রেকর্ডে recordID 1, idType 1 ও বৈধ NRIC, EARNER 1, nationality 301, sex M, designation 3, জন্মতারিখ 19810320 এবং grossCommission -4256 আছে। প্রত্যাশিত উত্তরে আবার প্রাপ্তিস্বীকার কোড, কোনো ফিল্ড-ত্রুটি না থাকা ও returnCode 10 থাকে। ঋণাত্মক চিহ্ন ও সংশোধনীর নির্দেশক অক্ষুণ্ণ রাখুন; এটি আরেকটি মূল ধনাত্মক অঙ্কের জমা নয়।
Set A দৃশ্যপট 3: একই রেকর্ডের পুনরাবৃত্তি যাচাই
validateOnly=true এবং দৃশ্যপট 1-এর প্রতিষ্ঠান ও অনুমোদিত ব্যক্তির ফিল্ড ব্যবহার করুন; সঙ্গে batchIndicator O, দুটি রেকর্ড ও totalGrossCommission 69520 থাকবে। দুই রেকর্ডেই EARNER 1-এর একই বৈধ NRIC এবং একই nationality 301, sex M, designation 3 ও জন্মতারিখ 19810320 থাকে; recordID যথাক্রমে 1 ও 2 এবং মোট কমিশন 25985 ও 43535। প্রত্যাশিত ফল returnCode 30, বার্তা Arguments Error ও messageCode 850301। fieldInfoList-এ commissionEarnerDtl চিহ্নিত হয়, Duplicate record exists বলা হয় এবং recordID 2 দেখানো হয়। শুধু যাচাইয়ের এই দৃশ্যপট ইচ্ছাকৃতভাবে একই রেকর্ডের পুনরাবৃত্তি পরীক্ষা করে, অর্থের যোগফল মিলে গেলেও।
Set B ও পরীক্ষার ফল পাঠানো
10–20টি কাল্পনিক রেকর্ড তৈরি করুন, সম্ভব হলে ব্যক্তি ও ব্যবসায়িক আয়কারীর রেকর্ড মিলিয়ে; organisationIDType 7 ও organisationIDNo 98706710M ব্যবহার করুন। স্যান্ডবক্সে সফলভাবে বাস্তব পরীক্ষামূলক জমা দিলে প্রাপ্তিস্বীকার কোড আসে। উৎসের টেমপ্লেট অনুযায়ী ফল data_mgmt@iras.gov.sg-এ ইমেইল করতে বলা হয়েছে: Set A-এর ক্রমিক 1 ও 2-এর প্রাপ্তিস্বীকার কোড; Set B-এর রেকর্ডসংখ্যা ও মোট কমিশন। দৃশ্যপট 3 যাচাইয়ের ত্রুটির পরীক্ষা; সফল প্রাপ্তিস্বীকারের সারি হিসেবে তা তালিকায় নেই। IRAS জানিয়েছে, পরীক্ষার ফল দশ কর্মদিবসের মধ্যে জানাবে। এটি পুরোনো নির্দেশিকার পরীক্ষাপদ্ধতি, উৎপাদন ব্যবস্থায় প্রকৃত তথ্যের বদলে কাল্পনিক তথ্য দেওয়ার অনুমতি নয়।
সরকারি উৎস
এই নিবন্ধে সরকারি PDF-এর মূল বিষয়বস্তু, প্রাসঙ্গিক শর্ত, পদ্ধতি ও পরিশিষ্ট স্বাধীনভাবে ব্যাখ্যা করা হয়েছে। মূল ভাষার প্রামাণ্য উৎস হলো সংযুক্ত নথি; পরবর্তী পরিবর্তন আলাদাভাবে যাচাই করতে হবে।
সরকারি PDF পড়ুন ↗