Header of a GSTR-3B self-assessed monthly summary return for one GSTIN and one return period (the period is the linked GSTFiscalPeriod, not a raw string). Draft headers are auto-provisioned per active GSTRegistration by the scheduled GST-return provisioning job; the ComputeGSTR3B action (also run nightly by the scheduled GSTR-3B process job) then derives the box figures from three layers: outward supplies (box 3.1) from the filed GSTR-1, input tax credit (boxes 4A/4D) from the fetched GSTR-2B, and reverse-charge liability plus blocked ITC (3.1(d), 4B(1)) from the TaxTransaction ledger, with the Rule-37 180-day unpaid-bill tracker feeding 4B(2)/4D(1). The derived box rows are stored in internal child tables that are not exposed as metadata entities - read them through the GetGSTR3B action, which returns the consolidated table-wise summary. Creating or editing a header validates the GSTIN format (15 characters).
Fields
| Field | Label | Type | Required | What it does |
|---|
AckNumber | Ack Number | Text | | |
ComputedAt | Computed At | DateAndTime | | |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
FiledOn | Filed On | DateAndTime | | |
GspReferenceId | GSP Reference Id | Text | | |
GSTIN | GSTIN | Text | | |
GSTMonthId | GST Month | Lookup → GSTMonth_c | | |
GstnPayload | GSTN Payload | LongMultiLineText | | |
GstnResponse | GSTN Response | LongMultiLineText | | |
Id | Id | Guid | Yes | |
IsFiled | Is Filed | Boolean | | |
IsNilReturn | Is Nil Return | Boolean | | |
Label | Label | Text | | |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Name | Text | Yes | |
OwnerId | Owner | Lookup → UserAccount | Yes | |
ProcessedInvoiceValue | Processed Invoice Value | Decimal | | Total invoice value processed into this return by the compute, stamped for reference alongside ComputedAt; not a statutory box figure. |
RecordTypeId | Record Type | Guid, hidden | | |
ReturnPeriodId | Return Period | Lookup → GSTFiscalPeriod | | |
Status | Status | PickList | | Filing lifecycle stored as text: Draft, Computed, Saved, Submitted, Filed. Filed is a one-way frozen state - it blocks recompute and is what the GSTR-9 annual rollup selects on. 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) | Recomputes this GSTR-3B in one transaction: syncs the Rule-37 180-day tracker from bills, rebuilds the derived box rows (3.1 outward from the filed GSTR-1, 4A ITC from the fetched GSTR-2B, 3.1(d) reverse charge and 4B(1) blocked ITC from the TaxTransaction ledger, 4B(2)/4D(1) from the tracker, 4D(2) disclosure from the 2B ITC summary) and advances Status to Computed. Idempotent: only auto-filled rows are replaced; rows a user entered by hand are left untouched, and boxes the compute cannot derive (3.1.1, 4A(2), Rule 42/43 reversals, table 6.1 payments) are never cleared. Refused on a Filed return. The same compute runs on the scheduled GSTR-3B process job. |
Edit | Edit | Edit | Edit |
EditInLine | Edit InLine | EditInline | Edit InLine |
EditInList | Edit | EditInline | edit |
FileToGSTN | File To GSTN | ServerAction (FileToGSTN) | File to GSTIN |
GetGSTR3B | GetGSTR3B | ServerAction (GetGSTR3B) | Read-only: returns the consolidated table-wise GSTR-3B summary for this header (the box rows 3.1/3.1.1/4A/4B/4D with their tax heads). This is the way to read the computed figures, because the derived box rows live in internal tables that are not exposed as metadata entities. |
MakeChallan | Make Challan | ServerAction | GST payment challans are not generated by the platform; do not confuse this with the implemented TDS deposit-challan pipeline on TdsChallan. |
New | New | New | New |
PullFromGSTIN | Pull From GSTIN | ServerAction (Pull From GSTIN) | GSTR-3B figures are not pulled from GSTN; they are computed locally by ComputeGSTR3B from the filed GSTR-1, the GSTR-2B and the tax ledger. |
