💵

Government & Public Sector

Tax & Revenue

Tax administration systems, GST platforms, income tax filing, revenue collection, and compliance management. From India's GST Network to global tax administration platforms.

1.4B+

Monthly GST Invoices

70M+

Income Tax Returns Filed

₹18L Cr

Annual GST Collection (FY24)

Infosys

Built India's IT Portal

What Engineers Miss When They First Enter Tax & Revenue

Tax technology in India has two distinct scales that require very different architectures. The GSTN (GST Network) processes 1.4 billion e-invoices per month from 12 million+ GST-registered businesses. The Income Tax e-filing portal serves 70+ million taxpayers filing annually, with a very pronounced spike around the ITR filing deadline (July 31) that dwarfs the daily load by 100x. Both systems are built and operated by IT companies under government contract, and both have had high-profile outages under exactly the conditions where reliability matters most — the Income Tax portal's troubled launch in 2021 when Infosys was contracted to build it was a public incident that attracted Parliamentary scrutiny.

The GST e-invoicing mandate (Phase 1 for large businesses, now extending to businesses with ₹5 crore+ turnover) has been the most significant GST technology requirement since the system launched. E-invoicing requires businesses to generate invoices through the Invoice Registration Portal (IRP), which validates the invoice, assigns a unique IRN (Invoice Reference Number), and generates a QR code. Only then is the invoice valid for input tax credit claim. The engineering implication is that the billing system of every covered business must integrate with the IRP API at the point of invoice generation — the invoice cannot be printed and sent until the IRP has validated and returned the IRN. For businesses that generate thousands of invoices per day, the IRP integration becomes a critical path in their sales process.

Tax fraud detection at GSTN scale is a genuine data engineering problem. Circular transactions — where input tax credit (ITC) is claimed for purchases from shell companies that paid no tax and have no real business activity — have been a persistent problem in the GST system. Detecting them requires building a graph of buyer-seller relationships across 12 million taxpayers, identifying clusters of entities that have circular transaction patterns, and flagging them for audit without generating excessive false positives on legitimate business structures. The GSTN analytics team runs SNA (Social Network Analysis) on transaction data to identify suspicious clusters, which is one of the more interesting applications of graph analytics in Indian government technology.

What Teams Actually Do Day To Day

  • 1Build and operate the GST return filing pipeline: the GSTR-1 inward supply data collection from businesses, the GSTR-3B summary return filing with self-assessed tax liability, the GSTR-2B auto-populated input tax credit statement that matches purchase data reported by suppliers against the taxpayer's declared purchases, and the reconciliation exception flagging where supplier-reported and buyer-reported figures diverge.
  • 2Develop the e-invoicing integration: the IRP API that validates invoice data against GST schema, generates the IRN, digitally signs the invoice data, and returns the QR code; the NIC e-invoice portal that provides a user interface for businesses without ERP integration; and the invoice cancellation flow for invoices that are generated in error.
  • 3Implement the Income Tax e-filing system: the ITR form selection wizard that helps taxpayers identify the right form for their income type, the prefilled return generation that pre-populates salary, TDS, and bank interest data from Form 26AS and Annual Information Statement, the tax computation engine that applies the current year tax rates and deduction rules, and the e-verification flow via Aadhaar OTP or net banking.
  • 4Build the tax analytics and audit risk scoring system: the AI/ML models that score each taxpayer's return for audit risk based on declared income, claimed deductions, industry benchmarks, and past filing behaviour; the ITC reconciliation system that identifies mismatches between ITC claimed and ITC available in GSTR-2B; and the faceless assessment workflow for IT scrutiny cases.
  • 5Develop the integration platform that connects tax systems to other government databases: TDS credit verification with TRACES, PAN-Aadhaar link verification with UIDAI, property transaction reporting from registrar offices to AIS (Annual Information Statement), and share transaction reporting from depositories to capital gains pre-fill.

One End-to-End Flow: A Business Generates a GST-Compliant Invoice via E-Invoicing

A B2B business generates an invoice from its ERP, gets it validated by the IRP, receives the IRN and QR code, and the buyer's ITC is automatically available in their GSTR-2B — all in under 10 seconds.

