ข้ามไปยังเนื้อหา

บล็อก

ระบบ AI สามารถประมวลผลและยื่นแบบแสดงรายการภาษี Self Assessment ไปยัง HMRC โดยอัตโนมัติได้หรือไม่

สาธิต FileMyTax — ไปป์ไลน์ที่ขับเคลื่อนด้วย AI ตั้งแต่ PDF ของธนาคารไปจนถึงการยื่น HMRC MTD ที่สร้างโดย TenthMatrix สำหรับ CognoAI

  • Balinder Walia
  • อ่าน 2 นาที
  • Updated

สหายสั้น ๆ ที่อ่านได้แบบสกิม หากต้องการเจาะลึกเกี่ยวกับสถาปัตยกรรม HMRC OAuth ตัวอย่าง Curl และข้อจำกัด โปรดอ่าน บทความยาว. ไม่ใช่คำแนะนำด้านภาษี

AI สามารถส่งไฟล์ Self Assessment ของคุณไปยัง HMRC ได้หรือไม่

ทุกเดือนมกราคมจะมีคำถามเดียวกัน: AI สามารถอ่านใบแจ้งยอดธนาคารของฉันและยื่นแบบแสดงรายการภาษีในสหราชอาณาจักรได้หรือไม่ คำตอบที่เป็นประโยชน์จากระบบที่เราสร้างขึ้นมา CognoAI - เผยแพร่ที่นี่เป็น FileMyTax - เป็น ใช่เพื่อการเตรียมการ ไม่ใช่สำหรับการยื่นแบบอัตโนมัติ. AI สามารถแยกธุรกรรมจาก PDF จำแนกเป็นหมวดหมู่ HMRC Self Assessment กระทบยอดยอดคงเหลือ และคำนวณภาษีปี 2025-26 ตามที่กำหนด มนุษย์ยังคงตรวจสอบ นักบัญชียังคงลงชื่อออก และผู้เสียภาษียังคงดำเนินการ HMRC OAuth ให้เสร็จสิ้นก่อนที่จะมีการดำเนินการใด ๆ ถึงการผลิต MTD

TenthMatrix พัฒนาแพลตฟอร์มพื้นฐาน CognoAI เป็นเจ้าของทรัพย์สินทางปัญญา โพสต์นี้จะอธิบายว่าสิ่งที่ดูเหมือนในการเรียก API หกสาย — โดยไม่ใช้ชื่อผลิตภัณฑ์ที่เป็นเจ้าของจากที่อื่น

ฝาครอบ FileMyTax AI ถึง HMRC Self Assessment

ชมการสาธิต

จัดเก็บ PDF ผ่านการจำแนกประเภทและการคำนวณไปยังแซนด์บ็อกซ์ HMRC MTD — พร้อมช่องตรวจทานใน UI

ไปป์ไลน์หกขั้นตอน

เวิร์กโฟลว์ FileMyTax: ไคลเอนต์, การนำเข้า, AI, เครื่องมือภาษี, HMRC, การตรวจสอบ

  1. อัปโหลด — POST /fastapi/api/upload ส่ง PDF ไปยัง MiniIO ผ่าน nginx
  2. สารสกัด — pdfplumber สำหรับตารางดั้งเดิม Claude Vision สำหรับการสแกน
  3. จำแนกประเภท — LLM จับคู่บรรทัดกับหมวดหมู่ค่าใช้จ่าย SA ด้วยคะแนนความเชื่อมั่น
  4. กระทบยอด — การตรวจสอบยอดเงินและการสะสมรายได้/ค่าใช้จ่าย
  5. คำนวณ — ภาษีเงินได้ที่กำหนดในปี 2025-26 + คลาส 4 NI (ไม่มี LLM ในวิชาคณิตศาสตร์)
  6. ไฟล์ — POST /fastapi/api/file เป็น HMRC MTD หลังจาก OAuth และการอนุมัติของมนุษย์

การรับรองความถูกต้อง JWT มาจาก opsapi; NINO ถูกเข้ารหัสเมื่อไม่ได้ใช้งาน Gatus บนพอร์ต 8085 เฝ้าดูทุกบริการ

ใครเป็นคนสร้างมัน

CognoAI เป็นเจ้าของ IP ของระบบและทิศทางผลิตภัณฑ์ TenthMatrix สร้างแพลตฟอร์ม Dockerised — การกำหนดเส้นทาง nginx, บริการ FastAPI AI, opsapi auth, PostgreSQL, MiniIO, การตรวจสอบ Gatus และ UI การตรวจสอบ Next.js เราเผยแพร่ภายใต้ชื่อ FileMyTax เพื่ออธิบายการสาธิต; เราไม่ใช้ชื่อผลิตภัณฑ์ CognoAI อื่นในบทความนี้

เหตุใด AI จึงช่วย — และจุดสิ้นสุดของมัน

AI ชนะด้วยความเร็วและความสม่ำเสมอในสายธนาคารหลายร้อยสาย การแจ้งความผิดปกติ และการจับคู่คำอธิบายที่ยุ่งเหยิงกับหมวดหมู่ HMRC มันไม่ได้แทนที่การตัดสิน: การโอนเทียบกับค่าเช่า ทุนเทียบกับรายได้ และเรื่องส่วนตัวกับธุรกิจ ยังคงต้องจับตามอง เครื่องมือภาษีเป็น Python ล้วนๆ พร้อมช่อง DECIMAL ซึ่งเป็นการแยกแบบเดียวกับที่เรายืนยันสำหรับการเงินที่ได้รับการควบคุม: LLM สำหรับภาษา รหัสสำหรับกฎหมาย.

ในการทดสอบเราใช้ การติดตั้งคำชี้แจงของเจ้าของบ้านสไตล์ HSBC ที่สมมติขึ้น (ข้อมูลสังเคราะห์เท่านั้น) ที่มีสถานการณ์การหมุนเวียนสูงเพื่อแยกความเครียด — รวมถึงบทเรียนที่ pdfplumber เลือกคอลัมน์ผิด (ยอดคงเหลือเทียบกับการจ่ายเงิน) ความล้มเหลวเหล่านั้นเป็นสาเหตุของการกระทบยอดและการทบทวน

สถาปัตยกรรมโดยสรุป

หนึ่ง nginx บน localhost อยู่ข้างหน้าทุกสิ่ง: Next.js สำหรับมนุษย์, FastAPI สำหรับ AI และการยื่น, opsapi สำหรับการเข้าสู่ระบบและ NINO ที่เข้ารหัส PostgreSQL จัดเก็บใบแจ้งยอดและธุรกรรมที่เป็นความลับ MiniIO เก็บ PDF เครื่องคำนวณภาษีใช้แบนด์ของสหราชอาณาจักรปี 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 จะแสดง UI ของ Next.js: อัปโหลดคำสั่ง ดูความคืบหน้าในการแยกและการจัดหมวดหมู่ ตรวจสอบคะแนนความเชื่อมั่น เรียกใช้การคำนวณสำหรับปีภาษี 2025-26 เชื่อมต่อ HMRC ในแซนด์บ็อกซ์ และหยุดที่ขั้นตอนไฟล์จนกว่ามนุษย์จะยืนยัน การหยุดชั่วคราวนั้นเป็นการตัดสินใจของผลิตภัณฑ์ ไม่ใช่คุณสมบัติที่ขาดหายไป การส่งแบบอัตโนมัติโดยสมบูรณ์จะเร็วกว่าและเปราะบางทางกฎหมาย

เจ้าของบ้านที่มีบัญชีการเช่าหลายบัญชีและผู้ค้ารายเดียวที่มีสายงานส่วนตัวและสายธุรกิจปะปนกันคือกลุ่มเป้าหมายหลัก ทีมปฏิบัติการทางการเงินที่สนับสนุนพวกเขาได้รับแนวทางเดียวกัน: ส่งออก CSV น้อยลง, ทำงานทั้งคืนน้อยลงก่อนวันที่ 31 มกราคม, มีเวลาอธิบายตัวเลขมากขึ้นแทนที่จะค้นหาตัวเลขเหล่านั้น

ลองอย่างปลอดภัย

โคลนสแต็กรัน ./start.shวางตัวอย่าง curl จากบทความขนาดยาว และอยู่ในแซนด์บ็อกซ์ HMRC จนกว่านักบัญชีของคุณจะดำเนินการคืนเงินเต็มจำนวน ชุด HMRC_ENVIRONMENT=sandboxสร้างผู้ใช้ทดสอบหากจำเป็น และปฏิบัติต่อ POST /api/file เหมือนขีปนาวุธสำหรับการผลิต — เพราะในโหมดถ่ายทอดสดมันเป็นอย่างนั้น

หากพอร์ต nginx 80 ไม่ว่าง ให้ใช้ NGINX_HOST_PORT=8080. หาก JWT ล้มเหลวกะทันหัน ให้ตรวจสอบ opsapi และ FastAPI แบ่งปันความลับเดียวกัน หากการกระทบยอดดังขึ้น ให้แก้ไขการแมปคอลัมน์ PDF ก่อนที่จะแทนที่การจัดประเภท ลำดับดังกล่าวจะช่วยประหยัดเวลาได้หลายชั่วโมง

OAuth ไม่ใช่ทางเลือก

HMRC จะไม่ยอมรับการยื่นเอกสารจากงาน cron พื้นหลังที่มีเพียงหมายเลข National Insurance ผู้เสียภาษีจะต้องอนุญาตใบสมัครของคุณผ่าน Government Gateway ซึ่งจะส่งคืนโทเค็นที่ร้านค้าแบ็กเอนด์และรีเฟรช FileMyTax ปรากฏอยู่ในการตั้งค่า: บันทึก NINO ที่เข้ารหัส เปิด URL การอนุญาต HMRC ส่งคืนผ่านการโทรกลับ ดึงข้อมูลธุรกิจและภาระผูกพัน จากนั้นจึงยื่นไฟล์ ส่วนหัวของการป้องกันการฉ้อโกงจะคอยติดตามการเรียก API ทุกครั้ง — ID อุปกรณ์, ตัวแทนผู้ใช้ และส่วนอื่นๆ ของ Gov-* จะตั้งค่าแพลตฟอร์มส่งต่อจากไคลเอนต์

นั่นคือเหตุผลว่าทำไมสไลด์การตลาดแบบ "อัตโนมัติ" จึงมีความหมายจริงๆ การเตรียมการอัตโนมัติโดยเจตนาของมนุษย์และเกต OAuth ในตอนท้าย. วิศวกรรมศาสตร์ยังคงมีคุณค่า: ขั้นตอนการขดทั้งหกสามารถทำซ้ำได้ ทดสอบได้ในแซนด์บ็อกซ์ และสังเกตได้ใน Gatus

อ่านฉบับยาวครับ

ที่ บทความยาว ครอบคลุมการระบุแหล่งที่มา, สถาปัตยกรรม SVG, ตัวอย่าง Curl แบบเต็ม, ตารางสิทธิประโยชน์, ขั้นตอน OAuth, ข้อจำกัด, การตรวจสอบ Gatus, พารามิเตอร์ภาษีปี 2025-26 และแผนงาน ดู การสาธิต YouTube และเยี่ยมชม cognoai.uk สำหรับบริบทของผลิตภัณฑ์ TenthMatrix สำหรับวิศวกรรม