A R R R Associates
37 lines
2.2 KiB
Plaintext
37 lines
2.2 KiB
Plaintext
ARRR GST Operator Agent 1.5.0
|
|
|
|
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.0 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.
|