একটি AI সিস্টেম প্রক্রিয়া এবং ফাইল একটি Self Assessment ট্যাক্স স্বয়ংক্রিয়ভাবে HMRC এ রিটার্ন করতে পারে?
FileMyTax প্রদর্শন করা — ব্যাঙ্ক PDF থেকে HMRC MTD ফাইলিং পর্যন্ত একটি AI-চালিত পাইপলাইন, CognoAI-এর জন্য Workstation দ্বারা নির্মিত
Balinder Walia২০ মে, ২০২৬5 min read
একটি সংক্ষিপ্ত, স্কিম-পঠনযোগ্য সহচর। আর্কিটেকচার, HMRC OAuth, কার্ল উদাহরণ এবং সীমাবদ্ধতা সহ সম্পূর্ণ গভীরে ডুব দেওয়ার জন্য, পড়ুন দীর্ঘ নিবন্ধ. ট্যাক্স পরামর্শ নয়।
এআই কি আপনার Self Assessment থেকে HMRC ফাইল করতে পারে?
প্রতি জানুয়ারিতে একই প্রশ্ন আসে: একজন AI কি আমার ব্যাঙ্ক স্টেটমেন্ট পড়তে পারে এবং আমার UK ট্যাক্স রিটার্ন জমা দিতে পারে? আমরা যে সিস্টেমের জন্য তৈরি করেছি তার ব্যবহারিক উত্তর CognoAI — এখানে হিসাবে প্রকাশিত FileMyTax — হয় হ্যাঁ প্রস্তুতির জন্য, অনুপস্থিত ফাইলিংয়ের জন্য নয়. AI PDFs থেকে লেনদেন বের করতে পারে, HMRC Self Assessment ক্যাটাগরিতে শ্রেণীবদ্ধ করতে পারে, ব্যালেন্স মিটমাট করতে পারে এবং 2025-26 ট্যাক্স নির্ধারকভাবে গণনা করতে পারে; একজন মানুষ এখনও পর্যালোচনা করে, একজন হিসাবরক্ষক এখনও সাইন অফ করে, এবং করদাতা এখনও HMRC OAuth সম্পূর্ণ করে তার উৎপাদন MTD পৌঁছানোর আগেই।
Workstation অন্তর্নিহিত প্ল্যাটফর্ম তৈরি করেছে; CognoAI মেধা সম্পত্তির মালিক। এই পোস্টটি ব্যাখ্যা করে যে এটি ছয়টি API কলে কেমন দেখায় — অন্য কোথাও মালিকানাধীন পণ্যের নাম ব্যবহার না করে।
ডেমো দেখুন
HMRC MTD স্যান্ডবক্সে শ্রেণিবিন্যাস এবং গণনার মাধ্যমে ব্যাঙ্ক PDF — UI-তে পর্যালোচনা গেট সহ।
ছয় ধাপের পাইপলাইন
- আপলোড করুন —
POST /fastapi/api/uploadnginx এর মাধ্যমে MinIO-তে PDF পাঠায়। - নির্যাস — নেটিভ টেবিলের জন্য pdfplumber; স্ক্যানের জন্য ক্লড ভিশন।
- শ্রেণীবদ্ধ করুন — LLM কনফিডেন্স স্কোর সহ SA ব্যয়ের বিভাগগুলিতে লাইন ম্যাপ করে।
- মিলন - ব্যালেন্স চেক এবং আয়/ব্যয় রোল-আপ।
- হিসাব করুন — নির্ধারক 2025-26 আয়কর + ক্লাস 4 NI (গণিতে LLM নেই)।
- ফাইল —
POST /fastapi/api/fileOAuth এবং মানুষের অনুমোদনের পরে HMRC MTD পর্যন্ত।
JWT auth এসেছে opsapi থেকে; NINO বিশ্রামে এনক্রিপ্ট করা হয়; পোর্ট 8085-এ Gatus প্রতিটি পরিষেবা দেখে।
কারা এটি নির্মাণ করেছে
CognoAI সিস্টেমের আইপি এবং পণ্যের দিকনির্দেশের মালিক। Workstation Dockerised প্ল্যাটফর্ম তৈরি করেছে — nginx পাথ রাউটিং, FastAPI AI পরিষেবা, opsapi auth, PostgreSQL, MinIO, Gatus মনিটরিং, এবং Next.js পর্যালোচনা UI। নামে প্রকাশ করি FileMyTax ডেমো বর্ণনা করতে; আমরা এই লেখায় অন্যান্য CognoAI পণ্যের নাম ব্যবহার করি না।
কেন AI সাহায্য করে - এবং এটি কোথায় থামে
AI শত শত ব্যাঙ্ক লাইন, অসঙ্গতি ফ্ল্যাগিং এবং HMRC বিভাগে অগোছালো বর্ণনা ম্যাপিং জুড়ে গতি এবং ধারাবাহিকতায় জয়লাভ করে। এটি রায় প্রতিস্থাপন করে না: স্থানান্তর বনাম ভাড়া, মূলধন বনাম রাজস্ব, এবং ব্যক্তিগত বনাম ব্যবসার এখনও চোখ দরকার। ট্যাক্স ইঞ্জিনটি দশমিক ক্ষেত্র সহ বিশুদ্ধ পাইথন - একই বিচ্ছেদ যা আমরা নিয়ন্ত্রিত অর্থের জন্য জোর দিয়ে থাকি: ভাষার জন্য LLM, আইনের জন্য কোড.
পরীক্ষায় আমরা ব্যবহার করেছি কাল্পনিক HSBC-শৈলী বাড়িওয়ালা বিবৃতি ফিক্সচার (শুধুমাত্র সিন্থেটিক ডেটা) স্ট্রেস এক্সট্রাকশনের জন্য উচ্চ টার্নওভারের পরিস্থিতি সহ — যেখানে পিডিএফপ্লাম্বার ভুল কলাম বেছে নিয়েছে (ব্যালেন্স বনাম পেইড-ইন) সেসব সহ। সেই ব্যর্থতার কারণেই মিলন ও পর্যালোচনা বিদ্যমান।
এক নজরে স্থাপত্য
লোকালহোস্টে একটি এনজিএনএক্স সবকিছুকে সামনে রাখে: মানুষের জন্য Next.js, AI এবং ফাইলিংয়ের জন্য FastAPI, লগইন করার জন্য opsapi এবং এনক্রিপ্ট করা NINO। PostgreSQL বিবৃতি এবং শ্রেণীবদ্ধ লেনদেন সঞ্চয় করে; MinIO পিডিএফ ধারণ করে। ট্যাক্স ক্যালকুলেটর Python-এ UK 2025/26 ব্যান্ড প্রয়োগ করে — ব্যক্তিগত ভাতা টেপার, আয়কর, ক্লাস 4 NI — DECIMAL(18,2) মানি ফিল্ড সহ। এই বিভাজনটি ইচ্ছাকৃত: নিয়ন্ত্রক এবং হিসাবরক্ষকদের পুনরুত্পাদনযোগ্য গণিতের প্রয়োজন, সম্ভাব্য টোকেন নয়।
ফাইন্যান্স টিমের জন্য সুবিধা
- গতি — শত শত লাইন মিনিটে শ্রেণীবদ্ধ, এক্সেলে দিন নয়।
- ধারাবাহিকতা — প্রতিটি সারিতে একই HMRC বিভাগের নিয়ম।
- অসঙ্গতি — পুনর্মিলন পৃষ্ঠের ভারসাম্য এবং ম্যাপিং ত্রুটিগুলি তাড়াতাড়ি।
- অডিট ট্রেইল — প্রক্রিয়াকরণ অবস্থা, আত্মবিশ্বাস, কারণ সহ ওভাররাইড।
- গোপনীয়তা — একটি SaaS ভাড়াটিয়ার মাধ্যমে বিবৃতি পাস ছাড়া স্থানীয় স্ট্যাক বিকল্প।
- হিসাবরক্ষক সময় — পর্যালোচকরা একটি খসড়া রিটার্ন দেখেন, কাঁচা PDF নয়।
এক অনুচ্ছেদে HMRC MTD
opsapi এর মাধ্যমে NINO সংরক্ষণ করুন, OAuth শুরু করুন, ব্যবসা এবং বাধ্যবাধকতা আনুন, তারপর আপনার অ্যাকাউন্টেন্ট খুশি না হওয়া পর্যন্ত স্যান্ডবক্সে ফাইল করুন। জালিয়াতি প্রতিরোধ শিরোনাম এবং টোকেন রিফ্রেশ সার্ভার-সাইড পরিচালনা করা হয়। ফ্লিপ HMRC_ENVIRONMENT=production শুধুমাত্র যখন আপনি এটা বোঝাতে চান।
দাবিত্যাগ
- ট্যাক্স পরামর্শ নয়। লাইভ জমা দেওয়ার আগে পর্যালোচনা করার জন্য একজন ইউকে অ্যাকাউন্ট্যান্ট পান।
- FileMyTax এই নিবন্ধে প্রদর্শনের নাম; অন্যান্য CognoAI পণ্যের নামগুলি আলাদা - সেগুলিকে একত্রিত করবেন না৷
- কাল্পনিক ব্যাংক তথ্য যেখানে টেস্ট ফিক্সচার উল্লেখ করা হয়েছে।
- কোন অনুপস্থিত ফাইলিং - আগে মানব গেট
POST /api/file.
যা দেখবেন ভিডিওতে
YouTube ওয়াকথ্রু নেক্সট.js UI দেখায়: একটি বিবৃতি আপলোড করুন, নিষ্কাশন এবং শ্রেণীবিভাগের অগ্রগতি দেখুন, আত্মবিশ্বাসের স্কোর পরিদর্শন করুন, 2025-26 কর বছরের জন্য গণনা চালান, স্যান্ডবক্সে HMRC সংযুক্ত করুন এবং একজন মানুষ নিশ্চিত না হওয়া পর্যন্ত ফাইলের ধাপে বিরতি দিন। সেই বিরতি হল পণ্যের সিদ্ধান্ত - একটি অনুপস্থিত বৈশিষ্ট্য নয়। সম্পূর্ণরূপে অনুপস্থিত জমা দ্রুত এবং আইনিভাবে ভঙ্গুর হবে.
একাধিক ভাড়া অ্যাকাউন্ট সহ বাড়িওয়ালা এবং মিশ্র ব্যক্তিগত এবং ব্যবসায়িক লাইনের একমাত্র ব্যবসায়ীরা প্রাথমিক দর্শক। তাদের সমর্থনকারী ফাইন্যান্স অপারেটিং দলগুলি একই পাইপলাইন পায়: কম CSV রপ্তানি, 31 জানুয়ারির আগে কম অল-নাইটার্স, নম্বরগুলি খুঁজে বের করার পরিবর্তে আরও বেশি সময়।
নিরাপদে এটি চেষ্টা করুন
স্ট্যাক ক্লোন করুন, চালান ./start.sh, দীর্ঘ নিবন্ধ থেকে কার্ল উদাহরণ পেস্ট করুন, এবং আপনার অ্যাকাউন্ট্যান্ট সম্পূর্ণ রিটার্নের মধ্য দিয়ে না যাওয়া পর্যন্ত HMRC স্যান্ডবক্সে থাকুন। সেট HMRC_ENVIRONMENT=sandbox, প্রয়োজনে একজন পরীক্ষামূলক ব্যবহারকারী তৈরি করুন এবং চিকিত্সা করুন POST /api/file একটি উত্পাদন ক্ষেপণাস্ত্রের মত - কারণ লাইভ মোডে, এটি।
যদি nginx পোর্ট 80 ব্যস্ত থাকে, ব্যবহার করুন NGINX_HOST_PORT=8080. JWT হঠাৎ ব্যর্থ হলে, opsapi যাচাই করুন এবং FastAPI একই গোপন কথা শেয়ার করুন। যদি পুনর্মিলন চিৎকার করে, তাহলে শ্রেণিবিন্যাস ওভাররাইড করার আগে PDF কলাম ম্যাপিং ঠিক করুন — এই অর্ডারটি ঘন্টা বাঁচায়।
OAuth ঐচ্ছিক নয়
HMRC শুধুমাত্র একটি জাতীয় বীমা নম্বর সহ একটি ব্যাকগ্রাউন্ড ক্রন চাকরি থেকে ফাইলিং গ্রহণ করবে না। করদাতাকে অবশ্যই সরকারি গেটওয়ের মাধ্যমে আপনার আবেদন অনুমোদন করতে হবে, যা ব্যাকএন্ড স্টোর এবং রিফ্রেশ টোকেন প্রদান করে। FileMyTax পৃষ্ঠতল যা সেটিংসে প্রবাহিত হয়: একটি এনক্রিপ্ট করা NINO সংরক্ষণ করুন, HMRC অনুমোদন URL খুলুন, কলব্যাকের মাধ্যমে ফিরে আসুন, ব্যবসা এবং বাধ্যবাধকতা আনুন, তারপর ফাইল করুন৷ জালিয়াতি প্রতিরোধ শিরোনাম প্রতিটি API কলে রাইড করে — ডিভাইস আইডি, ব্যবহারকারী এজেন্ট এবং বাকি গভ-* ক্লায়েন্টের কাছ থেকে প্ল্যাটফর্ম ফরোয়ার্ড সেট করে।
তাই মার্কেটিং স্লাইডে "স্বয়ংক্রিয়" বলতে আসলেই বোঝায় একটি ইচ্ছাকৃত মানব এবং শেষে OAuth গেট সহ স্বয়ংক্রিয় প্রস্তুতি. প্রকৌশল এখনও মূল্যবান: ছয়টি কার্ল ধাপ পুনরাবৃত্তিযোগ্য, স্যান্ডবক্সে পরীক্ষাযোগ্য এবং গ্যাটাসে পর্যবেক্ষণযোগ্য।
দীর্ঘ সংস্করণ পড়ুন
দ দীর্ঘ নিবন্ধ অ্যাট্রিবিউশন, আর্কিটেকচার SVG, সম্পূর্ণ কার্ল উদাহরণ, সুবিধা সারণী, OAuth পদক্ষেপ, সীমাবদ্ধতা, Gatus মনিটরিং, 2025-26 ট্যাক্স প্যারামিটার এবং রোডম্যাপ কভার করে। ঘড়ি YouTube ডেমো এবং পরিদর্শন করুন cognoai.uk পণ্য প্রসঙ্গে; Workstation ইঞ্জিনিয়ারিং এর জন্য।
Run it on your own machine
Machines that run tax-return AI locally
Bank statements are some of the most sensitive data you hold. A local LLM can extract every transaction and classify it into HMRC Self Assessment income and expense categories without the statements leaving your office. Each machine below runs the extract, classify and reconcile steps from this post. The button puts it in your basket with Trade membership added and opens checkout — you can remove Trade there before you pay.
- NVIDIA
NVIDIA DGX Spark
GB10 Grace Blackwell with 128 GB of unified memory. Runs 70B-class classifiers and a vision model for scanned statements side by side — sized for a practice filing for many clients.
Add to basket with Trade - Apple
Apple Mac Studio — M5 Max, 36 GB
A quiet desktop for a sole trader or small practice. 8B–14B models in Ollama or MLX classify a full tax year of transactions and flag anything they're unsure of for review.
Add to basket with Trade - AMD Ryzen
Workstation Creator AI — AMD Ryzen 9 9950X + RTX 5090
A 16-core AMD Ryzen tower with a 32 GB GPU, shipped with Ubuntu and the CUDA stack installed. Fast batch OCR and classification when you process statements in bulk.
Add to basket with Trade