1

Invoice is generated in the seller's ERP

The seller's accounts team creates an invoice in their ERP (SAP, Tally, or Zoho Books) for a B2B sale. The ERP validates the buyer's GSTIN format and checks if e-invoicing is applicable for the transaction (B2B, above the turnover threshold, applicable supply type). The invoice data is formatted as per the e-invoice JSON schema.

Systems Involved

ERP billing module, GSTIN format validation, e-invoicing applicability check, JSON schema formatting

Where It Usually Breaks

Incorrect buyer GSTIN in the seller's master data — a common issue when buyers have multiple GSTINs across states — causes the IRP to reject the invoice. The rejection is discovered only at invoice generation time, requiring the seller to update the master data and regenerate the invoice, delaying the delivery.

2

Invoice is submitted to the IRP for validation

The ERP or the GSP (GST Suvidha Provider) middleware calls the IRP API with the invoice JSON. The IRP validates: mandatory fields present, GSTIN active, HSN/SAC code valid, tax calculation correct. On validation pass, the IRP generates the IRN (a 64-character hash of the GSTIN, financial year, document type, and document number), digitally signs the payload, and generates the QR code.

Systems Involved

IRP API, invoice validation rules, IRN generation, digital signature, QR code generation

Where It Usually Breaks

IRP API downtime or high latency — which has occurred during peak periods like month-end when many businesses generate large volumes of invoices simultaneously — blocks invoice generation and disrupts the business's billing cycle. The government mandates retry logic and an offline fallback for covered taxpayers.

3

IRN and QR code are embedded in the invoice PDF

The ERP receives the IRN and signed QR code from the IRP. These are embedded in the invoice PDF: the QR code appears visually on the invoice, and the IRN is printed as a reference number. The invoice PDF is now a valid GST invoice and can be sent to the buyer.

Systems Involved

ERP PDF generation, IRN embedding, QR code printing

Where It Usually Breaks

Invoices printed before the IRN is received — when field teams generate paper invoices at the delivery point without network connectivity — are technically non-compliant. The buyer cannot claim ITC on an invoice without an IRN.

4

Buyer's ITC is auto-populated in GSTR-2B

The IRP transmits the validated invoice data to the GSTN. At the end of the month, when GSTR-2B is generated for the buyer, the invoice appears in the auto-populated ITC statement. The buyer's accounts team reconciles GSTR-2B against their purchase register, confirms the invoice is correct, and the ITC is claimed in the GSTR-3B filing.

Systems Involved

GSTN invoice ledger, GSTR-2B auto-population, buyer reconciliation, GSTR-3B ITC claim

Where It Usually Breaks

Mismatches between the invoice as transmitted to IRP (and hence in GSTR-2B) and the invoice as recorded in the buyer's purchase register — due to amendments made after IRN generation — create reconciliation exceptions that the buyer's GST team must investigate and resolve each month.

Technology Architecture — How Tax & Revenue Platforms Are Built

The diagram below reflects how production Tax & Revenue systems are structured at scale — nine layers from client channels through edge security, API gateway, domain microservices, polyglot data stores, async event streaming, analytics, external partners, and cloud infrastructure. Solid arrows show synchronous REST/gRPC calls; dashed arrows show async event flows via Kafka or a message queue.

