क्या कोई AI सिस्टम स्वचालित रूप से Self Assessment टैक्स रिटर्न को HMRC पर संसाधित और दाखिल कर सकता है?
FileMyTax का प्रदर्शन - बैंक PDF से HMRC MTD फाइलिंग तक AI-संचालित पाइपलाइन, CognoAI के लिए Workstation द्वारा निर्मित
Balinder Walia20 मई 20266 min readएक छोटा, स्किम-पठनीय साथी। आर्किटेक्चर, HMRC OAuth, कर्ल उदाहरण और सीमाओं के बारे में पूरी जानकारी के लिए पढ़ें लंबा लेख. कर सलाह नहीं.
क्या AI आपके Self Assessment को HMRC में फ़ाइल कर सकता है?
हर जनवरी में एक ही प्रश्न सामने आता है: क्या कोई एआई मेरे बैंक स्टेटमेंट को पढ़ सकता है और मेरा यूके टैक्स रिटर्न जमा कर सकता है? जिस प्रणाली के लिए हमने निर्माण किया है उसका व्यावहारिक उत्तर कॉग्नोएआई - यहाँ इस रूप में प्रकाशित किया गया है FileMyTax - है हाँ, तैयारी के लिए, न कि अप्राप्य फाइलिंग के लिए. एआई पीडीएफ से लेनदेन निकाल सकता है, उन्हें एक्सपीआर1एक्स एक्सपीआर0एक्स श्रेणियों में वर्गीकृत कर सकता है, शेष राशि का मिलान कर सकता है और 2025-26 कर की गणना निश्चित रूप से कर सकता है; एक मानव अभी भी समीक्षा करता है, एक अकाउंटेंट अभी भी हस्ताक्षर करता है, और करदाता अभी भी MTD के उत्पादन तक पहुंचने से पहले HMRC OAuth को पूरा करता है।
Workstation ने अंतर्निहित प्लेटफ़ॉर्म विकसित किया; CognoAI के पास बौद्धिक संपदा है। यह पोस्ट बताती है कि छह API कॉल में यह कैसा दिखता है - कहीं और स्वामित्व वाले उत्पाद नामों का उपयोग किए बिना।
डेमो देखें
वर्गीकरण और गणना के माध्यम से पीडीएफ को HMRC MTD सैंडबॉक्स में बैंक करें - यूआई में समीक्षा द्वार के साथ।
छह चरणों वाली पाइपलाइन
- अपलोड करें —
POST /fastapi/api/uploadnginx के माध्यम से पीडीएफ को MiniIO को भेजता है। - निकालना - देशी तालिकाओं के लिए पीडीएफप्लंबर; स्कैन के लिए क्लाउड विजन।
- वर्गीकृत करें - LLM कॉन्फिडेंस स्कोर के साथ लाइनों को SA व्यय श्रेणियों में मैप करता है।
- सुलह करो - शेष राशि की जांच और आय/व्यय रोल-अप।
- गणना — नियतात्मक 2025-26 आयकर + कक्षा 4 एनआई (गणित में कोई LLM नहीं)।
- फ़ाइल —
POST /fastapi/api/fileOAuth और मानव अनुमोदन के बाद HMRC MTD पर।
JWT प्रमाणीकरण opsapi से आता है; NINO को आराम से एन्क्रिप्ट किया गया है; पोर्ट 8085 पर गैटस हर सेवा पर नज़र रखता है।
इसे किसने बनवाया
कॉग्नोएआई सिस्टम आईपी और उत्पाद दिशा का स्वामी है। Workstation डॉकराइज़्ड प्लेटफ़ॉर्म बनाया गया - nginx पाथ रूटिंग, FastAPI AI सेवाएँ, opsapi auth, PostgreSQL, MiniIO, Gatus मॉनिटरिंग और Next.js समीक्षा UI। हम नाम से प्रकाशित करते हैं FileMyTax डेमो का वर्णन करने के लिए; हम इस लेख में अन्य CognoAI उत्पाद नामों का उपयोग नहीं करते हैं।
एआई क्यों मदद करता है - और यह कहां रुकता है
AI सैकड़ों बैंक लाइनों में गति और स्थिरता, विसंगतियों को चिह्नित करने और HMRC श्रेणियों में गंदे विवरणों को मैप करने में जीतता है। यह निर्णय को प्रतिस्थापित नहीं करता है: स्थानांतरण बनाम किराया, पूंजी बनाम राजस्व, और व्यक्तिगत बनाम व्यवसाय को अभी भी नजर की जरूरत है। कर इंजन दशमलव फ़ील्ड के साथ शुद्ध पायथन है - वही पृथक्करण जिस पर हम विनियमित वित्त के लिए जोर देते हैं: भाषा के लिए LLM, कानून के लिए कोड.
परीक्षण में हमने प्रयोग किया काल्पनिक एचएसबीसी-शैली मकान मालिक कथन फिक्स्चर (केवल सिंथेटिक डेटा) तनाव निष्कर्षण के लिए उच्च टर्नओवर परिदृश्यों के साथ - उन पाठों सहित जहां पीडीएफप्लंबर ने गलत कॉलम चुना (बैलेंस बनाम पेड-इन)। उन विफलताओं के कारण ही मेल-मिलाप और समीक्षा मौजूद है।
वास्तुकला एक नजर में
लोकलहोस्ट पर एक nginx सब कुछ सामने रखता है: मनुष्यों के लिए Next.js, AI और फाइलिंग के लिए FastAPI, लॉगिन के लिए opsapi और एन्क्रिप्टेड NINO। PostgreSQL विवरण और वर्गीकृत लेनदेन संग्रहीत करता है; मिनिआईओ के पास पीडीएफ़ हैं। कर कैलकुलेटर पायथन में यूके 2025/26 बैंड लागू करता है - व्यक्तिगत भत्ता टेपर, आयकर, कक्षा 4 एनआई - दशमलव (18,2) धन क्षेत्रों के साथ। यह विभाजन जानबूझकर किया गया है: नियामकों और लेखाकारों को प्रतिलिपि प्रस्तुत करने योग्य गणित की आवश्यकता है, संभाव्य टोकन की नहीं।
वित्त टीमों के लिए लाभ
- रफ़्तार - एक्सेल में सैकड़ों पंक्तियाँ दिनों में नहीं बल्कि मिनटों में वर्गीकृत होती हैं।
- स्थिरता - प्रत्येक पंक्ति पर समान HMRC श्रेणी नियम।
- विसंगतियों - सुलह से संतुलन और मानचित्रण संबंधी त्रुटियां जल्दी सामने आती हैं।
- लेखापरीक्षा - प्रसंस्करण की स्थिति, आत्मविश्वास, कारणों से आगे निकल जाता है।
- गोपनीयता - SaaS टैनेंट के माध्यम से स्टेटमेंट पास किए बिना स्थानीय स्टैक विकल्प।
- अकाउंटेंट का समय - समीक्षक ड्राफ्ट रिटर्न देखते हैं, कच्ची पीडीएफ़ नहीं।
एक पैराग्राफ में HMRC MTD
Opsapi के माध्यम से NINO सहेजें, OAuth आरंभ करें, व्यवसाय और दायित्व प्राप्त करें, फिर सैंडबॉक्स में फ़ाइल करें जब तक कि आपका अकाउंटेंट खुश न हो जाए। धोखाधड़ी रोकथाम हेडर और टोकन रिफ्रेश को सर्वर-साइड नियंत्रित किया जाता है। पलटना HMRC_ENVIRONMENT=production केवल तभी जब आपका मतलब हो।
अस्वीकरण
- कर सलाह नहीं. लाइव सबमिशन से पहले यूके अकाउंटेंट से समीक्षा करवाएं।
- FileMyTax इस आलेख में प्रदर्शन नाम है; अन्य CognoAI उत्पाद नाम अलग-अलग हैं - उन्हें मिश्रित न करें।
- काल्पनिक बैंक डेटा जहां परीक्षण फिक्स्चर का उल्लेख किया गया है।
- कोई अप्राप्य फाइलिंग नहीं - पहले मानव द्वार
POST /api/file.
जो आप वीडियो में देखेंगे
YouTube वॉकथ्रू नेक्स्ट.जेएस यूआई दिखाता है: एक स्टेटमेंट अपलोड करें, निष्कर्षण और वर्गीकरण प्रगति देखें, आत्मविश्वास स्कोर का निरीक्षण करें, कर वर्ष 2025-26 के लिए गणना चलाएं, सैंडबॉक्स में HMRC कनेक्ट करें, और फ़ाइल चरण पर तब तक रोकें जब तक कोई मानव पुष्टि न कर दे। वह ठहराव उत्पाद निर्णय है - कोई लुप्त सुविधा नहीं। पूरी तरह से अप्राप्य सबमिशन तेज़ और कानूनी रूप से नाजुक होगा।
कई किराये के खातों वाले मकान मालिक और मिश्रित व्यक्तिगत और व्यावसायिक क्षेत्रों वाले एकमात्र व्यापारी प्राथमिक दर्शक हैं। उनका समर्थन करने वाली वित्त संचालन टीमों को समान पाइपलाइन मिलती है: कम सीएसवी निर्यात, 31 जनवरी से पहले कम ऑल-नाइटर्स, संख्याओं को खोजने के बजाय उन्हें समझाने में अधिक समय।
इसे सुरक्षित रूप से आज़माएँ
स्टैक को क्लोन करें, चलाएँ ./start.sh, लंबे लेख से कर्ल उदाहरण चिपकाएँ, और HMRC सैंडबॉक्स में तब तक रहें जब तक कि आपका अकाउंटेंट पूर्ण रिटर्न न दे दे। तय करना HMRC_ENVIRONMENT=sandbox, यदि आवश्यक हो तो एक परीक्षण उपयोगकर्ता बनाएं और उपचार करें POST /api/file एक उत्पादन मिसाइल की तरह - क्योंकि लाइव मोड में, यह है।
यदि nginx पोर्ट 80 व्यस्त है, तो उपयोग करें NGINX_HOST_PORT=8080. यदि JWT अचानक विफल हो जाता है, तो सत्यापित करें कि opsapi और FastAPI एक ही रहस्य साझा करते हैं। यदि सुलह चिल्लाती है, तो वर्गीकरण को ओवरराइड करने से पहले पीडीएफ कॉलम मैपिंग को ठीक करें - वह आदेश घंटों बचाता है।
OAuth वैकल्पिक नहीं है
HMRC केवल राष्ट्रीय बीमा नंबर वाले बैकग्राउंड क्रॉन जॉब से फाइलिंग स्वीकार नहीं करेगा। करदाता को आपके आवेदन को सरकारी गेटवे के माध्यम से अधिकृत करना होगा, जो बैकएंड स्टोर में टोकन लौटाता है और ताज़ा करता है। FileMyTax सतहें जो सेटिंग्स में प्रवाहित होती हैं: एक एन्क्रिप्टेड NINO सहेजें, HMRC प्राधिकरण URL खोलें, कॉलबैक के माध्यम से वापस लौटें, व्यवसाय और दायित्व प्राप्त करें, फिर फ़ाइल करें। प्रत्येक API कॉल पर धोखाधड़ी रोकथाम हेडर साथ-साथ चलते हैं - डिवाइस आईडी, उपयोगकर्ता एजेंट, और बाकी गॉव-* क्लाइंट से प्लेटफ़ॉर्म को आगे सेट करते हैं।
यही कारण है कि मार्केटिंग स्लाइड में "स्वचालित" का वास्तव में अर्थ होता है अंत में एक जानबूझकर मानव और OAuth गेट के साथ स्वचालित तैयारी. इंजीनियरिंग अभी भी मूल्यवान है: छह कर्ल चरण दोहराए जाने योग्य हैं, सैंडबॉक्स में परीक्षण योग्य हैं, और गैटस में देखने योग्य हैं।
लंबा संस्करण पढ़ें
The लंबा लेख इसमें एट्रिब्यूशन, आर्किटेक्चर एसवीजी, पूर्ण कर्ल उदाहरण, लाभ तालिका, ओएथ चरण, सीमाएं, गैटस मॉनिटरिंग, 2025-26 कर पैरामीटर और रोडमैप शामिल हैं। घड़ी यूट्यूब डेमो और जाएँ 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