This page helps you find out why a Tax Center figure, return or e-document is missing or wrong, and sends you to the page that has the full fix. Most problems come from one of four places: the source document (not posted, wrong date, wrong GSTIN), the return setup (no registration, period or return record), the GSTN connection (no session or no integration answer), or a deliberate limit of xMatix. Work out which one first. Every problem below is a short answer; the linked page has the exact message, the cause and the fix.
Overview
Every GST return in xMatix is built in the same order:
- A sales invoice, bill, credit note or expense voucher is posted. Posting records its tax as tax transactions, under the GSTIN of the branch or company.
- A GST registration and a GST period exist for that GSTIN and month, and the month's return records have been provisioned (created).
- Process GSTR1, Process GSTR2B or Process GSTR3B builds the books side of the return from the posted documents. Scheduled jobs do the same for open periods.
- Where a GSP integration is set up, Pull From GSTIN brings in GSTN's side, and Save to GSTN and the filing actions send your side.
- The return is Filed. A Filed return is frozen: it cannot be processed again.
E-invoices and e-way bills work the same way. xMatix records the request on the Invoice. A GSP integration your administrator configures sends it to the portal and writes the answer back. Until that integration answers, nothing is sent.
TDS follows its own order: a TDS section on the bill line, a posted deduction, a challan, a quarterly return, and certificates.
When to use it
Use this page when:
- a document you posted is not in a return, or a return figure is zero or lower than you expect;
- a button refuses with a message, or does nothing;
- a request to GSTN, the e-invoice portal or the e-way bill portal never comes back;
- a TDS deduction, challan, return or Form 26AS result looks wrong.
Procedure
Step 1 — Note what you see
Write down the return or document, the GSTIN, the month, the Status, and the exact message if there is one. Most messages in the Tax Center name the record and the fix. Search for the message on the page for that return.
Step 2 — Check the source document
Open one document that should be in the figure and check that:
- it is posted. Drafts never reach a return;
- its date is in the return's month. For a bill, the month comes from the Supplier Invoice Date, or the Document Date when that is blank;
- it was raised under the return's GSTIN. A branch with no GST registration, in a company with no default active registration, gives tax rows with no GSTIN, and those reach no return;
- it has tax lines. Posting does not stop when the tax capture fails, so a posted document can have none. See Tax transactions.
Step 3 — Check the return setup
- The GST registration has Is Active on and a GSTIN. Inactive registrations are left out of the GST console and of provisioning. See GST registrations.
- A GST period exists for the month. Creating a period does not create returns: provision the month as well. See GST periods.
- The period is Open if you expect the scheduled jobs to keep processing it. The jobs skip Closed and Locked periods.
Step 4 — Run the processing action again
Open the return and click Process GSTR1, Process GSTR2B or Process GSTR3B. Processing updates the books side in place and keeps the decisions you recorded on documents. It does not touch the portal side, and it is refused on a Filed return.
Step 5 — Check the GSTN exchange
If the problem is with Pull From GSTIN, Save to GSTN, filing, an e-invoice or an e-way bill:
- read the message field on the record: Pull Message, GSTN Response, Response (eInvoice) or the e-way bill panel;
- check Save Status where the return has one;
- if nothing has come back, ask your administrator to check the integration's runs in Sync health.
Step 6 — Check permissions
If a button is missing, the user's security profile probably does not grant that action. Each return action is a server action granted per profile. Check the profile before you treat a missing button as a calculation problem.
Common problems: GST console
The GSTIN picker is empty, or a registration is missing from it
The console lists only GST registrations with Is Active on and a GSTIN. Edit the registration and switch on Is Active. See The GST console.
A financial year is missing
The year list comes from the stored GST periods. Create or provision the periods for that year. When no periods exist, the single year shown is only a default.
A card says "Not created", or opens an empty list
The month's returns have not been provisioned. Creating a GST period does not create them. Provision the month with the scheduled provisioning job, or, for the current month, with Provision GST Returns on the GST registration. See GST periods.
The GSTR-2B card says Not Synced although the statement has rows
The card counts only GSTN's side, which arrives with Pull From GSTIN. Rows built from your own bills by Process GSTR2B do not count. Pull the statement and refresh the console.
One GSTIN got no GSTR-1, GSTR-2B or GSTR-3B
Either the registration is inactive, or it is an Input Service Distributor (ISD) registration. An ISD registration gets GSTR-6 only. See GST registrations.
Common problems: GSTN sign-in
"… is not authenticated with GSTN. Request an OTP and complete authentication first."
The registration has no live GSTN session, or it has expired. Click Send OTP in the return's dialog, or run Request GSTN OTP and Submit OTP on the GST registration, then try again. "No GST registration found for …" means the GSTIN on the return has no registration record.
"Set the GSTN portal username on this registration before requesting an OTP"
Fill GSTN Username on the registration's Details tab, then start the sign-in again. For the other sign-in messages, such as an OTP already in progress or a live session, see GST registrations.
Common problems: GSTR-1
An invoice is missing from GSTR-1
Process GSTR1 takes only posted, non-cancelled documents dated in the month and issued under the return's GSTIN. Fix the document and click Process GSTR1 again. If it is still missing, check whether it was ignored or carried forward. See GSTR-1.
A registered buyer's invoice is in B2C
The invoice had no buyer GSTIN when it was posted. Add the GSTIN to the customer account or address, correct the invoice, and process again.
Carry Forward or Ignore on the B2B invoice list does nothing
Those buttons have no server logic behind them. Record the decision on the GSTR-1 record's Reconciliations tab instead. A decision cannot be undone from the screen.
"GSTR1 '…' is Filed and cannot be re-processed; create an amendment instead of regenerating the filed period."
The return is Filed and frozen. Report the change through an amendment on the GST portal in a later period.
"A filing is already in progress for this return."
Do not try again from xMatix: a repeated request can file the return twice. Check the return on the GST portal first, then ask an administrator to clear the filing state.
Common problems: GSTR-2B
A bill is missing from the books side
Process GSTR2B takes only posted bills against a supplier account, recorded under the statement's GSTIN, whose Supplier Invoice Date (or Document Date) is in the month. A bill for last month's supplier invoice belongs to last month's statement. See GSTR-2B.
The same invoice is in Missing in Books and Missing in GSTN
The two sides disagree on the supplier GSTIN, invoice number or invoice date. The books side uses the bill's Supplier Invoice Number and Supplier Invoice Date, and the number must match GSTN's exactly. Correct the bill or the supplier account and process again.
Add In Books, Ignore or Vendor Follow-up does not change the figures
That is expected. These buttons record a decision on the row. A row moves to Matched only when the two sides agree, for example after you post the Draft bill that Add In Books raised and process again.
I want to accept or reject a document in IMS
xMatix does not record IMS decisions. Make them on the GST portal, then pull the statement again. xMatix keeps the IMS status GSTN sends, and GSTR-3B leaves out documents with IMS status R from table 4A.
GSTR-3B table 4D(2) or GSTR-9 table 8A is zero
Both read the statement's ITC Summary, which exists only after a successful Pull From GSTIN. Processing the books side never creates it. Pull the statement, then process GSTR-3B again.
Common problems: GSTR-3B
Box 3.1 is zero or lower than my sales
Process GSTR3B reads the GSTR-1 for the same GSTIN and month, preferring a Filed one and otherwise using a Draft one. Check that the GSTR-1 was processed and which documents on it were ignored or carried forward, then process GSTR-3B again. See GSTR-3B.
A credit is missing from 4A
4A reads only the latest GSTR-2B statement for the month, GSTN's side, and only lines marked available. If the supplier has not reported the invoice, it cannot be in 4A. Blocked credit goes to 4B(1), and only when the bill line's ITC Eligibility was Blocked at posting.
The return was not processed overnight
The scheduled GSTR-3B job waits until the month's GSTR-1 and GSTR-2B have both been processed, and it skips Filed returns and periods that are not Open. Process those first, or click Process GSTR3B yourself.
Status went back from Saved to Computed
The scheduled job reprocessed the return; it does this to every unfiled return in an open period. Run Save to GSTN and Check Save Status again before you file.
A figure I typed into a derived row disappeared
Processing rewrites the rows it fills automatically. Correct the source document, or record the figure on a row that is not auto-filled.
Processed Invoice Value is blank
That is expected: Process GSTR3B does not fill it. Use Status, Computed At and the Overview figures instead.
"A filed GSTR-3B cannot be recomputed."
The return is Filed and frozen. Report corrections in a later period's return.
Make Challan does nothing
xMatix does not create GST payment challans. Create the challan and pay on the GST portal.
Common problems: ITC and Rule 37
The ITC Ledger list is empty, or its dashboard tile shows zero
That is expected. Nothing in xMatix creates ITC Ledger records, and no return reads them. Your credit is in the GSTR-2B statement and in GSTR-3B tables 4A, 4B and 4D. See ITC management.
I can't find an ITC availment or Rule 42 action
There is none. Work out a Rule 42/43 reversal outside xMatix and enter it as a manual GSTR-3B row, which processing keeps.
A Rule 37 reversal appeared, or a paid bill was not reclaimed
A bill is reversed when it is more than 180 days old and still has an open amount. It is reclaimed in the month its open amount reaches zero and a dated payment is applied to it, so a part-paid bill still counts as unpaid. Apply the payment to the bill, then process an open GSTR-3B again.
Common problems: GSTR-6 and GSTR-9
"… ITC pool(s) have no recipient to distribute to"
The ISD has no operational recipient for the month. Check the ISD Recipient Turnover records. See GSTR-6.
Every GSTR-9 figure is zero, or "Prerequisite not met"
GSTR-9 reads only Filed GSTR-1 and GSTR-3B returns, and all twelve months must exist and be Filed. File the months, or record the filings you made on the portal, then compute again. See Annual returns.
Common problems: e-invoicing
Generate keeps saying "E-invoice generation in progress"
xMatix set the Invoice's Status (eInvoice) to the trigger value and nothing has answered. An administrator should check that the integration flow is enabled, reacts to that status, and has run without errors. See E-invoicing.
"This invoice already has an IRN; an e-invoice cannot be regenerated."
The invoice is already registered. Cancel the IRN on the portal, or issue a credit note and a new invoice.
The portal rejects missing names, addresses, PIN or unit
The built-in request leaves the seller and buyer legal name, address and PIN and the line unit blank. The integration must add them.
Generate fails with an access-denied message
The profile has E Invoice Generator but not Set E-Invoice Status. Ask your administrator to grant it.
Common problems: e-way bills
The panel stays on "Waiting for GSP"
No integration has answered the request. Check the integration's run. You can correct the details and click Generate again; the same record is updated.
"E-way bill … is already generated for this document. Cancel it before generating a new one."
A valid e-way bill exists for the Invoice. Cancel it within 24 hours of generation, or wait until it expires. See E-way bills.
The register says Generated but the bill has expired
No job marks e-way bills Expired. The panel on the Invoice shows Expired as soon as Valid Upto has passed.
E Way Bill on a delivery order does nothing
Only the Invoice can raise an e-way bill. Raise it from the Invoice that covers the goods.
Common problems: TDS
TDS was not deducted on a bill
Deduction starts only when one bill reaches the section's single-bill threshold, or when amounts already deducted plus the new bill pass the annual threshold. Also check the vendor's Deductee Type and that the section on the line is still valid. See TDS sections.
"Only a Draft challan can be deposited." or "Challan needs a bank GL account to pay from."
The challan was already deposited, or it has no bank account to pay from. Each challan message and its fix is in TDS challans.
One month produced two challans for the same payment code
Challans are grouped by payment code and major head, so company and non-company deductees give separate challans. That is correct.
"A Filed return cannot be recomputed"
The TDS return is Filed. Make changes through a correction return. For validation results such as Missing CIN or Challan Over-Utilised, see TDS returns.
"The 26AS lines carry more than one PAN", or every group is Missing in books
Split the Form 26AS rows into one statement per PAN. Missing in books means the company has no TDS receivable posted from its sales invoices for that year, or it was posted under another company. See TDS reconciliation.
Training
Practice exercise
In a sandbox, post a sales invoice to a registered customer, dated in the current month, under a branch with an active GST registration. Then remove the GSTIN from a second customer and post an invoice to them as well. Open the month's GSTR-1, click Process GSTR1, and find both invoices.
Expected result: the first invoice is under B2B. The second is under B2C Small (or B2C Large, if it is inter-state and above the limit), because it had no buyer GSTIN at posting. Explain to a colleague why editing the GSTR-1 row would not fix it, and what would.
Quick reference
- Drafts never reach a return. Post first.
- A bill's month comes from its Supplier Invoice Date.
- No GST registration on the branch or company means no GSTIN on the tax rows, and no return.
- Creating a GST period does not create returns. Provision the month.
- Scheduled jobs process only Open periods.
- Processing again is safe: it keeps your decisions. It is refused once the return is Filed.
- Filed is one-way. Correct a Filed return through an amendment or a later period.
- No integration, no portal: e-invoices, e-way bills and GSTN saves wait until an integration answers.
- A missing button usually means a missing action grant on the security profile.
Permissions
Each Tax Center button, such as Process GSTR1, Pull From GSTIN, Save to GSTN or Provision GST Returns, is a server action that a security profile must grant. A user without the grant does not see the button. New, Edit and Delete follow the entity's access in the profile. Each return page lists the standard grants under its own Permissions section.
Configuration
These are the settings an administrator checks when the Tax Center does not behave as expected:
- GST registrations (Is Active, GSTIN, GSTN Username, Enable ISD): decide which GSTINs appear, which returns are provisioned and whether GSTN sign-in works. See GST registrations.
- GST periods (Open, Closed, Locked): decide what the scheduled jobs process and what can be changed. Locked is final. See GST periods.
- Scheduled jobs: provision each month's returns and process GSTR-1, GSTR-2B, GSTR-3B and GSTR-6 for open periods. The GSTR-3B job waits for the month's GSTR-1 and GSTR-2B.
- GSP integrations: carry Pull, Save and filing requests to GSTN, and e-invoice and e-way bill requests to their portals. Check their runs in Sync health.
- Tax groups and TDS sections: decide the tax captured at posting, and so every return figure. See TDS sections.
- Return forms: some fields, such as GSTR-3B Save Status and GSTN Response, and the manual entry forms for box tables, are not on the standard forms. Add them in the form designer as described on each return page.
Common questions
Should I edit a return row to fix a wrong figure?
No. Rows that processing builds are rebuilt from your posted documents the next time the return is processed, and the scheduled jobs reprocess unfiled returns in open periods. A figure you type into such a row disappears. Correct the source document through your usual correction process instead, then process the return again. For figures xMatix cannot derive, such as a Rule 42/43 reversal or e-commerce supplies in GSTR-3B Table 3.1.1, use rows that are not auto-filled, which processing keeps.
Does xMatix send anything to GSTN by itself?
No. xMatix sends nothing until a user clicks Save to GSTN, a filing action, or Generate on an e-invoice or e-way bill, and even then only through a GSP integration your administrator has set up. Without that integration, requests wait and no number comes back. You can still prepare every return in xMatix, file on the GST portal, and record the filing with File To GSTN (GSTR-1) or Record Manual Filing (GSTR-3B).
Can I un-file a return?
No. Filed is one-way in xMatix, as it is at GSTN. Processing, saving and filing are all refused on a Filed return, and nothing moves it back. Report a correction through an amendment on the portal or in a later period's return. Before recording a manual filing, check the acknowledgement number against the portal, because a wrong entry cannot be undone from the screen.
Why do the GST console and the return record show different totals?
They show different sides. The return record's Overview shows the books side, built from your posted documents. The console's GSTR-2B card shows GSTN's side, which arrives with Pull From GSTIN. The difference between the two is what the return's Reconciliations tab breaks down document by document.