# EntryFlow API Specification
> The AI Ingestion Engine for Tally Prime, Indian GST Compliance & Financial Books
> Official Portal: https://entryflow.callagentai.in
> Bulk GSTIN Tool: https://entryflow.callagentai.in/tools/gstin-validator
> Parent Ecosystem: https://callagentai.in

## Core Mission
EntryFlow turns scanned/photographed Indian tax invoices into verified JSON data, Modulo-36 validated GST tax entries, and 1-click importable Tally Prime XML vouchers.

## Canonical Web Resources
- Web App: https://entryflow.callagentai.in
- Interactive Live Sandbox: https://entryflow.callagentai.in/#demo
- Free Bulk GSTIN Validator: https://entryflow.callagentai.in/tools/gstin-validator
- Tally Prime XML Guide: https://entryflow.callagentai.in/guides/tally-prime-xml-purchase-voucher-import-format
- GSTR-2B Reconciliation Guide: https://entryflow.callagentai.in/guides/gstr-2b-reconciliation-tally-prime-guide
- CA Firm Automation Guide: https://entryflow.callagentai.in/guides/automate-ca-firm-vendor-invoice-data-entry
- AI Tools for CAs (Custom Workflows & Scale): https://entryflow.callagentai.in/guides/ai-tools-for-chartered-accountants-automate-tally-prime-vouchers-2026
- Refund Policy (7-Day Guarantee): https://entryflow.callagentai.in/refund-policy
- DPDP Act 2023 Privacy Policy: https://entryflow.callagentai.in/privacy
- Terms of Service: https://entryflow.callagentai.in/terms
- Contact & Grievance: https://entryflow.callagentai.in/contact

## API Endpoints

### 1. Ingest & Extract Invoice
- **POST** https://entryflow.callagentai.in/v1/extract
  - Accepts multipart file (PDF, JPG, PNG).
  - Returns structured JSON containing Supplier/Buyer GSTIN, State code, HSN line items, CGST/SGST/IGST breakdown, and 1-paisa math reconciliation.

### 2. Generate Tally XML
- **POST** https://entryflow.callagentai.in/v1/tally-xml
  - Accepts invoice JSON structure.
  - Returns raw <TALLYMESSAGE> XML file ready for Tally Prime Import > Transactions.

### 3. Verify GSTIN Checksum (Single & Bulk)
- **GET** `https://entryflow.callagentai.in/v1/validate-gstin?gstin=27AABCA1234F1Z5`
  - Validates 15-character alphanumeric GSTIN against official Modulo-36 algorithm.
  - Returns state mapping and checksum validity.
- **Web Tool:** `https://entryflow.callagentai.in/tools/gstin-validator` (Free bulk and single GSTIN check utility)

### 4. Sample Demonstration
- **GET** https://entryflow.callagentai.in/v1/sample-invoice
  - Returns verified sample Indian tax invoice with live extraction and Tally XML voucher.

## Tech Stack
- FastAPI (High performance asynchronous Python framework)
- Gemini 2.5 Flash Vision (Sub-2s multimodal document extraction)
- PyMuPDF (PDF to raster rendering)
- Tally Prime TDL/XML Standard Schema