xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/B2B Invoice — entity reference
REFERENCE · Last reviewed

B2B Invoice — entity reference

One invoice in Table 4 (B2B) of a GSTR-1 return, under the B2B Supply group for its buyer GSTIN. Process GSTR1 creates it from a posted sales invoice that carried a buyer GSTIN, or whose Tax Supply Type contains SEZ. Exports and credit or debit notes never land here. Pull from GSTIN creates the portal-side copy from what GSTN returns. The tax per rate is held in GSTR-1 line items under the invoice. Ignore and Carry Forward decisions are recorded on this record from the GSTR-1 Reconciliations tab. The Carry Forward and Ignore buttons on this entity's own list have no server logic and change nothing. The record page has no buttons. Rows are not in any app menu; open them from the B2B rows of the GSTR-1 Overview. Do not create or edit rows by hand: a new row is attached to no group, and an edit is overwritten by the next processing run.

Fields

FieldLabelTypeRequiredWhat it does
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
GSTINGSTINTextThe buyer's GSTIN, taken from the GSTIN field of the sales invoice when it was posted. On the portal side it is the GSTIN GSTN returned. Reconciliation pairs B2B invoices on this GSTIN and the invoice number. It is blank for an SEZ supply posted without a GSTIN.
GSTR1B2BSupplyIdB2B SupplyLookup → GSTR1B2BSupplyThe B2B Supply group (one per buyer GSTIN) the invoice sits under. Carry Forward places the copy under next month's group for the same buyer GSTIN.
IdIdGuidYes
InvoiceDateInvoice DateDateThe document date of the source sales invoice, or the invoice date GSTN returned. It does not affect reconciliation pairing.
InvoiceNumberInvoice NumberTextThe name of the source sales invoice on the books side, or the invoice number GSTN returned on the portal side.
InvoiceTypeInvoice TypeTextRegular for an ordinary B2B invoice. For a document whose Tax Supply Type contains SEZ: SezWP when it carries integrated tax, SezWOP when it does not. Portal-side rows can also read DeemedExport. Save to GSTN sends R, SEWP or SEWOP. SEZ invoices go to GSTR-3B table 3.1(b) and to GSTR-9 row 4D (SezWP) or 5B (SezWOP).
InvoiceValueInvoice ValueCurrencyThe taxable value plus every tax head of the invoice, rounded to two decimals. On the portal side, the value GSTN returned. Matched requires it to agree within 1 rupee.
IsCarriedForwardCarried ForwardBooleanSet when you choose Carry Forward. The invoice is left out of this return, and a copy is added to next month's return under the group for the same buyer GSTIN.
IsIgnoredIgnoredBooleanSet when you choose Ignore on the invoice's reconciliation row. An ignored invoice is left out of the Overview figures, out of what Save to GSTN sends and out of GSTR-3B.
LabelLabelTextNot set by xMatix. It stays blank.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesFirst a number from the B2B Invoices Name Setting (series B2BINV). After the next processing run that is not skipped, it becomes the invoice number.
OwnerIdOwnerLookup → UserAccountYes
PlaceOfSupplyPlace Of SupplyTextThe two-digit state code of the invoice's place of supply. Save to GSTN sends it as the invoice's place of supply.
RecordTypeIdRecord TypeGuid
ReverseChargeReverse ChargeBooleanTaken from the Reverse Charge (eInvoice) setting of the sales invoice, or the reverse-charge flag GSTN returned. Reverse-charge invoices are counted under B2B Reverse Charge on the Overview, sent with flag Y, added to GSTR-3B table 3.1(a) like other B2B invoices, and put in GSTR-9 row 5C.
SourceSourceTextBooks for invoices built by Process GSTR1 from your posted sales, Portal for invoices imported by Pull from GSTIN. Processing only changes Books rows, and a pull only replaces Portal rows.
SourceRecordIdSource RecordGuid, hiddenOn the books side, the posted sales invoice the row was built from. Re-processing matches on it, so the row keeps its identity and its decision from one run to the next. Empty on portal rows and on carried-forward copies.
TaxableRateTaxable RateDecimalThe rate of the invoice's first tax line, recorded when the row was first built and not refreshed by later processing. For an intra-state invoice it is the central tax rate, not the combined rate. The rate-wise detail is on the GSTR-1 line items.
TaxAmountTax AmountDecimalThe total of every tax head on the invoice. Refreshed on every processing run.
UIPropsUI PropsText
UpdatedDateTimeModified OnDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CarryForwardCarry ForwardServerActionThe recon grid's row-level carry-forward decision on a B2B invoice - same shared implementation as the GSTR1 header's CarryForward: the selected document is reported in the next period's filing instead of this one, without moving or copying the row. Portal rows and already-carried rows are rejected.
CloneCloneServerAction (Clone)Create a copy of this record
EditEditEdit, inactiveedit
IgnoreIgnoreServerActionThe recon grid's row-level ignore decision on a B2B invoice - same shared implementation as the GSTR1 header's Ignore: the document is dropped from the filing outright and no later filing picks it up. Portal rows are rejected.
NewNewNew, inactiveNew