save_gstr1_data
Upload GSTR-1 data to the GST portal for validation. Provide access token, GSTIN, return period, and full GSTR-1 payload; returns a reference ID to poll until completed.
Instructions
Upload GSTR-1 data to the GST portal for validation (Step 2).
After calling this tool, use check_return_status() with the returned reference_id to poll until the status is COMPLETED before proceeding.
Args: access_token: Taxpayer session token from generate_taxpayer_session() gstin: 15-digit GST Identification Number ret_period: Return period in MMYYYY format (e.g. "032026" for March 2026) gstr1_data: Complete GSTR-1 payload dict containing b2b, b2cl, b2cs, hsn, docs sections etc.
Returns: Dict with reference_id for status polling, or an error dict.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"access_token": "<access_token>",
"gstin": "<gstin>",
"ret_period": "<ret_period>",
"gstr1_data": "<gstr1_data>"
},
"name": "save_gstr1_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gstin | Yes | ||
| gstr1_data | Yes | ||
| ret_period | Yes | ||
| access_token | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |