هل يمكن لنظام الذكاء الاصطناعي معالجة وتقديم ضريبة Self Assessment للعودة إلى HMRC تلقائيًا؟
عرض FileMyTax - مسار مدعوم بالذكاء الاصطناعي من ملفات PDF البنكية إلى ملفات HMRC MTD، تم إنشاؤه بواسطة Workstation لصالح CognoAI
Balinder Walia20 مايو 20265 min read
رفيق قصير وقابل للقراءة. للتعمق الكامل في البنية، HMRC OAuth، وأمثلة التجعيد، والقيود، اقرأ المقال الطويل. ليست نصيحة ضريبية.
هل يمكن لمنظمة العفو الدولية تقديم ملف Self Assessment الخاص بك إلى HMRC؟
يظهر نفس السؤال في شهر يناير من كل عام: هل يستطيع الذكاء الاصطناعي قراءة بياناتي المصرفية وتقديم إقراراتي الضريبية في المملكة المتحدة؟ الإجابة العملية من النظام الذي بنيناه من أجله CognoAI - نشرت هنا باسم FileMyTax - يكون نعم للتحضير، وليس للحفظ غير المراقب. يمكن للذكاء الاصطناعي استخراج المعاملات من ملفات PDF، وتصنيفها إلى فئات HMRC Self Assessment، وتسوية الأرصدة، وحساب ضرائب 2025-26 بشكل حتمي؛ لا يزال الإنسان يراجع، ولا يزال المحاسب يوقع، ولا يزال دافع الضرائب يكمل HMRC OAuth قبل أن يصل أي شيء إلى إنتاج MTD.
قامت Workstation بتطوير النظام الأساسي؛ تمتلك CognoAI الملكية الفكرية. يشرح هذا المنشور كيف يبدو الأمر في ستة مكالمات API - دون استخدام أسماء المنتجات المملوكة في مكان آخر.
شاهد العرض التوضيحي
بنك PDF من خلال التصنيف والحساب إلى وضع الحماية HMRC MTD - مع بوابات المراجعة في واجهة المستخدم.
خط الأنابيب ذو الست خطوات
- رفع —
POST /fastapi/api/uploadيرسل ملف PDF إلى MinIO عبر nginx. - يستخرج - pdfplumber للجداول الأصلية؛ كلود فيجن للفحص.
- تصنيف — يقوم LLM بتعيين الخطوط إلى فئات نفقات SA مع درجات الثقة.
- تصالح — التحقق من الرصيد ومجموعات الدخل/المصروفات.
- احسب - ضريبة الدخل الحتمية 2025-26 + الفئة 4 NI (لا يوجد LLM في الرياضيات).
- ملف —
POST /fastapi/api/fileإلى HMRC MTD بعد OAuth والموافقة البشرية.
مصادقة JWT تأتي من opsapi؛ يتم تشفير NINO في حالة الراحة؛ يراقب Gatus على المنفذ 8085 كل خدمة.
من بناه
CognoAI يمتلك نظام IP واتجاه المنتج. Workstation إنشاء منصة Dockerised — توجيه مسار nginx، وخدمات FastAPI AI، وopsapi auth، وPostgreSQL، وMinIO، ومراقبة Gatus، وواجهة مستخدم مراجعة Next.js. ننشر تحت الاسم FileMyTax لوصف العرض التوضيحي؛ نحن لا نستخدم أسماء منتجات CognoAI الأخرى في هذه المقالة.
لماذا يساعد الذكاء الاصطناعي - وأين يتوقف
يفوز الذكاء الاصطناعي بالسرعة والاتساق عبر مئات الخطوط المصرفية، والإبلاغ عن الحالات الشاذة، ورسم خرائط للأوصاف الفوضوية لفئات HMRC. إنه لا يحل محل الحكم: التحويلات مقابل الإيجار، ورأس المال مقابل الإيرادات، والشخصية مقابل الأعمال لا تزال بحاجة إلى عيون. محرك الضرائب هو بايثون خالص مع الحقول العشرية - وهو نفس الفصل الذي نصر عليه بالنسبة للتمويل المنظم: LLM للغة، رمز للقانون.
في الاختبار استخدمنا تركيبات بيان المالك الخيالية على طراز HSBC (بيانات تركيبية فقط) مع سيناريوهات معدل دوران مرتفع للتأكيد على الاستخراج - بما في ذلك الدروس التي اختار فيها pdfplumber العمود الخطأ (الرصيد مقابل الدفع). تلك الإخفاقات هي سبب وجود المصالحة والمراجعة.
الهندسة المعمارية في لمحة
يتصدر nginx واحد على المضيف المحلي كل شيء: Next.js للبشر، وFastAPI للذكاء الاصطناعي وحفظ الملفات، وopsapi لتسجيل الدخول، وNINO المشفر. يقوم PostgreSQL بتخزين البيانات والمعاملات السرية؛ MiniIO يحمل ملفات PDF. تطبق حاسبة الضرائب نطاقات UK 2025/26 في Python - تفتق المخصصات الشخصية، وضريبة الدخل، والفئة 4 NI - مع حقول المال DECIMAL(18,2). وهذا الانقسام مقصود: يحتاج المنظمون والمحاسبون إلى عمليات حسابية قابلة للتكرار، وليس الرموز الاحتمالية.
فوائد للفرق المالية
- سرعة - مئات الأسطر مصنفة بالدقائق، وليس بالأيام في برنامج Excel.
- تناسق - نفس قواعد فئة HMRC في كل صف.
- الشذوذ — تسوية أسطح التوازن ورسم خرائط الأخطاء مبكرًا.
- مسار التدقيق - حالة المعالجة، والثقة، والتجاوزات بالأسباب.
- خصوصية - خيار المكدس المحلي دون تمرير البيانات من خلال مستأجر SaaS.
- وقت المحاسب — يرى المراجعون مسودة إرجاع، وليس ملفات PDF أولية.
HMRC MTD في فقرة واحدة
احفظ NINO عبر opsapi، وقم ببدء OAuth، واجلب الأعمال والالتزامات، ثم قم بتقديم الملف في وضع الحماية حتى يصبح المحاسب الخاص بك سعيدًا. تتم معالجة رؤوس منع الاحتيال وتحديث الرمز المميز من جانب الخادم. نقف HMRC_ENVIRONMENT=production فقط عندما تقصد ذلك.
إخلاء المسؤولية
- ليست نصيحة ضريبية. احصل على محاسب بريطاني للمراجعة قبل التقديم المباشر.
- FileMyTax هو اسم العرض التوضيحي في هذه المقالة; أسماء منتجات CognoAI الأخرى منفصلة، فلا تخلط بينها.
- بيانات البنك وهمية حيث يتم ذكر تركيبات الاختبار.
- لا يوجد حفظ غير المراقب — بوابة الإنسان من قبل
POST /api/file.
ما ستشاهده في الفيديو
تعرض الإرشادات التفصيلية على YouTube واجهة مستخدم Next.js: تحميل بيان، ومشاهدة تقدم الاستخراج والتصنيف، وفحص درجات الثقة، وتشغيل الحساب للسنة الضريبية 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 التسجيل من وظيفة cron في الخلفية برقم التأمين الوطني فقط. يجب على دافعي الضرائب الموافقة على طلبك من خلال بوابة الحكومة، التي تقوم بإرجاع الرموز المميزة إلى مخازن الواجهة الخلفية وتحديثها. أسطح FileMyTax التي تتدفق في الإعدادات: احفظ NINO المشفر، وافتح عنوان URL لتفويض HMRC، وقم بالرجوع عبر رد الاتصال، وجلب الأعمال والالتزامات، ثم قم بالملف. تظهر رؤوس منع الاحتيال في كل مكالمة API - يقوم معرف الجهاز ووكيل المستخدم وبقية Gov-* بتعيين النظام الأساسي للأمام من العميل.
هذا هو السبب في أن كلمة "تلقائي" في الشرائح التسويقية تعني حقًا إعداد تلقائي باستخدام بوابة بشرية وOAuth متعمدة في النهاية. لا تزال الهندسة ذات قيمة: خطوات التجعيد الستة قابلة للتكرار، وقابلة للاختبار في وضع الحماية، ويمكن ملاحظتها في جاتوس.
قراءة النسخة الطويلة
ال مقالة طويلة يغطي الإسناد، وهندسة SVG، وأمثلة الضفيرة الكاملة، وجدول المزايا، وخطوات OAuth، والقيود، ومراقبة Gatus، ومعلمات الضرائب 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