اپنے انوائس اور اخراجات کے ڈیٹا بیس سے Claude Code کے ساتھ VAT ریٹرن سسٹم بنانا

ایک مختصر، سکم پڑھنے کے قابل ساتھی۔ کوڈ، پرامپٹس، اسکیما، ایک HMRC MTD واک تھرو، اور ایج کیسز کے ساتھ مکمل ~5,000 الفاظ کے گہرے غوطے کے لیے، پڑھیں طویل مضمون.

سہ ماہی VAT میرے مہینے کا بدترین حصہ تھا۔

ہر سہ ماہی میں، برطانیہ کے ایک چھوٹے کاروبار کو VAT ریٹرن پیش کرنا ہوتا ہے: نمبروں کے نو خانے (فروخت، خریداری، VAT واجب الادا، VAT قابل دعوی، یورپی یونین کے سامان اگر آپ شمالی آئرلینڈ میں ہیں، ٹوٹل، نیٹ) اور انہیں HMRC Making Tax Digital (MTD) کے ذریعے جمع کروائیں۔ برسوں سے، میرا اس طرح نظر آتا تھا: Postgres میں انوائس ٹیبل کھولیں، CSV برآمد کریں، اسے Excel میں پیسٹ کریں، چند سو قطاروں کو ہاتھ سے درجہ بندی کریں، فارمولے چلائیں، نو نمبروں کو تیسرے فریق MTD برج میں کاپی کریں، جمع کرائیں، امید پر کلک کریں۔

اس نے کام کیا، لیکن یہ سست اور نقصان دہ تھا۔ رسیدیں غائب ہوگئیں۔ وسط سہ ماہی کی شرح کی تبدیلیوں نے فارمولوں کو توڑ دیا۔ ایک VAT درجہ بندی میں ٹائپنگ کی غلطی منتقل ہو سکتی ہے۔ Box 5 سینکڑوں پاؤنڈ کی طرف سے. اور آڈٹ ٹریل تھا "مجھ پر بھروسہ کریں، میرے پاس ایک اسپریڈشیٹ تھی"۔

اس سال میں نے پوری چیز کو ایک چھوٹے Claude Code پروجیکٹ کے طور پر دوبارہ بنایا جو میرے انوائس + اخراجات DB کو پڑھتا ہے، ہر لائن کی درجہ بندی کرتا ہے، نو خانوں کی گنتی کرتا ہے، ایک PDF کو خشک کرتا ہے، اور تب ہی HMRC MTD کو جمع کرتا ہے - انسانی منظوری کے دروازے کے ساتھ۔ یہ بلاگ مختصر ورژن ہے۔ طویل مضمون میں پرامپٹس، ازگر، HMRC OAuth فلو، اور گوچاس ہیں۔

واک تھرو دیکھیں

VAT ریٹرن پائپ لائن کا ایک مختصر واک تھرو جو ایک حقیقی (گمنام) انوائسز + اخراجات DB کے خلاف اختتام سے آخر تک چل رہی ہے۔

پانچ قدمی پائپ لائن

