First GIR Filings
Schema Errors, Correction Workflows and the Mistakes That Define Year Two
TL;DR
- A first-cycle GIR (GloBE Information Return) filing carries more risk than a routine, repeat filing, teams are new to the data requirements, teams may be validating GIR XML against production-scale data for the first time, and correction workflows have never been exercised under pressure.
- Errors don’t disappear once filed. Every correction is tracked through a DocRefID and CorrDocRefID chain in the OECD’s GIR XML schema, corrections create a traceable XML reference chain, not a quiet fix.
- An amendment can trigger a fresh exchange of the corrected GIR with every jurisdiction the original was shared with, a first-cycle mistake doesn’t stay local.
- In the UK, HMRC requires the GIR to be submitted using third-party software and to conform to the OECD GIR XML Schema, a file that fails to satisfy those validations is rejected before it’s even accepted.
- A rejected GIR is treated as not filed, there’s no partial credit for a file that fails validation.
- The mistakes that define a group’s second-year filing are usually the ones baked into workflows during the first cycle, when nothing had been tested yet.
Quick Answer
The first GIR filing cycle under BEPS (Base Erosion and Profit Shifting) Pillar Two is higher-risk than any routine filing because three things are happening for the first time at once: teams are handling GIR schema validation against real data for the first time, Pillar Two correction workflows have never been used under real conditions, and any error creates a traceable DocRefID amendment trail rather than a quiet fix. A rejected or incorrect first GIR isn’t just a delay, it may require corrected information to be re-exchanged with relevant jurisdictions, and it sets the pattern that defines how complicated (or clean) year two becomes.
Introduction
Every recurring compliance filing eventually becomes routine. The first one never is. For advisors and in-house teams preparing to file GIR data for the first time under BEPS 2.0 Pillar Two rules, that gap matters more than it would for almost any other filing, because the GIR isn’t a form you fill in and submit once. It’s a structured XML document, checked against a formal schema, cross-referenced by DocRefIDs, and exchanged with relevant tax authorities under applicable information-exchange arrangements. Mistakes in that structure don’t behave like mistakes in a PDF return. They leave a trail. And that trail is exactly what makes the first cycle the highest-risk one a group will ever file.
Why “First Cycle” Risk Is Different From Ordinary Filing Risk
Three things are genuinely new in a first GIR filing, and each one compounds the others:
The data requirements are unfamiliar. The GIR, sometimes searched for as the “Global Information Return,” though its correct name is the GloBE Information Return, pulls constituent entity identifiers, jurisdiction-level effective tax rates, top-up tax amounts, safe harbour elections, and GloBE status flags into a single structured file. A team preparing this for the first time is mapping their own general ledger and consolidation data into an entirely new data structure, often without a prior filing to check against.
GIR schema validation is untested. GIR files are subject to XML schema (XSD) validation as well as additional technical and business validation rules. XSD validation checks whether every required element is present, correctly typed, and within valid ranges. The additional technical and business rules check whether the data is logically consistent, does an entity marked as excluded also carry the fields that exclusion implies. A file may be XSD-valid and still fail these additional validation rules. Teams don’t discover which of their assumptions were wrong until they’ve actually run real data through both layers, which, in a first cycle, is happening for the first time under deadline pressure.
Correction workflows are untested. The mechanics of doing so correctly, which is where most of the risk in a first cycle actually concentrates, are unfamiliar territory.
How the GIR’s Correction Mechanism Actually Works
This is the part of Pillar Two amendment mechanics that catches first-time filers off guard: a GIR correction isn’t a case of re-submitting a cleaner version and moving on. Every data record in the GIR XML schema carries a set of reference fields that govern exactly how a correction has to be structured:
Schema element | What it does |
DocRefID | A unique identifier assigned to every individual data record in the GIR. Required on every record, whether new or corrected. |
CorrDocRefID | References the DocRefID of the specific record being corrected or deleted. Must point to the latest version of that record, if it’s already been corrected once, this can’t reference the original. |
MessageRefID | A unique identifier for the submission itself. Every correction needs its own new MessageRefID, even if it’s correcting a single record. |
DocTypeIndic | Flags whether a given record is new, corrected, or deleted data. |
In practice, this means:
- A series of corrections is fully traceable, once the data has been exchanged. Every version of every record is chained through DocRefIDs, so there’s no way to “quietly” fix something without it showing up in the amendment history. That said, this only applies once the GIR information has actually been exchanged with the relevant jurisdictions: if an error is found before exchange has taken place, the formal DocRefID/CorrDocRefID correction mechanism isn’t required. Once exchange has happened, the correction mechanism applies.
- All the original validation rules apply again. A correction isn’t exempt from the checks that applied to the first submission, it has to pass the same structural and business validation the original did.
- Amendments can trigger a fresh exchange. Because the GIR is automatically shared with other tax administrations under exchange agreements, a correction to data that’s already been exchanged can prompt a new round of exchange with every jurisdiction that received the original.
None of this is punitive by design, it’s simply how a machine-readable, internationally exchanged document must work. But it means a first-cycle error isn’t a private matter between a filer and one tax authority. It’s visible, structured, and potentially multi-jurisdictional.
Not Sure Your Correction Workflow Will Hold Up?
Get a free 15-minute review with our Pillar Two team, we’ll look at how you’re planning to handle DocRefID amendments and flag anything that’s likely to trip up your first correction.
Why an XML Error With HMRC Isn’t Just “Try Again”
A GIR that fails HMRC’s validation checks must be corrected and resubmitted before the filing process is successfully completed. HMRC requires a UK-filed GIR to be submitted using compatible software through its File Transfer Service, in .xml format conforming to the OECD GloBE Information Return XML Schema, there’s no portal for uploading a PDF, HTML file, or spreadsheet. Software providers must obtain HMRC approval and production credentials before making live transfers, and files that don’t contain the expected data and structure fail at the validation stage before they’re accepted at all.
That combination, mandatory API submission, credentialed software, and structural validation before acceptance, is precisely where first-cycle teams lose time they don’t have: discovering, mid-deadline, that a file which looked complete still fails HMRC’s validation stage because a required element, data type, or structural detail wasn’t exactly right.
What This Means for Year Two
Process weaknesses introduced during the first GIR cycle can carry forward into subsequent filings, for example, inconsistent DocRefID generation, unclear correction responsibilities, or insufficient testing of validation-error workflows. None of that shows up as a problem in year one if the first filing happens to go smoothly. It shows up in year two, when the same shortcuts meet a second dataset, a personnel change, or updated OECD or HMRC guidance since the last cycle.
Teams can reduce second-cycle risk by treating correction workflows, identifier governance and validation testing as part of the initial implementation rather than dealing with them only when an error occurs. That discipline is part of the same broader shift the OECD’s wider BEPS action plans have been pushing toward: structured, machine-readable, auditable reporting, rather than a document filed once and forgotten.
Preparing Your First GIR Filing?
Get a free 15-minute review with our Pillar Two team, we’ll walk through your schema validation and correction process before you’re relying on it under deadline.
Frequently Asked Questions
What is a DocRefID in a GIR filing?
It’s a unique identifier attached to every data record in the GIR XML schema. To correct or delete a record, the correction must reference that exact DocRefID, or, if the record’s already been corrected once, the DocRefID of its latest version, through a CorrDocRefID field.
What happens if my GIR is rejected due to an XML error?
HMRC says failed returns must be corrected and resubmitted. If a previously failed GIR passes validation by 1 September 2026, HMRC will use the date it received the first GIR as the submission date. Outside that concession, the underlying filing obligation stays outstanding until a valid file is successfully submitted, so a rejection needs to be treated as urgently as a missed deadline.
Does correcting a GIR trigger a new exchange with other countries?
It can. Corrected information should be exchanged with all Competent Authorities for which that information is subject to exchange, so a correction to previously exchanged data can prompt a fresh round of exchange with the relevant jurisdictions.
Does HMRC accept a GIR in any format other than XML?
No. HMRC’s Pillar 2 filing service requires submission in .xml format through HMRC’s File Transfer Service/File Upload API using compatible software, there’s no route to upload a PDF, HTML file, or spreadsheet directly.
Why is the first GIR filing riskier than later ones?
Because three things are happening for the first time simultaneously: the team is unfamiliar with the data requirements, schema validation is being run against real data for the first time, and the correction workflow has never actually been used, so there’s no prior experience to fall back on if something goes wrong.