IFMIS Payslip Automator Chrome Extension

A Chrome extension that automates the process of fetching payslip data from the IFMIS Telangana government portal. The extension allows users to input a date range and automatically fetches payslip information for all months within that range.

Features

• User-friendly Interface: Clean, modern UI with form inputs for employee code, OTP, and date range
• Batch Processing: Automatically fetches data for all months within the specified date range
• Data Extraction: Extracts token number and transaction date from API responses
• Results Display: Shows results in a organized table format with status indicators
• Copy to Clipboard: One-click functionality to copy all data as CSV format
• Error Handling: Graceful handling of API errors and validation
• Progress Tracking: Real-time progress updates during data fetching

Installation

Method 1: Load as Unpacked Extension (Recommended for Development)

1. Download the Extension Files

   • Download all the extension files to a folder on your computer
   • Ensure you have the following files:
     • manifest.json
     • popup.html
     • popup.css
     • popup.js

2. Open Chrome Extensions Page

   • Open Google Chrome
   • Navigate to chrome://extensions/
   • Or go to Menu → More Tools → Extensions

3. Enable Developer Mode

   • Toggle the "Developer mode" switch in the top-right corner

4. Load the Extension

   • Click "Load unpacked" button
   • Select the folder containing your extension files
   • The extension should now appear in your extensions list

5. Pin the Extension (Optional)

   • Click the puzzle piece icon in Chrome's toolbar
   • Find "IFMIS Payslip Automator" and click the pin icon

Usage

1. Access the Extension

   • Click on the extension icon in your Chrome toolbar
   • The extension popup will open

2. Enter Your Information

   • Employee Code: Enter your IFMIS employee code (e.g., 1400061)
   • OTP: Enter the OTP received from IFMIS
   • From Month/Year: Select the starting month and year
   • To Month/Year: Select the ending month and year

3. Fetch Data

   • Click the "Fetch Data" button
   • The extension will show a loading spinner with progress updates
   • Wait for all API calls to complete

4. View Results

   • Results will be displayed in a table showing:
     • Month/Year
     • Token Number
     • Transaction Date
     • Status (Success/Error/No data found)

5. Copy Data

   • Click the "Copy Data" button to copy all results as CSV format
   • The data will be copied to your clipboard
   • You can paste it into Excel or any spreadsheet application

API Details

The extension makes API calls to:

https://ifmis.telangana.gov.in/generate_pay_slip_public

Parameters:

• empcode: Employee code
• monthno: Month number (1-12)
• optradio: Set to "empcode"
• otp: One-time password
• year: Year (e.g., 2025)

Response Format

The API returns data in the following format:

[
    1,
    [
        {
            "id": 123,
            "bill_month": 3,
            "bill_year": 2025,
            "tokenno": "TOKEN123",
            "transdate": "2025-03-26",
            "gross": "50000",
            "dedn": "5000",
            "net": "45000",
            "ddocode": "DDO001",
            "created_at": "2025-03-26 10:00:00",
            "users": {
                "id": 75456,
                "designation": "Employee",
                "userdesc": "Description",
                "ddo_dept_id": 123,
                "username": "username",
                "ddo_regno": "REG123",
                "ddodept": {
                    "id": 456,
                    "name": "Department Name"
                }
            }
        }
    ]
]

Troubleshooting

Common Issues

1. Extension Not Loading

   • Ensure all files are in the same folder
   • Check that manifest.json is properly formatted
   • Try refreshing the extensions page

2. API Calls Failing

   • Verify your employee code and OTP are correct
   • Ensure you have an active internet connection
   • Check if the IFMIS portal is accessible

3. Copy Function Not Working

   • Ensure the extension has clipboard permissions
   • Try refreshing the extension popup

4. CORS Errors

   • The extension is configured to handle CORS for the IFMIS domain
   • If you encounter CORS issues, ensure the extension has the correct host permissions

Error Messages

• "Please fill in all fields": Ensure all form fields are completed
• "Invalid date range": The "From" date should be before the "To" date
• "HTTP error! status: XXX": The API returned an error status code
• "No data found": The API returned an empty response for that month

Security Notes

• The extension only requests permissions necessary for its functionality
• API calls are made directly to the IFMIS server
• No data is stored locally or transmitted to third parties
• OTP and employee codes are only used for API calls and not stored

Technical Details

• Manifest Version: 3 (Latest Chrome extension standard)
• Permissions:
  • activeTab: For accessing the current tab
  • clipboardWrite: For copying data to clipboard
• Host Permissions: https://ifmis.telangana.gov.in/*
• Content Security Policy: Restricted to extension's own scripts

Support

For issues or questions:

1. Check the troubleshooting section above
2. Verify your IFMIS credentials are correct
3. Ensure the IFMIS portal is accessible from your network

Version History

• v1.0: Initial release with core functionality
  • Basic form interface
  • API integration
  • Results display
  • Copy to clipboard functionality