Tax & Revenue — Enterprise Architecture ReferenceSolid arrows: synchronous calls (REST / gRPC) · Dashed arrows: async event flows (Kafka / Message Queue)CLIENTS & CHANNELSWeb SPAiOS / AndroidAdmin PortalPartner API3rd-Party WebhooksBatch / CronEDGE SECURITY & DELIVERYCDN (CloudFront / Akamai) · DDoS Shield · WAF (OWASP rules) · SSL/TLS Termination · Global Load Balancer (ALB / NLB)API GATEWAYKong / AWS API Gateway / NGINX / ApigeeRate Limiting · Routing · Versioning · Throttling · BFF PatternIDENTITY & ACCESSOAuth 2.0 · OpenID Connect · SAML 2.0JWT · RBAC · MFA · SSOCORE DOMAIN MICROSERVICES · REST / gRPC📋 GST Administration Platf…Taxpayer registration and GSTIN m…Monthly/quarterly return filing (…POST /api/v1/gst/returns/gstr1GSTN Portal📝 Income Tax AdministrationITR form selection and filing (IT…Income computation under multiple…POST /api/v1/itr/fileIncome Tax e-Filing Portal🔍 Tax Analytics & Fraud De…Taxpayer risk scoring and profili…Invoice mismatch and circular tra…GET /api/v1/analytics/risk-score/{t…Project Insight (India IT)⚖️ Enterprise Tax Complianc…Multi-tax computation (GST, IT, T…Automated return preparation from…POST /api/v1/compliance/compute-taxClearTax EnterpriseService Mesh: mTLS · Circuit Breaker (Resilience4j / Hystrix) · Service Discovery (Consul / Eureka) · Distributed Tracing (Jaeger)DATA PERSISTENCE · PolyglotOracle DatabaseOLTPMongoDBPrimaryRedis CacheCacheElasticsearchSearchS3 / BlobObjectASYNC MESSAGING & EVENTSApache Kafka / SQSPub/Sub · TopicsDead Letter QueueError HandlingStream ProcessorFlink / SparkANALYTICS & DATA PLATFORMData Warehouse (BigQuery / Snowflake / Redshift) · ETL/ELT (dbt / Airflow) · BI Tools (Tableau / Metabase) · ML Feature StoreEXTERNAL INTEGRATIONS & PARTNERSGSTN APIs (government)E-Invoice Portal (IRP)E-Way Bill systemAccounting softwareERP systemsIncome Tax Portal (go…PLATFORM: Hybrid Cloud (Govt) / AWS / Azure · Kubernetes (EKS/AKS/GKE) · Docker · Helm · ArgoCD · CI/CD (GitHub Actions) · IaC (Terraform)OBSERVABILITY: ELK / Datadog · Prometheus / Grafana · Jaeger · PagerDutySECURITY: TLS 1.3 · Vault / KMS · SAST/DAST · SOC2 / ISO 27001Sync (REST / gRPC)Async (Kafka / Events)Each service owns its bounded context · CQRS & Event Sourcing where applicable · Polyglot persistence per domain

Industry Players & Real Applications

🇮🇳 Indian Companies

GSTN (GST Network)

Government Tax Platform

Java, Hadoop, MongoDB, Oracle, cloud-native

India's GST backbone — processes 1.4B invoices/month, 1.4 crore registered taxpayers, built by Infosys

Infosys (Income Tax Portal)

Government IT Contractor

Java, microservices, cloud-native, ML

Built and operates India's new Income Tax e-filing portal under ₹4,200 Cr contract

ClearTax (Clear)

Tax Filing SaaS

Java, React, ML, AWS

India's largest tax filing platform — GST, ITR, TDS, e-invoicing. 5M+ businesses

Zoho Books / Zoho GST

Accounting + GST Compliance

Java, custom Zoho stack

Integrated accounting and GST filing — auto-reconciliation, return filing from Zoho

Tally Solutions

Accounting + Tax Software

C++, custom Tally engine

India's most widely used accounting software — GST-compliant, used by 7M+ businesses

TCS (Tax Technology)

Government IT Services

Java, Oracle, SAP, cloud migration

Provides tax technology solutions for multiple state governments and CBIC (customs)

🌍 Global Companies

SAP Tax Compliance

Germany

Enterprise Tax Platform

SAP ABAP, HANA, cloud

Global tax compliance for enterprises — multi-country tax calculation, reporting, and e-invoicing

Avalara

USA

Tax Automation SaaS

C#, .NET, Azure, ML

Automated tax calculation and compliance — 1,200+ tax rule integrations, used by 30,000+ companies

Thomson Reuters ONESOURCE

USA

Enterprise Tax Software

Java, .NET, Azure

Global indirect tax, transfer pricing, and tax provision — used by Fortune 500 companies

Vertex

USA

Tax Technology

Java, cloud-native, API-first

Indirect tax calculation engine — real-time tax determination for e-commerce and ERP

🛠️ Enterprise Platform Vendors

GSTN API Platform

Government API

Government APIs for GST return filing, e-invoicing, e-way bill generation — used by all GST software providers

Income Tax e-Filing Portal

Government Portal

Online portal for ITR filing, TDS returns, tax payment, and compliance — serves 70M+ taxpayers

E-Invoice System (IRP)

E-Invoicing

Invoice Registration Portal for mandatory e-invoicing — generates IRN for B2B transactions above ₹5 Cr

ICEGATE (Customs)

Customs Platform

Indian Customs Electronic Gateway — handles customs declarations, duties, and trade facilitation

Core Systems

These are the foundational systems that power Tax & Revenue operations. Understanding these systems — what they do, how they integrate, and their APIs — is essential for anyone working in this domain.

Business Flows

Key Business Flows Every Developer Should Know.Business flows are where domain knowledge directly impacts code quality. Each flow represents a real business process that your code must correctly implement — including all the edge cases, failure modes, and regulatory requirements that aren't obvious from the happy path.

The detailed step-by-step breakdown of each flow — including the exact API calls, data entities, system handoffs, and failure handling — is covered below. Study these carefully. The difference between a developer who “knows the code” and one who “knows the domain” is exactly this: the domain-knowledgeable developer reads a flow and immediately spots the missing error handling, the missing audit log, the missing regulatory check.

Technology Stack

Real Industry Technology Stack — What Tax & Revenue Teams Actually Use. Every technology choice in Tax & Revenueis driven by specific requirements — reliability, compliance, performance, or integration capabilities. Here's what you'll encounter on real projects and, more importantly, why these technologies were chosen.

The pattern across Tax & Revenue is consistent: battle-tested backend frameworks for business logic, relational databases for transactional correctness, message brokers for event-driven workflows, and cloud platforms for infrastructure. Modern Tax & Revenueplatforms increasingly adopt containerisation (Docker, Kubernetes), CI/CD pipelines, and observability tools — the same DevOps practices you'd find at any modern tech company, just with stricter compliance requirements.

⚙️ backend

Java / Spring Boot

Core tax computation engine, return processing, GSTN API integration — enterprise-grade reliability

Python / PySpark

Tax analytics, fraud detection ML models, Benford's Law analysis, graph algorithms

Node.js

API gateway, webhook handlers, real-time validation services

Drools / BRMS

Tax rule engine — codifies tax law as business rules, enables rapid rule updates without code changes

🖥️ frontend

React + TypeScript

Tax filing portals, compliance dashboards, admin interfaces

Angular

Government portals (GSTN uses Angular), enterprise tax compliance UIs

React Native

Mobile tax filing apps — ITR filing, GST return status, tax payment

🗄️ database

Oracle Database

GSTN's primary database — handles billions of invoice records, ACID transactions

MongoDB

Invoice document storage — flexible schema for varied invoice formats

Hadoop / Spark

Big data analytics — cross-matching billions of records across IT, GST, and MCA databases

Neo4j / Graph DB

Transaction network analysis — circular trading detection, shell company identification

☁️ cloud

Hybrid Cloud (Govt)

Government tax systems run on NIC/MeghRaj cloud with private cloud components

AWS / Azure

Private sector tax SaaS (ClearTax, Avalara) — auto-scaling for filing deadline peaks

Kafka

Event streaming — real-time invoice processing, compliance event pipeline

Elasticsearch

Full-text search across tax records, taxpayer lookup, compliance search

Interview Questions

Q1.How does India's GST Network (GSTN) handle the scale of processing 1.4 billion invoices per month?

GSTN is one of the world's most complex tax technology platforms. Scale: 1.4 crore registered taxpayers, 1.4B+ invoices/month, peak load during filing deadlines (11th and 20th of each month). Architecture: 1) Distributed Processing: Invoice data is partitioned by state (37 states/UTs). Each state's data processed independently. Cross-state matching (IGST) requires inter-partition joins. 2) Batch + Real-time: E-invoicing is real-time (IRP validates and returns IRN in < 2 seconds). Return filing is batch — GSTR-1 data uploaded in bulk, processed in parallel. GSTR-2B (buyer's view) generated as a batch job after GSTR-1 filing deadline. 3) Database: Oracle for transactional data, MongoDB for invoice documents (flexible schema — invoices have varied line items), Hadoop cluster for analytics and cross-matching. 4) Filing Deadline Spike: 70%+ of returns filed in last 3 days before deadline. System scales horizontally — additional compute nodes brought online. Queue-based processing prevents system overload. 5) API Architecture: GSP (GST Suvidha Providers) like ClearTax, Tally connect via standardized APIs. Rate limiting per GSP. Async filing — submit → get token → poll for status. 6) Reconciliation Engine: Matches seller's GSTR-1 invoices with buyer's purchase data. Generates GSTR-2B automatically. Handles mismatches: amount differences, missing invoices, late filing by suppliers. This reconciliation across 1.4B invoices is one of the largest data matching operations in the world.

Q2.How would you design a tax rule engine that can handle frequent tax law changes?

Tax law changes frequently — GST rates revised, new exemptions added, thresholds updated. Hardcoding tax rules in application code is unmaintainable. Solution: Business Rule Management System (BRMS). Architecture: 1) Rule Engine: Use Drools (Java) or custom DSL. Tax rules expressed as: IF (HSN code IN [1001-1005]) AND (transaction type = 'B2B') AND (inter-state = true) THEN tax_rate = 5% AND tax_type = 'IGST'. 2) Rule Versioning: Each rule has effective_from and effective_to dates. On a given transaction date, the engine picks the applicable version. Historical transactions always compute with the rule version active at that time. 3) Rule Hierarchy: Central GST rules (CGST Act), State-specific rules (SGST variations), Industry exemptions, Special economic zone rules. Rules evaluated in priority order with override capability. 4) Testing: Every rule change goes through regression testing — run all existing transactions through new rules, compare results. If output changes unexpectedly, alert. 5) Deployment: Rules deployed independently of application code. Rule file (DRL in Drools, or JSON config) pushed to rule engine. Hot-reload without application restart. 6) Audit Trail: Every rule execution logged: transaction → rules applied → computation result. Required for tax audit compliance. Example: GST Council meets quarterly and may change 50+ rules. With BRMS, rule analysts update the rule files, test, and deploy — no developer code change needed.

