One GSTR-3B monthly summary return for one GSTIN and one monthly GST fiscal period. Draft returns are created by GST-return provisioning (the Provision GST returns scheduled job or the Provision GST Returns action on a GST Registration), one per active regular registration per month. Process GSTR3B fills the boxes: table 3.1 from the same-period GSTR-1 (a Filed one preferred), table 4A from the latest same-period GSTR-2B statement, 3.1(d) reverse charge and 4B(1) blocked credit from the tax ledger, and 4B(2)/4D(1) from the Rule 37 180-day unpaid-bill tracker. Rows entered by hand (3.1(e), table 3.1.1, 4A(2), Rule 42/43 reversals, 6.1 payment details) are kept on reprocessing. The return is filed either through the GSP integration (Save to GSTN, Check Save Status, Submit File to GSTN) or on the government portal and then recorded with Record Manual Filing. A Filed return is frozen and is what the GSTR-9 annual return reads. See the GSTR-3B guide in the Tax Center documentation for the full procedure.
Fields
| Field | Label | Type | Required | What it does |
|---|
AckNumber | Ack Number | Text | | The acknowledgement number GSTN issued for the filing, at most 20 characters. Written back by Submit File to GSTN, or entered in Record Manual Filing, where it is required. |
ComputedAt | Computed At | DateAndTime | | When Process GSTR3B last ran for this return. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
FiledOn | Filed On | DateAndTime | | Date the return was filed. Stamped when Submit File to GSTN succeeds, or taken from the Record Manual Filing dialog (defaults to now when left empty). |
GspReferenceId | GSP Reference Id | Text | | The reference GSTN issued for the latest Save to GSTN. It is not a receipt: only Check Save Status can tell whether GSTN accepted the save. |
GSTIN | GSTIN | Text | | The filer's 15-character GST identification number. It must be well formed; a malformed value is refused whenever the record is saved. Decides which GSTR-1, GSTR-2B, tax-ledger lines and GST Registration session the return uses. |
GSTMonthId | GST Month | Lookup → GSTMonth_c | | Legacy month link. Not used by processing or filing; the return period is Return Period. |
GstnPayload | GSTN Payload | LongMultiLineText | | Hidden working field holding the request being sent to GSTN while a save, status check or filing is in progress. Cleared once GSTN accepts the save. Not for users. |
GstnResponse | GSTN Response | LongMultiLineText | | The last message from GSTN or the gateway for this return: the acceptance line, a refusal, or the per-box error list when GSTN rejects a save. |
Id | Id | Guid | Yes | |
IsFiled | Is Filed | Boolean | | Set when the return is filed by either route (Submit File to GSTN or Record Manual Filing), together with Status Filed. |
IsNilReturn | Is Nil Return | Boolean | | Marker that the month is a nil return. Informational only: no action reads it, and Save to GSTN still refuses a return that has no rows. |
Label | Label | Text | | Display name of the return, set by provisioning as GSTR-3B followed by the period, for example GSTR-3B Aug 2026. |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Name | Text | Yes | |
OwnerId | Owner | Lookup → UserAccount | Yes | |
ProcessedInvoiceValue | Processed Invoice Value | Decimal | | Header total field that Process GSTR3B does not fill. A blank value does not mean processing failed; confirm a run by Status, Computed At and the box figures. |
RecordTypeId | Record Type | Guid, hidden | | |
ReturnPeriodId | Return Period | Lookup → GSTFiscalPeriod | | The monthly GST fiscal period this return covers. Process GSTR3B is refused without it, and it decides which month's GSTR-1, GSTR-2B and ledger lines are read. |
Status | Status | PickList | | Lifecycle of the return. Provisioning sets Draft, Process GSTR3B sets Computed, an accepted GSTN save sets Saved, and a filing (Submit File to GSTN or Record Manual Filing) sets Filed. Filed is one-way: it blocks reprocessing and re-sending and is what the GSTR-9 rollup selects. The values Pushed to GSTN and GST Payment Made exist in the list but no action sets them. Values: Draft, Pushed to GSTN, GST Payment Made, Filed. |
SubscriptionKey | Subscription Key | Guid, hidden | Yes | |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
Actions
| Action | Label | Type | What it does |
|---|
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
ComputeGSTR3B | Process GSTR3B | ServerAction (ComputeGSTR3B) | Process GSTR3B. Refreshes the Rule 37 tracker from purchase bills, rebuilds every auto-filled box row (3.1 from the same-period GSTR-1, Filed preferred; 4A from the latest GSTR-2B statement; 3.1(d) and 4B(1) from the tax ledger; 4B(2) and 4D(1) from the Rule 37 tracker; 4D(2) from the statement's not-available ITC), refreshes Payable on the 6.1 rows, and sets Status to Computed. Rows entered by hand are kept. Refused on a Filed return. The Process GSTR-3B data scheduled job runs the same processing. |
Edit | Edit | Edit | Edit |
EditInLine | Edit InLine | EditInline | Edit InLine |
EditInList | Edit | EditInline | edit |
FileToGSTN | File To GSTN | ServerAction (FileToGSTN) | Record Manual Filing. Records a GSTR-3B already filed on the government portal: asks for the Ack Number (required, at most 20 characters) and Filed On (defaults to now), then sets Is Filed and Status Filed. Sends nothing to GSTN. Refused on a return already Filed, without a valid GSTIN, or while a GSP filing is in progress. |
GetGSTR3B | GetGSTR3B | ServerAction (GetGSTR3B) | Returns the table-wise summary shown on the Overview tab: tables 3.1, 3.1.1, 4A, 4B, 4D and 6.1, every statutory line included, with taxable value and the four tax heads. Read-only. |
MakeChallan | Make Challan | ServerAction | Has no effect. xMatix does not generate GST payment challans; create and pay them on the government portal. |
New | New | New | New |
PullFromGSTIN | Pull From GSTIN | ServerAction (Pull From GSTIN) | Retired and inactive. GSTR-3B figures are not pulled from GSTN; they are built by Process GSTR3B. |
