ifixkart-admin/docs/billing/invoice.md
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- Backend: FastAPI app with all models, services, schemas, routes
- Admin Panel: Next.js dashboard with all modules
  (CRM, POS, repairs, warranties, billing, notifications, etc.)
- Ecommerce: storefront (submodule) + product catalog
- AI Agents: .agents/ skill library for Antigravity IDE
- Docs: architecture, billing, notification gateway markdown
- Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
2026-10-13 12:59:47 +05:30

1 KiB

Invoice Architecture & Tax Calculation

GST Tax Calculation Engine

Calculates CGST, SGST, and IGST dynamically based on seller store location vs customer billing address:

IF Seller State == Customer Billing State THEN
    CGST Rate = Total GST Rate / 2  (e.g., 9%)
    SGST Rate = Total GST Rate / 2  (e.g., 9%)
    IGST Rate = 0%
ELSE
    CGST Rate = 0%
    SGST Rate = 0%
    IGST Rate = Total GST Rate  (e.g., 18%)
END IF

Shared Online/Offline Invoice Model

CREATE TABLE invoices (
    invoice_id VARCHAR(26) PRIMARY KEY,
    invoice_no VARCHAR(16) NOT NULL UNIQUE, -- CBIC 16-Char Limit
    order_id VARCHAR(26) NULL,
    pos_transaction_id VARCHAR(26) NULL,
    customer_id VARCHAR(26) NOT NULL,
    subtotal DECIMAL(10,2) NOT NULL,
    discount_amount DECIMAL(10,2) DEFAULT 0.00,
    cgst DECIMAL(10,2) DEFAULT 0.00,
    sgst DECIMAL(10,2) DEFAULT 0.00,
    igst DECIMAL(10,2) DEFAULT 0.00,
    total_amount DECIMAL(10,2) NOT NULL,
    pdf_path VARCHAR(500) NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);