Q3.Explain how graph analysis detects GST fraud like circular trading and fake invoicing.

GST fraud often involves networks of companies creating fake invoices to claim fraudulent ITC (Input Tax Credit). Graph analysis is the most effective detection method. Types of fraud: 1) Circular Trading: A sells to B, B sells to C, C sells back to A (or to A's related entity). Goods never actually move. Each entity claims ITC on purchases. Net effect: government loses tax revenue. 2) Fake Invoice Factories: Shell companies (registered but no real business) issue invoices to multiple genuine businesses. Genuine businesses claim ITC on these fake invoices. Shell company collects fee (2-5% of invoice value) and disappears. Graph Detection: Model: Each GSTIN is a node. Each invoice is an edge. Build directed graph of all B2B transactions. Algorithms: a) Cycle detection (DFS/Tarjan's) — find cycles (A→B→C→A). Flag if goods description is similar across cycle (same goods 'moving' in circles). b) Community detection — find clusters of GSTINs transacting mostly with each other (closed groups are suspicious). c) Centrality analysis — shell companies often have high betweenness centrality (they connect many otherwise unconnected businesses). d) Temporal analysis — fake invoice chains often created in short burst (all in last week of month before GSTR-3B deadline). Red flags: New registration + high-value transactions immediately. GSTIN with many buyers but no purchases (or vice versa). Concentration — 90%+ of a company's purchases from a single supplier. Implementation: Neo4j for graph storage and query. Python NetworkX for algorithm prototyping. Apache Spark GraphX for large-scale processing. India's GSTN analytics team has recovered ₹1,000+ crore using these techniques.