1. جڑیں۔ Claude Code کو ملتا ہے۔ صرف پڑھنے کے لیے میرے رسیدوں اور اخراجات کی میزوں سے ڈی بی کنکشن۔ اسے کبھی بھی ماخذ ڈیٹا تک تحریری رسائی حاصل نہیں ہوتی ہے۔ اسٹرائپ، وائز، ریولوٹ، اور کچھ بینک فیڈز سے CSVs کو اس میں ڈالا جاتا ہے۔ ./imports/.
2. معمول بنائیں۔ کلاڈ ایک چھوٹی ازگر اسکرپٹ تیار کرتا ہے اور چلاتا ہے جو ہر سورس اسکیما کو ایک کیننیکل ویو میں نقشہ بناتا ہے: id, date, supplier_or_customer, gross, net, vat_amount, vat_rate, vat_treatment, country_code, currency, source, run_key. غیر ملکی کرنسی کو HMRC ماہانہ شرح کا استعمال کرتے ہوئے GBP میں تبدیل کیا جاتا ہے۔ پوری مدت ایک بے ضمیر کی طرف سے کلید ہے run_key لہذا دوبارہ چلنا محفوظ ہے۔
3. درجہ بندی + مصالحت۔ کلاڈ ہر لائن کو VAT ٹریٹمنٹ میں درجہ بندی کرتا ہے - معیاری 20%، کم کیا گیا 5%، صفر، مستثنیٰ، باہر کا دائرہ، ریورس چارج، EU سامان، EU خدمات، ملتوی درآمد VAT - ایک چھوٹا استعمال کرتے ہوئے vat-rules.md میں ریپو میں رکھتا ہوں۔ یہ ادائیگیوں اور جھنڈوں کی بے ضابطگیوں (منفی خالص رقم، گمشدہ سپلائر VAT نمبر، ملک کے کوڈ کی مماثلت، ایسے سپلائرز جو VAT-رجسٹرڈ نہیں ہیں) کے خلاف انوائسز کو بھی ملاتا ہے۔
4. حساب ایک خالص فنکشن Python ماڈیول - ریاضی میں کوئی LLM نہیں ہے۔ - درجہ بند قطاروں کو پڑھتا ہے اور Box 9 کے ذریعے Box 1 تیار کرتا ہے، اس کے علاوہ مارک ڈاؤن میں خشک چلنے والی رپورٹ۔ فلیٹ ریٹ اسکیم، کیش اکاؤنٹنگ، اور سالانہ اکاؤنٹنگ برانچز واضح کوڈ کے راستے ہیں، فوری ہدایات نہیں۔
5. جمع کروائیں۔ میرے (یا میرے اکاؤنٹنٹ) کے ڈرائی رن پر دستخط کرنے کے بعد ہی پائپ لائن HMRC MTD API کو کال کرتی ہے۔ OAuth2 ٹوکن۔ فراڈ سے بچاؤ کے ہیڈرز۔ GET obligations کھلی مدت تلاش کرنے کے لیے۔ POST returns کے ساتھ finalised: true. پھر GET liabilities اس بات کی تصدیق کرنے کے لیے کہ مجھے کیا واجب الادا ہے اور کب۔

کیوں Claude Code بجائے Xero/QuickBooks/FreeAgent

سچ میں، زیادہ تر چھوٹے کاروباروں کے لیے، پیکڈ اکاؤنٹنٹ SaaS صحیح جواب ہے۔ ان کے پاس HMRC سرٹیفیکیشن، سپورٹ ٹیمیں ہیں، اور آپ کا اکاؤنٹنٹ انہیں پہلے سے جانتا ہے۔ تو میں نے ایسا کیوں کیا؟

• میں پہلے ہی ہر روز Claude Code استعمال کرتا ہوں۔ سافٹ ویئر کے کام کے لیے۔ VAT پائپ لائن کو جمع کرنے کے لیے اسے استعمال کرنے کی معمولی قیمت بھی کم ہے۔
• میرا ڈیٹا مقامی ہے۔ انوائس DB میری مشین کو کبھی نہیں چھوڑتا ہے۔ درجہ بندی قطاروں پر چلتا ہے۔ ریاضی مقامی ازگر ہے۔ صرف آخری نو نمبر HMRC پر جاتے ہیں۔ کوئی ساس کرایہ دار، کوئی تیسرا فریق نہیں۔
• میں درجہ بندی کے قواعد پر مکمل کنٹرول چاہتا ہوں۔ میرا کچھ سپلائر مکس عجیب ہے (EU خدمات، ملتوی درآمد VAT، صفر ریٹیڈ ایج کیسز کے ایک جوڑے)۔ میں ان اصولوں کو انکوڈنگ کرنا vat-rules.md + ایک Python ماڈیول میرے لئے SaaS کو ترتیب دینے سے زیادہ تیز ہے۔
• آڈٹ ٹریل میرا ہے۔ ہر کلاڈ پرامپٹ اور ہر فرق کو دستخط شدہ مدت کے سنیپ شاٹ کے ساتھ صرف ضمیمہ لاگ میں شامل کیا جاتا ہے۔ اگر HMRC کبھی پوچھتا ہے، تو میں سیکنڈوں میں صحیح حساب پیدا کر سکتا ہوں۔

اگر آپ پہلے سے ہی Claude Code استعمال نہیں کرتے ہیں یا آپ آدھی رات کو Python پڑھنے سے لطف اندوز نہیں ہوں گے، تو براہ کرم Xero/QuickBooks/FreeAgent استعمال کریں۔ یہ آپ کے اپنے VAT سسٹم کو رول کرنے کی سفارش نہیں ہے۔ یہ ایک کہانی ہے جب آپ ایسا کرتے ہیں تو کیا ممکن ہے۔

LLM کہاں ہے اور کہاں نہیں ہے۔

