A R R R Associates
46 lines
2.9 KiB
Plaintext
46 lines
2.9 KiB
Plaintext
ARRR GST Operator Agent 1.5.1
|
|
|
|
Purpose
|
|
-------
|
|
Runs only on the GST operator workstation. It opens visible Chrome/Edge, redeems a short-lived GST job token from ARRR ERP, fills the selected Credential Vault username/password, waits for manual CAPTCHA/OTP, downloads selected GST return data, and uploads the package back to ERP for transfer to the configured Storage Agent.
|
|
|
|
Architecture
|
|
------------
|
|
ARRR ERP starts the agent through the Windows custom URL protocol arrrgst://. No browser-to-localhost HTTP/HTTPS request is used. No localhost TLS certificate, local web server, Tally access, or client storage access is required on the operator workstation.
|
|
|
|
Installation
|
|
------------
|
|
Run install_gst_operator_agent.ps1 as the Windows user who will operate GST downloads. Administrator rights are not required. Python 3.11+ and installed Chrome or Edge are required.
|
|
|
|
Browser prompt
|
|
--------------
|
|
The first time ARRR ERP opens arrrgst://, Chrome/Edge may ask whether to open ARRR GST Operator Agent. Choose Open/Allow.
|
|
|
|
Security
|
|
--------
|
|
The custom URL contains only a short-lived signed job token. GST username/password are redeemed by the local agent directly from ARRR ERP and are never inserted in ERP page HTML or in the custom URL. CAPTCHA/OTP remains manual.
|
|
|
|
Uninstall
|
|
---------
|
|
Run uninstall_gst_operator_agent.ps1. It removes the protocol registration and also cleans legacy v1.0.x localhost listener/startup/certificate state.
|
|
|
|
|
|
V1.5.1 OCTAGST-STYLE RETURN-DASHBOARD EXTRACTION
|
|
- Preserves the v1.4.0 Credential Vault login, manual CAPTCHA/OTP, natural Welcome -> Return Dashboard flow, ERP upload and failure diagnostics.
|
|
- GSTR-2B no longer transfers the browser to gstr2b.gst.gov.in.
|
|
- GSTR-2B is requested from the authenticated return.gst.gov.in Return Dashboard using the GST offline-download API pattern used by the supplied OctaGST extension.
|
|
- The agent follows GST-provided download URLs, saves returned ZIP/JSON files, and safely extracts JSON members locally.
|
|
- Same-origin GSTR-1 and GSTR-3B API calls remain unchanged.
|
|
- No automatic GST logout is performed.
|
|
- A job is completed only after every selected period/return has a saved result and ERP/client-storage upload is confirmed.
|
|
- Manual JSON/ZIP import remains available in ERP as fallback.
|
|
|
|
|
|
V1.5.1 NATURAL MONTHLY RETURN FLOW + GSTR-2B PENDING POLL
|
|
--------------------------------------------------------
|
|
- Restores robust Aadhaar/E-KYC Remind me later / Later dismissal.
|
|
- GSTR-2B generation-accepted responses are PENDING, not failures; polls up to 25 minutes.
|
|
- GSTR-1: selects FY/Quarter/Month on Return Dashboard, clicks Search, opens the actual GSTR-1 card, then performs offline generation/download from the initialized page context.
|
|
- GSTR-3B: selects FY/Quarter/Month, clicks Search, opens the actual GSTR-3B card, then reads summary/tax-payable from the initialized return page context.
|
|
- Existing Credential Vault, custom protocol, login/CAPTCHA, manual fallback, ERP upload and Storage Agent flow are unchanged.
|