Q4.What is the difference between tax computation and tax compliance, and how does technology address each?

Tax Computation: Determining the correct tax amount for a single transaction. Challenge: Multiple tax types (GST, TDS, customs), complex rules (exemptions, thresholds, place of supply), real-time requirement (customer checkout). Technology: Rule engine evaluates transaction attributes → determines applicable tax rate and type → computes amount. Must be fast (< 50ms for POS/e-commerce). Avalara and Vertex specialize in this — their APIs return tax computation for any transaction. Tax Compliance: Aggregating all transactions, preparing returns, filing with authorities, reconciling, and maintaining audit trail. Challenge: Monthly/quarterly deadlines, matching with government data, handling amendments, managing multiple entity/state registrations. Technology: ERP/accounting data → ETL pipeline → tax return preparation engine → validation → filing via government API → status tracking → reconciliation. ClearTax and Thomson Reuters ONESOURCE specialize in this. Key difference: Computation is real-time per-transaction (milliseconds). Compliance is batch periodic (monthly/quarterly, processing millions of transactions). Architecture difference: Computation = low-latency API with cached rules. Compliance = batch processing pipeline with state management, reconciliation engine, and filing queue. Example: When you buy on Amazon, Avalara computes GST in real-time (computation). At month-end, Amazon's tax team uses ClearTax to aggregate all transactions, reconcile ITC, and file GSTR-1 and GSTR-3B (compliance).