یہ وہ حصہ ہے جس کے بارے میں میں بلند آواز میں ہونا چاہتا ہوں۔ کلاڈ VAT ریاضی میں نہیں ہے۔ کلاڈ لائنوں کی درجہ بندی کرتا ہے، مفاہمت کا مشورہ دیتا ہے، اور ریاضی کرنے والے ڈیٹرمنسٹک Python ماڈیولز کو تخلیق اور ترمیم کرتا ہے۔ Box 9 کے ذریعے Box 1 کی اصل گنتی یونٹ ٹیسٹ کے ساتھ ایک خالص فنکشن ہے۔ HMRC جمع کرانے کے لیے انسانی منظوری کے دروازے کی ضرورت ہوتی ہے۔ ڈرائی رن رپورٹ سائن آف کے لیے سچائی کا ذریعہ ہے۔ اگر میں اس بات کی وضاحت نہیں کر سکتا ہوں کہ کوڈ اور درجہ بند قطاروں کو دیکھنے سے نمبر کیوں ہے، تو میں جمع نہیں کرتا۔

یہ ایک سخت اصول ہے کیونکہ فنانس کو ریگولیٹ کیا جاتا ہے، اور "AI نے یہ کیا" MTD کے تحت دفاع نہیں ہے۔ دی طویل مضمون آپ کے اپنے نفاذ میں اس لائن کو کس طرح کھینچنا ہے اس کے بارے میں مزید تفصیل میں جاتا ہے۔

اس کی تعمیر میں مجھے کیا لاگت آتی ہے، اور مجھے چلانے میں کیا لاگت آتی ہے۔

تعمیر کا وقت تقریباً ایک ہفتہ مرکوز شاموں کا تھا - زیادہ تر اسکیما نارملائزیشن، درجہ بندی کے قواعد، اور انجن کے لیے ٹیسٹ لکھنے پر صرف ہوتا تھا۔ HMRC MTD OAuth رقص سب سے سست حصہ تھا۔ پہلے سینڈ باکس کے خلاف دوڑنا ہر منٹ کے قابل تھا۔

چلانے کے لیے، ہر سہ ماہی میں مجھ پر تقریباً لاگت آتی ہے: میری Claude Code سبسکرپشن (دوسرے کام کے لیے پہلے سے ادا کی گئی ہے) اور کلاسیفائر کے لیے ٹوکن کے استعمال میں چند پیسے۔ HMRC API خود مفت ہے۔ VAT انجن اور آڈٹ لاگ مقامی طور پر میرے میک پر چلتے ہیں۔

اہم تردید

میں ایک انجینئر ہوں، چارٹرڈ اکاؤنٹنٹ نہیں۔ یہ مضمون ٹیکس کا مشورہ نہیں ہے۔ اس سے پہلے کہ آپ اپنے اصلی HMRC اکاؤنٹ کے خلاف اس طرح کی کوئی چیز چلائیں، اپنی پہلی واپسی کے اختتام سے آخر تک جائزہ لینے کے لیے برطانیہ میں رجسٹرڈ اکاؤنٹنٹ حاصل کریں۔ HMRC MTD استعمال کریں۔ سینڈ باکس جب تک آپ اور آپ کا اکاؤنٹنٹ دونوں خوش نہ ہوں۔ ایک خراب VAT جمع کرانے کی قیمت اکاؤنٹنٹ کے وقت کے ایک گھنٹے کی لاگت سے بہت زیادہ ہے۔

لمبا ورژن پڑھیں

اگر آپ پوری تصویر چاہتے ہیں - عین مطابق CREATE TABLE اسکیما، Claude Code پرامپٹس، یونٹ ٹیسٹ کے ساتھ ڈیٹرمنسٹک Python انجن، HMRC MTD OAuth فلو، فراڈ سے بچاؤ کے ہیڈرز، اور ایج کیسز پر ایک مکمل سیکشن (Brexit / NI پروٹوکول، ریورس ریٹ، فلیٹ چارج، فلیٹ ریٹ، فلیٹ چارج تبدیلیاں، ملٹی کرنسی انوائس، کریڈٹ نوٹ، ڈپازٹس) - پڑھیں طویل مضمون. یہ وہ ورژن ہے جو میں شروع کرنے سے پہلے پڑھنا چاہتا تھا۔

دیکھیں YouTube واک تھروفالو اپ ٹیوٹوریلز کے لیے سبسکرائب کریں (آٹو امپورٹ بینک فیڈز، رسیدوں کے لیے او سی آر، شیڈول کرون + سلیک اپروول)، اور یاد رکھیں: ٹیکس مشورہ نہیں، اکاؤنٹنٹ سائن آف درکار ہے۔