Q5.How does the e-invoicing system work in India, and what are the technical challenges?

India's e-invoicing is a government-mandated system where B2B invoices above a threshold (currently ₹5 Cr annual turnover) must be registered with the Invoice Registration Portal (IRP) before being shared with buyers. Technical Flow: 1) Seller ERP generates invoice in prescribed JSON Schema (IRN schema — ~50 mandatory fields). 2) ERP calls IRP API with signed invoice JSON. 3) IRP validates: GSTIN active, HSN valid, no duplicate (seller GSTIN + doc no + FY is unique), tax computation correct. 4) IRP generates: IRN (Invoice Reference Number — unique hash), QR code (contains key invoice data for offline verification), Digital signature (government PKI). 5) IRP pushes to: GSTN (auto-populates GSTR-1), E-Way Bill portal (auto-generates Part A if goods involved). Technical Challenges: 1) Latency: IRP must respond in < 2 seconds. Millions of invoices/day. Caching, horizontal scaling, and efficient validation critical. 2) Idempotency: If ERP call times out, retry must not create duplicate IRN. IRP uses seller GSTIN + document no + FY as idempotency key. 3) Schema Validation: JSON schema is complex and changes periodically. ERP software must update schema validation. Common errors: wrong HSN code length, missing mandatory fields, incorrect tax calculation. 4) Offline Handling: What if IRP is down? Regulations allow invoice generation with 'pending IRN' status. Must register within 24 hours. ERP queues failed e-invoices for retry. 5) Cancellation: E-invoice can be cancelled within 24 hours via IRP. After 24 hours, must issue credit note instead. ERP must enforce this time-based logic. 6) Multi-IRP: Government has authorized multiple IRPs for redundancy. ERP should implement failover — if IRP-1 is slow, route to IRP-2.

Glossary & Key Terms

GSTN

GST Network — the technology backbone of India's GST system, processing billions of invoices and returns

GSTIN

GST Identification Number — unique 15-digit identifier for each registered taxpayer

ITC

Input Tax Credit — tax paid on purchases that can be claimed as credit against output tax liability

GSTR-1

Monthly return of outward supplies — seller's invoice-level data filed by 11th of next month

GSTR-3B

Monthly summary return — tax liability and ITC summary, filed by 20th of next month with payment

E-Invoice

Electronically registered invoice with government-issued IRN — mandatory for B2B above ₹5 Cr turnover

IRN

Invoice Reference Number — unique hash generated by IRP for each registered e-invoice

IRP

Invoice Registration Portal — government system that validates and registers e-invoices

E-Way Bill

Electronic permit for goods movement above ₹50,000 — tracks goods in transit

HSN Code

Harmonized System of Nomenclature — international product classification code used for tax rate determination

TDS

Tax Deducted at Source — tax withheld by payer on payments like salary, rent, professional fees

Form 26AS

Annual tax statement showing all TDS, TCS, advance tax, and refunds for a PAN holder